api

Initialisation du projet

Base de données

Ce projet est conçu pour fonctionner avec une base de données SQL Server. Montez votre propre base en local pour le développement.

Variables d'environnement

Des variables d'environnement sont à renseigner dans le projet API. Dupliquez le .env.example, renommez-le en .env et renseignez les variables.

Lancement

À la racine de la solution, exécutez la commande suivante:

dotnet run --project API

Base de données

Exécutez la commande suivante pour générer les fichiers de migration

Prérequis : installez l’outil EF Core CLI si ce n’est pas déjà fait :

dotnet tool install --global dotnet-ef
dotnet ef migrations add MIGRATION_NAME -p Infrastructure -s API

Appliquez ensuite la migration avec la commande :

dotnet ef database update -p Infrastructure -s API

Inventaire

Les stocks ne sont pas gérés comme un champ qu'on vient incrémenter ou décrémenter. Les stocks sont le calcul de l'ensemble des écritures dans le registre article.

L'ajustement du stock se fait par les feuilles d'inventaires. L'opérateur renseigne ainsi le stock réel. Une fois validée, les écritures nécessaires dans le registre sont crées.

    sequenceDiagram

    InventoryLine->>InventoryHeader: Déclaration quantités réelles
    InventoryHeader->>ItemLedger: Validation feuille, création d'entrées dans le registre pour ajustement des écarts

Loading

Vente

    sequenceDiagram

    Commande_vente->>Panier: Statut: Cart
    Panier->>Commande_vente: Statut: Released - Déclenchement Cmd achat si auto
    Commande_vente->>ItemLedger: Statut: Posted (Validée est considérée comme expédiée). Stock requis

Loading

Achat

    sequenceDiagram

    Inventaire_insuffisant->>Commande_achat: Génération automatique ou manuelle selon paramétrage
    Commande_achat->>Panier: Statut de départ pour l'ajout des articles
    Panier->>Commande_achat: En cours, demande au fournisseur
    Commande_achat->>ItemLedger: Validée - mise en stock via le registre

Loading