# MODULO DEPRECATED

Este modulo esta deprecated desde 2026-02-03.

## Razon

La funcionalidad de facturacion esta siendo consolidada en el modulo `financial`.
El modulo `invoices` (schema `operations`, formerly `billing`) fue disenado para facturacion operativa,
pero para mantener una arquitectura limpia, toda la logica de facturas debe
residir en un unico modulo.

## Mapeo de Entidades

| Invoices (operations)  | Financial (financial)        | Notas                                    |
|------------------------|------------------------------|------------------------------------------|
| Invoice                | financial/invoice.entity.ts  | financial tiene integracion con journals |
| InvoiceItem            | financial/invoice-line.entity.ts | Renombrado a InvoiceLine              |
| Payment                | financial/payment.entity.ts  | financial tiene PaymentType enum         |
| PaymentAllocation      | (sin equivalente directo)    | Usar payment_invoices table              |

## Diferencias Clave

### Invoices (deprecated)
- Schema: `operations` (moved from `billing` to resolve conflict with SaaS billing schema)
- Enfoque: Facturacion operativa, CFDI Mexico
- Sin integracion contable directa

### Financial (activo)
- Schema: `financial`
- Enfoque: Contabilidad completa con journal entries
- Integracion con plan de cuentas
- Soporte para asientos automaticos

## Migracion

Para migrar codigo existente:

```typescript
// ANTES (deprecated)
import { Invoice, Payment } from '@modules/invoices';

// DESPUES (recomendado)
import { Invoice, Payment } from '@modules/financial/entities';
```

## Uso Actual

Este modulo aun tiene las siguientes dependencias activas:

1. `app.integration.ts` - Importa InvoicesModule y entities
2. `app.ts` - Importa invoicesRoutes
3. `billing-usage/entities/invoice.entity.ts` - Referencia en comentario deprecated

**IMPORTANTE:** Estas referencias deben actualizarse antes de eliminar este modulo.

## Plan de Deprecation

1. **Fase 1 (Actual):** Marcar como deprecated, documentar
2. **Fase 2:** Migrar endpoints a financial module
3. **Fase 3:** Actualizar todas las referencias
4. **Fase 4:** Eliminar modulo invoices

## Contacto

Para dudas sobre la migracion, consultar la documentacion en:
- `orchestration/tareas/2026-02-03/` - Tarea de consolidacion
- `docs/40-estandares/` - Estandares de arquitectura
