ValidateColombianTaxId
Valida identificación y DV DIAN cuando aplica.
Blueprint interactivo
Arquitectura contable antes que pantalla bonita.
Esta página explica cómo está pensado ContPass: dominio, validaciones, servicios, reportes y límites del MVP. No expone datos operativos, clientes, proveedores, valores reales ni información sensible.
ContPass Core
Mapa de componentes
Entrada
Panel Filament
Resources, Pages, Widgets, permisos y formularios.
Reportes
CSV auditables
Libro auxiliar, terceros y balance.
Dominio
Servicios contables
Persistencia
PostgreSQL ready
Comprobantes, asientos, terceros y reglas.
Rendimiento
Redis ready
Cache, sesiones y colas configurables.
Capas del sistema
Haz clic y abre la capa que quieras entender.
La interfaz captura intención; el dominio decide cómo se registran, validan y protegen los movimientos contables.
01 Interfaz operativa Abrir detalle
Filament v5 organiza catálogos, formularios, tablas, widgets y páginas de reportes. No contiene la lógica contable crítica.
02 Dominio contable Abrir detalle
Actions y services causan ingresos, egresos, pagos y ajustes dentro de transacciones de base de datos.
03 Persistencia Abrir detalle
PostgreSQL es el objetivo principal; las migraciones se mantienen portables y con relaciones explícitas.
04 Observabilidad contable Abrir detalle
Reportes CSV, estados de comprobante e inmutabilidad permiten revisar historia sin borrar evidencia.
Servicios de dominio
El comportamiento vive fuera del formulario.
Cada operación relevante pasa por servicios explícitos. Esto evita que una pantalla cree asientos incompletos o salte reglas de periodo, partida doble y trazabilidad.
PostIncomeVoucher
Causa ingreso y genera asiento balanceado.
PostExpenseVoucher
Causa egreso, soporte, deducibilidad y cuenta por pagar.
ApplyWithholdingRules
Aplica reglas versionadas por vigencia, base y tarifa.
RegisterPayment
Registra pago contra caja o banco y método de pago.
CreateAdjustmentVoucher
Corrige con nota de ajuste sin editar el origen.
PostsBalancedVoucher
Protege el principio de partida doble.
EnsureOpenAccountingPeriod
Bloquea operación directa en periodos cerrados.
Flujos críticos
Tres caminos, una misma regla: trazabilidad antes que velocidad.
Ingreso Expandir flujo
- 1 Tercero validado
- 2 Cuenta PUC clase 4
- 3 Contrapartida por cobrar
- 4 Comprobante aprobado
Egreso Expandir flujo
- 1 Soporte y deducibilidad
- 2 Gasto/costo clase 5 o 6
- 3 Retenciones versionadas
- 4 Cuenta por pagar
Pago / ajuste Expandir flujo
- 1 Caja o banco clase 11
- 2 Medio de pago trazable
- 3 Alerta no bancarizada
- 4 Ajuste si ya fue aprobado
Garantías técnicas
Lo público explica estructura, no expone operación.
La landing documenta decisiones del sistema sin revelar terceros, cuentas reales, comprobantes reales, saldos, usuarios internos ni datos de empresa.
Sin datos sensibles
La página usa conceptos, nombres de módulos y patrones. No muestra información operacional.
Asientos inmutables
Lo aprobado se corrige con nota de ajuste, no con edición directa.
Reglas configurables
Retenciones y vigencias viven en configuración versionada.
Reportes exportables
CSV UTF-8 preparado para revisión contable y auditoría.
PostgreSQL ready
Base principal objetivo para producción.
Redis ready
Cache, colas y sesiones pueden moverse a Redis por entorno.