ETASCOM CRM V3 - Documentation API

🏭 CRM ETASCOM V3 - Système de Gestion Industrielle

📋 Table des Matières

Vue d'ensemble
Fonctionnalités
Architecture
Installation
Configuration
Workflow de Production
Gestion des Achats & Fournisseurs
Structure du Projet
API
Base de Données
Déploiement
Contribution
Support

🎯 Vue d'ensemble

CRM ETASCOM V3 est un système de gestion industrielle complet développé pour l'usine ETASCOM Automotive (fabrication de mousse de protection et adhésifs). Cette application Next.js moderne intègre tous les aspects de la gestion industrielle : des achats et matières premières à la production et livraison des produits finis.

🎨 Interface Utilisateur

Design moderne avec support Dark/Light mode
Interface responsive optimisée pour tous les appareils
Composants réutilisables basés sur Tailwind CSS
Support multilingue (FR, EN, ES, AR)
Support RTL pour l'arabe

✨ Fonctionnalités

🏭 Gestion Industrielle Complète

📦 Gestion des Matières Premières

Configuration avancée des matières premières avec spécifications techniques
Catégories hiérarchiques pour organisation optimale (Mousses → PE → PE réticulée)
Gestion des prix et coûts avec taxes personnalisables
Codes et identification (référence interne, code-barres, code fournisseur)
Gestion des stocks en temps réel avec alertes automatiques
Traçabilité complète avec numéros de lot et dates d'expiration
Contrôles qualité intégrés avec certifications

🛒 Module Achats & Fournisseurs

Gestion des fournisseurs avec adresses, contacts et identifiants légaux
Bons de commande fournisseurs avec workflow de validation
Réceptions de marchandises avec contrôle qualité
Gestion des factures et échéances
Retours fournisseurs pour produits défectueux
Suivi des livraisons et réceptions
Export PDF/Excel des documents
Traçabilité complète des achats et réceptions

📊 Gestion du Stock & Logistique

Niveaux de stock par emplacement et zone
Mouvements de stock traçables (ENTRÉE, SORTIE, TRANSFERT)
Gestion des lots avec numéros de batch et dates d'expiration
Bons de livraison pour les expéditions clients
Réceptions fournisseurs avec validation qualité
Transferts internes entre entrepôts et emplacements
Retours clients et fournisseurs
Réservations pour production
Points de commande automatiques
Traçabilité complète des mouvements

🏗️ Production & Fabrication

Ordres de fabrication avec planification avancée
Postes de travail (WorkCenter) avec capacités et coûts
Nomenclatures enrichies (BillOfMaterial) avec coûts, efficacité, opérations
Gammes de fabrication (Routing) avec séquences d'opérations
Opérations détaillées avec consignes, cadences, contrôles qualité
Suivi des opérateurs et performance en temps réel
Contrôles qualité intégrés aux opérations
Gestion des rebuts et pertes de production
Calcul des coûts de production automatique
Traçabilité complète ISO/IATF

👥 Ressources Humaines

Gestion des employés et contrats
Feuilles de paie et congés
Formations et évaluations
Planning et affectations

💼 Commercial

Gestion des offres avec workflow Kanban (Brouillon → À envoyer → Envoyé → Caduc)
Conversion leads vers clients avec historique complet
Suivi des projets et clients avec adresses multiples
Contrats clients et facturation avec taxes
Campagnes marketing et gestion des prospects
Identifiants légaux internationaux (ICE, RC, SIRET, DUNS)

🏷️ Système d'Étiquettes Complet

Étiquettes matières premières avec informations fournisseur et stockage
Étiquettes produits finis avec informations client et expédition
Gestion des lots avec numéros de batch et dates d'expiration
Codes-barres et QR codes uniques pour chaque étiquette
Types d'étiquettes multiples (RAW_MATERIAL, FINISHED_PRODUCT, SHIPPING, etc.)
Statuts d'étiquettes (DRAFT, GENERATED, PRINTED, APPLIED, DAMAGED, REPLACED)
Traçabilité complète des produits de la réception à l'expédition

💬 Communication Interne

Actualités d'entreprise avec système de likes et commentaires
FAQ et documentation organisées par catégories
Centre d'aide avec guides utilisateur et procédures
Gestion des mots de passe sécurisée pour les plateformes externes
Système de demandes avec workflow d'approbation (achats, congés, formation, etc.)
Commentaires internes et externes sur les demandes

💱 Système de Devises Complet

Gestion multi-devises avec support international (MAD, EUR, USD, GBP, etc.)
Taux de change historiques avec sources de données multiples
Devises préférées par client, fournisseur et transporteur
Conversion automatique des montants selon les devises
Support des formats de devises (position du symbole, décimales)
Gestion des échéances et paiements multi-devises

🔧 Fonctionnalités Techniques

Authentification & Sécurité

NextAuth.js 4.24.11 - Authentification sécurisée avec 2FA
Bcrypt 6.0.0 - Hachage sécurisé des mots de passe
Zod 3.25.67 - Validation des schémas et données
Gestion des rôles et permissions granulaires
Audit trail complet des actions

Interface Utilisateur

React 19.1.0 - Framework UI moderne
Tailwind CSS 4.1.11 - Styling utilitaire
React Aria Components 1.10.1 - Accessibilité complète
Radix UI 1.4.2 - Composants primitifs accessibles
Motion 12.19.2 - Animations fluides
Next Themes 0.4.6 - Support Dark/Light mode
Responsive design optimisé pour tous les appareils

Gestion des Données

TanStack React Query 5.81.5 - Gestion d'état serveur
TanStack React Table 8.21.3 - Tableaux avancés
Prisma 6.10.1 - ORM type-safe
PostgreSQL 15 - Base de données relationnelle
React Hook Form 7.59.0 - Gestion des formulaires

Visualisation & Graphiques

ApexCharts 4.7.0 - Graphiques avancés
Recharts 2.15.1 - Graphiques React
React Leaflet 5.0.0 - Cartes interactives
Tableaux de bord personnalisables
Rapports et exports avancés

Communication & Notifications

Sonner 2.0.5 - Système de notifications
Nodemailer 7.0.4 - Envoi d'emails
Chat intégré pour la communication
Notifications en temps réel

Internationalisation

i18next 25.2.1 - Support multilingue complet
Next i18next 15.4.2 - Intégration Next.js
Support RTL pour l'arabe
Détection automatique de la langue

Fonctionnalités Métier

Gestion des taxes flexible (TVA, taxes de vente, etc.)
Adresses multiples par entité (facturation, livraison, autres)
Contacts multiples avec postes et coordonnées
Support multi-pays avec identifiants légaux internationaux
Système d'étiquettes complet avec codes-barres et QR codes
Communication interne avec actualités, FAQ et demandes
Gestion des mots de passe sécurisée pour plateformes externes
Système de devises complet avec taux de change et conversion automatique
Système de production industriel avec postes de travail et gammes de fabrication
Nomenclatures enrichies avec calculs de coûts et efficacité
Traçabilité opérateur et suivi de performance en temps réel

Stockage & Fichiers

AWS SDK S3 3.839.0 - Stockage cloud sécurisé
Upload automatique des fichiers
Suppression en cascade des fichiers
Gestion des types de fichiers

🏗️ Architecture

Stack Technologique

Frontend:
├── Next.js 15.3.4 (App Router)
├── React 19.1.0
├── TypeScript 5.8.3
├── Tailwind CSS 4.1.11
├── React Hook Form 7.59.0
├── TanStack React Query 5.81.5 (State Management)
├── React Aria Components 1.10.1
├── Radix UI 1.4.2 (Composants)
├── Lucide React 0.525.0 (Icônes)
├── ApexCharts 4.7.0 (Graphiques)
├── Recharts 2.15.1 (Graphiques)
├── React Leaflet 5.0.0 (Cartes)
├── Next Themes 0.4.6 (Dark/Light Mode)
├── i18next 25.2.1 (Internationalisation)
└── Motion 12.19.2 (Animations)

Backend:
├── Next.js API Routes
├── Prisma 6.10.1 (ORM)
├── PostgreSQL 15
├── NextAuth.js 4.24.11
├── AWS SDK S3 3.839.0 (Storage)
├── Nodemailer 7.0.4 (Email)
├── Bcrypt 6.0.0 (Hashing)
└── Zod 3.25.67 (Validation)

Infrastructure:
├── Docker (optionnel)
├── Vercel/Netlify (déploiement)
├── Supabase/Neon (base de données)
└── AWS S3 (stockage fichiers)

Outils de Développement

Qualité de Code:
├── ESLint 9.30.0 (Linting)
├── Prettier 3.6.2 (Formatage)
├── TypeScript 5.8.3 (Type Safety)
└── Autoprefixer 10.4.21 (CSS)

UI/UX Libraries:
├── React Aria Components 1.10.1 (Accessibilité)
├── Radix UI 1.4.2 (Composants primitifs)
├── Lucide React 0.525.0 (Icônes)
├── Remix Icons 4.6.0 (Icônes supplémentaires)
├── Class Variance Authority 0.7.1 (Variants CSS)
├── Tailwind Merge 3.3.1 (Fusion classes)
├── CLSX 2.1.1 (Classes conditionnelles)
└── Vaul 1.1.2 (Drawer/Modal)

Formulaires & Validation:
├── React Hook Form 7.59.0 (Gestion formulaires)
├── Hookform Resolvers 5.1.1 (Résolveurs)
├── Zod 3.25.67 (Validation schémas)
├── Input OTP 1.4.2 (Codes OTP)
└── React Day Picker 9.7.0 (Sélecteur dates)

État & Données:
├── TanStack React Query 5.81.5 (Server State)
├── TanStack React Table 8.21.3 (Tableaux)
├── React Wrap Balancer 1.1.1 (Texte équilibré)
└── React Resizable Panels 3.0.3 (Panneaux)

Graphiques & Visualisation:
├── ApexCharts 4.7.0 (Graphiques avancés)
├── React ApexCharts 1.7.0 (Wrapper React)
├── Recharts 2.15.1 (Graphiques React)
└── React Leaflet 5.0.0 (Cartes interactives)

Animations & Interactions:
├── Motion 12.19.2 (Animations)
├── DND Kit 6.3.1 (Drag & Drop)
├── Embla Carousel 8.6.0 (Carrousels)
├── React Aspect Ratio 1.1.9 (Ratios)
└── Sonner 2.0.5 (Notifications)

Internationalisation:
├── i18next 25.2.1 (i18n core)
├── React i18next 15.5.3 (React integration)
├── Next i18next 15.4.2 (Next.js integration)
└── i18next Browser Language Detector 8.2.0

Utilitaires:
├── Date-fns 4.1.0 (Manipulation dates)
├── CMDK 1.1.1 (Command palette)
├── Faker.js 9.8.0 (Données de test)
└── Headless Tree 1.2.0 (Arbres)

Architecture des Modules

src/app/(protected)/
├── sales/             # Module Commercial
│   ├── offres/        # Gestion des offres
│   ├── projets/       # Gestion des projets
│   └── clients/       # Gestion des clients
├── production/        # Module Production
│   ├── ordres/        # Ordres de fabrication
│   ├── operations/    # Opérations
│   └── qualite/       # Contrôles qualité
├── achat/            # Module Achats
│   ├── commandes/     # Bons de commande
│   ├── fournisseurs/  # Gestion fournisseurs
│   └── factures/      # Factures
├── stock/            # Module Stock
│   ├── niveaux/       # Niveaux de stock
│   ├── mouvements/    # Mouvements
│   └── emplacements/  # Gestion des zones
└── raws/             # Matières Premières
    ├── reception/     # Réceptions
    ├── stock/         # Stock MP
    └── batches/       # Gestion des lots
├── communication/    # Communication Interne
    ├── actualites/   # Actualités et posts
    ├── faq/          # Questions fréquentes
    ├── documentation/ # Centre d'aide
    └── demandes/     # Système de demandes
├── etiquettes/       # Système d'Étiquettes
    ├── generation/   # Génération d'étiquettes
    ├── impression/   # Impression et statuts
    └── tracabilite/  # Traçabilité des produits

🚀 Installation

Prérequis

Node.js 18+ (recommandé 20+)
PostgreSQL 15+
npm ou yarn ou pnpm
Git pour le contrôle de version

1. Cloner le projet

git clone https://github.com/yboulhilat/ETASCOM_CRM_V3.git
cd CRM_ETASCOM_V2

2. Installer les dépendances

npm install
# ou
yarn install

3. Configuration de l'environnement

cp .env.example .env.local

Éditer le fichier .env.local :

DATABASE_URL="postgresql://postgres.uxaispxvqujpswfyupdk:[YOUR-PASSWORD]@aws-0-ap-southeast-1.pooler.supabase.com:6543/postgres?pgbouncer=true"

# Direct connection to the database. Used for migrations.
DIRECT_URL="postgresql://postgres.uxaispxvqujpswfyupdk:[YOUR-PASSWORD]@aws-0-ap-southeast-1.pooler.supabase.com:5432/postgres"

# Next Auth Config #
NEXT_PUBLIC_API_URL=http://localhost:3000/api
NEXT_PUBLIC_BASE_PATH=http://localhost:3000/
NEXTAUTH_URL=http://localhost:3000/
NEXTAUTH_SECRET=N3G2xT44ovZWp24HUQE54JRJq63ZOhhOHe1uQnsQxs4=
GOOGLE_CLIENT_ID=your_gogle_oauth2_client_id
GOOGLE_CLIENT_SECRET=your_gogle_oauth2_secret_key

# Storage Configuration (AWS S3 or DigitalOcean Spaces)
STORAGE_TYPE=aws

STORAGE_ACCESS_KEY_ID=AKIAZBA3WKIG3F3OSOR7
STORAGE_SECRET_ACCESS_KEY=G1Bg1Ns4ORPo/R0u+qyXf7tsLH/x+fIGyRRWsbDI
STORAGE_REGION=eu-north-1
STORAGE_BUCKET=etascom
STORAGE_ENDPOINT=https://etascom.s3.eu-north-1.amazonaws.com/
STORAGE_FORCE_PATH_STYLE=true
STORAGE_CDN_URL=https://etascom.s3.eu-north-1.amazonaws.com/

# SMTP Credentials
SMTP_HOST=your_smtp_host
SMTP_PORT=your_smtp_port
SMTP_SECURE=false
SMTP_USER=no-reply@domain.com
SMTP_PASS=your_smtp_pass

# Additional Optional Settings
SMTP_SENDER=Metronic
SMTP_FROM=no-reply@domain.com

# Google reCAPTCHA v2
NEXT_PUBLIC_RECAPTCHA_SITE_KEY=6LdHvcQrAAAAANBIIOmFRX0co60rvwD6u3qZbsPR
RECAPTCHA_SECRET_KEY=6LdHvcQrAAAAAEz8HcOxwB5NU74XUqjGVxP8EMik

4. Configuration de la base de données

# Générer le client Prisma
npx prisma generate

# Appliquer les migrations
npx prisma migrate deploy

# (Optionnel) Peupler avec des données de test
npx prisma db seed

5. Lancer l'application

npm run dev
# ou
yarn dev
# ou
pnpm dev

L'application sera accessible sur http://localhost:3000

📜 Scripts Disponibles

Scripts de Développement

# Développement
npm run dev              # Serveur de développement Next.js
npm run build            # Build de production
npm run start            # Serveur de production
npm run build:staging    # Build pour staging

# Qualité de code
npm run lint             # Linting ESLint
npm run format           # Formatage Prettier

# Base de données
npm run prisma:generate  # Générer le client Prisma
npm run prisma:push      # Pousser le schéma vers la DB
npm run prisma:migrate   # Créer une migration
npm run prisma:seed      # Peupler la DB avec des données
npm run prisma:setup     # Configuration initiale

Scripts Prisma

# Générer le client Prisma
npx prisma generate

# Appliquer les migrations
npx prisma migrate dev --name "add_erp_models"

# Pousser le schéma (développement)
npx prisma db push

# Peupler avec des données de test
npx prisma db seed

# Ouvrir Prisma Studio
npx prisma studio

# Vérifier le schéma
npx prisma validate

🚀 Démarrage Rapide

Commandes Essentielles

# 1. Générer le client Prisma
npx prisma generate

# 2. Créer la migration
npx prisma migrate dev --name "add_erp_models"

# 3. Vérifier le schéma
npx prisma db push

# 4. Lancer l'application
npm run dev

Vérification du Schéma

# Vérifier la validité du schéma
npx prisma validate

# Visualiser la base de données
npx prisma studio

🔄 Workflow de Production

Flux de Travail Complet

┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│   PLANIFICATION │───▶│  COMMANDE MP     │───▶│   RÉCEPTION     │
└─────────────────┘    └──────────────────┘    └─────────────────┘
         │                       │                       │
         ▼                       ▼                       ▼
┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│  CRÉATION OF    │◀───│  MOUVEMENT STOCK │◀───│  CRÉATION LOT   │
│                 │    │      ENTRÉE      │    │                 │
└─────────────────┘    └──────────────────┘    └─────────────────┘
         │
         ▼
┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│ CONSOMMATION MP │───▶│  EXÉCUTION OPS   │───▶│  CONTRÔLE QUAL  │
└─────────────────┘    └──────────────────┘    └─────────────────┘
         │                       │                       │
         ▼                       ▼                       ▼
┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│  PRODUCTION PF  │───▶│ MOUVEMENT STOCK  │───▶│  STOCKAGE PF    │
│                 │    │     SORTIE       │    │                 │
└─────────────────┘    └──────────────────┘    └─────────────────┘

🛒 Gestion des Achats & Fournisseurs

📋 MODÈLES PRINCIPAUX

🏢 Fournisseurs (`Supplier`)

model Supplier {
  id          String   @id @default(cuid())
  code        String   @unique
  name        String
  type        String   @default("SUPPLIER") // SUPPLIER, SUBCONTRACTOR
  phone       String?
  email       String?
  website     String?
  currencyId  String?  // Devise préférée
  isActive    Boolean  @default(true)

  // Relations
  rawMaterials      RawMaterial[]
  purchaseOrders    PurchaseOrder[]
  receptionNotes    ReceptionNote[]
  stockMovements    StockMovement[]
  addresses         Address[]
  contacts          Contact[]
  legalIdentifiers  LegalIdentifier[]
}

📦 Commandes d'Achat (`PurchaseOrder`)

model PurchaseOrder {
  id            String   @id @default(cuid())
  number        String   @unique
  supplierId    String
  orderDate     DateTime @default(now())
  expectedDate  DateTime?
  status        String   @default("DRAFT") // DRAFT, CONFIRMED, PARTIALLY_RECEIVED, RECEIVED, CANCELLED
  totalAmount   Float    @default(0)
  currencyId    String?
  notes         String?

  // Relations
  supplier      Supplier
  lines         PurchaseOrderLine[]
  stockMovements StockMovement[]
}

📋 Lignes de Commande (`PurchaseOrderLine`)

model PurchaseOrderLine {
  id                String   @id @default(cuid())
  purchaseOrderId   String
  rawMaterialId     String
  quantity          Float
  unitPrice         Float
  totalPrice        Float
  receivedQuantity  Float    @default(0)
  remainingQuantity Float    // Calculé : quantity - receivedQuantity
  notes             String?
}

📥 GESTION DES RÉCEPTIONS

Bon de Réception (`ReceptionNote`)

model ReceptionNote {
  id            String   @id @default(cuid())
  number        String   @unique
  supplierId    String
  receptionDate DateTime @default(now())
  status        String   @default("DRAFT") // DRAFT, RECEIVED, VALIDATED
  notes         String?

  // Relations
  supplier      Supplier
  files         File[]
}

🚚 GESTION DES LIVRAISONS

Bon de Livraison (`DeliveryNote`)

model DeliveryNote {
  id            String   @id @default(cuid())
  number        String   @unique
  clientId      String
  transporterId String?
  deliveryDate  DateTime
  status        String   @default("DRAFT") // DRAFT, CONFIRMED, SHIPPED, DELIVERED
  notes         String?

  // Relations
  client        Client
  transporter   Transporter?
  files         File[]
}

📊 MOUVEMENTS DE STOCK

Types de Mouvements (`StockMovementType`)

enum StockMovementType {
  // MOUVEMENTS D'ENTRÉE
  IN                    // Entrée générale
  SUPPLIER_RECEIPT      // Réception fournisseur
  RETURN_FROM_SUPPLIER  // Retour fournisseur
  PRODUCTION            // Production (création produit fini)
  ADJUSTMENT_IN         // Ajustement d'inventaire (entrée)

  // MOUVEMENTS DE SORTIE
  OUT                   // Sortie générale
  CUSTOMER_DELIVERY     // Livraison client
  RETURN_TO_SUPPLIER    // Retour fournisseur (défectueux)
  CONSUMPTION           // Consommation (matière première vers production)
  ADJUSTMENT_OUT        // Ajustement d'inventaire (sortie)

  // MOUVEMENTS DE TRANSFERT
  TRANSFER              // Transfert interne
  WAREHOUSE_TRANSFER    // Transfert entre entrepôts
  LOCATION_TRANSFER     // Transfert entre emplacements

  // MOUVEMENTS SPÉCIAUX
  CUSTOMER_RETURN       // Retour client
  DAMAGED               // Produit endommagé
  EXPIRED               // Produit expiré
  LOST                  // Produit perdu
  STOLEN                // Produit volé
  QUALITY_REJECT        // Rejet qualité
  SCRAP                 // Mise au rebut
}

🔄 FLUX DE TRAVAIL COMPLET

1. PROCESSUS D'ACHAT

1. Création Commande d'Achat (PurchaseOrder)
   ↓
2. Confirmation avec Fournisseur
   ↓
3. Réception Marchandise (ReceptionNote)
   ↓
4. Validation Qualité
   ↓
5. Mise en Stock (StockMovement: SUPPLIER_RECEIPT)
   ↓
6. Facturation Fournisseur

2. PROCESSUS DE LIVRAISON

1. Commande Client (SalesOrder)
   ↓
2. Préparation Commande
   ↓
3. Création Bon de Livraison (DeliveryNote)
   ↓
4. Expédition (StockMovement: CUSTOMER_DELIVERY)
   ↓
5. Livraison Client
   ↓
6. Facturation Client

3. GESTION DES RETOURS

RETOUR CLIENT:
- StockMovement: CUSTOMER_RETURN
- Réintégration en stock

RETOUR FOURNISSEUR:
- StockMovement: RETURN_TO_SUPPLIER
- Sortie de stock
- Crédit fournisseur

📁 STRUCTURE DES FICHIERS

Pages UI Existantes :

✅ app/(protected)/stock/movements/page.tsx - Mouvements de stock
✅ app/(protected)/stock/lots/page.tsx - Gestion des lots
✅ app/(protected)/stock/locations/page.tsx - Emplacements
❌ app/(protected)/purchases/orders/page.tsx - VIDE (à implémenter)

Pages Manquantes à Créer :

app/(protected)/purchases/suppliers/page.tsx - Gestion fournisseurs
app/(protected)/purchases/receptions/page.tsx - Réceptions
app/(protected)/sales/deliveries/page.tsx - Livraisons
app/(protected)/purchases/returns/page.tsx - Retours fournisseurs
app/(protected)/sales/returns/page.tsx - Retours clients

🎯 RECOMMANDATIONS

Implémenter les pages manquantes pour une gestion complète
Créer les APIs pour PurchaseOrder, ReceptionNote, DeliveryNote
Ajouter les hooks React Query pour chaque entité
Implémenter les workflows de validation et d'approbation
Ajouter la traçabilité complète avec les mouvements de stock

Le système est très complet au niveau du schéma mais nécessite l'implémentation des interfaces utilisateur ! 🚀

Étapes Détaillées

Phase 1 : Planification et Approvisionnement

Analyse des besoins : Calcul des matières premières nécessaires
Création commande : Génération de commande fournisseur
Suivi livraison : Monitoring des délais
Réception : Contrôle et enregistrement des lots
Mouvement stock : Transfert vers zone de stockage

Phase 2 : Lancement Production

Création OF : Génération de l'ordre de fabrication
Réservation composants : Blocage des matières nécessaires
Planification opérations : Ordonnancement des étapes
Assignation ressources : Opérateurs et équipements

Phase 3 : Exécution

Consommation MP : Préparation des composants
Exécution opérations : Fabrication étape par étape
Contrôles qualité : Vérifications aux points critiques
Gestion incidents : Résolution des problèmes qualité

Phase 4 : Finalisation

Production PF : Création du produit fini
Mouvement stock : Transfert vers stock produits finis
Étiquetage : Génération des étiquettes
Clôture OF : Finalisation de l'ordre

📁 Structure du Projet

ETASCOM_CRM_V3_NEXT_JS/
├── app/                       # Next.js App Router
│   ├── (auth)/               # Pages d'authentification
│   ├── (protected)/          # Pages protégées
│   └── api/                  # API Routes
├── components/               # Composants réutilisables
│   ├── ui/                  # Composants UI de base
│   ├── common/              # Composants communs
│   └── keenicons/           # Icônes
├── prisma/                  # Schéma et migrations
│   ├── schema.prisma        # ✅ Schéma ERP complet (30+ modèles)
│   ├── data/               # Données de seed
│   └── migrations/         # Migrations DB
├── lib/                    # Utilitaires
├── providers/              # Context providers
├── hooks/                  # Hooks React
├── i18n/                   # Internationalisation
└── public/                 # Assets statiques

🗄️ Structure de la Base de Données

Modèles Principaux (40+ modèles)

🏭 RÉFÉRENTIELS DE BASE
├── Company (multi-tenant)
├── RawMaterial (complet avec prix/taxes)
├── FinishedProduct (complet avec prix/taxes)
├── Equipment
├── Client, Supplier, Transporter (avec adresses)
└── Lead (prospects)

🏷️ CATÉGORIES & CLASSIFICATIONS
├── RawMaterialCategory (hiérarchique)
├── FinishedProductCategory (hiérarchique)
└── Tax (TVA, taxes de vente)

📍 ADRESSES & CONTACTS
├── Address (polymorphe)
├── Contact (polymorphe)
└── LegalIdentifier (ICE, RC, SIRET, DUNS)

📦 STOCK & LOGISTIQUE
├── Warehouse, StockLocation
├── StockMovement, StockLot, StockLabel
└── DeliveryNote, ReceptionNote

🏗️ PRODUCTION & FABRICATION
├── WorkCenter (postes de travail)
├── BillOfMaterial (nomenclature enrichie)
├── Routing, Operation (gammes de fabrication)
├── WorkOrder, WorkOrderStep (ordres de fabrication)
└── Equipment (machines et outillages)

💼 COMMERCIAL
├── SalesOffer, SalesOfferLine (Kanban)
├── SalesOrder, SalesOrderLine
└── Invoice

🏷️ SYSTÈME D'ÉTIQUETTES
├── ProductLabel (étiquettes complètes)
├── LabelType (RAW_MATERIAL, FINISHED_PRODUCT, etc.)
└── LabelStatus (DRAFT, PRINTED, APPLIED, etc.)

💬 COMMUNICATION INTERNE
├── Post, PostComment, PostLike (actualités)
├── FAQ, HelpDocument (documentation)
├── PasswordVault (mots de passe)
├── Request, RequestComment (demandes)
└── RequestType, RequestStatus (workflow)

💱 SYSTÈME DE DEVISES
├── Currency (devises internationales)
└── CurrencyExchangeRate (taux de change historiques)

📁 FICHIERS
└── File (polymorphe avec S3)

🔌 API

Endpoints Principaux

Module Achats & Fournisseurs

# Fournisseurs
GET    /api/suppliers                # Liste des fournisseurs
POST   /api/suppliers                # Créer un fournisseur
PUT    /api/suppliers/[id]           # Modifier un fournisseur
DELETE /api/suppliers/[id]           # Supprimer un fournisseur

# Commandes d'achat
GET    /api/purchase-orders          # Liste des bons de commande
POST   /api/purchase-orders          # Créer un bon de commande
PUT    /api/purchase-orders/[id]     # Modifier un bon de commande
DELETE /api/purchase-orders/[id]     # Supprimer un bon de commande

# Réceptions
GET    /api/reception-notes          # Liste des réceptions
POST   /api/reception-notes          # Créer une réception
PUT    /api/reception-notes/[id]     # Modifier une réception
DELETE /api/reception-notes/[id]     # Supprimer une réception

# Livraisons
GET    /api/delivery-notes           # Liste des livraisons
POST   /api/delivery-notes           # Créer une livraison
PUT    /api/delivery-notes/[id]      # Modifier une livraison
DELETE /api/delivery-notes/[id]      # Supprimer une livraison

Module Commercial

# Offres commerciales
GET    /api/sales-offers             # Liste des offres
POST   /api/sales-offers             # Créer une offre
PUT    /api/sales-offers/[id]        # Modifier une offre
PUT    /api/sales-offers/[id]/status # Changer le statut (Kanban)

# Commandes clients
GET    /api/sales-orders             # Liste des commandes
POST   /api/sales-orders             # Créer une commande
PUT    /api/sales-orders/[id]        # Modifier une commande

# Clients et leads
GET    /api/clients                  # Liste des clients
POST   /api/clients                  # Créer un client
GET    /api/leads                    # Liste des leads
POST   /api/leads                    # Créer un lead
PUT    /api/leads/[id]/convert       # Convertir lead en client

Module Stock & Logistique

# Mouvements de stock
GET    /api/stock-movements          # Mouvements de stock
POST   /api/stock-movements          # Créer un mouvement
PUT    /api/stock-movements/[id]     # Modifier un mouvement
DELETE /api/stock-movements/[id]     # Supprimer un mouvement

# Niveaux de stock
GET    /api/stock-levels             # Niveaux de stock
GET    /api/stock-lots               # Gestion des lots
POST   /api/stock-lots               # Créer un lot
PUT    /api/stock-lots/[id]          # Modifier un lot

# Entrepôts et emplacements
GET    /api/warehouses               # Liste des entrepôts
POST   /api/warehouses               # Créer un entrepôt
GET    /api/stock-locations          # Emplacements de stock
POST   /api/stock-locations          # Créer un emplacement

Module Production

GET    /api/manufacturing-orders     # Ordres de fabrication
POST   /api/manufacturing-orders     # Créer un OF
PUT    /api/manufacturing-orders/[id] # Modifier un OF

Module Référentiels

# Matières premières et produits
GET    /api/raw-materials            # Liste des matières premières
POST   /api/raw-materials            # Créer une matière première
GET    /api/finished-products        # Liste des produits finis
POST   /api/finished-products        # Créer un produit fini

# Catégories
GET    /api/raw-material-categories  # Catégories matières premières
GET    /api/finished-product-categories # Catégories produits finis

# Taxes
GET    /api/taxes                    # Liste des taxes
POST   /api/taxes                    # Créer une taxe

# Adresses et contacts
GET    /api/addresses                # Adresses d'une entité
POST   /api/addresses                # Créer une adresse
GET    /api/contacts                 # Contacts d'une entité
POST   /api/contacts                 # Créer un contact

# Système d'étiquettes
GET    /api/product-labels           # Liste des étiquettes
POST   /api/product-labels           # Créer une étiquette
PUT    /api/product-labels/[id]      # Modifier une étiquette
PUT    /api/product-labels/[id]/status # Changer le statut
GET    /api/product-labels/[id]/print # Générer pour impression

# Communication interne
GET    /api/posts                    # Actualités et posts
POST   /api/posts                    # Créer un post
GET    /api/faq                      # Questions fréquentes
POST   /api/faq                      # Créer une FAQ
GET    /api/help-documents           # Documentation d'aide
POST   /api/help-documents           # Créer un document

# Système de demandes
GET    /api/requests                 # Liste des demandes
POST   /api/requests                 # Créer une demande
PUT    /api/requests/[id]            # Modifier une demande
PUT    /api/requests/[id]/status     # Changer le statut
GET    /api/requests/[id]/comments   # Commentaires d'une demande

# Gestion des mots de passe
GET    /api/password-vault           # Mots de passe (utilisateur)
POST   /api/password-vault           # Ajouter un mot de passe
PUT    /api/password-vault/[id]      # Modifier un mot de passe
DELETE /api/password-vault/[id]      # Supprimer un mot de passe

# Système de devises
GET    /api/currencies               # Liste des devises
POST   /api/currencies               # Créer une devise
GET    /api/exchange-rates           # Taux de change
POST   /api/exchange-rates           # Ajouter un taux de change
GET    /api/exchange-rates/convert   # Convertir un montant

# Production & Fabrication
GET    /api/equipments               # Liste des équipements
POST   /api/equipments               # Créer un équipement
GET    /api/work-centers             # Liste des postes de travail
POST   /api/work-centers             # Créer un poste de travail
GET    /api/bill-of-materials        # Nomenclatures enrichies
POST   /api/bill-of-materials        # Créer une nomenclature
GET    /api/routings                 # Gammes de fabrication
POST   /api/routings                 # Créer une gamme
GET    /api/operations               # Opérations de production
POST   /api/operations               # Créer une opération
GET    /api/work-orders              # Ordres de fabrication
POST   /api/work-orders              # Créer un ordre de fabrication
PUT    /api/work-orders/[id]/status  # Changer le statut d'un OF
GET    /api/work-order-steps         # Étapes d'un OF
PUT    /api/work-order-steps/[id]    # Mettre à jour une étape

Exemples d'utilisation

Créer une matière première complète

const response = await fetch('/api/raw-materials', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    code: 'MP001',
    name: 'Mousse PE réticulée 30kg/m³',
    categoryId: 'cat-foam-pe',
    productType: 'STOCKABLE',
    billingPolicy: 'ORDERED',
    unitOfMeasure: 'm²',
    unitOfPurchase: 'm²',
    unitOfStock: 'm²',
    sellingPrice: 45.5,
    cost: 23.58,
    costPerUnit: 'par m²',
    salesTaxId: 'tax-tva20',
    internalReference: 'PA00003',
    barcode: '1234567890123',
    supplierCode: 'SUP-MP001',
    density: 30,
    thickness: 10,
    width: 1000,
    length: 2000,
    color: 'Blanc',
    internalNotes: 'Mousse de protection automobile',
    tags: 'automobile,protection,pe',
    supplierId: 'supplier-id',
    minStockLevel: 100,
    maxStockLevel: 500,
    reorderPoint: 150,
  }),
});

Créer une offre commerciale

const response = await fetch('/api/sales-offers', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    number: 'OFF-2025-001',
    clientId: 'client-id',
    projectName: 'Protection pare-chocs BMW',
    internalDesignation: 'PROJ-BMW-2025',
    annualVolume: 10000,
    annualAmount: 455000,
    currency: 'MAD',
    validityDate: '2025-12-31',
    priority: 1,
    status: 'DRAFT',
    protoTotalPrice: 5000,
    seriesUnitPrice: '45.50',
    firstOrderLeadTime: 15,
    incoterms: 'FOB',
    destinationCountry: 'Maroc',
    lines: [
      {
        finishedProductId: 'product-id',
        description: 'Mousse protection pare-chocs',
        quantity: 1000,
        unitPrice: 45.5,
        totalPrice: 45500,
      },
    ],
  }),
});

Créer une étiquette produit

const response = await fetch('/api/product-labels', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    labelType: 'FINISHED_PRODUCT',
    productName: 'Protection Pare-chocs BMW',
    productCode: 'PROT-BMW-001',
    quantity: 100,
    unit: 'PCS',
    warehouseId: 'warehouse-id',
    locationId: 'location-id',
    clientId: 'client-id',
    clientName: 'YAZAKI',
    lotNumber: 'LOT-2025-001',
    productionDate: '2025-01-15',
    shippingDate: '2025-01-20',
    destinationCountry: 'France',
    destinationCity: 'Paris',
  }),
});

Créer une demande d'achat

const response = await fetch('/api/requests', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    type: 'PURCHASE',
    title: 'Achat PC portable pour développement',
    description:
      "Besoin d'un PC portable pour le développement de l'application",
    priority: 'NORMAL',
    amount: 15000,
    currencyId: 'currency-mad-id',
    approverId: 'manager-id',
  }),
});

Convertir un montant entre devises

const response = await fetch('/api/exchange-rates/convert', {
  method: 'GET',
  headers: {
    'Content-Type': 'application/json',
  },
  params: new URLSearchParams({
    amount: '1000',
    fromCurrencyId: 'currency-eur-id',
    toCurrencyId: 'currency-mad-id',
    date: '2025-01-15',
  }),
});

const result = await response.json();
// { convertedAmount: 10500, rate: 10.5, source: "Manual" }

Créer une devise

const response = await fetch('/api/currencies', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    code: 'MAD',
    name: 'Dirham Marocain',
    symbol: 'د.م.',
    decimalPlaces: 2,
    position: 'AFTER',
    isDefault: true,
  }),
});

Créer un poste de travail

const response = await fetch('/api/work-centers', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    code: 'LAMINEUSE_1',
    name: 'Lamineuse principale',
    description: 'Lamineuse automatique pour mousse PE',
    capacity: 1200.0, // unités/heure
    costPerHour: 45.5, // coût horaire du poste
    equipmentId: 'equipment-lamineuse-id', // Lien vers l'équipement (optionnel)
  }),
});

Créer un équipement

const response = await fetch('/api/equipments', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    code: 'LAMINEUSE_001',
    name: 'Lamineuse automatique PE',
    type: 'Machine de production',
    description: 'Lamineuse pour mousse PE réticulée',
    brand: 'ETASCOM',
    model: 'LAM-PE-2024',
    serialNumber: 'SN-LAM-001',
    location: 'Atelier Production A',
  }),
});

Créer une nomenclature enrichie

const response = await fetch('/api/bill-of-materials', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    finishedProductId: 'product-id',
    rawMaterialId: 'material-id',
    quantity: 0.202,
    unit: 'm²',
    operationSequence: 10,
    efficiency: 1.0,
    unitCost: 1.23,
    coefficient: 1.1,
    isConsumable: true,
    scrapRate: 2.5,
  }),
});

Créer une opération de production

const response = await fetch('/api/operations', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    routingId: 'routing-id',
    workCenterId: 'workcenter-id',
    sequence: 1,
    name: 'LAMINATION',
    instructions: "Régler la température à 180°C, vérifier l'épaisseur",
    durationType: 'CADENCE',
    ratePerHour: 1200.0,
    qualityChecks: "Mesurer l'épaisseur, vérifier la couleur",
    requiredTools: 'Règle de mesure, thermomètre',
    safetyNotes: 'Porter des gants de protection',
  }),
});

🗄️ Base de Données

Modèles Principaux

🏭 Référentiels de Base

Company - Gestion multi-tenant avec adresses et contacts
RawMaterial - Matières premières complètes (prix, taxes, codes, notes)
FinishedProduct - Produits finis avec gestion avancée
Equipment - Machines et outillages
Client, Supplier, Transporter - Entités avec adresses multiples
Lead - Prospects avec conversion vers clients

🏷️ Catégories et Classifications

RawMaterialCategory - Catégories hiérarchiques matières premières
FinishedProductCategory - Catégories hiérarchiques produits finis
Tax - Gestion des taxes (TVA, taxes de vente, etc.)

📍 Adresses et Contacts

Address - Adresses multiples par entité (facturation, livraison)
Contact - Contacts multiples avec postes et coordonnées
LegalIdentifier - Identifiants légaux (ICE, RC, SIRET, DUNS, etc.)

📦 Stock & Logistique

Warehouse - Entrepôts
StockLocation - Emplacements détaillés (zone, allée, rayonnage)
StockMovement - Mouvements traçables (IN, OUT, TRANSFER, etc.)
StockLot - Gestion des lots avec dates d'expiration
StockLabel - Étiquettes et codes-barres
DeliveryNote / ReceptionNote - Bons de livraison et réception
PurchaseOrder / PurchaseOrderLine - Commandes d'achat
Supplier - Fournisseurs avec adresses et contacts
Transporter - Transporteurs pour les livraisons

🏗️ Production & Fabrication

WorkCenter - Postes de travail avec capacités et coûts (liés aux équipements)
Equipment - Machines et outillages de production (liés aux postes de travail)
BillOfMaterial - Nomenclatures enrichies (coûts, efficacité, opérations)
Routing - Gammes de fabrication avec séquences
Operation - Opérations détaillées (consignes, cadences, qualité)
WorkOrder - Ordres de fabrication avec planification
WorkOrderStep - Suivi opérateur et performance en temps réel

💼 Gestion Commerciale

SalesOffer / SalesOfferLine - Offres commerciales avec statuts Kanban
SalesOrder / SalesOrderLine - Commandes clients
Invoice - Facturation complète

🏷️ Système d'Étiquettes

ProductLabel - Étiquettes complètes avec informations produit, stockage, fournisseur/client
LabelType - Types d'étiquettes (RAW_MATERIAL, FINISHED_PRODUCT, SHIPPING, etc.)
LabelStatus - Statuts des étiquettes (DRAFT, PRINTED, APPLIED, etc.)

💬 Communication Interne

Post - Actualités et posts d'entreprise avec likes et commentaires
PostComment - Commentaires hiérarchiques sur les posts
PostLike - Système de likes pour les posts
FAQ - Questions fréquentes organisées par catégories
HelpDocument - Documentation d'aide avec sections
PasswordVault - Gestion sécurisée des mots de passe
Request - Système de demandes avec workflow d'approbation
RequestComment - Commentaires sur les demandes (internes/externes)

💱 Système de Devises

Currency - Devises internationales avec formats et symboles
CurrencyExchangeRate - Taux de change historiques avec sources

📁 Gestion des Fichiers

File - Modèle central pour S3 avec relations polymorphes

Relations Clés

RawMaterial ↔ StockLot (1:N)
FinishedProduct ↔ WorkOrder (1:N)
WorkOrder ↔ WorkOrderStep (1:N)
PurchaseOrder ↔ PurchaseOrderLine (1:N)
SalesOrder ↔ SalesOrderLine (1:N)
SalesOffer ↔ SalesOfferLine (1:N)
RawMaterialCategory ↔ RawMaterial (1:N) hiérarchique
FinishedProductCategory ↔ FinishedProduct (1:N) hiérarchique
Tax ↔ RawMaterial/FinishedProduct/SalesLines (1:N)
Address/Contact/LegalIdentifier ↔ Toutes entités (1:N) polymorphes
ProductLabel ↔ Warehouse/StockLocation/Supplier/Client (1:N)
Post ↔ PostComment/PostLike (1:N)
Request ↔ RequestComment (1:N)
Currency ↔ Client/Supplier/Transporter/SalesOffer/SalesOrder/Invoice/Request (1:N)
CurrencyExchangeRate ↔ Currency (1:N) avec contrainte unique
Toutes les entités ↔ File (1:N) avec suppression cascade

✅ État Actuel du Projet

Terminé

[x] Schéma Prisma complet - 40+ modèles ERP industriels
[x] Architecture modulaire - Modules séparés par fonctionnalité
[x] Relations et contraintes - Base de données optimisée
[x] Support multi-tenant - Gestion des entreprises
[x] Gestion des fichiers S3 - Upload et suppression automatique
[x] Traçabilité ISO/IATF - Lots, mouvements, opérateurs
[x] Système de catégories hiérarchiques - Organisation des produits
[x] Gestion des taxes - TVA et taxes personnalisables
[x] Adresses et contacts multiples - Structure professionnelle
[x] Identifiants légaux internationaux - ICE, RC, SIRET, DUNS
[x] Module offres commerciales - Workflow Kanban complet
[x] Gestion des leads - Conversion prospects vers clients
[x] Système d'étiquettes complet - Codes-barres, QR codes, traçabilité
[x] Communication interne - Actualités, FAQ, documentation, demandes
[x] Gestion des mots de passe - Coffre-fort sécurisé
[x] Système de rôles métier - 25+ rôles spécialisés
[x] Données de seed complètes - Super admin, entités, catégories, taxes
[x] Système de devises complet - Devises internationales et taux de change
[x] Système de production industriel - Postes de travail, nomenclatures enrichies, gammes de fabrication
[x] Traçabilité opérateur - Suivi de performance et contrôles qualité
[x] Documentation complète - README détaillé

En Cours

[ ] API Endpoints - Développement des routes API
[ ] Interfaces utilisateur - Composants React
[ ] Workflows métier - Logique de production

Prochaines Étapes

[ ] Migrations DB - Application du schéma
[ ] Tests unitaires - Validation des fonctionnalités
[ ] Déploiement - Mise en production

🚀 Déploiement

Déploiement sur Vercel

Connecter le repository à Vercel
Configurer les variables d'environnement
Déployer automatiquement

# Variables d'environnement requises
DATABASE_URL=postgresql://...
NEXTAUTH_SECRET=your-secret
NEXTAUTH_URL=https://your-domain.vercel.app

Déploiement avec Docker

# Dockerfile
FROM node:18-alpine
WORKDIR /app
COPY package*.json ./
RUN npm ci --only=production
COPY . .
RUN npm run build
EXPOSE 3000
CMD ["npm", "start"]

Scripts de Déploiement

# Build de production
npm run build

# Démarrage en production
npm start

# Linting
npm run lint

# Tests
npm run test

🤝 Contribution

Guidelines

Fork le projet
Créer une branche pour votre fonctionnalité (git checkout -b feature/AmazingFeature)
Commit vos changements (git commit -m 'Add some AmazingFeature')
Push vers la branche (git push origin feature/AmazingFeature)
Ouvrir une Pull Request

Standards de Code

TypeScript strict activé
ESLint et Prettier configurés
Conventional Commits pour les messages
Tests requis pour les nouvelles fonctionnalités

Structure des Commits

feat: ajouter gestion des étiquettes OF
fix: corriger calcul des coûts de production
docs: mettre à jour la documentation API
style: améliorer l'interface des tableaux
refactor: optimiser les requêtes Prisma
test: ajouter tests pour le module stock

📞 Support

Documentation

Guide utilisateur : Documentation complète
API Reference : Documentation API
Workflow Production : Guide workflow

Contact

Email : support@etasmcom.com
Issues : GitHub Issues
Discussions : GitHub Discussions

Roadmap

[ ] Module Maintenance : Gestion préventive et corrective
[ ] Module Qualité : Système de gestion qualité avancé
[ ] Mobile App : Application mobile pour les opérateurs
[ ] BI Dashboard : Tableaux de bord business intelligence
[ ] IoT Integration : Intégration capteurs et équipements

📄 Licence

Développé avec ❤️ pour ETASCOM

ETASCOM CRM V3 - Documentation API

🏭 CRM ETASCOM V3 - Système de Gestion Industrielle

📋 Table des Matières

🎯 Vue d'ensemble

🎨 Interface Utilisateur

✨ Fonctionnalités

🏭 Gestion Industrielle Complète

📦 Gestion des Matières Premières

🛒 Module Achats & Fournisseurs

📊 Gestion du Stock & Logistique

🏗️ Production & Fabrication

👥 Ressources Humaines

💼 Commercial

🏷️ Système d'Étiquettes Complet

💬 Communication Interne

💱 Système de Devises Complet

🔧 Fonctionnalités Techniques

Authentification & Sécurité

Interface Utilisateur

Gestion des Données

Visualisation & Graphiques

Communication & Notifications

Internationalisation

Fonctionnalités Métier

Stockage & Fichiers

🏗️ Architecture

Stack Technologique

Outils de Développement

Architecture des Modules

🚀 Installation

Prérequis

1. Cloner le projet

2. Installer les dépendances

3. Configuration de l'environnement

4. Configuration de la base de données

5. Lancer l'application

📜 Scripts Disponibles

Scripts de Développement

Scripts Prisma

🚀 Démarrage Rapide

Commandes Essentielles

Vérification du Schéma

🔄 Workflow de Production

Flux de Travail Complet

🛒 Gestion des Achats & Fournisseurs

📋 MODÈLES PRINCIPAUX

🏢 Fournisseurs (Supplier)

📦 Commandes d'Achat (PurchaseOrder)

📋 Lignes de Commande (PurchaseOrderLine)

📥 GESTION DES RÉCEPTIONS

Bon de Réception (ReceptionNote)

🚚 GESTION DES LIVRAISONS

Bon de Livraison (DeliveryNote)

📊 MOUVEMENTS DE STOCK

Types de Mouvements (StockMovementType)

🔄 FLUX DE TRAVAIL COMPLET

1. PROCESSUS D'ACHAT

2. PROCESSUS DE LIVRAISON

3. GESTION DES RETOURS

📁 STRUCTURE DES FICHIERS

Pages UI Existantes :

Pages Manquantes à Créer :

🎯 RECOMMANDATIONS

Étapes Détaillées

Phase 1 : Planification et Approvisionnement

Phase 2 : Lancement Production

Phase 3 : Exécution

Phase 4 : Finalisation

📁 Structure du Projet

🗄️ Structure de la Base de Données

Modèles Principaux (40+ modèles)

🔌 API

Endpoints Principaux

Module Achats & Fournisseurs

Module Commercial

Module Stock & Logistique

Module Production

Module Référentiels

Exemples d'utilisation

Créer une matière première complète

🏢 Fournisseurs (`Supplier`)

📦 Commandes d'Achat (`PurchaseOrder`)

📋 Lignes de Commande (`PurchaseOrderLine`)

Bon de Réception (`ReceptionNote`)

Bon de Livraison (`DeliveryNote`)

Types de Mouvements (`StockMovementType`)