Diagramas Mermaid (Floutic)

Arquitectura de servicios (docker-compose)

Notas rápidas:

• Redes: web (externa) y internal (servicios Floutic).
• frontend monta docker-volumes/frontend/node_modules; backend se monta en /app.
• openobserve, mailpit y docs están definidos en docker-compose.yml (opcionales según entorno).

Flujo operativo del agente (OpenAgent)

Claves:

• Regla crítica docker_only: nunca ejecutar npm/pip/python/pytest en host; usar docker compose exec o scripts.
• Contextos requeridos: ai/context/project/01-infrastructure.md a 04-workflow.md + 99-skills-ref.md.
• Skills autoinvocadas según acción (Tailwind, Zod, FastAPI, etc.).

Pipeline de validación en Docker

Notas:

• test_backend.sh arranca Redis si no está corriendo y usa docker compose run backend con ENVIRONMENT=test.
• test_frontend_unit.sh ejecuta Vitest via docker compose run frontend.
• test_frontend_security.sh mantiene rate limiting activo y corre specs de seguridad (tests/security-headers-cors.spec.ts, etc.).
• test_e2e.sh aplica overrides en .env, recrea backend/frontend, ejecuta clean_and_seed.py y corre Playwright (workers=1 por defecto).

Fuentes: docker-compose.yml, scripts en ./scripts, guías AGENTS*.md y configuración de agentes en .opencode/agent/openagent.md.