OPS Technical Documentation

Este portal es la documentacion tecnica interna de OPS: arquitectura, configuracion, runbooks, decisiones operativas, salvaguardas y estado del proyecto.

Debe servir para que alguien pueda entender como esta construido el sistema, como se despliega, como se mantiene y que decisiones importantes ya estan tomadas.

Regla De Separacion

  • El portal publico de usuario explica que es OPS, por que usarlo y como trabajar con el.
  • Este portal tecnico explica como funciona por dentro, como se opera y que riesgos o contratos hay que respetar.
  • La documentacion sensible o de mantenimiento no debe publicarse en el portal de usuarios.

Lectura Tecnica Recomendada

  1. Indice general del repo docs
  2. Estado actual del proyecto
  3. Arquitectura multitenant
  4. Contrato operativo SaaS
  5. Asistente OPS
  6. Razonamiento estricto del asistente
  7. Sistema de temas
  8. Conectores MCP y Flowtitude
  9. Deploy
  10. Build y publicacion de docs
  11. MVP local: asistente para desarrollo web

Areas

  • Arquitectura: contratos, modulos, multitenancy, asistente, temas y conectores.
  • Runbooks: despliegue, backup, dispatch, incidentes y configuraciones.
  • Desarrollo: setup local, migraciones y contratos API.
  • Operacion: estado actual, auditorias, salvaguardas y procedimientos diarios.