Introducción

¡Bienvenido a Jean d’Arc.

Esta es la documentación técnica del ecosistema Nostromo.

Aquí se describen:

Arquitectura del sistema
Decisiones de diseño
Modelos de datos
Flujos operativos
Convenciones y estándares

El objetivo es servir como referencia técnica para desarrollo, operación y mantenimiento de las plataformas financieras y administrativas del sistema.

🧭 Mapa del Ecosistema

Explora los pilares fundamentales de nuestra plataforma:

Sistema Contable El corazón financiero. Motor de remuneraciones, cumplimiento tributario (SII) y leyes sociales chilenas.

Sevastopol (Frontend) La experiencia de usuario. Arquitectura de Islas con SolidJS y Astro, optimizada para velocidad y reactividad.

Orchestrator (Backend) El cerebro de operaciones. API Node.js/Express, gestión multi-tenant y lógica de negocio core.

Arquitectura El plano maestro. Diagramas de flujo, modelos de datos y decisiones de diseño de alto nivel.

🎯 Nuestro Propósito

En un ecosistema complejo como Nostromo, la claridad es poder. Esta documentación tiene misiones críticas:

Single Source of Truth (SSOT): Eliminar ambigüedades. Si está escrito aquí, es la regla. Si el código dice otra cosa, es un bug (o la doc necesita update).
Onboarding Acelerado: Permitir que nuevos ingenieros entiendan el “por qué” y el “cómo” sin necesidad de largas sesiones de shadowing.
Estandarización: Definir patrones claros para APIs, estructuras de bases de datos y componentes UI.

🚀 Primeros Pasos

Para navegar eficientemente:

Usa la Barra Lateral 👈 para recorrer los módulos secuencialmente.
Presiona Ctrl + K (o Cmd + K) para activar la Búsqueda Rápida ⚡ y saltar a cualquier tema.
Revisa la sección de Arquitectura si necesitas entender la “big picture” antes de entrar en detalles.