Metadata-Version: 2.4
Name: erica-erp
Version: 1.0.6
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
Requires-Dist: python-dotenv>=1.0.1

# ERICA ERP - Enterprise Resource Integrated Communication App

<div align="center">
  <img src="https://raw.githubusercontent.com/YannickMagayane/EricaSaas/main/static/img/logo.png" alt="ERICA Logo" width="120">
  <h3>Modern, Scalable & Secure Enterprise Ecosystem</h3>
  <p><i>Empowering organizations through unified business logic and intelligent communication.</i></p>

  [![PyPI version](https://img.shields.io/pypi/v/erica-erp.svg)](https://pypi.org/project/erica-erp/)
  [![Python version](https://img.shields.io/pypi/pyversions/erica-erp.svg)](https://pypi.org/project/erica-erp/)
  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
</div>

---

## � Overview

**ERICA ERP** is a comprehensive Enterprise Resource Planning solution engineered with **Python 3.13+** and **Django**. It provides a robust, multi-tenant architecture designed to scale with your business, offering seamless integration between human resources, financial tracking, and real-time collaboration.

## 🚀 Key Modules & Capabilities

### 🏢 Core Architecture & Multi-Tenancy
- **Advanced Tenancy**: Native support for multiple legal entities with complete data isolation and schema-level routing.
- **Dynamic UI Engine**: Role-based interface customization powered by **WorkPosition** logic.
- **Security First**: Integrated 2FA (TOTP), session auditing, and granular permission sets.

### 👥 Human Capital Management (HR)
- **Employee Lifecycle**: From recruitment to offboarding, manage contracts, roles, and hierarchies.
- **Interactive Attendance**: Real-time clock-in/out systems with interactive timelines and leave calendars.
- **Performance & Growth**: Managed evaluations and academic/professional training tracking.

### 💰 Financial Suite
- **Smart Accounting**: Double-entry bookkeeping system with dynamic transaction routing.
- **Automated Billing**: Professional invoicing engine with payment status tracking and tax integration.
- **Live Dashboards**: Real-time financial insights and KPI monitoring.

### � Project & Operations
- **Strategic Execution**: Plan projects with milestones, tasks, and high-fidelity **Gantt charts**.
- **Efficiency Tracking**: Timesheets and expense reporting linked directly to project budget lines.
- **Collaboration**: Unified messaging and internal mail routing for team synchronization.

### 📦 Logistics & Inventory
- **Warehouse Management**: Track stock levels across multiple locations with automated movement logs.
- **Supplier Ecosystem**: Manage procurement workflows and supplier relationships.

---

## 🗺️ Roadmap (Upcoming Features)

- 🤖 **AI-Driven Analytics**: Predictive financial modeling and automated inventory optimization.
- 📱 **Native Mobile Presence**: High-performance React Native app for full on-the-go management.
- 🔌 **Logistics Connectors**: Direct API integrations with global shipping and banking providers.

---

## 👨‍💻 About the Author

**Yannick Magayane**
*High-Performance Full-Stack Developer | Academic Mentor*

> "Building the future of enterprise management through clean code and scalable architecture."

Expertise in building complex Django ecosystems, Vue.js interfaces, and secure Python distributions. Proudly serving as an academic mentor to the next generation of software engineers.

<div align="left">
  <a href="https://github.com/YannickMagayane">
    <img src="https://img.shields.io/badge/GitHub-YannickMagayane-black?style=for-the-badge&logo=github" alt="GitHub">
  </a>
</div>

---

## �️ Seamless Installation

Deploying your ERICA ERP instance takes only moments:

### 1. Install via Pip
```bash
pip install erica-erp
```

### 2. Initialize Database
Setup your schemas and migrations automatically:
```bash
erica-admin migrate
```

### 3. Launch the Server
Start your local development or production-ready instance:
```bash
erica-admin runserver
```

---
*ERICA ERP is distributed under the MIT License. Developed with passion by Yannick Magayane.*
