# 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 |