16 KiB
16 KiB
VALIDACION DE COMPLETITUD
Fecha: 2025-12-18 Fase: 4 - Validacion Objetivo: Verificar que no faltan objetos o componentes dependientes
1. VALIDACION DE PRERREQUISITOS CORE
1.1 Modulos Core Requeridos
| Modulo | Estado | Requerido | Validado | Notas |
|---|---|---|---|---|
| MGN-001 Auth | 40% | 100% | ❌ | Falta completar JWT, roles, permisos |
| MGN-002 Users | 40% | 100% | ❌ | Depende de Auth |
| MGN-003 Tenants | 50% | 100% | ❌ | RLS policies incompletas |
| MGN-004 Roles | 30% | 100% | ❌ | Sistema de permisos |
| MGN-005 Catalogs | 0% | 100% | ❌ | BLOQUEANTE - No iniciado |
| MGN-010 Financial | 70% | 90% | ❌ | Falta migrar a TypeORM |
| MGN-011 Inventory | 60% | 80% | ❌ | Products y stock_quants |
| MGN-012 Partners | 50% | 80% | ❌ | Falta servicio completo |
| MGN-013 Sales | 50% | 70% | ❌ | Pricelists incompleto |
1.2 Entidades Core Requeridas por Retail
| Entidad | Schema | Estado | Usado Por |
|---|---|---|---|
| tenants | auth | Existe | Todos los modulos |
| users | auth | Existe | Auth, POS |
| roles | auth | Parcial | Auth, Permisos |
| permissions | auth | No existe | Auth |
| user_roles | auth | No existe | Auth |
| countries | core | No existe | Partners |
| currencies | core | No existe | Precios |
| sequences | core | No existe | Numeracion |
| uom | core | No existe | Productos |
| uom_categories | core | No existe | UoM |
| partners | core | Parcial | Clientes, Proveedores |
| taxes | financial | Existe | Facturacion |
| tax_groups | financial | No existe | Impuestos |
| accounts | financial | Existe | Contabilidad |
| journals | financial | Existe | Pagos |
| payment_methods | financial | No existe | POS, E-commerce |
| product_categories | inventory | Existe | Productos |
| products | inventory | Existe | Todos |
| warehouses | inventory | Existe | Inventario |
| stock_quants | inventory | Parcial | Stock |
| pricelists | sales | No existe | Precios |
| pricelist_items | sales | No existe | Precios |
1.3 Acciones Requeridas para Core
acciones_core:
criticas:
- id: ACT-CORE-001
modulo: MGN-005 Catalogs
descripcion: Implementar catalogos base completos
entidades:
- core.countries
- core.currencies
- core.uom_categories
- core.uom
- core.sequences
prioridad: P0
bloqueante: true
- id: ACT-CORE-002
modulo: MGN-001 Auth
descripcion: Completar sistema de autenticacion
entidades:
- auth.permissions
- auth.user_roles
servicios:
- AuthService (completar JWT)
- PermissionsService
prioridad: P0
bloqueante: true
altas:
- id: ACT-CORE-003
modulo: MGN-010 Financial
descripcion: Migrar a TypeORM
entidades:
- financial.tax_groups
- financial.payment_methods
prioridad: P0
- id: ACT-CORE-004
modulo: MGN-013 Sales
descripcion: Implementar listas de precios
entidades:
- sales.pricelists
- sales.pricelist_items
prioridad: P0
2. VALIDACION DE MODULOS RETAIL
2.1 RT-001 Fundamentos
| Componente | Tipo | Estado | Dependencia |
|---|---|---|---|
| retail schema | DDL | Planificado | - |
| branches | Entity | Planificado | auth.tenants |
| cash_registers | Entity | Planificado | branches |
| branch_users | Entity | Planificado | branches, users |
| BranchesService | Service | Planificado | - |
| CashRegistersService | Service | Planificado | BranchesService |
Validacion: ✅ Completo - Todas las dependencias identificadas
2.2 RT-002 POS
| Componente | Tipo | Estado | Dependencia |
|---|---|---|---|
| pos_sessions | Entity | Planificado | branches, cash_registers, users |
| pos_orders | Entity | Planificado | pos_sessions, partners |
| pos_order_lines | Entity | Planificado | pos_orders, products |
| pos_payments | Entity | Planificado | pos_orders |
| POSSessionService | Service | Planificado | CashRegistersService |
| POSOrderService | Service | Planificado | PriceEngineService, RetailStockService, LoyaltyService |
| POSPaymentService | Service | Planificado | - |
| POSSyncService | Service | Planificado | POSOrderService |
| POSController | Controller | Planificado | POSSessionService, POSOrderService |
| POSGateway | WebSocket | Planificado | POSSyncService |
| Sales Page | Frontend | Planificado | API Client |
| Checkout Page | Frontend | Planificado | API Client |
Validacion: ✅ Completo
Dependencias externas validadas:
- PriceEngineService (RT-006)
- RetailStockService (RT-003)
- LoyaltyService (RT-005)
- Products (MGN-011)
- Partners (MGN-012)
2.3 RT-003 Inventario
| Componente | Tipo | Estado | Dependencia |
|---|---|---|---|
| stock_transfers | Entity | Planificado | branches, users |
| stock_transfer_lines | Entity | Planificado | stock_transfers, products |
| stock_adjustments | Entity | Planificado | branches, users |
| stock_adjustment_lines | Entity | Planificado | stock_adjustments, products |
| branch_stock (view) | View | Planificado | stock_quants, branches, products |
| RetailStockService | Service | Planificado | StockService (core) |
| TransfersService | Service | Planificado | RetailStockService |
| AdjustmentsService | Service | Planificado | RetailStockService |
| InventoryController | Controller | Planificado | Todos los services |
Validacion: ✅ Completo
Dependencias externas validadas:
- inventory.stock_quants (MGN-011)
- inventory.products (MGN-011)
- inventory.warehouses (MGN-011)
2.4 RT-004 Compras
| Componente | Tipo | Estado | Dependencia |
|---|---|---|---|
| purchase_suggestions | Entity | Planificado | branches, products, partners |
| supplier_orders | Entity | Planificado | partners, branches, users |
| supplier_order_lines | Entity | Planificado | supplier_orders, products |
| goods_receipts | Entity | Planificado | supplier_orders, branches, partners |
| goods_receipt_lines | Entity | Planificado | goods_receipts, products |
| RetailPurchaseService | Service | Planificado | PurchaseService (core) |
| PurchaseSuggestionsService | Service | Planificado | RetailStockService |
| GoodsReceiptService | Service | Planificado | RetailStockService |
| PurchaseController | Controller | Planificado | Todos los services |
Validacion: ✅ Completo
2.5 RT-005 Clientes
| Componente | Tipo | Estado | Dependencia |
|---|---|---|---|
| loyalty_programs | Entity | Planificado | tenants |
| membership_levels | Entity | Planificado | loyalty_programs |
| loyalty_transactions | Entity | Planificado | partners, loyalty_programs, pos_orders |
| customer_memberships | Entity | Planificado | partners, loyalty_programs, membership_levels |
| RetailCustomersService | Service | Planificado | PartnersService (core) |
| LoyaltyService | Service | Planificado | - |
| CustomersController | Controller | Planificado | RetailCustomersService, LoyaltyService |
Validacion: ✅ Completo
Dependencias externas validadas:
- core.partners (MGN-012)
- retail.pos_orders (RT-002)
2.6 RT-006 Precios
| Componente | Tipo | Estado | Dependencia |
|---|---|---|---|
| promotions | Entity | Planificado | tenants |
| promotion_products | Entity | Planificado | promotions, products, product_categories |
| coupons | Entity | Planificado | tenants, partners |
| coupon_redemptions | Entity | Planificado | coupons, pos_orders |
| PriceEngineService | Service | Planificado | PricelistsService (core), PromotionsService, CouponsService |
| PromotionsService | Service | Planificado | - |
| CouponsService | Service | Planificado | - |
| PricingController | Controller | Planificado | Todos los services |
Validacion: ✅ Completo
Dependencias externas validadas:
- sales.pricelists (MGN-013) - PENDIENTE IMPLEMENTAR
- inventory.products (MGN-011)
- inventory.product_categories (MGN-011)
2.7 RT-007 Caja
| Componente | Tipo | Estado | Dependencia |
|---|---|---|---|
| cash_movements | Entity | Planificado | pos_sessions, users |
| cash_closings | Entity | Planificado | pos_sessions, users |
| cash_counts | Entity | Planificado | pos_sessions, users |
| CashSessionService | Service | Planificado | POSSessionService |
| CashMovementService | Service | Planificado | CashSessionService |
| CashClosingService | Service | Planificado | CashSessionService |
| CashController | Controller | Planificado | Todos los services |
Validacion: ✅ Completo
Dependencias externas validadas:
- retail.pos_sessions (RT-002)
- auth.users (MGN-002)
2.8 RT-008 Reportes
| Componente | Tipo | Estado | Dependencia |
|---|---|---|---|
| mv_daily_sales | Mat. View | Planificado | pos_orders, pos_sessions |
| mv_product_sales | Mat. View | Planificado | pos_order_lines, pos_orders, pos_sessions |
| mv_branch_stock_summary | Mat. View | Planificado | branches, stock_quants, products |
| DashboardService | Service | Planificado | Multiples repositories |
| SalesReportService | Service | Planificado | ReportsService (core) |
| ProductReportService | Service | Planificado | - |
| CashReportService | Service | Planificado | - |
| ExportService | Service | Planificado | - |
| ReportsController | Controller | Planificado | Todos los services |
Validacion: ✅ Completo
Dependencias externas validadas:
- retail.pos_orders (RT-002)
- retail.pos_order_lines (RT-002)
- retail.pos_sessions (RT-002)
- retail.cash_closings (RT-007)
- inventory.stock_quants (MGN-011)
2.9 RT-009 E-commerce
| Componente | Tipo | Estado | Dependencia |
|---|---|---|---|
| carts | Entity | Planificado | tenants, partners |
| cart_items | Entity | Planificado | carts, products |
| ecommerce_orders | Entity | Planificado | partners, branches |
| ecommerce_order_lines | Entity | Planificado | ecommerce_orders, products |
| shipping_rates | Entity | Planificado | tenants |
| CatalogService | Service | Planificado | ProductsService |
| CartService | Service | Planificado | - |
| CheckoutService | Service | Planificado | CartService, PriceEngineService, RetailStockService |
| PaymentGatewayService | Service | Planificado | Stripe, Conekta providers |
| ShippingService | Service | Planificado | - |
| EcommerceOrderService | Service | Planificado | - |
| StorefrontController | Controller | Planificado | Todos los services |
| EcommerceAdminController | Controller | Planificado | EcommerceOrderService |
Validacion: ✅ Completo
Dependencias externas validadas:
- inventory.products (MGN-011)
- core.partners (MGN-012)
- retail.branches (RT-001)
- PriceEngineService (RT-006)
- RetailStockService (RT-003)
2.10 RT-010 Facturacion
| Componente | Tipo | Estado | Dependencia |
|---|---|---|---|
| cfdi_config | Entity | Planificado | tenants |
| cfdis | Entity | Planificado | pos_orders, ecommerce_orders, partners |
| CFDIService | Service | Planificado | CFDIBuilderService, PACService, XMLService, PDFService |
| CFDIBuilderService | Service | Planificado | - |
| PACService | Service | Planificado | FinkokPAC, FacturamaPAC |
| XMLService | Service | Planificado | - |
| PDFService | Service | Planificado | - |
| AutofacturaService | Service | Planificado | CFDIService |
| CFDIController | Controller | Planificado | CFDIService |
| AutofacturaController | Controller | Planificado | AutofacturaService |
Validacion: ✅ Completo
Dependencias externas validadas:
- retail.pos_orders (RT-002)
- retail.ecommerce_orders (RT-009)
- core.partners (MGN-012)
- financial.taxes (MGN-010)
3. VALIDACION DE INTEGRACIONES
3.1 Integraciones Backend
| Integracion | Modulo | Estado | Validacion |
|---|---|---|---|
| Finkok PAC | RT-010 | Planificado | ✅ Docs API disponibles |
| Facturama PAC | RT-010 | Planificado | ✅ Docs API disponibles |
| Stripe | RT-009 | Planificado | ✅ SDK oficial |
| Conekta | RT-009 | Planificado | ✅ SDK oficial |
| MercadoPago | RT-009 | Opcional | ✅ SDK oficial |
| Fedex | RT-009 | Planificado | ⚠️ Requiere contrato |
| DHL | RT-009 | Opcional | ⚠️ Requiere contrato |
3.2 Integraciones Hardware (POS)
| Integracion | Tipo | Estado | Validacion |
|---|---|---|---|
| Impresora ESC/POS | USB/BT/Net | Planificado | ✅ Web USB/BT APIs |
| Lector codigo barras | Keyboard wedge | Planificado | ✅ Solo JS |
| Cajon de dinero | Via impresora | Planificado | ✅ Comando ESC/POS |
| Terminal bancaria | Serial/USB | Opcional | ⚠️ Depende de banco |
4. VALIDACION DE SEGURIDAD
4.1 Row-Level Security (RLS)
| Tabla | RLS Habilitado | Policy Definida |
|---|---|---|
| retail.branches | ✅ | ✅ |
| retail.cash_registers | ✅ | ✅ |
| retail.branch_users | ✅ | ✅ |
| retail.pos_sessions | ✅ | ✅ |
| retail.pos_orders | ✅ | ✅ |
| retail.pos_order_lines | ✅ | ✅ |
| retail.pos_payments | ✅ | ✅ |
| retail.cash_movements | ✅ | ✅ |
| retail.cash_closings | ✅ | ✅ |
| retail.cash_counts | ✅ | ✅ |
| retail.stock_transfers | ✅ | ✅ |
| retail.stock_adjustments | ✅ | ✅ |
| retail.loyalty_programs | ✅ | ✅ |
| retail.customer_memberships | ✅ | ✅ |
| retail.promotions | ✅ | ✅ |
| retail.coupons | ✅ | ✅ |
| retail.cfdis | ✅ | ✅ |
| retail.cfdi_config | ✅ | ✅ |
| retail.carts | ✅ | ✅ |
| retail.ecommerce_orders | ✅ | ✅ |
Validacion RLS: ✅ Todas las tablas tienen RLS planificado
4.2 Autenticacion y Autorizacion
| Aspecto | Estado | Validacion |
|---|---|---|
| JWT Token | Planificado | ✅ |
| Refresh Token | Planificado | ✅ |
| Middleware Tenant | Planificado | ✅ |
| Middleware Branch | Planificado | ✅ |
| RBAC | Pendiente core | ⚠️ Depende de MGN-004 |
5. RESUMEN DE VALIDACION
5.1 Estado por Fase
| Fase | Modulos | Validacion |
|---|---|---|
| Prerrequisitos Core | MGN-001,002,003,004,005,010,011,012,013 | ❌ 9 gaps identificados |
| Retail Fundamentos | RT-001 | ✅ Completo |
| POS MVP | RT-002, RT-006, RT-003, RT-007 | ✅ Completo |
| Facturacion | RT-010 | ✅ Completo |
| Clientes | RT-005 | ✅ Completo |
| Compras | RT-004 | ✅ Completo |
| Reportes | RT-008 | ✅ Completo |
| E-commerce | RT-009 | ✅ Completo |
5.2 Gaps Criticos (Bloqueantes)
| ID | Descripcion | Modulo | Accion |
|---|---|---|---|
| GAP-VAL-001 | MGN-005 Catalogs no existe | Core | Implementar antes de Sprint 5 |
| GAP-VAL-002 | Auth/Permisos incompleto | MGN-001/004 | Completar antes de Sprint 5 |
| GAP-VAL-003 | Pricelists no existe | MGN-013 | Implementar antes de RT-006 |
| GAP-VAL-004 | PaymentMethods no existe | MGN-010 | Implementar antes de RT-002 |
5.3 Conclusion
⚠️ NO SE PUEDE INICIAR RETAIL hasta completar los prerrequisitos del core (Sprints 1-4).
Una vez completados los prerrequisitos:
- ✅ Todas las entidades retail estan planificadas
- ✅ Todas las dependencias estan mapeadas
- ✅ Todas las integraciones estan identificadas
- ✅ RLS planificado para todas las tablas
Estado: VALIDACION COMPLETA CON GAPS Gaps Bloqueantes: 4 Gaps No Bloqueantes: 0