131 lines
4.0 KiB
Markdown
131 lines
4.0 KiB
Markdown
# 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 |
|