Principios
La filosofía que guía cada decisión de diseño, código y producto en el ecosistema CIS.

Manifiesto

Somos la Compañía de Innovación de Santiago SpA, una empresa del Círculo de Santiago SpA. Construimos software que hace tangible lo intangible: ideas, acuerdos, decisiones, firmas, compromisos.

Creemos que la burocracia es código mal escrito — repetitivo, inconsistente, sin tests, propenso a errores humanos. Y creemos que el software bien diseñado puede absorber esa burocracia, dejar libre el pensamiento estratégico, y devolverle a las personas el tiempo que la fricción administrativa les robó.

No construimos herramientas para dominar a los usuarios. Construimos herramientas que disminuyen la distancia entre querer hacer algo y hacerlo. Entre pensar una empresa y constituirla. Entre firmar un acuerdo y que quede legalmente trazable. Entre tener un correo y que quede organizado, respondido, archivado.

Nuestra infraestructura es determinística por default — pipelines versionados, observables, testeables. La inteligencia artificial aparece solo en el borde, donde agrega valor humano: en la redacción, en el juicio, en la creatividad. Nunca en el core operacional.

Nuestra arquitectura es multi-tenant desde el día uno. Todo lo que funciona para nosotros debe poder funcionar para otros. Todo lo que es útil internamente debe poder abrirse al mundo cuando esté listo. No construimos fortalezas privadas — construimos herramientas extensibles.

Y por sobre todo, nos acompañamos con Claudia — la asistente IA que ejecuta los pipelines, responde correos, agenda reuniones, firma documentos, y cuida de nosotros. Claudia no es un producto; es una colega silenciosa que hace que todo lo demás funcione.

Principios de diseño

01

Determinismo primero, AI en el borde

Los pipelines críticos (facturación, firma, contabilidad) son código Python normal, versionado, testeable. La IA solo participa para routing ("¿qué hacer?") y redacción ("¿cómo decirlo?"). Nunca en la ejecución del core.

02

Minimalismo honesto

Cada elemento visible tiene una razón. Si no aporta información ni guía la acción, no está. Los espacios vacíos son tan importantes como los llenos. La claridad vale más que la impresión.

03

Multi-tenant desde el día 1

Cada modelo de datos tiene org_id. Cada endpoint filtra por tenant. Nunca hardcodeamos "el CIS" en código — siempre hay una organización actual. Esto nos deja vender la plataforma sin rewrite.

04

Consistencia > originalidad

Todas las apps del ecosistema CIS (admin, inbox, claudia, status) comparten @cis/ui y core-style. Si un componente no existe en esas libs, lo creamos — no reinventamos en cada app.

05

Accesible por default

Contraste mínimo WCAG AA. Tamaños de fuente ≥14px para texto de UI, ≥16px para contenido. Navegación por teclado completa. Lectores de pantalla soportados con labels semánticos. Dark mode nativo.

06

Observable, auditable, legal

Toda acción privilegiada queda como firma electrónica simple (Ley 19.799). Cada sudo, cada edit, cada envío de DTE, cada firma, generan un receipt verificable públicamente. El audit log es parte del producto, no un afterthought.

07

Bilingüe ES-first

Español es la lengua primaria. Inglés es para nombres técnicos y código. Nunca mezclamos en el mismo componente. El usuario final nunca ve "Save" — ve "Guardar". Los nombres de archivos internos pueden estar en inglés si son convencionales.

08

Los datos pertenecen al usuario

Todo dato del usuario es exportable en formato abierto (CSV, JSON, PDF, ZIP). Ningún vendor lock-in. Si algún día dejamos de mantener la plataforma, el usuario debe poder llevarse sus datos y re-plantarlos en otro sistema.

09

Secretos nunca tocan disco plano

Passwords, tokens, certs digitales, claves SII — todo vive cifrado en el vault Fernet. Nunca en .env, nunca en git, nunca en logs. Leído solo at-runtime, nunca cacheado en memoria global.

10

Errores hablan como humanos

Cuando algo falla, el mensaje dice QUÉ falló, POR QUÉ, y QUÉ HACER. Nunca "Error 500" solo. Nunca stacktraces al usuario final. Nunca jerga técnica sin traducción. Los errores son oportunidades de educar.

Voice & Tone

Cuando la plataforma habla (en mensajes, errores, notificaciones, emails transaccionales), lo hace con estas características:

"El sistema debería sentirse como un colega competente y callado — no como un formulario burocrático, no como una app de marketing, no como una fortaleza empresarial. Como alguien que sabe lo que hace, te dice lo necesario, y sigue trabajando."

Reglas de oro

  1. Nunca hacer esperar sin feedback visible (loading state siempre)
  2. Nunca perder trabajo del usuario sin confirmación (autoguardar cuando posible)
  3. Nunca requerir acción del usuario para cosas que pueden automatizarse
  4. Nunca exponer datos de otro tenant/usuario ni por error
  5. Nunca cobrar por acceder a los datos propios
  6. Nunca ocultar el camino de vuelta (siempre hay un "atrás" visible)
  7. Nunca usar dark patterns (checkbox pre-marcado, triggers de FOMO, scroll infinito sin opt-out)
  8. Nunca romper URLs — si cambia, hacemos redirect permanente