Formato basado en Keep a Changelog. Versionado según SemVer.
1.5.0 — 2026-09-07
Empresa Operativa Chile incorpora control interno ejecutable para que una falla técnica, financiera o humana deje evidencia y no dependa de una sola persona para ser detectada.
- Vista «Control interno» en Web, Android y Windows: KRI, procesos críticos, catálogo de controles, risk register, RACI, auditoría continua y whistleblowing.
- Motor de procesos de siete etapas con evidencia obligatoria y segregación de funciones que rechaza saltos, roles no habilitados y personas en funciones incompatibles.
- Gobierno con Board, Management, Finance, Accounting, Treasury, Technology, Security, Compliance, Internal Audit y External Audit.
- Controles Preventive/Detective/Corrective y Manual/Automated/Hybrid; frecuencias configurables de revisión; y denuncias con independencia, conflicto y escalamiento.
- Escenario SANDBOX de custodia digital,
docs/CONTROL-INTERNO.md, parte 16 del currículo y caso capstone de un descalce de CLP 84.000.000.
- El respaldo sube a formato v3 para incluir controles, riesgos, procesos, frecuencias y denuncias; la importación de respaldos v1 y v2 permanece compatible.
- Manual, HTML, arquitectura, roadmap y documentación principal incorporan la nueva capa sin renombrar el producto ni reemplazar la operación contable existente.
De 153 a 158. Las pruebas nuevas cubren secuencia y SoD, controles/riesgos/KRI, frecuencias, independencia del canal de denuncias y compatibilidad del respaldo v3.
Los manuales entran en la aplicación, el teclado se vuelve una forma de trabajar y el producto tiene presentación.
- Pestaña «Ayuda»: la guía ilustrada y el manual completo se leen dentro de la aplicación, en un marco del mismo origen. Los dos viajan en el paquete instalado, así que funcionan sin conexión igual en navegador, Android y Windows.
docs/MANUAL.html— el manual en HTML autocontenido, con índice lateral y sin JavaScript. Usa un juego compacto de capturas (docs/assets/compacto/, densidad 1): con las de densidad 2 el archivo pasaría de diez megas y engordaría el APK.- Ayuda contextual al pasar el cursor. La marca ? junto a cada rótulo ya no exige pulsar:
al pasar por encima muestra en una línea qué es el término; al pulsar, la definición completa
con aquello con lo que no hay que confundirlo. El globo cuelga del
bodycon posición fija para no quedar recortado dentro de las tablas, que tienen scroll propio. termWord(): subraya una palabra dentro de una frase, sin añadir un signo que interrumpa la lectura.- 12 atajos de teclado (
packages/shortcuts), pensados sobre todo para Windows:- Ctrl+K — buscador: salta a cualquier pantalla o término del glosario, con navegación por flechas. Es el único que hace falta aprender.
- Alt+1…9 pantallas · F1 ayuda · Alt+M modo · Alt+T tema · Alt+←→ período · Alt+N acción principal · / buscar · Esc cerrar.
- Dentro de un campo de texto sólo pasan los atajos con modificador y Esc: escribir «no» en una descripción no abre nada.
docs/ATAJOS-DE-TECLADO.md, generado desde el mismo módulo; CI comprueba la sincronía.- Presentación del producto (
docs/presentacion.md→scripts/build-presentation.mjs): 8 diapositivas 16:9 en HTML y PDF, más la pauta del expositor con el guion hablado y los minutos de cada lámina. La duración total se calcula sola. Fuente única: el guion y las láminas viven en el mismo archivo, que es lo que impide que a la segunda edición cuenten cosas distintas. Se publica junto a la app, así que se puede proyectar desde el sitio sin descargar nada.
scripts/build-manual-pdf.mjspasa a serscripts/build-manual.mjsy produce los dos formatos.- Las capturas se toman en dos juegos:
assets/capturas/(densidad 2, para el PDF y el README) yassets/compacto/(densidad 1, para los HTML embarcados). El segundo es un espejo del primero, no una lista aparte. - El manejo de teclas antiguo (Alt+número, escrito a mano en
app.js) se reemplazó por la tabla declarativa; hay una prueba que falla si vuelve a duplicarse. npm run checkvalida también los atajos y la estructura de la presentación.
De 137 a 153. Las nuevas comprueban que no haya dos atajos con la misma combinación, que escribir en un campo no dispare atajos sin modificador, que los HTML embarcados no lleven JavaScript —la política de seguridad de la app los bloquearía— ni imágenes externas, que el manual en HTML no supere el tamaño que lo haría inviable dentro del APK, y que ninguna diapositiva se publique sin pauta ni minutos.
La guía «Empezar aquí», ilustrada y en tres formatos.
La versión anterior daba la ruta en texto. Faltaba lo que hace que una guía se pueda seguir sin conocer el sistema: ver la pantalla donde se hace cada cosa, y un mapa de quién hace qué.
- Dos diagramas generados (
scripts/lib/diagrams.mjs), no dibujados a mano — si mañana se agrega una etapa, aparecen solos:- Casos de uso: los actores (quien crea la empresa, contador, Registro de Empresas, SII, municipalidad, banco) y el límite del sistema. Todo lo que cruza hacia un organismo va con línea discontinua, para que no se malinterprete nunca que la aplicación presenta o paga algo.
- La ruta completa: las 14 etapas agrupadas por fase, numeradas y encadenadas.
- Una captura de cada pantalla donde se hace cada etapa, dentro del propio documento. Se toman a densidad 1 y algo más angostas que las del manual porque viajan embebidas: cada vista se ilustra una vez, en la primera etapa que la usa.
docs/EMPEZAR-AQUI.html— autocontenido (imágenes en data URI), con índice lateral pegajoso, tema claro y oscuro, y cero JavaScript: se abre dentro de la aplicación, cuya política de seguridad prohíbe scripts en línea.docs/EMPEZAR-AQUI.pdf— 34 páginas, para descargar, imprimir o enviar.- La guía se lee DENTRO de la aplicación. La pestaña «Empezar aquí» la muestra en un marco del mismo origen —no en una pestaña nueva—, con botón para descargar el PDF. Ambos archivos viajan en el bundle: se leen y se descargan sin conexión, igual en el navegador, en Android y en Windows.
- El conversor Markdown → HTML y el envoltorio de Chrome se extrajeron a
scripts/lib/(markdown.mjs,chrome.mjs,print-style.mjs), compartidos por el manual y la guía. Antes vivían dentro del script del manual; ahora los dos documentos salen del mismo motor y no pueden divergir de aspecto. - El servidor local declara
application/pdfy deja de añadircharseta los binarios. frame-ancestorspasa de'none'a'self': sigue impidiendo que cualquier sitio externo enmarque la aplicación —que es de lo que protege esa directiva— y permite lo único que hacía falta, que la app se enmarque a sí misma para mostrar la guía.npm run docsgenera también la guía.
De 131 a 137. Las nuevas comprueban que el HTML no referencie ni una imagen externa (una ruta relativa haría que la guía se viera rota dentro del APK), que cada pantalla que la guía manda abrir tenga su captura y aparezca exactamente una vez, que los diagramas estén generados y describan su contenido para lectores de pantalla, y que el bundle embarque los dos formatos.
Una ruta para quien nunca ha creado una empresa.
El manual describe pantallas, y eso sirve cuando ya sabes qué quieres hacer. No sirve para quien abre la aplicación por primera vez y su pregunta es «no sé por dónde empezar». Esa persona necesita otra cosa: una secuencia en el tiempo, con la decisión de cada punto, el papel que le va a quedar y cómo sabe que terminó.
- Pantalla “Empezar aquí” (
apps/web/src/views/empezar.js), primera en la navegación y la única ordenada por tiempo en vez de por función. 14 etapas en 5 fases —antes de existir, hacerla nacer, habilitarla, operar mes a mes, cerrar el año—, cada una con: la pregunta que te estás haciendo, por qué importa, qué necesitas tener antes, las alternativas de cada decisión con sus riesgos, qué documento te queda y quién lo emite, los errores típicos, y cómo sabes que terminaste. - Ventanas vinculadas: cada etapa tiene un botón que abre la pantalla donde se hace, y muestra el estado real del trámite (pendiente / en trámite / hecho) leído del espacio de trabajo, no de una lista paralela. Arriba, un bloque “Por dónde sigues” apunta a la primera etapa sin terminar.
- Sección “Qué cubre este sistema y qué no”, con los vacíos declarados y qué significa cada uno para el usuario: remuneraciones, comercio exterior, inventario, activo fijo y depreciación, corrección monetaria, reorganizaciones, registros empresariales completos, término de giro, conexión con el SII y tasas municipales por comuna.
docs/EMPEZAR-AQUI.md, generado desde el mismo módulo connode scripts/build-guide.mjs. CI comprueba la sincronía, igual que con el glosario: si el documento y la pantalla se editaran por separado, en un mes mandarían a la gente a sitios distintos.- Índice “Si sólo tienes una pregunta” con las doce dudas más frecuentes de quien recién parte, cada una enlazada a la etapa que la responde.
- Sección de errores caros y cuándo dejar de leer y llamar a un contador.
- El manual de usuario abre con un aviso que remite a la guía nueva cuando la pregunta es “no sé por dónde empezar”.
npm run checkvalida también la sincronía de la guía.
De 120 a 131. Las nuevas comprueban que la guía no prometa pantallas inexistentes, que cubra los nueve trámites de constitución sin dejar ninguno huérfano, que toda etapa de trámite diga qué documento queda, y que la lista de limitaciones no se quede corta.
Capital, Capital Propio Tributario y patente municipal dejan de ser el mismo número.
Hasta aquí la ficha de empresa tenía un solo campo capital, rotulado “capital enterado”, y esa
misma cifra se usaba para estimar la patente municipal de cualquier año. Eso trata como sinónimos
seis magnitudes que jurídica y contablemente no lo son, y produce una cifra plausible y equivocada
—que es el peor resultado posible en una herramienta de cumplimiento—.
- Módulo Capital y Patrimonio (
apps/web/src/views/capital.js, vista nueva): capital social, suscrito, enterado y por enterar como campos separados; accionistas (admite uno solo al 100 %); número de acciones y valor nominal; fechas de constitución e inicio de actividades. - Ledger de movimientos patrimoniales (
packages/company-operations/capital.mjs): aporte inicial, aporte posterior, capital pendiente enterado, aumento y disminución de capital, aporte en bienes, préstamo del accionista, devolución del préstamo y retiro/distribución. Cada tipo declara su efecto sobre el patrimonio y sobre el pasivo. - Aporte ≠ préstamo. Un depósito del dueño obliga a declarar su naturaleza —aporte de capital,
préstamo del accionista, ingreso operacional u otro— en vez de registrarse automáticamente como
capital. Dos tipos de operación nuevos:
shareholder_loanyshareholder_loan_repayment, con sus asientos explicados. - Aportes en bienes con
tipoActivo, valor de aporte, valor contable y valor tributario por separado, documento de respaldo y accionista aportante. - Motor de Capital Propio Tributario (
packages/accounting-engine/tax-equity.mjs):calculateTaxEquity(...)con los dos métodos —art. 41 N.º 1 de la LIR y CPT simplificado del art. 14 letra D) N.º 3 letra (j)—. Devuelve el desglose partida a partida, el método, la base legal, los supuestos, las advertencias y la evidencia. Nunca devuelve sólo un número. - Motor de patente municipal (
packages/accounting-engine/municipal-patent.mjs):calculateMunicipalPatent(...)distingueNEW_BUSINESSdeESTABLISHED_BUSINESS, aplica las deducciones por inversiones en otros negocios afectos a patente (art. 24 inciso final) y el prorrateo entre sucursales (art. 25), y explica de dónde salió cada peso. - Maestro municipal extensible (
packages/chile-tax-rules/municipalities.mjs) con identidad de comunas y cero tasas inventadas: todas nacenUNVERIFIEDy sólo pasan aVERIFIEDcuando el usuario registra la tasa con su fuente y su fecha de verificación. - Cierre anual con snapshot inmutable: activos, pasivos, patrimonio contable, CPT y su método, ajustes, régimen, movimientos de capital, base municipal del período siguiente, evidencias y la versión de las reglas legales con que se calculó. Reabrirlo exige motivo; importar un respaldo no puede pisarlo.
- Expediente anual exportable en JSON, con empresa, ejercicio, patente, municipalidad y bitácora.
- Historial por año de capital, patrimonio, CPT, base y patente. Un ejercicio cerrado nunca se recalcula: se muestra lo que quedó guardado.
- Glosario del sistema (
packages/glossary/index.mjs): 54 términos con resumen, definición pedagógica, base legal y —lo decisivo en este dominio— con qué no hay que confundirlos. Tres consumidores desde una sola copia: la vista Glosario con búsqueda insensible a tildes, las ayudas contextuales?junto a cada campo, ydocs/GLOSSARY.mdgenerado connode scripts/build-glossary.mjs. CI comprueba la sincronía. - Simulador educativo en SANDBOX: escenarios de capital inicial ($500.000 / $1.000.000 / $5.000.000) mostrando el efecto en la patente y el choque contra el mínimo legal.
- Caso de referencia completo en el sandbox: SpA de desarrollo de software, un accionista al 100 %, sin trabajadores, oficina virtual, notebook aportado al capital, préstamo del accionista y el ejercicio 2026 entero hasta el cierre y la base municipal de 2027.
- Estados y origen del dato:
ESTIMADO · CALCULADO · DECLARADO · VERIFICADO · PAGADOyusuario · calculado · importado · sii · municipalidad, para no presentar una estimación interna como un hecho acreditado. - Indicadores nuevos en el panel: capital enterado, CPT del último cierre, patente del período y estado del cierre anual.
- Comandos de CLI:
patente-municipal,cptyglosario. - Documentación nueva:
docs/accounting/CAPITAL-PATRIMONIO.md,docs/tax/CAPITAL-PROPIO-TRIBUTARIO.md,docs/municipal/PATENTE-MUNICIPAL.mdydocs/guides/OFICINA-VIRTUAL.md.
- Tope de la patente municipal: 4.000 → 8.000 UTM. El art. 24 del D.L. 3.063 fija el máximo en
8.000 UTM; el repositorio traía el texto anterior a la Ley N.º 20.280.
scripts/validate-rules.mjsahora falla si alguien lo revierte. - La patente ya no se estima con
capital enterado × tasa mínimapara cualquier año. La base legal cambia entre el primer ejercicio y los siguientes, y ahora el motor lo refleja. - Se unificó el
idNormade BCN del D.L. 3.063, que aparecía con dos valores distintos en el repositorio (6942 en las reglas y 7054 en las fuentes).
- El campo
capitalde la ficha se conserva y se mantiene sincronizado con el capital enterado, para no romper respaldos, exportaciones ni vistas anteriores. El formulario de la ficha ya no lo edita: lo gobierna el módulo de capital. - Formato de respaldo v2 (añade capital, movimientos patrimoniales, cierres anuales y ficha municipal). Los respaldos v1 se siguen importando sin cambios.
validate-rules.mjspasa de comprobar cuatro tasas a validar también el rango y los topes de la patente, los dos métodos de CPT y que toda regla declare fuente y fecha de verificación.
Una ficha antigua con sólo capital migra en lectura: esa cifra pasa a capitalEnterado, y
capitalSocial y capitalSuscrito quedan marcados PENDING_CONFIRMATION en vez de inventarse.
La migración no escribe en el almacén, así que instalar esta versión no puede alterar datos
existentes: si el usuario nunca vuelve a guardar, el archivo original queda intacto.
De 50 a 119. Las nuevas protegen distinciones, no aritmética: que un préstamo del accionista nunca sume capital enterado, que el CPT simplificado no se aplique a quien no califica, que la base de la patente cambie entre el año 1 y el año 2, que un CPT negativo se lleve a $0 como manda la ley, que una tasa fuera del rango legal se rechace, que la UTM de otro período se declare, y que las cinco magnitudes del caso de referencia sean cinco números distintos.
1.0.0 — 2026-08-14
Primera versión distribuible. El proyecto pasa de prototipo con tres interfaces distintas a un producto con una sola interfaz en Android, Windows y navegador.
- Aplicación Android (APK) con Capacitor 7. Empaqueta la misma interfaz que la web.
- Aplicación de Windows con Tauri 2: instalador MSI, instalador NSIS y ejecutable portable.
- Aplicación web / PWA instalable, con service worker y funcionamiento sin conexión, publicada en GitHub Pages.
- Interfaz nueva completa (
apps/web): 10 vistas, sistema de diseño propio, tema claro y oscuro, navegación adaptada a móvil con barra inferior, atajos de teclado y modo impresión. - Arrastre del remanente de crédito fiscal entre períodos (
vatCarryForwardInto). Antes se perdía: la aplicación cobraba un IVA que legalmente no correspondía. - F29 con IVA de documentos. El borrador usa los montos reales registrados en lugar de derivar siempre neto × 19 %, que ignora exenciones, notas de crédito y redondeos del emisor.
- Cálculo de los tres vencimientos del F29 con traslado por fin de semana declarado.
- Trazabilidad de reglas: cada tasa declara
sourceylastVerified, conruleProvenance()para consultarlo. - Exportación e importación de respaldos en un formato común a las tres plataformas, más exportación de operaciones y bitácora a CSV.
- Reapertura de períodos con motivo obligatorio registrado en la bitácora.
- Diagnóstico operativo (
healthCheck) que señala evidencias faltantes y obligaciones vencidas. - Validación de RUT con dígito verificador (módulo 11).
- CLI reescrita en español, con comandos de cálculo y de espacio de trabajo sobre archivos.
- Generador de iconos sin dependencias (
scripts/build-icons.mjs): PNG, ICO y el juego completo de densidades de Android, rasterizados y comprimidos connode:zlib. - Verificador de APK (
scripts/verify-apk.mjs): abre el ZIP y cuenta lo que lleva dentro. - Workflows: CI en Ubuntu y Windows, Android, Windows, Release, Pages y Seguridad (CodeQL + detección de datos reales commiteados). Todas las acciones fijadas a un SHA.
- Manual de usuario ilustrado (
docs/MANUAL.mdydocs/MANUAL.pdf): 17 capítulos, 28 páginas, con las pantallas reales del producto y tres diagramas propios. - Capturas reproducibles (
scripts/capture-screenshots.mjs): la app acepta su estado por URL (?modo=,?tema=,?periodo=,#vista) y las 15 imágenes del manual se regeneran con un comando, así que no envejecen en silencio cuando cambia la interfaz. - Generador de PDF sin dependencias (
scripts/build-manual-pdf.mjs): Markdown → HTML con las imágenes embebidas → impresión con Chrome. - Navegación por URL:
#impuestosabre esa vista directamente, lo que hace funcionar los accesos directos del manifiesto PWA y permite enlazar a una pantalla desde la documentación. - Documentación: README nuevo,
docs/ARCHITECTURE.md, código de conducta, plantillas de incidencia y de pull request, este changelog. - 40 pruebas nuevas (de 10 a 50).
- La aplicación de escritorio no compilaba.
src-tauri/src/lib.rsusabaformat!("{\"id\":\"{}\"}", id)con llaves sin escapar: error de compilación en dos sitios. Nunca se había podido generar un instalador. - La navegación de la app de escritorio no funcionaba: los botones de la barra lateral no tenían ningún manejador asociado.
- Path traversal en el servidor local. La comprobación era
full.startsWith(path.join(__dirname, 'public')), que deja pasar un directorio hermano llamadopublic-privado. Ahora se compara con el separador incluido y hay pruebas en CI. - Se podían borrar operaciones de un período cerrado. El cierre bloqueaba las altas pero no las bajas, de modo que un período "cerrado" podía cambiar de saldo.
- El F29 ignoraba el IVA realmente registrado y lo recalculaba desde el neto.
- El catálogo de trámites de constitución quedaba congelado en los datos: una empresa creada antes de añadir un paso nuevo no lo veía nunca.
- El texto escrito por el usuario se insertaba sin escapar en tablas y bitácora.
- Las cifras desaparecían en las tarjetas estrechas.
table { min-width: 520px }desbordaba cualquier tabla dentro de una tarjeta angosta, y el desplazamiento horizontal escondía justo la columna de montos: el borrador del F29 mostraba los conceptos sin sus importes. El ancho mínimo pasa a aplicarse sólo a las tablas de muchas columnas.
- El servidor local (
apps/empresa-operativa) pasa a servir únicamente archivos estáticos; escucha en127.0.0.1en lugar de en todas las interfaces y envía cabeceras CSP. - El motor de
company-operationsse separó enworkspace.mjs(sinnode:*) más almacenes conectables de memoria, navegador y disco. - El sandbox se siembra con dos meses de operaciones, para que el remanente de crédito fiscal y un IVA no recuperable sean visibles desde el primer arranque.
- Versión unificada en
package.json,tauri.conf.json,Cargo.tomly la aplicación, con una prueba que lo verifica.
apps/contador-webyapps/contador-desktop/ui: dos interfaces paralelas que duplicaban parcialmente la aplicación y ya no compartían su API. La nuevaapps/weblas sustituye en las tres plataformas.- SQLite y
rusqlitedel shell de Windows. Obligaban a mantener dos implementaciones del motor contable —JavaScript y Rust— que acabarían dando resultados distintos. Verdocs/product/WINDOWS-APP.md. MANIFEST.sha256.json: hashes de archivos que en parte ya no existían. La verificación de integridad pasa alSHA256SUMS.txtque acompaña a cada release, que sí se genera con el artefacto que se publica.
- CSP
default-src 'self'en el servidor local y en la aplicación de Windows. - La ventana de Tauri declara únicamente
core:default; todo el acceso a disco pasa por cuatro comandos que validan sus argumentos contra una lista cerrada. - Escritura atómica del espejo en disco (temporal +
rename). - CI verifica que no se hayan commiteado respaldos de contabilidad real, certificados digitales ni claves privadas.
- CI verifica que el motor siga con cero dependencias de producción.
- Motor tributario inicial (IVA, PPM, honorarios, patente municipal, IDPC).
- Separación EMPRESA REAL / SANDBOX con persistencia local por archivos.
- Operaciones, obligaciones, cierre de período, bitácora de auditoría y respaldos.
- Academia: currículo, 16 laboratorios y casos integrales.
- Andamiaje de Tauri para Windows.