erp-retail/PROJECT-STATUS.md

157 lines
4.3 KiB
Markdown

# ESTADO DEL PROYECTO - ERP Retail
**Proyecto:** ERP Retail (Proyecto Independiente)
**Estado:** 📋 En planificación
**Progreso:** 25%
**Última actualización:** 2025-12-08
---
## 📊 RESUMEN EJECUTIVO
| Área | Estado | Descripción |
|------|--------|-------------|
| **Documentación** | 🟡 Inicial | 10 módulos definidos, estructura base |
| **DDL/Schemas** | ❌ No iniciado | Pendiente diseño de BD |
| **Backend** | ❌ No iniciado | Pendiente desarrollo |
| **Frontend** | ❌ No iniciado | Pendiente desarrollo |
---
## 📋 MÓDULOS DEFINIDOS (10)
| Código | Nombre | Descripción | Reutilización | Estado |
|--------|--------|-------------|---------------|--------|
| RT-001 | Fundamentos | Auth, Users, Tenants | 100% core | PLANIFICADO |
| RT-002 | POS | Punto de venta | 20% core | PLANIFICADO |
| RT-003 | Inventario | Stock multi-sucursal | 60% core | PLANIFICADO |
| RT-004 | Compras | Reabastecimiento | 80% core | PLANIFICADO |
| RT-005 | Clientes | Programa fidelidad | 40% core | PLANIFICADO |
| RT-006 | Precios | Promociones y descuentos | 30% core | PLANIFICADO |
| RT-007 | Caja | Arqueos y cortes | 10% core | PLANIFICADO |
| RT-008 | Reportes | Dashboard de ventas | 70% core | PLANIFICADO |
| RT-009 | E-commerce | Tienda online | 20% core | PLANIFICADO |
| RT-010 | Facturación | CFDI 4.0 | 60% core | PLANIFICADO |
**Story Points Estimados:** 353 SP (detallado en épicas)
---
## 🏪 DOMINIO DE NEGOCIO
### Modelo de Negocio
- Cadena de tiendas minoristas
- Multi-sucursal
- Inventario centralizado y distribuido
- Programa de lealtad
### Proceso Principal
```
Cliente → POS → Pago → Factura → Actualización Inventario
Programa de Puntos
```
### Características Específicas
- Venta rápida en mostrador (POS)
- Operación offline (PWA)
- Múltiples formas de pago
- Transferencias entre sucursales
- Promociones y cupones
- Integración e-commerce
---
## 📁 ESTRUCTURA DE DOCUMENTACIÓN
```
docs/
├── 00-vision-general/
│ └── VISION-RETAIL.md ✅
├── 02-definicion-modulos/
│ ├── INDICE-MODULOS.md ✅
│ ├── RT-001-fundamentos/README.md ✅
│ ├── RT-002-pos/README.md ✅
│ ├── RT-003-inventario/README.md ✅
│ ├── RT-004-compras/README.md ✅
│ ├── RT-005-clientes/README.md ✅
│ ├── RT-006-precios/README.md ✅
│ ├── RT-007-caja/README.md ✅
│ ├── RT-008-reportes/README.md ✅
│ ├── RT-009-ecommerce/README.md ✅
│ └── RT-010-facturacion/README.md ✅
└── 08-epicas/
└── EPIC-RT-001-fundamentos.md ✅
```
---
## 🎯 PRÓXIMOS PASOS
### Fase 1: Documentación Detallada
1. [ ] Crear épicas completas (EPIC-RT-002 a 010)
2. [ ] Documentar User Stories por módulo
3. [ ] Definir requerimientos funcionales (RF)
4. [ ] Crear especificaciones técnicas (ET)
### Fase 2: Diseño de Base de Datos
5. [ ] Diseñar schemas de BD
6. [ ] Implementar DDL
7. [ ] Documentar modelo de datos
### Fase 3: Desarrollo
8. [ ] Implementar backend (TypeScript/Express)
9. [ ] Implementar frontend POS (React PWA)
10. [ ] Testing
---
## 📈 MÉTRICAS
| Métrica | Valor |
|---------|-------|
| Módulos definidos | 10 |
| Épicas creadas | 10/10 ✅ |
| User Stories | 0 (pendiente) |
| Story Points | 353 |
| Archivos MD | 29 |
| Archivos SQL | 0 |
| Archivos TS | 0 |
---
## 🏗️ ARQUITECTURA
**Tipo:** Proyecto Independiente (fork conceptual del ERP-Core)
**Patrones a reutilizar del ERP-Core:**
- Multi-tenancy con RLS (para franquicias)
- Estructura de autenticación
- Patrones de inventario
- Sistema de compras
- Reportes y analytics
**Módulos 100% nuevos:**
- RT-002: POS (punto de venta con PWA)
- RT-007: Caja (arqueos y movimientos)
**Características técnicas:**
- PWA para operación offline
- Sincronización bidireccional
- Integración con hardware (impresoras, cajas)
**Opera de forma autónoma:** No requiere ERP-Core instalado
---
## 🔗 REFERENCIAS
- Índice de módulos: `docs/02-definicion-modulos/INDICE-MODULOS.md`
- Visión: `docs/00-vision-general/VISION-RETAIL.md`
- SPECS heredadas: `orchestration/00-guidelines/HERENCIA-SPECS-CORE.md`
- Directivas: `orchestration/directivas/`
---
**Última actualización:** 2025-12-08