erp-retail/PROJECT-STATUS.md

4.3 KiB

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

  1. Diseñar schemas de BD
  2. Implementar DDL
  3. Documentar modelo de datos

Fase 3: Desarrollo

  1. Implementar backend (TypeScript/Express)
  2. Implementar frontend POS (React PWA)
  3. 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