ifixkart-admin/docs/architecture/current-state.md
Adithiyan bbd3a3e959 feat: initial commit — full platform snapshot
- 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
2026-10-13 12:59:47 +05:30

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 |