ADN — Átomo (Protonion)
Producto: Átomo — Software contable SaaS multi-empresa
Empresa desarrolladora: Protonion
Versión ADN: 1.0
Fecha: 2026-08-07
Filosofía Owner: El Usuario (The Brain)
Filosofía Executor: El Asistente (The Tool)
1. Identidad
Átomo es la unidad indivisible de verdad financiera. Así como los átomos construyen toda la materia, cada transacción — por pequeña que sea — es un átomo que construye la estructura financiera completa de una empresa.
El nombre no hereda partículas de "Protonion": hereda su concepto (física fundamental). Protonion es la empresa que sostiene el ecosistema; Átomo es el producto que registra, valida y preserva la verdad contable de cada negocio.
Mercado inicial: PYMEs venezolanas. Modelo: SaaS multi-empresa (multi-tenant). Idioma de dominio: español (lenguaje ubicuo contable venezolano).
2. Principios Fundamentales (UEP v1.0)
- Roadmap-first: Nada se implementa sin un milestone en
roadmap.md. Zero Drift Policy. - Astronaut Protocol: Lógica de negocio FUERA de los componentes UI (
<script setup>≤ 30 líneas), composables como unidades de lógica, estructura semántica (Stack/Grid/Box/Section), design tokens obligatorios (cero hex hardcodeado),AsyncViewcomo patrón defensivo en toda vista con datos. - Verification First: Ninguna entrega se declara completa sin verificación (tests automatizados o
walkthrough.md). - SemVer estricto:
package.json↔roadmap.md↔ tags de Git sincronizados. - Dinámica Brain/Tool: El usuario decide (estrategia), el asistente ejecuta y verifica (The Tool).
3. Flujo Documental Canónico (PRD → PDR → ADR → RULE)
Invariantes innegociables (tomadas del flujo documental ZF):
- N0 (materia prima) — narrativa del cliente, hallazgos, investigación → alimenta N1.
- N1 (qué construir) —
PRD.md, historias de usuario, DOR/DOD. - N2 (decisiones) — PDR (decisión de producto) → ADR (decisión de arquitectura) → RULE (regla operativa).
- Un ADR solo nace de un PDR. Una RULE solo nace de un ADR.
- Nada se congela sin pasar por REVIEWER (handshake obligatorio).
- Estado real registrado en
.orion/workflow-state.json.
Anti-patrones prohibidos:
- PRD con decisiones de arquitectura mezcladas (el PRD dice qué; el ADR dice cómo).
- Números contables circulando sin un ADR/PDR de origen (ej: tasa BCV en 3 documentos distintos).
- Regla operativa sin ADR que la respalde.
- Referenciar un ADR que no existe.
Regla de oro: Si un dato contradice un ADR/RULE, manda el ADR/RULE.
4. Engineering Council — Roles
Cada rol es una "máscara" que el agente asume. Todos operan bajo la dinámica de handshakes binarios (PENDING/VALIDATED) en .orion/workflow-state.json.
| Rol | Mascara | Misión |
|---|---|---|
| LEDGER-ARCHITECT | El Geómetra del Mayor | Pureza del dominio contable (DDD), esquema del core, modelo de datos multi-tenant |
| GOVERNOR | El Guardián | Seguridad, compliance contable/fiscal, ADRs, reglas (RULE-*) |
| BUILDER | El Artesano | Implementación técnica (frontend, backend, tests) |
| SRE | El Operador | Infraestructura, despliegue, CI/CD, observabilidad, backups |
| FINOPS | El Contador | Control de costos del proyecto, auditoría de PDRs económicos, viabilidad |
| REVIEWER | El Auditor | QA final, code review, validación de cobertura, walkthroughs |
Handshake obligatorio entre cada transición. Si un handshake está PENDING, el rol siguiente queda bloqueado.
5. Reglas Fundamentales (RULE base del ADN)
| Regla | Descripción |
|---|---|
| RULE-MULTI-01 | Toda tabla de datos de negocio lleva tenant_id (aislamiento multi-tenant obligatorio) |
| RULE-AUDIT-01 | Toda transacción contable inmutable: partida doble (Debe = Haber) con trail de auditoría |
| RULE-DIVISA-01 | Todo monto monetario se almacena en USD + tasa de cambio al momento del registro (base para reexpresión futura) |
| RULE-INFLA-01 | Las partidas se etiquetan como monetarias/no monetarias desde el día 1 (schema preparado para NIC 29, sin implementar) |
| RULE-CIERRE-01 | El cierre mensual es irreversible: una vez cerrado, solo se corrige con asiento de apertura/reverso |
| RULE-SEC-01 | Cero secretos en código. Cero credenciales en repositorio |
| RULE-SEC-02 | RLS (Row Level Security) por tenant en todas las tablas |
| RULE-DOM-01 | Lenguaje Ubicuo en español para el dominio contable (asiento, partida, cuentas por pagar, kardex, cierre) |
| RULE-ASTRO-01 | Astronaut Protocol en toda vista: scripts ≤ 30 líneas, composables, design tokens |
6. Glosario (Lenguaje Ubicuo)
| Término | Definición |
|---|---|
| Tenant | Empresa cliente (un negocio con su propio conjunto de datos aislado) |
| Asiento | Registro contable que afecta 2+ cuentas; la unidad atómica del registro |
| Partida | Cada línea de un asiento (Debe o Haber) |
| Plan de cuentas | Estructura jerárquica de cuentas (activo, pasivo, patrimonio, ingresos, costos, gastos) |
| Libro diario | Registro cronológico de todos los asientos |
| Libro mayor | Agrupación por cuenta del efecto de todos los asientos |
| Balance de comprobación | Resumen Debe/Haber por cuenta que verifica que cuadre |
| Cierre | Corte mensual/anual del ejercicio; bloquea movimientos del período |
| Kardex | Control de inventario: entradas, salidas, existencias y costo promedio |
| Serie documental | Correlativo de facturas/N/C/N/D/cotizaciones/pedidos por punto de emisión |
| Partida monetaria | Activo/pasivo cuyo valor nominal es la medida de valor (efectivo, cuentas por cobrar/pagar) |
| Partida no monetaria | Inventarios, propiedad/planta/equipo, patrimonio — sujetas a reexpresión |
| REME | Resultado Monetario por Exposición (reexpresión por inflación) |
| REPOMON | Reporte de resultados monetarios (cédulas de reexpresión) |
| VEN-NIF | Principios de contabilidad generalmente aceptados en Venezuela |
7. Decisiones Fundacionales (registradas)
| # | Decisión | Fuente | Estado |
|---|---|---|---|
| D1 | Producto: Átomo | Elección del usuario | ✔ Fijada |
| D2 | Modelo SaaS multi-empresa (multi-tenant) | Decisión de Fase Inicial | ✔ Fijada |
| D3 | Fase 1 = Núcleo Contable + Administrativo | Decisión de Fase Inicial | ✔ Fijada |
| D4 | Reexpresión por inflación = fase posterior; schema preparado desde hoy | PDR-INFLA-001 |
En validación |
| D5 | Presupuesto desde cero (sin ancla previa) | Decisión de Fase Inicial | ✔ Fijada |
| D6 | Domain Expert / Product Owner: Baduy Salazar (contenido contable/fiscal) | Decisión de Fase Inicial | ✔ Fijada |
8. Referencias Cruzadas
- Protocolo universal:
Lab/medical-agent/_Genesis/UEP.md - Flujo documental canónico:
Protonion/ZF/docs/flujo-documental-prd-pdr-adr-nfc.md - Template PDR:
Protonion/ZF/docs/decisions/product/TEMPLATE-PDR.md - Patrón de cotización:
Lab/ProyectoNaif/COTIZACION.md - Estado del workflow:
.orion/workflow-state.json