Skip to content

README.md

Latest commit

 

History

History
93 lines (64 loc) · 2.92 KB

README.md

File metadata and controls

93 lines (64 loc) · 2.92 KB

GestionApp — Distribution Management System

Desktop application built in C# + WPF (.NET 8) focused on the day‑to‑day operation of a distribution business: inventory, combos, deliveries, costs, and movements. It prioritizes clean architecture, explicit business rules, and a consistent UX.

🚧 Project status

Actively in development. The system is continuously evolving and improvements are added progressively. This repository reflects ongoing work.

✨ Key features

  • 📦 Inventory with stock control and movement traceability.
  • 🧩 Combos/groupings and product relationships.
  • 🚚 Deliveries with priorities and date‑based alerts.
  • 💾 Local persistence with SQLite + EF Core.
  • 🧭 Modular navigation and reactive UI through MVVM.

🧱 Architecture & design

  • 🧩 MVVM with strict separation of View ↔ ViewModel ↔ Model.
  • 🧰 Dependency Injection for services, navigation, and ViewModels.
  • 🧠 Domain services encapsulating business rules.
  • 🗂️ Soft delete to preserve traceability.

🛠️ Environment requirements

  • 🪟 Windows 10/11 (WPF is Windows‑only).
  • 🧬 .NET SDK 8.0 or later.

▶️ Installation & run

dotnet restore
dotnet build
dotnet run

If the process is blocking compilation:

taskkill /F /IM GestionApp.exe
dotnet build

🗄️ Database

Local SQLite database created automatically at startup using EnsureCreated():

%APPDATA%\GestionApp\gestion.db

Technical note: if you change models or relationships, delete gestion.db and run again. Migrations are not used in this workflow.

🗂️ Repository structure

GestionApp/
├── Data/              # DbContext and EF Core configuration
├── Helpers/           # Commands, converters, and MVVM utilities
├── Models/            # Domain entities
├── Services/          # Business and navigation services
├── ViewModels/        # Presentation logic
├── Views/             # WPF views (XAML)
├── App.xaml           # Resources and DataTemplates
├── MainWindow.xaml    # Main shell
└── GestionApp.csproj

📦 Core packages

Package Purpose
Microsoft.EntityFrameworkCore.Sqlite SQLite persistence
Microsoft.EntityFrameworkCore.Tools EF Core tooling
Microsoft.Extensions.DependencyInjection DI container

🧪 Developer quick guide

  • Keep logic in services and ViewModels; views should be “thin”.
  • Forms use string for numeric fields to avoid decimal format issues.
  • Critical operations register movements for auditability.

📚 Documentation

  • Extended technical documentation in docs/DOCUMENTACION.md.

🤝 Contributing

If you want to collaborate, open an issue describing the proposed change. PRs should include a clear technical description and minimal manual verification steps.

Built with C# and WPF (.NET 8).