Metadata-Version: 2.4
Name: erica-erp
Version: 1.0.2
Summary: Enterprise Resource Integrated Communication App
Author: Yannick Magayane, Full-Stack Developper Django and Vue.js
Classifier: Programming Language :: Python :: 3
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
Requires-Python: >=3.13
Description-Content-Type: text/markdown
Requires-Dist: Django<5.1,>=5.0
Requires-Dist: django-allauth>=65.12.0
Requires-Dist: django-htmx>=1.26.0
Requires-Dist: django-environ>=0.12.0
Requires-Dist: django-cotton>=2.6.1
Requires-Dist: psycopg2-binary>=2.9.11
Requires-Dist: cloudinary>=1.44.1
Requires-Dist: django-cloudinary-storage>=0.3.0
Requires-Dist: requests>=2.32.5
Requires-Dist: pandas>=2.3.3
Requires-Dist: openpyxl>=3.1.5
Requires-Dist: pyotp>=2.9.0
Requires-Dist: qrcode>=8.2
Requires-Dist: gunicorn>=23.0.0
Requires-Dist: matplotlib>=3.10.0

# 🌟 ERICA ERP - Enterprise Resource Integrated Communication App

**Author**: Yannick Magayane
**License**: Proprietary / Enterprise SaaS
**Version**: 1.0.0

ERICA is a professional-grade, multi-tenant SaaS ERP platform designed for seamless business management. It integrates HR, Project Management, Finance, Inventory, and Unified Communication into one unified, installable software package.

---

## 🚀 Presentation

ERICA shifts the paradigm of ERP distribution. It is not just code; it is a **Python Package** that can be installed on any server in seconds.

### ✨ Key Features
*   **Security First**: Source code is **compiled to binary (Cython)** before distribution to protect Intellectual Property.
*   **Multi-tenancy**: High-isolation with dedicated database schemas.
*   **Package Distribution**: Installable via `pip install erica-erp`.
*   **Dynamic UI**: Role-based access control (`WorkPosition`) that dynamically filters the navigation and dashboard.
*   **Smart HR & QR Attendance**: Modern HR flow with real-time tracking.
*   **Unified Communication**: Discussion threads attached to every business object.
*   **Payroll AST Engine**: Powerful and secure formula builder for complex payroll.
*   **Command Center**: Global search and action console (`Ctrl+K`).

---

## 🛠 Tech Stack
*   **Core**: Python 3.13+, Django 5.0 LTS
*   **Frontend**: HTMX, Alpine.js, TailwindCSS (Professional UI/UX)
*   **Package Manager**: Setuptools (pyproject.toml)
*   **Ops**: Docker, Docker Compose, Traefik, Nginx

---

## 🚦 Getting Started

### 1. Developer / Docker Mode (Recommended)
The easiest way to run the full stack (App + DB + Proxy):

```bash
# Start the full stack
./bin/start

# Access: http://localhost:8000
```

### 2. Distribution / Package Mode
Install ERICA as a system library. See the [**Distribution Guide**](docs/DISTRIBUTION.md) for detailed instructions.

```bash
# Quick local link
pip install -e .
```

---

## 📦 Maintenance Tools
*   `./bin/start`: Launches the Docker environment.
*   `./bin/release`: Builds the `.whl` distribution package.
*   `./bin/backup`: Triggers a secure database dump.

---

## 🇫🇷 Version Française

ERICA est un ERP SaaS professionnel, conçu pour une gestion d'entreprise fluide et intégrée.

### 🚀 Points Forts
*   **Distribution Pip**: Installable comme un vrai logiciel (`pip install`).
*   **Interface Dynamique**: Menu et widgets pilotés par le modèle `WorkPosition`.
*   **Sécurité Totale**: Isolation stricte des données par client (Multi-tenant).

### 🚦 Lancement Rapide
1. **Docker**: `./bin/start` (Accès sur port 8000).
2. **CLI**: Utilisez `erica-admin` pour toutes les tâches d'administration.

---
© 2025 ERICA ERP - Yannick Magayane.
