CRISALI Engineering

Building the CRISALI Platform

Engineering Dashboard

Centro oficial de diseño, arquitectura, documentación y desarrollo de CRISALI Platform.

Foundation progress: 46%

🧩

CORE

Usuarios, roles, permisos, tenants, auditoría, archivos y catálogos.

Diseño

🌎

Commerce Workspace

VUCEM, MVE, COVE, eDocument, acuses y expediente digital.

Prioridad alta

🔐

Chilkat

Firma, XML, SOAP, certificados y acuses.

Aprobado

🗄

PostgreSQL

Base principal del sistema. No SQLite en producción.

Decidido

Últimas decisiones

Clave	Decisión	Estado
ADR-0001	Chilkat como motor oficial de firma/SOAP/XML.	Aprobada
ADR-0003	eDocument normaliza PDFs a 300 DPI.	Aprobada
TECH-0001	PostgreSQL + FastAPI + React/Vite.	Aprobada

CORE

Usuarios, organizaciones, roles, permisos, catálogos, auditoría y servicios compartidos.

CRISALI CORE

El CORE será compartido por todos los workspaces: Commerce, DOT, Warehouse, CRM, Accounting, IA y futuros módulos.

Identity

Usuarios
Roles
Permisos
Sesiones JWT

Enterprise

Tenants
Organizaciones
Sucursales
Dominios

Shared

Archivos
Catálogos
Scheduler
IA/OCR

Commerce Workspace

Comercio Exterior: VUCEM, Manifestación de Valor, COVE, eDocument y Expediente Digital.

Operación como entidad principal

Operación → Importador → Proveedor → Factura → Mercancías → Documentos → MVE → COVE → eDocument → Acuses → Timeline → Expediente

MVE

Manifestación de Valor Electrónica.

COVE

Acuse, PDF interno y PDF oficial.

eDocument

PDF original, 300 DPI, hash y OCR.

Scheduler

Descarga nocturna de PDF oficiales.

Architecture

Estructura general de CRISALI Platform y sus workspaces.

Workspaces

CORE
Commerce
Aduanas
Warehouse
DOT / Safety
CRM
Accounting
AI

Regla: nada se programa si no está diseñado en Engineering.

Database

Modelo maestro de datos, convenciones, tablas, índices y PostgreSQL.

Stack DB

PostgreSQL será la base de datos principal. SQLite queda descartado para producción.

Grupo	Tablas
CORE	tenants, organizations, users, roles, permissions, audit_logs
Commerce	operations, mve, coves, edocuments, acuses, timeline
Shared	files, catalogs, scheduler_jobs, notifications

Catalogs

Catálogos maestros compartidos por todos los módulos.

Catálogos principales

Comercio Exterior

Unidades COVE
Tipos eDocument
Incoterms
Monedas
Aduanas
Patentes

Geográficos

Países
Estados
Ciudades
ZIP / CP
Counties USA

Administrativos

Estatus operación
Tipos archivo
Roles entidad
Prioridades

APIs

REST, SOAP, XML, JWT, OpenAI y conectores.

APIs oficiales

API	Uso
CORE API	Login, usuarios, permisos, catálogos.
Commerce API	Operaciones, MVE, COVE, eDocument.
Chilkat API	Firma, XML, SOAP, acuses.
AI API	OCR, clasificación, extracción, resumen.

Chilkat

Motor oficial de firma, XML, SOAP, certificados y acuses.

Chilkat Architecture

Firma XML cuando el trámite lo requiera.
Manejo de certificados en backend seguro.
Envío SOAP a VUCEM.
Consulta y descarga de acuses.
Bitácora completa de errores.

ADR-0001 aprobado: Chilkat es componente oficial para VUCEM.

Scheduler

Tareas nocturnas, mantenimiento, reintentos y descargas oficiales.

Scheduler CRISALI

Hora	Tarea
22:00	Consultar PDF oficiales después de 24 horas.
22:05	Descargar acuses y XML.
22:10	Respaldar documentos.
22:30	Enviar resumen de mantenimiento.

AI / OCR

OpenAI, OCR, clasificación, extracción y asistentes.

AI Services

Lectura de facturas.
OCR de PDF.
Clasificación de documentos.
Extracción de datos para MVE/COVE.
Asistente de preguntas VUCEM.

Knowledge Base

Ley Aduanera, RGCE, SAT, ANAM, FAQs, casos y errores.

Engineering Knowledge

Base de conocimiento interna y pública para SEO.

VUCEM
Manifestación de Valor
COVE
eDocument
Ley Aduanera
RGCE
SAT / ANAM

Engineering Handbook

Estándares, convenciones, seguridad, versionado y despliegue.

Handbook

Convenciones de tablas.
Convenciones de API.
Reglas de seguridad.
Versionado semántico.
Checklist de release.
Pruebas mínimas antes de producción.

Releases

Control formal de versiones.

Release History

Versión	Descripción
1.0.0	Foundation Release de CRISALI Platform.
1.1.0	Identidad CRISALI Engineering y dashboard profesional.
1.1.1	Navegación sin refresh usando secciones internas.

Roadmap

Ruta de construcción del sistema.

Roadmap

Fase	Objetivo	Estado
1	Foundation	En curso
2	CORE PostgreSQL	Siguiente
3	Login y permisos	Pendiente
4	Commerce Workspace	Pendiente

External Services

OpenAI, Chilkat, Let's Encrypt, VUCEM, SAT, ANAM y SMTP.

Servicios Externos

Servicio	Uso	Control
Chilkat	Firma, SOAP, XML	Licencia / versión
OpenAI	IA y OCR	API key / costos
Let's Encrypt	SSL	Renovación
VUCEM/SAT/ANAM	Servicios oficiales	Disponibilidad