docs: inicializar estructura de documentacion de agentes

2026-10-12 19:28:02 -05:00
commit 6ea00e4ec5
8 changed files with 3025 additions and 0 deletions
@@ -0,0 +1,130 @@
+# agents.md — Punto de entrada del proyecto
+
+> **Reglas:**
+> - Este archivo es el eslabón más importante. Leerlo siempre antes de cualquier tarea.
+> - Cada cambio significativo debe reflejarse en este archivo y en los demás archivos del índice.
+> - Debe ser técnico, claro y detallado para que cualquier humano, agente o IA lo entienda sin explicaciones previas.
+> - **"carga proyecto"** = Leer este archivo (agents.md) para comprender las reglas, stack, rutas y objetivos del proyecto.
+> - **"actualizar proyecto"** = hacer commit de los cambios pendientes, actualizar `agents.md` y `.agente/proyecto_estructura.md` con el árbol de archivos actual.
+
+---
+
+## Antecedentes
+
+[COMPLETAR — contexto del problema que resuelve este proyecto, por qué existe dentro del ecosistema Telcotronics]
+
+---
+
+## Objetivo general
+
+[COMPLETAR — qué hace el sistema y cuáles son sus responsabilidades principales]
+
+1. [COMPLETAR — responsabilidad 1]
+2. [COMPLETAR — responsabilidad 2]
+
+---
+
+## Stack técnico
+
+| Componente | Tecnología |
+|---|---|
+| Lenguaje | Go |
+| Framework | [COMPLETAR] |
+| Base de datos | [COMPLETAR] |
+| [Otros] | [COMPLETAR] |
+
+---
+
+## Módulos del sistema
+
+### 1. [Nombre del módulo]
+**Estado: ⏳ Pendiente**
+
+[Descripción del módulo]
+
+---
+
+## Infraestructura (referencia rápida)
+
+> ⚠️ La infraestructura es compartida por todo el ecosistema Telcotronics
+> (sigma-robot, sigma-web, sigma-c, sigmac_app, CRM, ERP y otros).
+> La fuente de verdad es **`mcp.telcotronics.net`** — actualmente 🔧 **en mantenimiento**.
+> Mientras esté en mantenimiento, la fuente alternativa es `/home/pablinux/Projects/infraestructura.md`.
+> No editar `.agente/infraestructura.md` directamente — ver protocolo de sincronización.
+
+| Parámetro | Valor |
+|---|---|
+| Dominio público | [COMPLETAR] |
+| Puerto interno | [COMPLETAR] |
+| Servicio systemd | [COMPLETAR] |
+| BD principal | [COMPLETAR] |
+| MCP ecosistema | `mcp.telcotronics.net` 🔧 en mantenimiento |
+
+> **Correo del ecosistema:** usar `no-reply@sigmac.app` con contraseña `Sigma.2030@`
+> vía `smtp.sigmac.app:587` (STARTTLS). Desde LAN interna usar `192.168.10.111:587`.
+> Credenciales disponibles en `.agente/infraestructura.md` — sección servidor-email.
+
+> Para el detalle completo y datos del ecosistema ver `.agente/infraestructura.md`.
+
+## Documentos del ecosistema (referencia)
+
+> Estos documentos viven en `/home/pablinux/Projects/` y son la fuente de verdad del ecosistema.
+> **No duplicar su contenido aquí** — referenciarlos.
+
+| Documento | Descripción |
+|---|---|
+| `~/Projects/design-system.md` | Sistema de diseño unificado — colores, tipografía, componentes para Flutter / Vue / Java / PHP |
+| `~/Projects/roadmap.md` | Hoja de ruta estratégica — decisiones técnicas tomadas y pendientes de ejecutar |
+| `~/Projects/infraestructura.md` | Arquitectura completa de servidores, red, CTs y servicios del ecosistema |
+| `~/Projects/prompt_actualizacion.md` | Protocolo de actualización — registrar objetivos, documentar sesiones, sincronizar |
+
+---
+
+## Variables de entorno (`.env`)
+
+| Variable | Descripción |
+|---|---|
+| [COMPLETAR] | [COMPLETAR] |
+
+---
+
+## Migraciones
+
+Runner: `[COMPLETAR]`
+
+| Archivo | Tabla principal | Estado |
+|---|---|---|
+| — | — | — |
+
+---
+
+## Para arrancar en local
+
+```bash
+# [COMPLETAR — pasos mínimos para correr el proyecto]
+```
+
+---
+
+## Índice de archivos del proyecto
+
+```
+app_compartir/
+├── README.md
+├── agents.md                            # ← LEER PRIMERO
+└── .agente/
+    ├── infraestructura.md               # Ecosistema — espejo del global
+    ├── proyecto_estructura.md           # Árbol de archivos y rutas
+    ├── proyecto_memoria.md              # Decisiones técnicas e historial
+    ├── proyecto_errores.md              # Registro de errores
+    ├── objetivos.md                     # Qué debe cumplirse (sin fecha)
+    └── ideas.md                         # Posibilidades sin compromiso
+```
+
+---
+
+## Estado global del proyecto
+
+| Módulo | Estado |
+|---|---|
+| [COMPLETAR] | ⏳ Pendiente |