takiabdou/crma-erp

Full-stack multi-tenant ERP for Algeria's CRMA agricultural insurance network. Django REST API + PostgreSQL + Docker. Modules: Procurement, Inventory, Fleet/Assets & HR/Payroll. JWT auth, role-based access control, strict per-caisse data isolation. Compliant with Algerian public procurement law. # 🏦 CRMA ERP Enterprise Resource Planning (ERP) system for **Caisse Régionale Mutuelle Agricole (CRMA)**. > **Latest version : v1.0.1** --- ## 📋 Project Overview This is a full-featured ERP built with **Django** and **PostgreSQL**, designed for the integrated management of a regional agricultural mutual insurance branch. ### ✅ Features (Phases 0 to 4) | Module | Status | Description | | ---------------- | -------------- | ---------------------------------------------------------------------------------- | | **Core** | ✅ Completed | User management, roles, regional branches and local offices | | **Purchasing** | ✅ Completed | Purchase requests, suppliers, purchase orders and market thresholds | | **Inventory** | ✅ Completed | Article management, stock entries/exits, movement history and alerts | | **SMG (Fleet)** | ✅ Completed | Vehicle fleet management, mission orders, fuel tracking, insurance and maintenance | | **HR & Payroll** | 🚧 In progress | Employee management, leave requests and payslips (Phase 5) | --- ## 🚀 Quick Installation ```bash # Clone the repository git clone github.com cd crma-erp # Create and activate the virtual environment python -m venv venv source venv/bin/activate # or .\venv\Scripts\activate on Windows # Install dependencies pip install -r requirements.txt # Start Docker containers (PostgreSQL + Redis) docker compose up -d # Apply migrations python manage.py migrate # Load test data python manage.py seed python manage.py seed_achats python manage.py seed_stock python manage.py seed_smg # Run the development server python manage.py runserver ```