- Backend: FastAPI app with all models, services, schemas, routes - Admin Panel: Next.js dashboard with all modules (CRM, POS, repairs, warranties, billing, notifications, etc.) - Ecommerce: storefront (submodule) + product catalog - AI Agents: .agents/ skill library for Antigravity IDE - Docs: architecture, billing, notification gateway markdown - Submodules: Backend/OpenWA, Ecommerce/File 2/storefront
30 lines
1.7 KiB
Markdown
30 lines
1.7 KiB
Markdown
# Current State Architecture & System Assessment
|
|
|
|
## Existing Stack Audit
|
|
|
|
### 1. Frontend
|
|
* **Storefront E-Commerce**: Next.js App Router (`Ecommerce Page`, Port 3021) utilizing React Server Components (RSC) and parallelized data fetches.
|
|
* **Admin ERP/CRM Portal**: Next.js App Router (`Admin Ecommerce`, Port 3022) with dynamic storefront management components.
|
|
|
|
### 2. Backend
|
|
* **Framework**: FastAPI (Python 3.11+).
|
|
* **Database Driver**: PyMySQL + SQLAlchemy 2.0 ORM.
|
|
* **Security & Auth**: Admin JWT bearer auth (`User`, `Role`, `Permission`). Customer Auth pending.
|
|
|
|
### 3. Database
|
|
* **Engine**: MySQL 8.0+ / MariaDB.
|
|
* **Identifier Standard**: 26-character String IDs (ULID format).
|
|
* **Existing Models**: `User`, `Role`, `Permission`, `Product`, `ProductVariant`, `VariantAttribute`, `Category`, `Brand`, `DeviceCatalog`, `StockMovement`, `StorefrontContent`, `AuditLog`.
|
|
|
|
---
|
|
|
|
## Gap Analysis (Existing vs Enterprise Target)
|
|
|
|
| Domain | Current Codebase Implementation | Gaps / Missing Capabilities |
|
|
| :--- | :--- | :--- |
|
|
| **Customer Auth** | Employee/User Auth present in `UserModel.py` | Missing `EcomCustomer` model, Google OAuth 2.0 flow, Customer JWT sessions |
|
|
| **E-Commerce Flow** | Mock responses in `StorefrontRouter.py` | Missing `Order`, `OrderItem`, `Cart`, `Checkout`, and `Razorpay` payment state machine |
|
|
| **Invoicing** | Not implemented | Missing online/offline GST-compliant invoice series engine |
|
|
| **Offline POS** | Not implemented | Missing Tauri + SQLite offline desktop application & sync gateway |
|
|
| **Search Engine** | Basic SQL filter queries | Missing OpenSearch projection layer & Outbox event relay |
|
|
| **Inventory** | Basic stock movement logs | Missing append-only Inventory Ledger with stock bucket calculation |
|