erica-erp 1.0.2

Enterprise Resource Integrated Communication App

🌟 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):

# Start the full stack
./bin/start

# Access: http://localhost:8000

2. Distribution / Package Mode

Install ERICA as a system library. See the Distribution Guide for detailed instructions.

# 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.