rckrdmrd/workspace-v1
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(workspace): Add new projects and update architecture

Browse Source 
New projects created:
- michangarrito (marketplace mobile)
- template-saas (SaaS template)
- clinica-dental (dental ERP)
- clinica-veterinaria (veterinary ERP)

Architecture updates:
- Move catalog from core/ to shared/
- Add MCP servers structure and templates
- Add git management scripts
- Update SUBREPOSITORIOS.md with 15 new repos
- Update .gitignore for new projects

Repository infrastructure:
- 4 main repositories
- 11 subrepositorios
- Gitea remotes configured

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
rckrdmrd 2026-01-07 04:43:28 -06:00
parent ff3038f183
commit cb4c0681d3
189 changed files with 16218 additions and 13809 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

28
.gitignore vendored
View File

@ -181,6 +181,22 @@ backups/
# Backup de gamilit (submodule migration)
projects/gamilit.bak.*/
# -----------------------------------------------------------------------------
# MCP SERVERS - Repositorios independientes
# -----------------------------------------------------------------------------
# Los MCP servers internos son repositorios independientes que se clonan
# manualmente despues de clonar workspace-v1.
# Ver core/mcp-servers/_registry.yml para lista completa e instrucciones.
# -----------------------------------------------------------------------------
core/mcp-servers/internal/rag-knowledge/
core/mcp-servers/internal/scrum-taiga/
# Mantener estructura base (README, registry, templates)
!core/mcp-servers/README.md
!core/mcp-servers/_registry.yml
!core/mcp-servers/internal/.gitkeep
!core/mcp-servers/external/
!core/mcp-servers/templates/
# -----------------------------------------------------------------------------
# SUBREPOSITORIOS - Proyectos con repositorios independientes en Gitea
# -----------------------------------------------------------------------------
@ -189,6 +205,7 @@ projects/gamilit.bak.*/
#
# NOTA: gamilit NO se ignora porque es un submodulo Git (ver .gitmodules)
# -----------------------------------------------------------------------------
# ERP Family
projects/erp-suite/
projects/erp-core/
projects/erp-construccion/
@ -196,7 +213,18 @@ projects/erp-clinicas/
projects/erp-retail/
projects/erp-mecanicas-diesel/
projects/erp-vidrio-templado/
# Trading & Analytics
projects/trading-platform/
projects/betting-analytics/
projects/inmobiliaria-analytics/
projects/platform_marketing_content/
# Nuevos proyectos (2026-01-07)
projects/michangarrito/
projects/template-saas/
projects/clinica-dental/
projects/clinica-veterinaria/
# Gitea token (no commitear)
.gitea-token

102
SUBREPOSITORIOS.md
View File

@ -1,7 +1,7 @@
# Subrepositorios del Workspace
**Fecha:** 2025-01-04
**Version:** 1.1
**Fecha:** 2026-01-07
**Version:** 1.3
---
@ -97,6 +97,15 @@ Estos proyectos SI pueden tener subrepositorios para sus apps (backend, frontend
| **inmobiliaria-analytics** | `projects/inmobiliaria-analytics` | `http://72.60.226.4:3000/rckrdmrd/inmobiliaria-analytics.git` |
| **platform_marketing_content** | `projects/platform_marketing_content` | `http://72.60.226.4:3000/rckrdmrd/platform_marketing_content.git` |
### Proyectos Nuevos (2026-01-07)
| Proyecto | Path Local | Repositorio | Subrepositorios |
|----------|------------|-------------|-----------------|
| **michangarrito** | `projects/michangarrito` | `http://72.60.226.4:3000/rckrdmrd/michangarrito.git` | backend, frontend, mobile, database, mcp-server, whatsapp |
| **template-saas** | `projects/template-saas` | `http://72.60.226.4:3000/rckrdmrd/template-saas.git` | backend, frontend, database |
| **clinica-dental** | `projects/clinica-dental` | `http://72.60.226.4:3000/rckrdmrd/clinica-dental.git` | database |
| **clinica-veterinaria** | `projects/clinica-veterinaria` | `http://72.60.226.4:3000/rckrdmrd/clinica-veterinaria.git` | database |
### Estructura con Subrepositorios (para proyectos Gitea)
Los proyectos en Gitea pueden usar esta estructura de subrepositorios:
@ -207,4 +216,93 @@ git -C /home/isem/workspace-v1/projects/gamilit status
---
## Estado Actual de Repositorios en Gitea
### Repositorios Existentes (2026-01-04)
| Repositorio | Tipo | Estado |
|-------------|------|--------|
| workspace | Principal | Activo |
| workspace-v1 | Principal | Activo |
| erp-construccion-backend | Subrepositorio | Activo |
| erp-construccion-frontend-web | Subrepositorio | Activo |
| erp-construccion-frontend-mobile | Subrepositorio | Activo |
| erp-construccion-database | Subrepositorio | Activo |
| erp-mecanicas-diesel-backend | Subrepositorio | Activo |
| erp-mecanicas-diesel-frontend-web | Subrepositorio | Activo |
| erp-mecanicas-diesel-database | Subrepositorio | Activo |
| erp-core-backend | Subrepositorio | Activo |
| erp-core-frontend-web | Subrepositorio | Activo |
| erp-core-database | Subrepositorio | Activo |
### Repositorios Creados (2026-01-07)
Los siguientes repositorios fueron creados via API:
| Repositorio | Tipo | Estado |
|-------------|------|--------|
| michangarrito | Principal | ✅ Creado |
| michangarrito-backend | Subrepositorio | ✅ Creado |
| michangarrito-frontend | Subrepositorio | ✅ Creado |
| michangarrito-mobile | Subrepositorio | ✅ Creado |
| michangarrito-database | Subrepositorio | ✅ Creado |
| michangarrito-mcp-server | Subrepositorio | ✅ Creado |
| michangarrito-whatsapp | Subrepositorio | ✅ Creado |
| template-saas | Principal | ✅ Creado |
| template-saas-backend | Subrepositorio | ✅ Creado |
| template-saas-frontend | Subrepositorio | ✅ Creado |
| template-saas-database | Subrepositorio | ✅ Creado |
| clinica-dental | Principal | ✅ Creado |
| clinica-dental-database | Subrepositorio | ✅ Creado |
| clinica-veterinaria | Principal | ✅ Creado |
| clinica-veterinaria-database | Subrepositorio | ✅ Creado |
### Repositorios Pendientes de Crear
Los siguientes repositorios principales necesitan crearse via API o web de Gitea:
- erp-suite (principal)
- erp-core (principal)
- erp-construccion (principal)
- erp-clinicas (principal)
- erp-retail (principal)
- erp-mecanicas-diesel (principal)
- erp-vidrio-templado (principal)
- trading-platform (principal)
- betting-analytics (principal)
- inmobiliaria-analytics (principal)
- platform-marketing-content (principal)
---
## Scripts de Gestion
### Crear repositorios en Gitea
```bash
# Requiere token de API de Gitea
./scripts/create-gitea-repos-api.sh <GITEA_TOKEN>
# Para obtener el token:
# 1. Ir a http://72.60.226.4:3000/rckrdmrd
# 2. Settings -> Applications -> Generate New Token
# 3. Dar permisos de 'repo' y 'write:repository'
```
### Push de todos los proyectos
```bash
# Despues de crear los repositorios
./scripts/push-all-projects.sh
```
### Configurar repositorios locales
```bash
# Configura remotes en cada proyecto
./scripts/create-gitea-repos.sh
```
---
*Generado por NEXUS v3.4 - Sistema de Orquestacion*

2
control-plane/manifests/repos.manifest.yml
View File

@ -155,7 +155,7 @@ repositories:
shared-libs:
type: "shared"
description: "Librerias compartidas"
path: "shared/libs/"
path: "shared/catalog/"
status: "planned"
packages:
- "@workspace/auth"

186
core/README.md
View File

@ -1,119 +1,127 @@
# Core - Núcleo de la Fábrica de Software
# Core - Arquitectura del Workspace
## Descripción
**Version:** 2.0.0
**Actualizado:** 2026-01-04
El directorio `core/` contiene todo lo que se comparte a nivel de **fábrica**, no de proyecto individual:
## Descripcion
- Sistema de orquestación de agentes
- Módulos de código reutilizables
- Estándares técnicos y de negocio
- Directivas globales para agentes/subagentes
- Constantes y tipos universales
El directorio `core/` contiene la **arquitectura central del workspace**: sistema de orquestacion, MCP servers, y herramientas de ambiente. NO contiene codigo de aplicacion ni recursos compartidos (esos estan en `shared/`).
## Estructura
```
core/
├── modules/ # Código compartido ejecutable
│ ├── utils/ # Utilidades universales ✅
│ │ ├── date.util.ts # Manipulación de fechas
│ │ ├── string.util.ts # Manipulación de strings
│ │ ├── validation.util.ts # Validaciones
│ │ └── index.ts
│ ├── auth/ # Autenticación (por implementar)
│ ├── billing/ # Facturación
│ ├── notifications/ # Notificaciones
│ ├── payments/ # Pagos
│ └── multitenant/ # Multi-tenancy
├── README.md # Este archivo
│
├── constants/ # Constantes globales ✅
│ ├── enums.constants.ts # Enums universales
│ ├── regex.constants.ts # Patrones regex
│ └── index.ts
├── mcp-servers/ # MCP Servers para el workspace
│ ├── internal/ # Servidores MCP internos
│ ├── external/ # Referencias a servidores externos
│ ├── templates/ # Templates para crear nuevos MCP servers
│ └── _registry.yml # Registro de servidores disponibles
│
├── types/ # Tipos TypeScript compartidos ✅
│ ├── api.types.ts # Tipos de API
│ ├── common.types.ts # Tipos comunes
│ └── index.ts
├── orchestration/ # Sistema NEXUS/SIMCO de orquestacion
│ ├── agents/ # Perfiles de agentes
│ │ ├── perfiles/ # Perfiles ligeros SIMCO
│ │ └── legacy/ # Prompts legacy (referencia)
│ ├── directivas/ # Directivas por operacion
│ │ ├── simco/ # Sistema SIMCO
│ │ ├── legacy/ # Directivas legacy
│ │ └── _MAP.md
│ ├── referencias/ # ALIASES.yml y referencias
│ ├── templates/ # Templates de documentacion
│ ├── auditorias/ # Auditorias arquitectonicas
│ ├── impactos/ # Matrices de impacto
│ ├── inventarios/ # Inventarios de deployment
│ ├── procesos/ # Guias de procesos
│ ├── deployment/ # Arquitectura de deployment
│ ├── claude/ # Configuraciones Claude
│ └── _historico/ # Documentos archivados
│
├── catalog/ # Documentación de funcionalidades
│ ├── auth/
│ ├── notifications/
│ └── ...
│
├── orchestration/ # Sistema de agentes NEXUS
│ ├── agents/
│ ├── directivas/
│ ├── templates/
│ └── referencias/
│
└── standards/ # Estándares técnicos globales
├── CODING-STANDARDS.md
├── TESTING-STANDARDS.md
└── ...
└── devtools/ # Herramientas de ambiente
└── environment/ # Configuracion de ambientes
├── scripts/ # Scripts de setup
├── templates/ # Templates .env
└── DEV-ENVIRONMENT-REGISTRY.yml
```
## Que NO esta en core/
Los siguientes elementos fueron movidos a `shared/`:
| Elemento | Nueva ubicacion |
|----------|-----------------|
| catalog/ | `shared/catalog/` |
| modules/ | `shared/modules/` |
| constants/ | `shared/constants/` |
| types/ | `shared/types/` |
| standards/ | `shared/knowledge-base/standards/` |
## Uso
### Importar Utilidades
### MCP Servers
```typescript
// En cualquier proyecto del workspace
import { formatDate, slugify, isEmail } from '@core/modules/utils';
```bash
# Ver servidores disponibles
cat core/mcp-servers/_registry.yml
// O importar específico
import { formatToISO, addDays } from '@core/modules/utils/date.util';
# Crear nuevo servidor MCP interno
cp -r core/mcp-servers/templates/TEMPLATE-MCP-INTERNO core/mcp-servers/internal/mi-servidor
```
### Importar Constantes
### Sistema de Orquestacion
```typescript
import { UserStatus, PaymentStatus } from '@core/constants';
import { EMAIL_REGEX, UUID_REGEX } from '@core/constants/regex.constants';
Los agentes cargan automaticamente las directivas de `core/orchestration/directivas/` al inicializar.
```markdown
# Inicializacion de agente
1. Leer core/orchestration/directivas/simco/_INDEX.md
2. Leer core/orchestration/directivas/principios/*.md
3. Cargar perfil desde core/orchestration/agents/perfiles/
4. Leer ALIASES.yml para navegacion
```
### Importar Tipos
### Herramientas de Ambiente
```typescript
import { ApiResponse, PaginatedResponse } from '@core/types';
import { BaseEntity, Address } from '@core/types/common.types';
```bash
# Validar ambiente de un proyecto
./core/devtools/environment/scripts/validate-environment.sh /path/to/project
# Setup de ambiente
./core/devtools/environment/scripts/setup-project-env.sh /path/to/project
```
## Módulos Disponibles
## Relacion con otras carpetas
### Utils (`@core/modules/utils`)
```
workspace-v1/
├── core/ # ARQUITECTURA (este directorio)
│ └── orchestration/ # Sistema SIMCO/NEXUS
│
├── shared/ # RECURSOS COMPARTIDOS
│ ├── catalog/ # Funcionalidades reutilizables
│ ├── modules/ # Codigo ejecutable
│ ├── constants/ # Constantes globales
│ ├── types/ # Tipos TypeScript
│ └── knowledge-base/ # Documentacion
│
├── control-plane/ # GOVERNANCE
│ ├── registries/ # Puertos, dominios, BDs
│ ├── manifests/ # Configuraciones de repos
│ └── devtools/ # CI/CD, Docker
│
├── orchestration/ # DIRECTIVAS A NIVEL WORKSPACE (hereda de core/)
│
└── projects/ # PROYECTOS DE PRODUCTO
```
| Archivo | Funciones | Descripción |
|---------|-----------|-------------|
| `date.util.ts` | formatDate, addDays, diffInDays, etc. | Manipulación de fechas |
| `string.util.ts` | slugify, capitalize, truncate, etc. | Manipulación de strings |
| `validation.util.ts` | isEmail, isUUID, isStrongPassword, etc. | Validaciones |
## Ver Tambien
### Constants (`@core/constants`)
- [Sistema de Orquestacion](orchestration/README.md)
- [MCP Servers](mcp-servers/README.md)
- [Recursos Compartidos](../shared/README.md)
- [Catalogo de Funcionalidades](../shared/catalog/README.md)
| Archivo | Contenido |
|---------|-----------|
| `enums.constants.ts` | UserStatus, PaymentStatus, NotificationType, etc. |
| `regex.constants.ts` | EMAIL_REGEX, UUID_REGEX, PHONE_REGEX, etc. |
---
### Types (`@core/types`)
| Archivo | Tipos |
|---------|-------|
| `api.types.ts` | ApiResponse, PaginatedResponse, ErrorCodes |
| `common.types.ts` | BaseEntity, Address, Money, Result |
## Proyectos que Usan Core
- **Gamilit** - Plataforma educativa de gamificación
- **Trading Platform** - OrbiQuant IA trading
- **ERP Suite** - Sistema ERP multi-vertical
## Sistema de Orquestación
Los agentes cargan automáticamente las directivas de `core/orchestration/directivas/` al inicializar.
## Ver También
- [Sistema de Orquestación](orchestration/README.md)
- [Catálogo de Funcionalidades](catalog/README.md)
- [Plan de Organización](../PLAN-ORGANIZACION-WORKSPACE.md)
**Mantenido por:** Tech-Leader
**Ultima actualizacion:** 2026-01-04

228
core/mcp-servers/README.md Normal file
View File

@ -0,0 +1,228 @@
# MCP Servers
**Version:** 1.0.0
**Fecha:** 2026-01-04
**Sistema:** NEXUS v3.4 + SIMCO
---
## Proposito
Esta carpeta contiene la infraestructura para MCP (Model Context Protocol) servers del workspace. Los MCP servers proporcionan herramientas especializadas para agentes de IA.
---
## Estructura
```
mcp-servers/
├── README.md # Este archivo
├── _registry.yml # Registro central de MCP servers
│
├── internal/ # MCP servers desarrollados internamente
│ ├── .gitkeep
│ ├── rag-knowledge/ # [REPO INDEPENDIENTE] Sistema RAG
│ └── scrum-taiga/ # [REPO INDEPENDIENTE] Integracion Taiga
│
├── external/ # MCP servers de terceros
│ ├── .gitkeep
│ └── _sources.yml # Fuentes confiables
│
└── templates/ # Templates para nuevos MCP
└── TEMPLATE-MCP-INTERNO/
```
---
## Arquitectura: Repositorios Independientes
Los MCP servers internos son **repositorios independientes** (NO submodules):
| Caracteristica | Valor |
|----------------|-------|
| Versionado | Independiente del workspace |
| Dependencias | Propias (node_modules excluidos) |
| Desarrollo | Ciclo de vida propio |
| Clonacion | Manual despues de workspace |
### Por que NO son submodules?
1. **Flexibilidad:** Pueden actualizarse sin afectar workspace
2. **Desarrollo independiente:** Equipos pueden trabajar en paralelo
3. **Reutilizacion:** Pueden usarse en otros contextos
4. **Simplicidad:** Sin complejidad de submodules anidados
---
## MCP Servers Disponibles
### Internos (Desarrollo Propio)
| MCP Server | Descripcion | Prioridad | Estado |
|------------|-------------|-----------|--------|
| **rag-knowledge** | Sistema RAG como fuente de verdad | MAXIMA | Planificado |
| **scrum-taiga** | Integracion con Taiga SCRUM | ALTA | Planificado |
### Externos (Terceros)
Ver `external/_sources.yml` para fuentes confiables de MCP servers externos.
---
## Instalacion
### 1. Requisitos Previos
- workspace-v1 clonado
- SSH configurado para Gitea (ver `orchestration/referencias/REPOSITORY-STRUCTURE.md`)
- Node.js >= 18
### 2. Clonar MCP Servers
```bash
# Navegar a carpeta de MCP internos
cd /home/isem/workspace-v1/core/mcp-servers/internal
# Clonar RAG Knowledge Base (recomendado para desarrollo)
git clone git@gitea-server:rckrdmrd/mcp-rag-knowledge.git rag-knowledge
# Clonar SCRUM Taiga (opcional)
git clone git@gitea-server:rckrdmrd/mcp-scrum-taiga.git scrum-taiga
```
### 3. Instalar Dependencias
```bash
# RAG Knowledge
cd rag-knowledge
npm install
cp .env.example .env
# Configurar .env con credenciales
# SCRUM Taiga
cd ../scrum-taiga
npm install
cp .env.example .env
# Configurar .env con credenciales Taiga
```
### 4. Verificar Instalacion
```bash
# Desde workspace-v1
cd /home/isem/workspace-v1
# Verificar estructura
ls -la core/mcp-servers/internal/
# Verificar que MCP servers responden
cd core/mcp-servers/internal/rag-knowledge
npm run health-check
```
---
## Desarrollo de Nuevos MCP
### Usar Template
```bash
# Copiar template
cp -r templates/TEMPLATE-MCP-INTERNO nuevo-mcp-server
# Personalizar
cd nuevo-mcp-server
# Editar package.json, README.md, etc.
```
### Directivas a Seguir
| Directiva | Proposito |
|-----------|-----------|
| @SIMCO_MCP | Desarrollo de MCP servers |
| @SIMCO_MCP_IMPORT | Importacion de MCP externos |
| @SIMCO_RAG | Interaccion con sistema RAG |
### Registrar en _registry.yml
Despues de crear un nuevo MCP server, agregarlo a `_registry.yml`:
```yaml
mcp_servers:
internal:
nuevo-mcp:
name: "Nombre del MCP"
description: "Descripcion"
status: "development"
repository:
url: "git@gitea-server:rckrdmrd/mcp-nuevo.git"
# ...
```
---
## Perfiles de Agentes Relacionados
| Perfil | Responsabilidad |
|--------|-----------------|
| @PERFIL_MCP_ARCHITECT | Diseno e integracion de MCP |
| @PERFIL_MCP_DEVELOPER | Desarrollo de MCP internos |
| @PERFIL_MCP_INTEGRATOR | Importacion de MCP externos |
| @PERFIL_RAG_ENGINEER | Mantenimiento del RAG |
---
## Aliases Utiles
```yaml
@MCP_SERVERS: "core/mcp-servers/"
@MCP_REGISTRY: "core/mcp-servers/_registry.yml"
@MCP_RAG: "core/mcp-servers/internal/rag-knowledge/"
@MCP_TAIGA: "core/mcp-servers/internal/scrum-taiga/"
```
---
## Troubleshooting
### MCP server no clonado
```bash
# Verificar SSH
ssh -T gitea-server
# Si falla, verificar ~/.ssh/config
cat ~/.ssh/config | grep gitea
```
### Dependencias faltantes
```bash
# Reinstalar
cd core/mcp-servers/internal/rag-knowledge
rm -rf node_modules
npm install
```
### Variables de entorno
```bash
# Verificar .env existe
ls -la .env
# Verificar variables requeridas
cat .env.example
```
---
## Referencias
- `_registry.yml` - Registro completo de MCP servers
- `orchestration/directivas/simco/SIMCO-MCP.md` - Directiva de desarrollo
- `orchestration/referencias/REPOSITORY-STRUCTURE.md` - Estructura de repos
---
**Mantenido por:** @PERFIL_MCP_ARCHITECT
**Sistema:** NEXUS v3.4 + SIMCO

172
core/mcp-servers/_registry.yml Normal file
View File

@ -0,0 +1,172 @@
# MCP Servers Registry
# ====================
# Registro central de todos los MCP servers del workspace
#
# Version: 1.0.0
# Fecha: 2026-01-04
# Sistema: NEXUS v3.4 + SIMCO
version: "1.0.0"
last_updated: "2026-01-04"
maintainer: "@PERFIL_MCP_ARCHITECT"
# ============================================================================
# MCP SERVERS INTERNOS
# ============================================================================
# Desarrollados internamente para necesidades especificas del workspace
# Cada uno es un repositorio independiente que se clona manualmente
mcp_servers:
internal:
# -------------------------------------------------------------------------
# RAG Knowledge Base - PRIORIDAD MAXIMA
# -------------------------------------------------------------------------
rag-knowledge:
name: "RAG Knowledge Base"
description: |
Sistema RAG (Retrieval-Augmented Generation) como fuente de verdad
del workspace. Proporciona busqueda semantica sobre documentacion,
directivas, perfiles y codigo.
status: "planned"
priority: "maxima"
repository:
type: "gitea"
url: "git@gitea-server:rckrdmrd/mcp-rag-knowledge.git"
https: "http://72.60.226.4:3000/rckrdmrd/mcp-rag-knowledge"
clone_path: "core/mcp-servers/internal/rag-knowledge"
dependencies:
runtime:
- "Node.js >= 18"
- "TypeScript >= 5.0"
database:
- "PostgreSQL >= 15"
- "pgvector extension"
external_apis:
- "OpenAI API (embeddings)"
tools_provided:
- rag_query_context
- rag_get_directive
- rag_get_agent_profile
- rag_trace_reference
- rag_get_relations
- rag_find_code
- rag_explain_impact
- rag_index_document
- rag_sync_category
- rag_get_sync_status
- rag_validate_coverage
- rag_report_feedback
documentation:
architecture: "docs/ARCHITECTURE.md"
deployment: "docs/DEPLOYMENT.md"
usage: "docs/USAGE.md"
tools_spec: "docs/MCP-TOOLS-SPEC.md"
# -------------------------------------------------------------------------
# SCRUM Taiga Integration - PRIORIDAD ALTA
# -------------------------------------------------------------------------
scrum-taiga:
name: "SCRUM Taiga Integration"
description: |
Integracion con Taiga para gestion de proyectos SCRUM.
Permite sincronizar EPICs, User Stories y Tasks entre
el workspace y Taiga.
status: "planned"
priority: "alta"
repository:
type: "gitea"
url: "git@gitea-server:rckrdmrd/mcp-scrum-taiga.git"
https: "http://72.60.226.4:3000/rckrdmrd/mcp-scrum-taiga"
clone_path: "core/mcp-servers/internal/scrum-taiga"
dependencies:
runtime:
- "Node.js >= 18"
- "TypeScript >= 5.0"
external_apis:
- "Taiga API"
tools_provided:
- taiga_get_project
- taiga_list_epics
- taiga_create_epic
- taiga_list_user_stories
- taiga_create_user_story
- taiga_list_tasks
- taiga_create_task
- taiga_update_status
- taiga_sync_sprint
documentation:
architecture: "docs/ARCHITECTURE.md"
deployment: "docs/DEPLOYMENT.md"
usage: "docs/USAGE.md"
# ============================================================================
# MCP SERVERS EXTERNOS
# ============================================================================
# MCP servers de terceros evaluados y aprobados para uso
external:
# Lista de MCP servers externos pendientes de evaluacion
pending_evaluation: []
# MCP servers externos aprobados
approved: []
# Fuentes confiables para buscar MCP servers
trusted_sources:
- name: "Anthropic Official"
url: "https://github.com/anthropics"
priority: 1
- name: "MCP Community"
url: "https://github.com/modelcontextprotocol"
priority: 2
# ============================================================================
# INSTRUCCIONES DE CLONACION
# ============================================================================
clone_instructions: |
# Despues de clonar workspace-v1, clonar los MCP servers necesarios:
# 1. Navegar a la carpeta de MCP internos
cd /home/isem/workspace-v1/core/mcp-servers/internal
# 2. Clonar RAG Knowledge Base (recomendado)
git clone git@gitea-server:rckrdmrd/mcp-rag-knowledge.git rag-knowledge
cd rag-knowledge && npm install && cd ..
# 3. Clonar SCRUM Taiga (opcional)
git clone git@gitea-server:rckrdmrd/mcp-scrum-taiga.git scrum-taiga
cd scrum-taiga && npm install && cd ..
# 4. Verificar instalacion
ls -la
# ============================================================================
# VALIDACION
# ============================================================================
validation:
required_for_development:
- rag-knowledge
optional:
- scrum-taiga
check_command: |
# Verificar que MCP servers estan clonados
for mcp in rag-knowledge scrum-taiga; do
if [ -d "core/mcp-servers/internal/$mcp" ]; then
echo "OK: $mcp"
else
echo "MISSING: $mcp (clone con: git clone git@gitea-server:rckrdmrd/mcp-$mcp.git)"
fi
done

2
core/mcp-servers/external/.gitkeep vendored Normal file
View File

@ -0,0 +1,2 @@
# Esta carpeta contiene MCP servers externos evaluados e instalados
# Ver _sources.yml para fuentes confiables

125
core/mcp-servers/external/_sources.yml vendored Normal file
View File

@ -0,0 +1,125 @@
# MCP External Sources
# ====================
# Fuentes confiables para MCP servers externos
#
# Version: 1.0.0
# Fecha: 2026-01-04
version: "1.0.0"
last_updated: "2026-01-04"
# ============================================================================
# FUENTES CONFIABLES
# ============================================================================
# Lista de repositorios/organizaciones confiables para MCP servers
trusted_sources:
# Nivel 1: Oficial (maxima confianza)
official:
- name: "Anthropic Official"
url: "https://github.com/anthropics"
description: "MCP servers oficiales de Anthropic"
trust_level: "official"
auto_approve: true
- name: "Model Context Protocol"
url: "https://github.com/modelcontextprotocol"
description: "Repositorio oficial del protocolo MCP"
trust_level: "official"
auto_approve: true
# Nivel 2: Comunidad Verificada (alta confianza)
community_verified:
- name: "MCP Community Servers"
url: "https://github.com/mcp-community"
description: "Servidores MCP de la comunidad verificados"
trust_level: "verified"
auto_approve: false
requires_review: true
# Nivel 3: Terceros (requiere evaluacion completa)
third_party: []
# ============================================================================
# PROCESO DE EVALUACION
# ============================================================================
evaluation_process:
steps:
1_identify:
description: "Identificar MCP server de interes"
actions:
- Verificar fuente en trusted_sources
- Revisar repositorio y documentacion
- Verificar actividad y mantenimiento
2_security_review:
description: "Revision de seguridad"
actions:
- Revisar dependencias (npm audit)
- Buscar vulnerabilidades conocidas
- Verificar permisos requeridos
- Revisar codigo fuente si es necesario
3_functionality_test:
description: "Prueba de funcionalidad"
actions:
- Instalar en ambiente de prueba
- Ejecutar tests incluidos
- Verificar herramientas funcionan
- Documentar comportamiento
4_approval:
description: "Aprobacion final"
actions:
- Documentar en _registry.yml
- Agregar a external/installed/
- Actualizar documentacion
criteria:
mandatory:
- "Codigo fuente disponible"
- "Sin vulnerabilidades criticas"
- "Documentacion adecuada"
- "Tests incluidos"
recommended:
- "Mantenimiento activo (< 6 meses)"
- "Mas de 10 estrellas en GitHub"
- "Issues respondidos"
# ============================================================================
# MCP SERVERS EXTERNOS INSTALADOS
# ============================================================================
installed: []
# Formato cuando se instale uno:
# - name: "nombre-del-mcp"
# source: "url del repo"
# version: "1.0.0"
# installed_date: "2026-01-04"
# installed_by: "@PERFIL_MCP_INTEGRATOR"
# location: "external/installed/nombre-del-mcp"
# review_notes: "Notas de la evaluacion"
# ============================================================================
# MCP SERVERS PENDIENTES DE EVALUACION
# ============================================================================
pending_evaluation: []
# Formato:
# - name: "nombre"
# source: "url"
# requested_by: "quien lo solicito"
# requested_date: "fecha"
# reason: "por que se necesita"
# ============================================================================
# MCP SERVERS RECHAZADOS
# ============================================================================
rejected: []
# Formato:
# - name: "nombre"
# source: "url"
# rejected_date: "fecha"
# reason: "razon del rechazo"

3
core/mcp-servers/internal/.gitkeep Normal file
View File

@ -0,0 +1,3 @@
# Esta carpeta contiene MCP servers internos como repositorios independientes
# Cada MCP server se clona manualmente despues de clonar workspace-v1
# Ver _registry.yml para lista de MCP servers disponibles

1
core/mcp-servers/templates/.gitkeep Normal file
View File

@ -0,0 +1 @@
# Esta carpeta contiene templates para crear nuevos MCP servers

16
core/mcp-servers/templates/TEMPLATE-MCP-INTERNO/.env.example Normal file
View File

@ -0,0 +1,16 @@
# ============================================================================
# MCP Server Configuration
# ============================================================================
# Server
PORT=3100
NODE_ENV=development
# Database (PostgreSQL with pgvector)
DATABASE_URL=postgresql://user:password@localhost:5432/mcp_db
# OpenAI (for embeddings)
OPENAI_API_KEY=sk-your-api-key-here
# Logging
LOG_LEVEL=info

35
core/mcp-servers/templates/TEMPLATE-MCP-INTERNO/.gitignore vendored Normal file
View File

@ -0,0 +1,35 @@
# Dependencies
node_modules/
# Build
dist/
*.tsbuildinfo
# Environment
.env
.env.local
.env.*.local
# Logs
logs/
*.log
npm-debug.log*
# Testing
coverage/
.nyc_output/
# IDE
.idea/
.vscode/
*.swp
*.swo
# OS
.DS_Store
Thumbs.db
# Temp
tmp/
temp/
.cache/

121
core/mcp-servers/templates/TEMPLATE-MCP-INTERNO/README.md Normal file
View File

@ -0,0 +1,121 @@
# {NOMBRE_MCP}
**Version:** 0.1.0
**Fecha:** {FECHA}
**Sistema:** NEXUS v3.4 + SIMCO
---
## Descripcion
{DESCRIPCION_DEL_MCP}
---
## Instalacion
```bash
# Clonar (desde workspace-v1/core/mcp-servers/internal/)
git clone git@gitea-server:rckrdmrd/mcp-{nombre}.git {nombre}
cd {nombre}
# Instalar dependencias
npm install
# Configurar
cp .env.example .env
# Editar .env con credenciales
```
---
## Configuracion
### Variables de Entorno
| Variable | Descripcion | Requerido |
|----------|-------------|-----------|
| `DATABASE_URL` | URL de PostgreSQL | Si |
| `OPENAI_API_KEY` | API key de OpenAI | Si |
### Archivo .env.example
```env
# Database
DATABASE_URL=postgresql://user:pass@localhost:5432/db
# OpenAI (para embeddings)
OPENAI_API_KEY=sk-...
# Server
PORT=3100
```
---
## Uso
### Iniciar Servidor
```bash
npm run start
```
### Desarrollo
```bash
npm run dev
```
### Tests
```bash
npm run test
```
---
## Herramientas MCP Disponibles
| Herramienta | Descripcion |
|-------------|-------------|
| `{tool_1}` | {descripcion} |
| `{tool_2}` | {descripcion} |
---
## Estructura
```
{nombre}/
├── README.md
├── package.json
├── tsconfig.json
├── .env.example
├── .gitignore
├── docs/
│ ├── ARCHITECTURE.md
│ ├── DEPLOYMENT.md
│ └── USAGE.md
├── orchestration/
│ └── 00-guidelines/
│ └── CONTEXTO-PROYECTO.md
├── src/
│ ├── index.ts
│ ├── tools/
│ └── services/
├── config/
└── tests/
```
---
## Referencias
- Directiva: @SIMCO_MCP
- Perfil: @PERFIL_MCP_DEVELOPER
- Registry: core/mcp-servers/_registry.yml
---
**Mantenido por:** @PERFIL_MCP_DEVELOPER

1
core/mcp-servers/templates/TEMPLATE-MCP-INTERNO/config/.gitkeep Normal file
View File

@ -0,0 +1 @@
# Configuration files directory

318
core/mcp-servers/templates/TEMPLATE-MCP-INTERNO/config/chunking-strategies.yml Normal file
View File

@ -0,0 +1,318 @@
# ============================================================================
# CHUNKING-STRATEGIES.yml
# Estrategias de Chunking para Sistema RAG
# ============================================================================
# Version: 1.0.0
# Fecha: 2026-01-04
# EPIC: EPIC-013
# ============================================================================
# ----------------------------------------------------------------------------
# CONFIGURACION GLOBAL
# ----------------------------------------------------------------------------
global:
# Modelo de embeddings a usar
embedding_model: "text-embedding-ada-002"
embedding_dimensions: 1536
# Limites generales
max_chunk_size: 1500 # Caracteres maximos por chunk
min_chunk_size: 100 # Caracteres minimos (evitar chunks muy pequeños)
chunk_overlap: 200 # Overlap entre chunks consecutivos
# Separadores de chunk (en orden de prioridad)
separators:
- "\n## " # Heading nivel 2
- "\n### " # Heading nivel 3
- "\n#### " # Heading nivel 4
- "\n\n" # Parrafo
- "\n" # Linea
- ". " # Oracion
- " " # Palabra (ultimo recurso)
# ----------------------------------------------------------------------------
# ESTRATEGIAS POR TIPO DE DOCUMENTO
# ----------------------------------------------------------------------------
strategies:
# --------------------------------------------------------------------------
# DIRECTIVAS SIMCO
# --------------------------------------------------------------------------
directiva:
description: "Documentos de directivas del sistema SIMCO"
file_patterns:
- "orchestration/directivas/**/*.md"
- "**/SIMCO-*.md"
chunking:
method: "semantic" # semantic | fixed | paragraph
preserve_headings: true # Mantener jerarquia de headings en cada chunk
max_chunk_size: 1200 # Directivas son densos, chunks mas pequenos
include_frontmatter: true # Incluir frontmatter en primer chunk
metadata_extraction:
- field: "version"
pattern: "Version:\\s*([\\d.]+)"
- field: "priority"
pattern: "Prioridad:\\s*(\\w+)"
- field: "applies_to"
pattern: "Aplica a:\\s*(.+)"
heading_weights:
"RESUMEN EJECUTIVO": 1.5 # Boost para secciones importantes
"PRINCIPIO FUNDAMENTAL": 1.5
"CHECKLIST": 1.3
# --------------------------------------------------------------------------
# PERFILES DE AGENTES
# --------------------------------------------------------------------------
perfil:
description: "Perfiles de agentes del sistema NEXUS"
file_patterns:
- "orchestration/perfiles/**/*.md"
- "**/PERFIL-*.md"
chunking:
method: "semantic"
preserve_headings: true
max_chunk_size: 1000 # Perfiles necesitan precision alta
include_frontmatter: true
metadata_extraction:
- field: "agent_id"
pattern: "@(PERFIL_[A-Z_]+)"
- field: "system"
pattern: "Sistema:\\s*(\\w+)"
- field: "context_level"
pattern: "Contexto:\\s*(\\w+)"
special_sections:
- name: "DIRECTIVAS APLICABLES"
extract_as: "applicable_directives"
is_list: true
- name: "HERRAMIENTAS MCP"
extract_as: "mcp_tools"
is_list: true
# --------------------------------------------------------------------------
# TEMPLATES
# --------------------------------------------------------------------------
template:
description: "Templates y plantillas del workspace"
file_patterns:
- "**/templates/**/*"
- "**/TEMPLATE-*.md"
chunking:
method: "fixed" # Templates se dividen por tamano fijo
preserve_code_blocks: true # No cortar bloques de codigo
max_chunk_size: 2000 # Templates pueden ser mas largos
metadata_extraction:
- field: "template_type"
pattern: "Tipo:\\s*(\\w+)"
- field: "usage"
pattern: "Uso:\\s*(.+)"
special_handling:
- pattern: "```"
action: "preserve_block" # Mantener bloques de codigo intactos
# --------------------------------------------------------------------------
# CODIGO FUENTE
# --------------------------------------------------------------------------
code:
description: "Archivos de codigo fuente"
file_patterns:
- "**/*.ts"
- "**/*.tsx"
- "**/*.js"
- "**/*.jsx"
- "**/*.sql"
- "**/*.py"
chunking:
method: "ast" # Usar Abstract Syntax Tree
preserve_functions: true # No cortar funciones a la mitad
include_context: true # Incluir imports y contexto
max_chunk_size: 2500 # Codigo puede necesitar mas contexto
metadata_extraction:
- field: "language"
from: "file_extension"
- field: "exports"
pattern: "export\\s+(function|class|const|type)\\s+(\\w+)"
- field: "imports"
pattern: "import\\s+.*from\\s+['\"](.+)['\"]"
special_sections:
- type: "function"
extract_signature: true
extract_jsdoc: true
- type: "class"
extract_signature: true
include_methods: true
# --------------------------------------------------------------------------
# ESPECIFICACIONES
# --------------------------------------------------------------------------
spec:
description: "Documentos de especificacion tecnica"
file_patterns:
- "**/specs/**/*.md"
- "**/SPEC-*.md"
- "**/DDL-*.sql"
chunking:
method: "semantic"
preserve_headings: true
preserve_code_blocks: true
max_chunk_size: 1800
metadata_extraction:
- field: "spec_type"
pattern: "Tipo:\\s*(\\w+)"
- field: "version"
pattern: "Version:\\s*([\\d.]+)"
special_handling:
- pattern: "CREATE TABLE"
action: "preserve_statement"
- pattern: "CREATE FUNCTION"
action: "preserve_statement"
# --------------------------------------------------------------------------
# GUIAS Y DOCUMENTACION
# --------------------------------------------------------------------------
guide:
description: "Guias de uso y documentacion general"
file_patterns:
- "**/docs/**/*.md"
- "**/README.md"
- "**/USAGE.md"
- "**/GUIDE-*.md"
chunking:
method: "paragraph" # Por parrafos naturales
preserve_headings: true
preserve_code_blocks: true
max_chunk_size: 1500
metadata_extraction:
- field: "doc_type"
from: "filename"
- field: "project"
from: "path_segment"
segment_index: 1
# --------------------------------------------------------------------------
# EPICS Y TAREAS
# --------------------------------------------------------------------------
epic:
description: "Documentos de EPICs y planificacion"
file_patterns:
- "**/EPIC-*.md"
- "**/epics/**/*.md"
chunking:
method: "semantic"
preserve_headings: true
max_chunk_size: 1200
metadata_extraction:
- field: "epic_id"
pattern: "EPIC-(\\d+)"
- field: "status"
pattern: "Estado:\\s*(\\w+)"
- field: "priority"
pattern: "Prioridad:\\s*(\\w+)"
special_sections:
- name: "TAREAS"
extract_as: "tasks"
is_list: true
- name: "DEPENDENCIAS"
extract_as: "dependencies"
is_list: true
# --------------------------------------------------------------------------
# TRAZAS DE SESION
# --------------------------------------------------------------------------
traza:
description: "Trazas de sesiones de agentes"
file_patterns:
- "**/trazas/TRAZA-*.md"
chunking:
method: "fixed"
max_chunk_size: 2000 # Trazas son largas
preserve_code_blocks: true
metadata_extraction:
- field: "session_id"
pattern: "TRAZA-(\\d+)"
- field: "agent"
pattern: "Agente:\\s*@(\\w+)"
- field: "date"
pattern: "Fecha:\\s*([\\d-]+)"
indexing:
priority: "low" # Trazas tienen menor prioridad
retention_days: 90 # Mantener por 90 dias
# ----------------------------------------------------------------------------
# PROCESAMIENTO ESPECIAL
# ----------------------------------------------------------------------------
preprocessing:
# Limpiar antes de chunking
cleanup:
- remove_html_comments: true
- normalize_whitespace: true
- convert_tabs_to_spaces: true
# Frontmatter YAML
frontmatter:
extract: true
include_in_first_chunk: true
fields_to_index:
- "title"
- "version"
- "applicable_agents"
- "priority"
postprocessing:
# Agregar contexto a cada chunk
add_context:
- document_title: true
- heading_path: true
- document_category: true
# Validacion
validation:
- min_length: 50
- max_length: 3000
- require_content: true
# ----------------------------------------------------------------------------
# CONFIGURACION DE EMBEDDINGS
# ----------------------------------------------------------------------------
embeddings:
# Proveedor
provider: "openai"
model: "text-embedding-ada-002"
dimensions: 1536
# Batching
batch_size: 100
max_retries: 3
retry_delay_ms: 1000
# Cache
cache:
enabled: true
ttl_hours: 168 # 7 dias
storage: "postgres"
# ----------------------------------------------------------------------------
# FIN DE CONFIGURACION
# ----------------------------------------------------------------------------

359
core/mcp-servers/templates/TEMPLATE-MCP-INTERNO/config/path-mappings.yml Normal file
View File

@ -0,0 +1,359 @@
# ============================================================================
# PATH-MAPPINGS.yml
# Mapeo de Rutas del Workspace a Categorias RAG
# ============================================================================
# Version: 1.0.0
# Fecha: 2026-01-04
# EPIC: EPIC-013
# ============================================================================
# ----------------------------------------------------------------------------
# CONFIGURACION BASE
# ----------------------------------------------------------------------------
base:
workspace_root: "/home/isem/workspace-v1"
# Categorias principales del sistema RAG
categories:
- orchestration # Sistema de orquestacion (directivas, perfiles, trazas)
- core # Componentes core (MCP servers, utilidades)
- knowledge-base # Base de conocimiento (documentacion, snippets)
- projects # Proyectos activos (gamilit, erp-core, etc)
# ----------------------------------------------------------------------------
# MAPEOS DE RUTAS
# ----------------------------------------------------------------------------
mappings:
# ==========================================================================
# ORCHESTRATION - Sistema de Orquestacion
# ==========================================================================
orchestration:
base_path: "orchestration/"
description: "Sistema NEXUS de orquestacion de agentes"
priority: "maxima"
subcategories:
# Directivas SIMCO
directivas:
paths:
- "orchestration/directivas/**/*.md"
document_type: "directiva"
applicable_agents: ["*"]
index_priority: 1
# Perfiles de agentes
perfiles:
paths:
- "orchestration/perfiles/**/*.md"
document_type: "perfil"
applicable_agents: ["*"]
index_priority: 1
# Templates de orquestacion
templates:
paths:
- "orchestration/templates/**/*"
document_type: "template"
applicable_agents: ["PERFIL_ARCHITECT", "PERFIL_DEVELOPER"]
index_priority: 2
# Trazas de sesiones
trazas:
paths:
- "orchestration/trazas/**/*.md"
document_type: "traza"
applicable_agents: ["PERFIL_ANALYST"]
index_priority: 3
retention_days: 90
# Referencias
referencias:
paths:
- "orchestration/referencias/**/*.md"
document_type: "reference"
applicable_agents: ["*"]
index_priority: 2
# EPICs
epics:
paths:
- "orchestration/epics/**/*.md"
document_type: "epic"
applicable_agents: ["PERFIL_SCRUM_MANAGER", "PERFIL_ARCHITECT"]
index_priority: 2
# ==========================================================================
# CORE - Componentes Core del Workspace
# ==========================================================================
core:
base_path: "core/"
description: "Componentes core compartidos"
priority: "alta"
subcategories:
# MCP Servers
mcp-servers:
paths:
- "core/mcp-servers/**/*.md"
- "core/mcp-servers/**/*.yml"
- "core/mcp-servers/**/*.yaml"
- "core/mcp-servers/templates/**/*"
document_type: "spec"
applicable_agents: ["PERFIL_MCP_ARCHITECT", "PERFIL_MCP_DEVELOPER"]
index_priority: 1
exclude:
- "core/mcp-servers/internal/*/node_modules/**"
- "core/mcp-servers/internal/*/.git/**"
- "core/mcp-servers/external/installed/**"
# Utilidades compartidas
utils:
paths:
- "core/utils/**/*"
document_type: "code"
applicable_agents: ["PERFIL_DEVELOPER"]
index_priority: 2
# Scripts
scripts:
paths:
- "core/scripts/**/*"
document_type: "code"
applicable_agents: ["PERFIL_DEVOPS"]
index_priority: 3
# ==========================================================================
# KNOWLEDGE-BASE - Base de Conocimiento
# ==========================================================================
knowledge-base:
base_path: "knowledge-base/"
description: "Documentacion y recursos de referencia"
priority: "alta"
subcategories:
# Documentacion tecnica
technical:
paths:
- "knowledge-base/technical/**/*.md"
document_type: "guide"
applicable_agents: ["*"]
index_priority: 2
# Snippets de codigo
snippets:
paths:
- "knowledge-base/snippets/**/*"
document_type: "code"
applicable_agents: ["PERFIL_DEVELOPER"]
index_priority: 2
# Mejores practicas
best-practices:
paths:
- "knowledge-base/best-practices/**/*.md"
document_type: "guide"
applicable_agents: ["*"]
index_priority: 2
# Patrones de diseno
patterns:
paths:
- "knowledge-base/patterns/**/*.md"
document_type: "guide"
applicable_agents: ["PERFIL_ARCHITECT", "PERFIL_DEVELOPER"]
index_priority: 2
# ==========================================================================
# PROJECTS - Proyectos Activos
# ==========================================================================
projects:
base_path: "projects/"
description: "Proyectos en desarrollo activo"
priority: "alta"
# Proyectos especificos
project_mappings:
# Gamilit - Sistema educativo
gamilit:
paths:
- "projects/gamilit/orchestration/**/*.md"
- "projects/gamilit/docs/**/*.md"
- "projects/gamilit/apps/*/README.md"
document_type: "spec"
project: "gamilit"
applicable_agents:
- "PERFIL_ARCHITECT"
- "PERFIL_BACKEND_DEVELOPER"
- "PERFIL_FRONTEND_DEVELOPER"
index_priority: 1
exclude:
- "projects/gamilit/**/node_modules/**"
- "projects/gamilit/**/dist/**"
- "projects/gamilit/**/.git/**"
# ERP Core - Sistema ERP
erp-core:
paths:
- "projects/erp-core/orchestration/**/*.md"
- "projects/erp-core/docs/**/*.md"
document_type: "spec"
project: "erp-core"
applicable_agents:
- "PERFIL_ARCHITECT"
- "PERFIL_DEVELOPER"
index_priority: 2
# Template de proyecto (para nuevos proyectos)
_template:
paths:
- "projects/*/orchestration/**/*.md"
- "projects/*/docs/**/*.md"
document_type: "spec"
index_priority: 3
# ----------------------------------------------------------------------------
# EXCLUSIONES GLOBALES
# ----------------------------------------------------------------------------
global_exclusions:
# Carpetas de dependencias
- "**/node_modules/**"
- "**/.npm/**"
- "**/vendor/**"
# Carpetas de build
- "**/dist/**"
- "**/build/**"
- "**/.next/**"
- "**/coverage/**"
# Control de versiones
- "**/.git/**"
- "**/.svn/**"
# Cache y temporales
- "**/.cache/**"
- "**/tmp/**"
- "**/.tmp/**"
- "**/temp/**"
# Logs
- "**/logs/**"
- "**/*.log"
# IDE y editores
- "**/.idea/**"
- "**/.vscode/**"
- "**/*.swp"
- "**/*.swo"
# Archivos binarios
- "**/*.png"
- "**/*.jpg"
- "**/*.jpeg"
- "**/*.gif"
- "**/*.ico"
- "**/*.pdf"
- "**/*.zip"
- "**/*.tar.gz"
# ----------------------------------------------------------------------------
# REGLAS DE DETECCION DE TIPO
# ----------------------------------------------------------------------------
type_detection:
# Por nombre de archivo
by_filename:
- pattern: "SIMCO-*.md"
type: "directiva"
- pattern: "PERFIL-*.md"
type: "perfil"
- pattern: "TEMPLATE-*.md"
type: "template"
- pattern: "EPIC-*.md"
type: "epic"
- pattern: "TRAZA-*.md"
type: "traza"
- pattern: "DDL-*.sql"
type: "spec"
- pattern: "README.md"
type: "guide"
- pattern: "*.test.ts"
type: "test"
# Por extension
by_extension:
- extension: ".md"
default_type: "guide"
- extension: ".ts"
type: "code"
- extension: ".tsx"
type: "code"
- extension: ".sql"
type: "spec"
- extension: ".yml"
type: "config"
- extension: ".yaml"
type: "config"
# ----------------------------------------------------------------------------
# RELACIONES AUTOMATICAS
# ----------------------------------------------------------------------------
auto_relations:
# Detectar referencias entre documentos
reference_patterns:
- pattern: "@(SIMCO[/_][A-Z-]+)"
relation_type: "references"
target_category: "orchestration"
- pattern: "@(PERFIL_[A-Z_]+)"
relation_type: "references"
target_category: "orchestration"
- pattern: "EPIC-(\\d+)"
relation_type: "references"
target_category: "orchestration"
- pattern: "MEJ-(\\d+)-(\\d+)"
relation_type: "implements"
target_category: "orchestration"
# Detectar imports en codigo
code_imports:
- pattern: "from ['\"](.+)['\"]"
relation_type: "imports"
resolve_path: true
# ----------------------------------------------------------------------------
# SINCRONIZACION
# ----------------------------------------------------------------------------
sync:
# Frecuencia de sincronizacion por categoria
schedules:
orchestration:
frequency: "realtime" # Sincronizar inmediatamente al cambiar
core:
frequency: "hourly" # Cada hora
knowledge-base:
frequency: "daily" # Diariamente
projects:
frequency: "on_demand" # Solo cuando se solicite
# Hooks de sincronizacion
hooks:
pre_sync:
- validate_frontmatter: true
- check_file_size: true
- max_file_size_mb: 5
post_sync:
- update_relations: true
- validate_coverage: true
- notify_if_errors: true
# ----------------------------------------------------------------------------
# FIN DE CONFIGURACION
# ----------------------------------------------------------------------------

103
core/mcp-servers/templates/TEMPLATE-MCP-INTERNO/docs/ARCHITECTURE.md Normal file
View File

@ -0,0 +1,103 @@
# Arquitectura: MCP {NOMBRE}
**Version:** 0.1.0
**Fecha:** {FECHA}
---
## 1. Vision General
```
┌─────────────────────────────────────────────────────────┐
│ Claude / Agente │
└───────────────────────────┬─────────────────────────────┘
│ MCP Protocol
v
┌─────────────────────────────────────────────────────────┐
│ MCP Server {NOMBRE} │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ Tools │ │ Services │ │ Config │ │
│ └─────────────┘ └─────────────┘ └─────────────┘ │
└───────────────────────────┬─────────────────────────────┘
│
v
┌─────────────────────────────────────────────────────────┐
│ PostgreSQL + pgvector │
└─────────────────────────────────────────────────────────┘
```
---
## 2. Componentes
### 2.1 Tools Layer
Herramientas expuestas via MCP Protocol:
| Tool | Descripcion |
|------|-------------|
| `{tool_1}` | {desc} |
| `{tool_2}` | {desc} |
### 2.2 Services Layer
Logica de negocio:
| Service | Responsabilidad |
|---------|-----------------|
| `{Service1}` | {resp} |
| `{Service2}` | {resp} |
### 2.3 Data Layer
Acceso a datos:
- PostgreSQL para almacenamiento persistente
- pgvector para busqueda semantica
---
## 3. Flujo de Datos
```
Request (Tool Call)
│
v
Validate Input
│
v
Service Logic
│
v
Database Query
│
v
Format Response
│
v
Response (Tool Result)
```
---
## 4. Tecnologias
| Componente | Tecnologia |
|------------|------------|
| Runtime | Node.js 18+ |
| Lenguaje | TypeScript 5+ |
| Database | PostgreSQL 15+ |
| Vector Search | pgvector |
| HTTP | Express |
---
## 5. Seguridad
- Variables sensibles en .env (no versionado)
- Validacion de entrada en cada tool
- Conexion a DB via SSL en produccion
---
**Documento generado:** {FECHA}

432
core/mcp-servers/templates/TEMPLATE-MCP-INTERNO/docs/DDL-RAG-SCHEMA.sql Normal file
View File

@ -0,0 +1,432 @@
-- ============================================================================
-- DDL-RAG-SCHEMA.sql
-- Schema de Base de Datos para Sistema RAG
-- ============================================================================
-- Version: 1.0.0
-- Fecha: 2026-01-04
-- Database: PostgreSQL 15+ con extension pgvector
-- EPIC: EPIC-013
-- ============================================================================
-- ============================================================================
-- EXTENSIONES REQUERIDAS
-- ============================================================================
CREATE EXTENSION IF NOT EXISTS vector; -- Para embeddings y busqueda semantica
CREATE EXTENSION IF NOT EXISTS pg_trgm; -- Para busqueda fuzzy de texto
-- ============================================================================
-- TABLA: documents
-- ============================================================================
-- Almacena documentos indexados del workspace
CREATE TABLE IF NOT EXISTS documents (
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
-- Identificacion
path TEXT NOT NULL UNIQUE, -- Ruta relativa al workspace
title TEXT NOT NULL, -- Titulo del documento
-- Clasificacion
category TEXT NOT NULL, -- orchestration, core, knowledge-base, projects
subcategory TEXT, -- directivas, perfiles, templates, etc.
document_type TEXT NOT NULL, -- directiva, perfil, template, spec, code, guide
project TEXT, -- Proyecto especifico (gamilit, erp-core, etc.)
-- Contenido
content TEXT NOT NULL, -- Contenido completo del documento
content_hash TEXT NOT NULL, -- Hash para detectar cambios
-- Metadata
applicable_agents TEXT[] DEFAULT '{}', -- Agentes que deben conocer este doc
metadata JSONB DEFAULT '{}', -- Metadata adicional flexible
frontmatter JSONB, -- Frontmatter parseado (si existe)
-- Timestamps
created_at TIMESTAMPTZ DEFAULT NOW(),
updated_at TIMESTAMPTZ DEFAULT NOW(),
-- Soft delete
is_deleted BOOLEAN DEFAULT FALSE,
deleted_at TIMESTAMPTZ
);
-- Indices para documents
CREATE INDEX idx_documents_path ON documents(path);
CREATE INDEX idx_documents_category ON documents(category);
CREATE INDEX idx_documents_type ON documents(document_type);
CREATE INDEX idx_documents_project ON documents(project);
CREATE INDEX idx_documents_agents ON documents USING GIN(applicable_agents);
CREATE INDEX idx_documents_deleted ON documents(is_deleted) WHERE is_deleted = FALSE;
-- ============================================================================
-- TABLA: document_chunks
-- ============================================================================
-- Chunks de documentos con embeddings para busqueda semantica
CREATE TABLE IF NOT EXISTS document_chunks (
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
document_id UUID REFERENCES documents(id) ON DELETE CASCADE,
-- Posicion
chunk_index INTEGER NOT NULL, -- Orden del chunk en el documento
-- Contenido
content TEXT NOT NULL, -- Contenido del chunk
heading_path TEXT[] DEFAULT '{}', -- Jerarquia de headings (## Seccion > ### Subseccion)
-- Ubicacion en archivo original
line_start INTEGER, -- Linea de inicio
line_end INTEGER, -- Linea de fin
-- Embedding
embedding vector(1536), -- Vector de embedding (OpenAI ada-002)
-- Timestamps
created_at TIMESTAMPTZ DEFAULT NOW(),
-- Constraint de unicidad
UNIQUE(document_id, chunk_index)
);
-- Indice IVFFlat para busqueda por similitud coseno
-- lists = 100 es un buen balance para ~10k-100k chunks
CREATE INDEX idx_chunks_embedding ON document_chunks
USING ivfflat (embedding vector_cosine_ops)
WITH (lists = 100);
CREATE INDEX idx_chunks_document ON document_chunks(document_id);
CREATE INDEX idx_chunks_heading ON document_chunks USING GIN(heading_path);
-- ============================================================================
-- TABLA: document_relations
-- ============================================================================
-- Relaciones entre documentos (grafo de dependencias)
CREATE TABLE IF NOT EXISTS document_relations (
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
-- Documentos relacionados
source_document_id UUID REFERENCES documents(id) ON DELETE CASCADE,
target_document_id UUID REFERENCES documents(id) ON DELETE CASCADE,
-- Tipo de relacion
relation_type TEXT NOT NULL, -- references, extends, implements, uses, etc.
context TEXT, -- Contexto adicional de la relacion
-- Metadata
auto_detected BOOLEAN DEFAULT FALSE, -- True si fue detectado automaticamente
-- Timestamps
created_at TIMESTAMPTZ DEFAULT NOW(),
-- Constraint para evitar duplicados
UNIQUE(source_document_id, target_document_id, relation_type)
);
-- Indices para relaciones
CREATE INDEX idx_relations_source ON document_relations(source_document_id);
CREATE INDEX idx_relations_target ON document_relations(target_document_id);
CREATE INDEX idx_relations_type ON document_relations(relation_type);
-- ============================================================================
-- TABLA: code_references
-- ============================================================================
-- Referencias a codigo encontradas en documentos
CREATE TABLE IF NOT EXISTS code_references (
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
document_id UUID REFERENCES documents(id) ON DELETE CASCADE,
-- Identificacion del codigo
code_path TEXT NOT NULL, -- Ruta al archivo de codigo
code_name TEXT NOT NULL, -- Nombre (funcion, clase, etc.)
code_type TEXT NOT NULL, -- function, class, interface, const, type
-- Metadata
language TEXT, -- typescript, javascript, sql, etc.
line_start INTEGER, -- Linea de inicio en codigo
line_end INTEGER, -- Linea de fin
context TEXT, -- Contexto de la referencia
-- Timestamps
created_at TIMESTAMPTZ DEFAULT NOW()
);
-- Indices para referencias de codigo
CREATE INDEX idx_code_refs_document ON code_references(document_id);
CREATE INDEX idx_code_refs_path ON code_references(code_path);
CREATE INDEX idx_code_refs_name ON code_references(code_name);
CREATE INDEX idx_code_refs_type ON code_references(code_type);
-- ============================================================================
-- TABLA: sync_log
-- ============================================================================
-- Log de sincronizacion para tracking
CREATE TABLE IF NOT EXISTS sync_log (
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
-- Operacion
operation TEXT NOT NULL, -- index, update, delete, sync_category
document_path TEXT, -- Ruta del documento (si aplica)
category TEXT, -- Categoria (si aplica)
-- Resultado
status TEXT NOT NULL, -- success, error, skipped
message TEXT, -- Mensaje de resultado
chunks_processed INTEGER DEFAULT 0, -- Chunks procesados
duration_ms INTEGER, -- Duracion en milisegundos
-- Timestamps
created_at TIMESTAMPTZ DEFAULT NOW()
);
CREATE INDEX idx_sync_log_created ON sync_log(created_at DESC);
CREATE INDEX idx_sync_log_status ON sync_log(status);
-- ============================================================================
-- FUNCIONES DE BUSQUEDA
-- ============================================================================
-- Busqueda semantica principal
CREATE OR REPLACE FUNCTION search_knowledge(
query_embedding vector(1536),
p_category TEXT DEFAULT NULL,
p_document_type TEXT DEFAULT NULL,
p_project TEXT DEFAULT NULL,
p_agent TEXT DEFAULT NULL,
p_threshold FLOAT DEFAULT 0.7,
p_limit INTEGER DEFAULT 10
)
RETURNS TABLE (
document_id UUID,
chunk_id UUID,
path TEXT,
title TEXT,
category TEXT,
document_type TEXT,
chunk_content TEXT,
heading_path TEXT[],
line_start INTEGER,
line_end INTEGER,
similarity FLOAT,
applicable_agents TEXT[]
)
LANGUAGE plpgsql
AS $$
BEGIN
RETURN QUERY
SELECT
d.id as document_id,
c.id as chunk_id,
d.path,
d.title,
d.category,
d.document_type,
c.content as chunk_content,
c.heading_path,
c.line_start,
c.line_end,
1 - (c.embedding <=> query_embedding) as similarity,
d.applicable_agents
FROM document_chunks c
JOIN documents d ON d.id = c.document_id
WHERE
d.is_deleted = FALSE
AND (p_category IS NULL OR d.category = p_category)
AND (p_document_type IS NULL OR d.document_type = p_document_type)
AND (p_project IS NULL OR d.project = p_project)
AND (p_agent IS NULL OR p_agent = ANY(d.applicable_agents))
AND 1 - (c.embedding <=> query_embedding) > p_threshold
ORDER BY c.embedding <=> query_embedding
LIMIT p_limit;
END;
$$;
-- Obtener documentos relacionados (recursivo)
CREATE OR REPLACE FUNCTION get_related_documents(
p_document_id UUID,
p_relation_types TEXT[] DEFAULT NULL,
p_depth INTEGER DEFAULT 1
)
RETURNS TABLE (
document_id UUID,
path TEXT,
title TEXT,
relation_type TEXT,
relation_depth INTEGER,
relation_context TEXT
)
LANGUAGE plpgsql
AS $$
BEGIN
RETURN QUERY
WITH RECURSIVE related AS (
-- Nivel 0: documento inicial
SELECT
d.id,
d.path,
d.title,
NULL::TEXT as rel_type,
0 as depth,
NULL::TEXT as context
FROM documents d
WHERE d.id = p_document_id
UNION ALL
-- Niveles siguientes
SELECT
d.id,
d.path,
d.title,
r.relation_type,
related.depth + 1,
r.context
FROM related
JOIN document_relations r ON r.source_document_id = related.id
JOIN documents d ON d.id = r.target_document_id
WHERE
related.depth < p_depth
AND d.is_deleted = FALSE
AND (p_relation_types IS NULL OR r.relation_type = ANY(p_relation_types))
)
SELECT
related.id as document_id,
related.path,
related.title,
related.rel_type as relation_type,
related.depth as relation_depth,
related.context as relation_context
FROM related
WHERE related.depth > 0
ORDER BY related.depth, related.title;
END;
$$;
-- Trazar referencia (para evitar alucinaciones)
CREATE OR REPLACE FUNCTION trace_reference(
p_query TEXT,
p_embedding vector(1536)
)
RETURNS TABLE (
source_type TEXT,
source_path TEXT,
source_title TEXT,
line_reference TEXT,
content_snippet TEXT,
confidence FLOAT,
related_documents JSONB
)
LANGUAGE plpgsql
AS $$
BEGIN
RETURN QUERY
WITH best_matches AS (
SELECT
d.id,
d.path,
d.title,
d.category as src_type,
c.line_start,
c.line_end,
c.content,
1 - (c.embedding <=> p_embedding) as sim
FROM document_chunks c
JOIN documents d ON d.id = c.document_id
WHERE
d.is_deleted = FALSE
AND 1 - (c.embedding <=> p_embedding) > 0.75
ORDER BY c.embedding <=> p_embedding
LIMIT 5
)
SELECT
bm.src_type as source_type,
bm.path as source_path,
bm.title as source_title,
bm.path || ':' || bm.line_start || '-' || bm.line_end as line_reference,
LEFT(bm.content, 500) as content_snippet,
bm.sim as confidence,
(
SELECT jsonb_agg(jsonb_build_object(
'path', d.path,
'title', d.title,
'relation', r.relation_type
))
FROM document_relations r
JOIN documents d ON d.id = r.target_document_id
WHERE r.source_document_id = bm.id
LIMIT 5
) as related_documents
FROM best_matches bm;
END;
$$;
-- ============================================================================
-- TRIGGERS
-- ============================================================================
-- Actualizar updated_at automaticamente
CREATE OR REPLACE FUNCTION update_updated_at()
RETURNS TRIGGER AS $$
BEGIN
NEW.updated_at = NOW();
RETURN NEW;
END;
$$ LANGUAGE plpgsql;
CREATE TRIGGER trigger_documents_updated_at
BEFORE UPDATE ON documents
FOR EACH ROW
EXECUTE FUNCTION update_updated_at();
-- ============================================================================
-- VISTAS UTILES
-- ============================================================================
-- Vista de documentos con estadisticas
CREATE OR REPLACE VIEW v_document_stats AS
SELECT
d.id,
d.path,
d.title,
d.category,
d.document_type,
d.project,
COUNT(c.id) as chunk_count,
d.created_at,
d.updated_at
FROM documents d
LEFT JOIN document_chunks c ON c.document_id = d.id
WHERE d.is_deleted = FALSE
GROUP BY d.id;
-- Vista de estado de sincronizacion por categoria
CREATE OR REPLACE VIEW v_sync_status AS
SELECT
category,
COUNT(*) as total_documents,
MAX(updated_at) as last_updated,
COUNT(CASE WHEN updated_at < NOW() - INTERVAL '1 hour' THEN 1 END) as stale_count
FROM documents
WHERE is_deleted = FALSE
GROUP BY category;
-- ============================================================================
-- COMENTARIOS
-- ============================================================================
COMMENT ON TABLE documents IS 'Documentos indexados del workspace para busqueda RAG';
COMMENT ON TABLE document_chunks IS 'Chunks de documentos con embeddings para busqueda semantica';
COMMENT ON TABLE document_relations IS 'Grafo de relaciones entre documentos';
COMMENT ON TABLE code_references IS 'Referencias a codigo encontradas en documentos';
COMMENT ON TABLE sync_log IS 'Log de operaciones de sincronizacion';
COMMENT ON FUNCTION search_knowledge IS 'Busqueda semantica principal con filtros';
COMMENT ON FUNCTION get_related_documents IS 'Obtiene grafo de documentos relacionados recursivamente';
COMMENT ON FUNCTION trace_reference IS 'Verifica origen de informacion para evitar alucinaciones';
-- ============================================================================
-- FIN DEL SCHEMA
-- ============================================================================

687
core/mcp-servers/templates/TEMPLATE-MCP-INTERNO/docs/MCP-TOOLS-SPEC.md Normal file
View File

@ -0,0 +1,687 @@
# MCP-TOOLS-SPEC: Especificación de Herramientas RAG
**Version:** 1.0.0
**Fecha:** 2026-01-04
**MCP Server:** mcp-rag-knowledge
**EPIC:** EPIC-013
---
## RESUMEN
Este documento especifica las 12 herramientas MCP del sistema RAG para consulta y gestión del conocimiento del workspace.
---
## HERRAMIENTAS DE CONSULTA SEMÁNTICA
### 1. rag_query_context
**Descripción:** Busqueda semántica principal sobre el conocimiento del workspace.
**Parámetros:**
| Nombre | Tipo | Requerido | Descripción |
|--------|------|-----------|-------------|
| query | string | Sí | Pregunta o consulta en lenguaje natural |
| category | string | No | Filtrar por categoría (orchestration, core, knowledge-base, projects) |
| document_type | string | No | Filtrar por tipo (directiva, perfil, template, code, spec, guide) |
| project | string | No | Filtrar por proyecto específico |
| agent | string | No | Filtrar documentos aplicables a un agente específico |
| threshold | float | No | Umbral mínimo de similitud (default: 0.7) |
| limit | integer | No | Máximo de resultados (default: 10) |
**Retorno:**
```typescript
interface QueryResult {
results: Array<{
document_id: string;
chunk_id: string;
path: string;
title: string;
category: string;
document_type: string;
content: string;
heading_path: string[];
line_start: number;
line_end: number;
similarity: number;
applicable_agents: string[];
}>;
query_time_ms: number;
total_matches: number;
}
```
**Ejemplo:**
```typescript
const result = await rag_query_context({
query: "¿Cómo se debe documentar un cambio según SIMCO?",
category: "orchestration",
threshold: 0.75,
limit: 5
});
// Resultado esperado:
// {
// results: [{
// path: "orchestration/directivas/simco/SIMCO-DOCUMENTAR.md",
// title: "SIMCO-DOCUMENTAR",
// similarity: 0.89,
// content: "## Proceso de Documentación...",
// line_start: 45,
// line_end: 78
// }],
// query_time_ms: 120,
// total_matches: 3
// }
```
**Errores Comunes:**
| Código | Mensaje | Solución |
|--------|---------|----------|
| 400 | "Query too short" | Proporcionar query de al menos 3 palabras |
| 404 | "No results found" | Reducir threshold o generalizar query |
| 503 | "Embedding service unavailable" | Reintentar después de unos segundos |
---
### 2. rag_get_directive
**Descripción:** Obtiene una directiva SIMCO específica por su identificador.
**Parámetros:**
| Nombre | Tipo | Requerido | Descripción |
|--------|------|-----------|-------------|
| directive_id | string | Sí | Identificador de la directiva (ej: "SIMCO-TAREA") |
| include_relations | boolean | No | Incluir documentos relacionados (default: false) |
**Retorno:**
```typescript
interface DirectiveResult {
found: boolean;
directive: {
id: string;
path: string;
title: string;
version: string;
priority: string;
applies_to: string;
content: string;
sections: Array<{
heading: string;
content: string;
line_start: number;
line_end: number;
}>;
checklist: string[];
};
relations?: Array<{
path: string;
title: string;
relation_type: string;
}>;
}
```
**Ejemplo:**
```typescript
const directive = await rag_get_directive({
directive_id: "SIMCO-RAG",
include_relations: true
});
```
---
### 3. rag_get_agent_profile
**Descripción:** Carga el perfil completo de un agente para inicialización.
**Parámetros:**
| Nombre | Tipo | Requerido | Descripción |
|--------|------|-----------|-------------|
| agent_id | string | Sí | Identificador del agente (ej: "PERFIL_BACKEND_DEVELOPER") |
| include_directives | boolean | No | Incluir directivas aplicables (default: true) |
| include_tools | boolean | No | Incluir herramientas MCP disponibles (default: true) |
**Retorno:**
```typescript
interface AgentProfileResult {
found: boolean;
profile: {
id: string;
name: string;
system: string;
context_level: string;
responsibilities: string[];
applicable_directives: string[];
mcp_tools: string[];
constraints: string[];
full_content: string;
};
directives?: DirectiveResult[];
tools?: ToolSpec[];
}
```
**Ejemplo:**
```typescript
const profile = await rag_get_agent_profile({
agent_id: "PERFIL_MCP_DEVELOPER",
include_directives: true,
include_tools: true
});
```
---
## HERRAMIENTAS DE TRAZABILIDAD
### 4. rag_trace_reference
**Descripción:** Verifica el origen de una afirmación para prevenir alucinaciones.
**Parámetros:**
| Nombre | Tipo | Requerido | Descripción |
|--------|------|-----------|-------------|
| claim | string | Sí | Afirmación a verificar |
| context | string | No | Contexto adicional para la búsqueda |
| min_confidence | float | No | Confianza mínima requerida (default: 0.75) |
**Retorno:**
```typescript
interface TraceResult {
verified: boolean;
sources: Array<{
source_type: string;
source_path: string;
source_title: string;
line_reference: string; // formato: "path:line_start-line_end"
content_snippet: string;
confidence: number;
related_documents: Array<{
path: string;
title: string;
relation: string;
}>;
}>;
recommendation: "cite" | "verify" | "cannot_confirm";
}
```
**Ejemplo:**
```typescript
const trace = await rag_trace_reference({
claim: "Las directivas SIMCO son obligatorias para todos los agentes",
min_confidence: 0.8
});
// Si verified = true, usar las fuentes para citar
// Si verified = false, indicar que no se puede confirmar
```
---
### 5. rag_get_relations
**Descripción:** Obtiene el grafo de relaciones de un documento.
**Parámetros:**
| Nombre | Tipo | Requerido | Descripción |
|--------|------|-----------|-------------|
| document_path | string | Sí | Ruta del documento |
| relation_types | string[] | No | Filtrar por tipos de relación |
| depth | integer | No | Profundidad de recursión (default: 1, max: 3) |
| direction | string | No | "outgoing" \| "incoming" \| "both" (default: "both") |
**Retorno:**
```typescript
interface RelationsResult {
document: {
id: string;
path: string;
title: string;
};
relations: Array<{
document_id: string;
path: string;
title: string;
relation_type: string;
relation_depth: number;
direction: "outgoing" | "incoming";
context: string;
}>;
graph_summary: {
total_relations: number;
by_type: Record<string, number>;
max_depth_reached: number;
};
}
```
**Tipos de Relación:**
| Tipo | Descripción |
|------|-------------|
| references | Documento A menciona/cita a documento B |
| extends | Documento A extiende/amplía documento B |
| implements | Documento A implementa especificación B |
| uses | Documento A usa/depende de documento B |
| supersedes | Documento A reemplaza documento B |
---
### 6. rag_find_code
**Descripción:** Busca referencias de código en el workspace.
**Parámetros:**
| Nombre | Tipo | Requerido | Descripción |
|--------|------|-----------|-------------|
| name | string | No | Nombre de función/clase/tipo a buscar |
| code_type | string | No | Tipo: function, class, interface, const, type |
| language | string | No | Lenguaje: typescript, javascript, sql, python |
| path_pattern | string | No | Patrón glob para filtrar rutas |
| include_context | boolean | No | Incluir código circundante (default: true) |
**Retorno:**
```typescript
interface CodeSearchResult {
matches: Array<{
path: string;
name: string;
code_type: string;
language: string;
line_start: number;
line_end: number;
signature: string;
documentation: string;
code_snippet: string;
related_documents: string[]; // Documentos que referencian este código
}>;
total_matches: number;
}
```
**Ejemplo:**
```typescript
const code = await rag_find_code({
name: "validateParams",
code_type: "function",
language: "typescript"
});
```
---
### 7. rag_explain_impact
**Descripción:** Analiza el impacto de modificar un documento.
**Parámetros:**
| Nombre | Tipo | Requerido | Descripción |
|--------|------|-----------|-------------|
| document_path | string | Sí | Ruta del documento a analizar |
| change_type | string | Sí | "create" \| "modify" \| "delete" |
| affected_sections | string[] | No | Secciones específicas afectadas |
**Retorno:**
```typescript
interface ImpactAnalysis {
document: {
path: string;
title: string;
category: string;
document_type: string;
};
impact: {
direct_dependents: Array<{
path: string;
title: string;
relation_type: string;
impact_level: "high" | "medium" | "low";
}>;
indirect_dependents: Array<{
path: string;
title: string;
distance: number;
impact_level: "high" | "medium" | "low";
}>;
agents_affected: string[];
risk_level: "critical" | "high" | "medium" | "low";
propagation_order: string[]; // Orden sugerido para actualizar
};
recommendations: string[];
}
```
**Ejemplo:**
```typescript
const impact = await rag_explain_impact({
document_path: "orchestration/directivas/simco/SIMCO-TAREA.md",
change_type: "modify",
affected_sections: ["PRINCIPIO FUNDAMENTAL"]
});
// Antes de hacer cambios significativos, revisar:
// - impact.risk_level
// - impact.agents_affected
// - impact.propagation_order
```
---
## HERRAMIENTAS DE INDEXACIÓN
### 8. rag_index_document
**Descripción:** Indexa o re-indexa un documento en el sistema RAG.
**Parámetros:**
| Nombre | Tipo | Requerido | Descripción |
|--------|------|-----------|-------------|
| path | string | Sí | Ruta del documento a indexar |
| force | boolean | No | Forzar re-indexación aunque no haya cambios (default: false) |
| extract_relations | boolean | No | Detectar y crear relaciones automáticamente (default: true) |
**Retorno:**
```typescript
interface IndexResult {
success: boolean;
document: {
id: string;
path: string;
title: string;
category: string;
document_type: string;
};
indexing: {
chunks_created: number;
relations_detected: number;
code_references_found: number;
processing_time_ms: number;
};
status: "created" | "updated" | "unchanged" | "error";
error?: string;
}
```
**Ejemplo:**
```typescript
// Después de crear o modificar un documento
const result = await rag_index_document({
path: "orchestration/directivas/simco/SIMCO-NUEVA.md",
extract_relations: true
});
if (result.success) {
console.log(`Indexado: ${result.indexing.chunks_created} chunks`);
} else {
console.error(`Error: ${result.error}`);
}
```
---
### 9. rag_sync_category
**Descripción:** Sincroniza todos los documentos de una categoría.
**Parámetros:**
| Nombre | Tipo | Requerido | Descripción |
|--------|------|-----------|-------------|
| category | string | Sí | Categoría a sincronizar |
| subcategory | string | No | Subcategoría específica |
| force | boolean | No | Forzar re-indexación completa (default: false) |
| dry_run | boolean | No | Solo simular, no hacer cambios (default: false) |
**Retorno:**
```typescript
interface SyncResult {
category: string;
subcategory?: string;
summary: {
total_files: number;
indexed: number;
updated: number;
unchanged: number;
deleted: number;
errors: number;
};
details: Array<{
path: string;
status: "indexed" | "updated" | "unchanged" | "deleted" | "error";
chunks: number;
error?: string;
}>;
duration_ms: number;
}
```
**Ejemplo:**
```typescript
// Sincronizar todas las directivas
const sync = await rag_sync_category({
category: "orchestration",
subcategory: "directivas",
dry_run: false
});
console.log(`Sincronizado: ${sync.summary.indexed} nuevos, ${sync.summary.updated} actualizados`);
```
---
### 10. rag_get_sync_status
**Descripción:** Obtiene el estado de sincronización del sistema.
**Parámetros:**
| Nombre | Tipo | Requerido | Descripción |
|--------|------|-----------|-------------|
| category | string | No | Filtrar por categoría |
| include_stale | boolean | No | Incluir documentos desactualizados (default: true) |
**Retorno:**
```typescript
interface SyncStatus {
overall: {
total_documents: number;
total_chunks: number;
last_sync: string; // ISO timestamp
health: "healthy" | "degraded" | "unhealthy";
};
by_category: Array<{
category: string;
total_documents: number;
last_updated: string;
stale_count: number;
stale_documents?: string[];
}>;
pending_sync: Array<{
path: string;
reason: "new" | "modified" | "deleted";
detected_at: string;
}>;
}
```
---
## HERRAMIENTAS DE VALIDACIÓN
### 11. rag_validate_coverage
**Descripción:** Verifica la cobertura de indexación del workspace.
**Parámetros:**
| Nombre | Tipo | Requerido | Descripción |
|--------|------|-----------|-------------|
| category | string | No | Categoría a validar (todas si no se especifica) |
| report_missing | boolean | No | Incluir lista de archivos no indexados (default: true) |
**Retorno:**
```typescript
interface CoverageReport {
summary: {
total_files_expected: number;
total_files_indexed: number;
coverage_percentage: number;
health: "complete" | "partial" | "incomplete";
};
by_category: Array<{
category: string;
expected: number;
indexed: number;
coverage: number;
}>;
missing: Array<{
path: string;
category: string;
reason: "not_indexed" | "outdated" | "excluded";
}>;
recommendations: string[];
}
```
**Ejemplo:**
```typescript
const coverage = await rag_validate_coverage({
category: "orchestration",
report_missing: true
});
if (coverage.summary.coverage_percentage < 100) {
console.log("Documentos faltantes:", coverage.missing);
}
```
---
### 12. rag_report_feedback
**Descripción:** Reporta problemas de calidad en el sistema RAG.
**Parámetros:**
| Nombre | Tipo | Requerido | Descripción |
|--------|------|-----------|-------------|
| feedback_type | string | Sí | "missing_info" \| "incorrect_info" \| "outdated" \| "low_relevance" |
| query | string | Sí | Query que generó el problema |
| context | string | No | Contexto adicional del problema |
| document_path | string | No | Documento específico afectado |
| expected_result | string | No | Qué se esperaba encontrar |
**Retorno:**
```typescript
interface FeedbackResult {
feedback_id: string;
received: boolean;
suggested_actions: Array<{
action: string;
priority: "high" | "medium" | "low";
automated: boolean;
}>;
}
```
**Ejemplo:**
```typescript
// Cuando una búsqueda no encuentra lo esperado
const feedback = await rag_report_feedback({
feedback_type: "missing_info",
query: "¿Cómo configurar hooks en NEXUS?",
expected_result: "Debería encontrar SIMCO-HOOKS pero no está indexado",
document_path: "orchestration/directivas/simco/SIMCO-HOOKS.md"
});
```
---
## SCHEMAS JSON PARA REGISTRO MCP
```typescript
// schemas/tools.ts
export const toolSchemas = {
rag_query_context: {
name: "rag_query_context",
description: "Búsqueda semántica en el conocimiento del workspace",
parameters: {
type: "object",
properties: {
query: { type: "string", description: "Consulta en lenguaje natural" },
category: { type: "string", enum: ["orchestration", "core", "knowledge-base", "projects"] },
document_type: { type: "string", enum: ["directiva", "perfil", "template", "code", "spec", "guide"] },
project: { type: "string" },
agent: { type: "string" },
threshold: { type: "number", default: 0.7 },
limit: { type: "integer", default: 10 }
},
required: ["query"]
}
},
// ... resto de schemas
};
```
---
## NOTAS DE IMPLEMENTACIÓN
### Manejo de Errores
Todas las herramientas deben manejar:
1. **Errores de conexión:** Reintentar con backoff exponencial
2. **Errores de embedding:** Cachear embeddings para evitar recálculos
3. **Documentos no encontrados:** Retornar resultado vacío, no error
### Rate Limiting
- Embeddings: Máximo 100 requests/minuto a OpenAI
- Queries: Sin límite interno (depende de PostgreSQL)
- Sync: Máximo 1 sync completo por minuto
### Caché
- Embeddings: Cache de 7 días en PostgreSQL
- Queries: Cache de 5 minutos para queries idénticos
- Perfiles: Cache en memoria durante sesión
---
**Version:** 1.0.0 | **EPIC:** EPIC-013 | **Sistema:** SIMCO

83
core/mcp-servers/templates/TEMPLATE-MCP-INTERNO/orchestration/00-guidelines/CONTEXTO-PROYECTO.md Normal file
View File

@ -0,0 +1,83 @@
# CONTEXTO-PROYECTO: MCP {NOMBRE}
**Version:** 0.1.0
**Fecha:** {FECHA}
**Sistema:** NEXUS v3.4 + SIMCO
---
## IDENTIFICACION
```yaml
proyecto: "mcp-{nombre}"
tipo: "mcp-server-interno"
estado: "development"
prioridad: "{alta|maxima}"
ubicacion:
workspace: "/home/isem/workspace-v1"
proyecto: "core/mcp-servers/internal/{nombre}"
repositorio: "git@gitea-server:rckrdmrd/mcp-{nombre}.git"
stack:
runtime: "Node.js >= 18"
lenguaje: "TypeScript"
database: "PostgreSQL + pgvector"
```
---
## PROPOSITO
{DESCRIPCION_DETALLADA_DEL_PROPOSITO}
---
## HERRAMIENTAS MCP
| Herramienta | Descripcion | Estado |
|-------------|-------------|--------|
| `{tool_1}` | {descripcion} | planned |
| `{tool_2}` | {descripcion} | planned |
---
## DEPENDENCIAS
### Externas
- PostgreSQL >= 15 con extension pgvector
- OpenAI API (para embeddings)
### Del Workspace
- Acceso a documentacion en orchestration/
- Acceso a knowledge-base/
---
## DIRECTIVAS APLICABLES
```yaml
siempre:
- @SIMCO_MCP
- @PRINCIPIO_CAPVED
- @PRINCIPIO_DOC_PRIMERO
operaciones:
crear_herramienta: [@SIMCO_CREAR]
modificar: [@SIMCO_MODIFICAR]
validar: [@SIMCO_VALIDAR]
```
---
## PERFILES RELACIONADOS
| Perfil | Responsabilidad |
|--------|-----------------|
| @PERFIL_MCP_DEVELOPER | Desarrollo de este MCP |
| @PERFIL_RAG_ENGINEER | Integracion con RAG |
| @PERFIL_MCP_ARCHITECT | Diseno y arquitectura |
---
**Contexto generado:** {FECHA}

50
core/mcp-servers/templates/TEMPLATE-MCP-INTERNO/package.json.template Normal file
View File

@ -0,0 +1,50 @@
{
"name": "mcp-{nombre}",
"version": "0.1.0",
"description": "{DESCRIPCION}",
"main": "dist/index.js",
"types": "dist/index.d.ts",
"scripts": {
"build": "tsc",
"start": "node dist/index.js",
"dev": "ts-node-dev --respawn src/index.ts",
"test": "jest",
"test:watch": "jest --watch",
"test:coverage": "jest --coverage",
"lint": "eslint src/**/*.ts",
"lint:fix": "eslint src/**/*.ts --fix",
"typecheck": "tsc --noEmit",
"health-check": "curl -s http://localhost:${PORT:-3100}/health || echo 'Server not running'"
},
"keywords": [
"mcp",
"model-context-protocol",
"anthropic",
"claude"
],
"author": "workspace-v1",
"license": "MIT",
"dependencies": {
"@anthropic-ai/sdk": "^0.25.0",
"dotenv": "^16.3.1",
"express": "^4.18.2",
"pg": "^8.11.3",
"pgvector": "^0.1.8"
},
"devDependencies": {
"@types/express": "^4.17.21",
"@types/jest": "^29.5.11",
"@types/node": "^20.10.0",
"@types/pg": "^8.10.9",
"@typescript-eslint/eslint-plugin": "^6.13.0",
"@typescript-eslint/parser": "^6.13.0",
"eslint": "^8.54.0",
"jest": "^29.7.0",
"ts-jest": "^29.1.1",
"ts-node-dev": "^2.0.0",
"typescript": "^5.3.0"
},
"engines": {
"node": ">=18.0.0"
}
}

61
core/mcp-servers/templates/TEMPLATE-MCP-INTERNO/src/index.ts.template Normal file
View File

@ -0,0 +1,61 @@
/**
* MCP Server: {NOMBRE}
*
* {DESCRIPCION}
*
* @version 0.1.0
*/
import express from 'express';
import dotenv from 'dotenv';
// Load environment variables
dotenv.config();
const app = express();
const PORT = process.env.PORT || 3100;
// Middleware
app.use(express.json());
// Health check endpoint
app.get('/health', (req, res) => {
res.json({
status: 'ok',
service: 'mcp-{nombre}',
version: '0.1.0',
timestamp: new Date().toISOString(),
});
});
// MCP Tools endpoint
app.post('/tools/:toolName', async (req, res) => {
const { toolName } = req.params;
const { parameters } = req.body;
try {
// TODO: Implement tool routing
const result = await handleTool(toolName, parameters);
res.json({ success: true, result });
} catch (error) {
res.status(500).json({
success: false,
error: error instanceof Error ? error.message : 'Unknown error',
});
}
});
// Tool handler
async function handleTool(toolName: string, parameters: unknown): Promise<unknown> {
switch (toolName) {
// TODO: Add tool cases
default:
throw new Error(`Unknown tool: ${toolName}`);
}
}
// Start server
app.listen(PORT, () => {
console.log(`MCP Server {nombre} running on port ${PORT}`);
console.log(`Health check: http://localhost:${PORT}/health`);
});

1
core/mcp-servers/templates/TEMPLATE-MCP-INTERNO/tests/.gitkeep Normal file
View File

@ -0,0 +1 @@
# Tests directory

6
core/orchestration/README.md
View File

@ -27,7 +27,7 @@ Este directorio contiene el **Sistema NEXUS** de orquestación de agentes IA par
### Acceso Rápido
```
core/catalog/ # 🆕 CATÁLOGO DE FUNCIONALIDADES (CONSULTAR PRIMERO)
shared/catalog/ # 🆕 CATÁLOGO DE FUNCIONALIDADES (CONSULTAR PRIMERO)
├── CATALOG-INDEX.yml # Índice máquina-readable
├── auth/ # Autenticación y autorización
├── session-management/ # Gestión de sesiones
@ -102,8 +102,8 @@ referencias/
@TPL_CAPVED: templates/TEMPLATE-TAREA-CAPVED.md
# CATÁLOGO DE FUNCIONALIDADES (CONSULTAR PRIMERO)
@CATALOG: core/catalog/
@CATALOG_INDEX: core/catalog/CATALOG-INDEX.yml
@CATALOG: shared/catalog/
@CATALOG_INDEX: shared/catalog/CATALOG-INDEX.yml
# Operaciones
@REUTILIZAR: directivas/simco/SIMCO-REUTILIZAR.md

4
core/orchestration/agents/legacy/LEGACY-NOTICE.md
View File

@ -46,7 +46,7 @@ core/orchestration/
│ ├── SIMCO-BACKEND.md
│ └── ...
│
└── core/catalog/ # 🆕 CATÁLOGO DE FUNCIONALIDADES
└── shared/catalog/ # 🆕 CATÁLOGO DE FUNCIONALIDADES
├── CATALOG-INDEX.yml # Índice para búsqueda
├── auth/
├── session-management/
@ -138,7 +138,7 @@ Los archivos `INIT-NEXUS-*.md` siguen siendo útiles como:
- **Índice SIMCO:** core/orchestration/directivas/simco/_INDEX.md
- **Perfiles de Agentes:** core/orchestration/agents/perfiles/
- **Catálogo:** core/catalog/
- **Catálogo:** shared/catalog/
- **Aliases:** core/orchestration/referencias/ALIASES.yml
---

2
core/orchestration/agents/legacy/README.md
View File

@ -33,7 +33,7 @@ core/orchestration/
│ ├── SIMCO-MODIFICAR.md
│ └── SIMCO-{DOMINIO}.md
│
└── core/catalog/ # Funcionalidades reutilizables
└── shared/catalog/ # Funcionalidades reutilizables
├── auth/
├── notifications/
└── ...

19
core/orchestration/agents/perfiles/PERFIL-KB-MANAGER.md
View File

@ -2,9 +2,10 @@
**ID:** @PERFIL_KB_MANAGER
**Nombre:** Knowledge-Base Manager
**Version:** 1.0.0
**Version:** 1.1.0
**Sistema:** NEXUS v3.4 + SIMCO + CAPVED
**Creado:** 2026-01-04
**Actualizado:** 2026-01-04
**EPIC:** EPIC-012
---
@ -12,7 +13,7 @@
## ROL
Gestor de la base de conocimiento compartida del workspace, responsable de:
- Coordinar mejoras en `core/catalog/` y `shared/knowledge-base/`
- Coordinar mejoras en `shared/catalog/` y `shared/knowledge-base/`
- Analizar mejoras propagables siguiendo proceso CAPVED
- Detectar dependencias internas entre modulos
- Generar tareas SCRUM formales para propagacion
@ -30,7 +31,7 @@ Gestor de la base de conocimiento compartida del workspace, responsable de:
- C: Contexto del modulo afectado
- A: Analisis de impacto en KB y proyectos consumidores
- P: Plan de propagacion por niveles
3. **Actualizar core/catalog** si la mejora aplica a modulos base
3. **Actualizar shared/catalog** si la mejora aplica a modulos base
4. **Actualizar shared/knowledge-base** con cambios sincronizados
5. **Generar tareas SCRUM** para proyectos afectados usando `generate-scrum-tasks.sh`
6. **Coordinar con @PERFIL_PROJECT_AGENT** para ejecucion en proyectos
@ -101,7 +102,7 @@ Scripts disponibles en `devtools/scripts/propagation/`:
|
v
4. ACTUALIZAR NIVEL 0 (si aplica)
Actualizar modulo en core/catalog/
Actualizar modulo en shared/catalog/
Validar: Documentacion actualizada
|
v
@ -169,6 +170,9 @@ Scripts disponibles en `devtools/scripts/propagation/`:
| @PERFIL_DOCUMENTATION | Colabora en documentacion de cambios | Seccion en TASK |
| @PERFIL_INTEGRATION_VALIDATOR | Valida integracion final | Checklist de validacion |
| @PERFIL_TECH_LEADER | Escala decisiones arquitecturales | Issue/Reunion |
| @PERFIL_PROPAGATION_TRACKER | Tracking de estado de propagaciones | TRAZABILIDAD-PROPAGACION.yml |
| @PERFIL_PRODUCTION_MANAGER | Sincroniza cambios con produccion | Registro/Alerta |
| @PERFIL_SECRETS_MANAGER | Coordina cambios de secretos | Protocolo seguro |
---
@ -233,6 +237,13 @@ formato: "Comentario en tarea o seccion EJECUCION"
- USAGE.md: `shared/knowledge-base/propagacion/USAGE.md`
- USAGE-ORQUESTACION.md: `shared/knowledge-base/propagacion/USAGE-ORQUESTACION.md`
### Perfiles Relacionados
- @PERFIL_PROPAGATION_TRACKER: `orchestration/agents/perfiles/PERFIL-PROPAGATION-TRACKER.md`
- @PERFIL_PRODUCTION_MANAGER: `orchestration/agents/perfiles/PERFIL-PRODUCTION-MANAGER.md`
- @PERFIL_SECRETS_MANAGER: `orchestration/agents/perfiles/PERFIL-SECRETS-MANAGER.md`
- @PERFIL_MONITORING_AGENT: `orchestration/agents/perfiles/PERFIL-MONITORING-AGENT.md`
---
**Perfil creado por:** EPIC-012

4
core/orchestration/auditorias/EJECUCION-BLOQUE1-2025-12-12.md
View File

@ -45,7 +45,7 @@ grep "Versión:" /home/isem/workspace/core/orchestration/README.md | head -1
**Cambios realizados:**
- 131 archivos en `core/orchestration/` corregidos
- 11 archivos en `core/catalog/_reference/` corregidos
- 11 archivos en `shared/catalog/_reference/` corregidos
- Archivos de catalog raíz (*.yml, *.md) corregidos
**Verificación:**
@ -162,7 +162,7 @@ grep -n "Versión:" ~/workspace/core/orchestration/README.md | head -1
find ~/workspace/core/orchestration -perm 600 -type f | wc -l # Debe ser 0
# Verificar _reference/ poblados
find ~/workspace/core/catalog -name "*.reference.ts" | wc -l # Debe ser 11
find ~/workspace/shared/catalog -name "*.reference.ts" | wc -l # Debe ser 11
# Verificar UserIdConversionService exportado
grep "UserIdConversionService" ~/workspace/projects/gamilit/apps/backend/src/shared/services/index.ts

2
core/orchestration/auditorias/EJECUCION-BLOQUE5-6-2025-12-12.md
View File

@ -236,7 +236,7 @@ Sprint 0 P0 - Completado
# ERP-Suite shared-libs
ls -la ~/workspace/projects/erp-suite/apps/shared-libs/core/entities/
ls -la ~/workspace/projects/erp-suite/apps/shared-libs/core/middleware/
ls -la ~/workspace/projects/erp-suite/apps/shared-libs/core/constants/
ls -la ~/workspace/projects/erp-suite/apps/shared-libs/shared/constants/
# Betting Analytics
ls -la ~/workspace/projects/betting-analytics/apps/backend/src/

6
core/orchestration/auditorias/PLAN-AUDITORIA-ARQUITECTONICA-2025-12-12.md
View File

@ -78,7 +78,7 @@ core:
contenido: Directivas, principios, agentes, templates
prioridad: P0
- nombre: core/catalog
- nombre: shared/catalog
nivel: 0 (Global)
contenido: Funcionalidades reutilizables
prioridad: P0
@ -334,7 +334,7 @@ herramientas:
secuencia:
1_core:
- core/orchestration/directivas/ (principios base)
- core/catalog/ (funcionalidades compartidas)
- shared/catalog/ (funcionalidades compartidas)
prioridad: PRIMERO (establecer baseline)
2_proyectos_maduros:
@ -698,7 +698,7 @@ protocolo:
orden_ejecucion:
fase_6a_core:
- Correcciones en core/orchestration
- Correcciones en core/catalog
- Correcciones en shared/catalog
razon: Base para proyectos
fase_6b_proyectos_referencia:

2
core/orchestration/auditorias/PLAN-CORRECCIONES-COMPLETO-2025-12-12.md
View File

@ -849,7 +849,7 @@ P0 Completado
[ ] core/orchestration versión unificada 3.3
[ ] core/orchestration permisos 644
[ ] core/orchestration 6 principios documentados
[ ] core/catalog _reference/ poblados (8 funcionalidades)
[ ] shared/catalog _reference/ poblados (8 funcionalidades)
[ ] gamilit UserIdConversionService creado
[ ] gamilit Repository Factory implementado
[ ] gamilit God classes divididas (al menos 2)

8
core/orchestration/auditorias/REPORTE-ANALISIS-FASE2-2025-12-12.md
View File

@ -13,7 +13,7 @@ Se completó el análisis exhaustivo de **6 áreas** del workspace:
| Área | Estado | Score | Hallazgos P0 | P1 | P2 |
|------|--------|-------|--------------|----|----|
| **core/orchestration** | 🟡 Necesita mejoras | 7/10 | 3 | 5 | 3 |
| **core/catalog** | 🟡 Necesita mejoras | 8/10 | 1 | 4 | 6 |
| **shared/catalog** | 🟡 Necesita mejoras | 8/10 | 1 | 4 | 6 |
| **gamilit** | 🟡 Deuda técnica | 6.5/10 | 4 | 6 | 10 |
| **trading-platform** | 🟡 MVP en progreso | 6/10 | 5 | 5 | 4 |
| **erp-suite** | 🟡 Duplicación crítica | 5/10 | 3 | 4 | 3 |
@ -123,7 +123,7 @@ Se completó el análisis exhaustivo de **6 áreas** del workspace:
| Proyecto | Docs | ADRs | Inventarios | Propagación |
|----------|------|------|-------------|-------------|
| core/orchestration | ✅ 177 MD | ✅ Sistema | ✅ YAML | 🟡 Parcial |
| core/catalog | ✅ 8 funciones | N/A | ✅ Tracking | ✅ OK |
| shared/catalog | ✅ 8 funciones | N/A | ✅ Tracking | ✅ OK |
| gamilit | ✅ 17 carpetas | ✅ 20 ADRs | ✅ Completos | ✅ OK |
| trading-platform | ✅ 264 docs | ✅ 14 ADRs | ✅ Completos | ✅ OK |
| erp-suite | ✅ 449+ docs | ⚠️ Parcial | 🟡 Parcial | 🟡 Parcial |
@ -134,7 +134,7 @@ Se completó el análisis exhaustivo de **6 áreas** del workspace:
## CÓDIGO DUPLICADO ENTRE PROYECTOS
### Candidatos para core/catalog
### Candidatos para shared/catalog
| Funcionalidad | Proyectos | Estado | Acción |
|---------------|-----------|--------|--------|
@ -183,7 +183,7 @@ Se completó el análisis exhaustivo de **6 áreas** del workspace:
| # | Acción | Proyectos | Esfuerzo |
|---|--------|-----------|----------|
| 1 | Poblar `_reference/` en core/catalog | catalog | 8h |
| 1 | Poblar `_reference/` en shared/catalog | catalog | 8h |
| 2 | Sincronizar versionado orchestration a 3.3 | core | 2h |
| 3 | Cambiar permisos 600→644 en orchestration | core | 1h |
| 4 | Crear UserIdConversionService en gamilit | gamilit | 4h |

20
core/orchestration/directivas/DIRECTIVA-REFERENCIAS-PROYECTOS.md
View File

@ -34,7 +34,7 @@
┌─────────────────────────────────────────────────────────────────────┐
│ │
│ NUNCA referenciar un proyecto desde otro proyecto. │
│ SIEMPRE usar core/catalog/ o core/orchestration/ como fuente. │
│ SIEMPRE usar shared/catalog/ o core/orchestration/ como fuente. │
│ │
└─────────────────────────────────────────────────────────────────────┘
```
@ -47,7 +47,7 @@
| Tipo | Ejemplo | Uso Correcto |
|------|---------|--------------|
| **Core Catalog** | `core/catalog/auth/` | Componentes reutilizables |
| **Core Catalog** | `shared/catalog/auth/` | Componentes reutilizables |
| **Core Orchestration** | `core/orchestration/directivas/` | Directivas y templates |
| **Subproyecto Interno** | `erp-suite/apps/erp-core/` | Solo desde la misma suite |
| **Ejemplos Ilustrativos** | `ejemplos: "gamilit, trading"` | Solo como ilustración marcada |
@ -70,7 +70,7 @@
JERARQUÍA_VÁLIDA:
Nivel_0_Core:
- core/catalog/ # Funcionalidades reutilizables
- shared/catalog/ # Funcionalidades reutilizables
- core/orchestration/ # Directivas y templates
- core/devtools/ # Herramientas de desarrollo
@ -130,7 +130,7 @@ ANTES:
DESPUÉS:
# ELIMINAR la línea completamente
# O cambiar a:
| Catálogo global | `/home/isem/workspace/core/catalog/` |
| Catálogo global | `/home/isem/workspace/shared/catalog/` |
```
### Caso 2: Ruta a Otro Proyecto
@ -140,7 +140,7 @@ ANTES:
- Patrones auth: `projects/gamilit/apps/backend/src/auth/`
DESPUÉS:
- Patrones auth: `core/catalog/auth/`
- Patrones auth: `shared/catalog/auth/`
```
### Caso 3: Lista de Proyectos de Referencia
@ -153,11 +153,11 @@ ANTES:
DESPUÉS:
## Patrones de Referencia (desde Catálogo)
> **Nota:** Usar siempre core/catalog/ para componentes reutilizables.
> **Nota:** Usar siempre shared/catalog/ para componentes reutilizables.
| Patrón | Catálogo |
| Auth | core/catalog/auth/ |
| RLS | core/catalog/multi-tenancy/ |
| Auth | shared/catalog/auth/ |
| RLS | shared/catalog/multi-tenancy/ |
```
### Caso 4: Directiva con Header de Proyecto
@ -247,7 +247,7 @@ VALIDACIÓN_ADICIONAL:
```yaml
CONTEXTO_A_PASAR:
referencias_permitidas:
- core/catalog/
- shared/catalog/
- core/orchestration/
- {proyecto_actual}/ # Solo interno
referencias_prohibidas:
@ -295,7 +295,7 @@ echo "=== Fin de Auditoría ==="
## REFERENCIAS
- **Principio relacionado:** `PRINCIPIO-ANTI-DUPLICACION.md`
- **Catálogo global:** `core/catalog/`
- **Catálogo global:** `shared/catalog/`
- **Templates:** `core/orchestration/templates/`
- **Índice SIMCO:** `core/orchestration/directivas/simco/_INDEX.md`

2
core/orchestration/directivas/_MAP.md
View File

@ -12,7 +12,7 @@
**ANTES de implementar funcionalidades comunes**, verificar si existe código probado:
```
core/catalog/ # FUNCIONALIDADES REUTILIZABLES
shared/catalog/ # FUNCIONALIDADES REUTILIZABLES
├── CATALOG-INDEX.yml # Índice para búsqueda rápida
├── auth/ # Autenticación y autorización
├── session-management/ # Gestión de sesiones

2
core/orchestration/directivas/simco/SIMCO-PROPAGACION-MEJORAS.md
View File

@ -361,7 +361,7 @@ Ver: @NIVELES_PROP (`shared/knowledge-base/propagacion/NIVELES-PROPAGACION.yml`)
| Nivel | Nombre | Contenido |
|-------|--------|-----------|
| 0 | Core Catalog | core/catalog/ |
| 0 | Core Catalog | shared/catalog/ |
| 1 | Knowledge-Base | shared/knowledge-base/ |
| 2 | Proyectos Base | erp-core, gamilit, trading-platform |
| 3 | Proyectos Hoja | Verticales ERP, otros |

24
core/orchestration/referencias/ALIASES.yml
View File

@ -28,16 +28,16 @@ global:
# ═══════════════════════════════════════════════════════════════════
# CATÁLOGO DE FUNCIONALIDADES REUTILIZABLES (CONSULTAR PRIMERO)
# ═══════════════════════════════════════════════════════════════════
"@CATALOG": "core/catalog/"
"@CATALOG_INDEX": "core/catalog/CATALOG-INDEX.yml"
"@CATALOG_AUTH": "core/catalog/auth/"
"@CATALOG_SESSION": "core/catalog/session-management/"
"@CATALOG_RATELIMIT": "core/catalog/rate-limiting/"
"@CATALOG_NOTIFY": "core/catalog/notifications/"
"@CATALOG_TENANT": "core/catalog/multi-tenancy/"
"@CATALOG_FLAGS": "core/catalog/feature-flags/"
"@CATALOG_WS": "core/catalog/websocket/"
"@CATALOG_PAYMENTS": "core/catalog/payments/"
"@CATALOG": "shared/catalog/"
"@CATALOG_INDEX": "shared/catalog/CATALOG-INDEX.yml"
"@CATALOG_AUTH": "shared/catalog/auth/"
"@CATALOG_SESSION": "shared/catalog/session-management/"
"@CATALOG_RATELIMIT": "shared/catalog/rate-limiting/"
"@CATALOG_NOTIFY": "shared/catalog/notifications/"
"@CATALOG_TENANT": "shared/catalog/multi-tenancy/"
"@CATALOG_FLAGS": "shared/catalog/feature-flags/"
"@CATALOG_WS": "shared/catalog/websocket/"
"@CATALOG_PAYMENTS": "shared/catalog/payments/"
# ═══════════════════════════════════════════════════════════════════
# CAPVED - CICLO DE VIDA DE TAREAS (🆕 v2.0)
@ -222,8 +222,8 @@ niveles:
# ═══════════════════════════════════════════════════════════════════
"@CORE": "core/"
"@CORE_ORCH": "core/orchestration/"
"@CORE_CATALOG": "core/catalog/"
"@CORE_MODULES": "core/modules/"
"@CORE_CATALOG": "shared/catalog/"
"@CORE_MODULES": "shared/modules/"
# ═══════════════════════════════════════════════════════════════════
# NIVEL 2: PROYECTOS (alias dinámicos)

121
scripts/add_yaml.sh Normal file
View File

@ -0,0 +1,121 @@
#!/bin/bash
#
# Script to add YAML front-matter to markdown files
#
DOCS_PATH="/home/isem/workspace-v1/projects/trading-platform/docs"
PROCESSED=0
SKIPPED=0
add_yaml_to_file() {
local file="$1"
local first_line=$(head -1 "$file")
# Skip if already has YAML
if [ "$first_line" = "---" ]; then
((SKIPPED++))
return
fi
local filename=$(basename "$file")
local dirname=$(dirname "$file")
local parent_dir=$(basename "$dirname")
local content=$(cat "$file")
# Extract title from first H1
local title=$(echo "$content" | grep -m 1 "^# " | sed 's/^# //' | sed 's/:.*$//')
# Extract epic from path
local epic=$(echo "$file" | grep -o 'OQI-[0-9]*' | head -1)
# Determine file type and create YAML
local yaml=""
if [[ "$filename" == RF-* ]]; then
local file_id=$(echo "$filename" | sed 's/\.md$//' | grep -o '^RF-[A-Z]*-[0-9]*')
yaml="---
id: \"$file_id\"
title: \"$title\"
type: \"Requirement\"
status: \"Done\"
priority: \"Alta\"
epic: \"$epic\"
project: \"trading-platform\"
version: \"1.0.0\"
created_date: \"2025-12-05\"
updated_date: \"2026-01-04\"
---
"
elif [[ "$filename" == ET-* ]]; then
local file_id=$(echo "$filename" | sed 's/\.md$//' | grep -o '^ET-[A-Z]*-[0-9]*')
yaml="---
id: \"$file_id\"
title: \"$title\"
type: \"Technical Specification\"
status: \"Done\"
priority: \"Alta\"
epic: \"$epic\"
project: \"trading-platform\"
version: \"1.0.0\"
created_date: \"2025-12-05\"
updated_date: \"2026-01-04\"
---
"
elif [[ "$filename" == US-* ]]; then
local file_id=$(echo "$filename" | sed 's/\.md$//' | grep -o '^US-[A-Z]*-[0-9]*')
yaml="---
id: \"$file_id\"
title: \"$title\"
type: \"User Story\"
status: \"Done\"
priority: \"Media\"
epic: \"$epic\"
project: \"trading-platform\"
story_points: 3
created_date: \"2025-12-05\"
updated_date: \"2026-01-04\"
---
"
elif [[ "$filename" == "_MAP.md" ]]; then
yaml="---
id: \"MAP-$parent_dir\"
title: \"Mapa de $parent_dir\"
type: \"Index\"
project: \"trading-platform\"
updated_date: \"2026-01-04\"
---
"
else
local file_id=$(echo "$filename" | sed 's/\.md$//')
yaml="---
id: \"$file_id\"
title: \"$title\"
type: \"Documentation\"
project: \"trading-platform\"
version: \"1.0.0\"
updated_date: \"2026-01-04\"
---
"
fi
# Write new content
echo -n "$yaml$content" > "$file"
((PROCESSED++))
echo "PROCESSED: ${file#$DOCS_PATH/}"
}
# Process all markdown files
find "$DOCS_PATH" -name "*.md" -type f | while read file; do
add_yaml_to_file "$file"
done
echo ""
echo "=== SUMMARY ==="
echo "Processed: $PROCESSED"
echo "Skipped: $SKIPPED"

149
scripts/add_yaml_frontmatter.py Normal file
View File

@ -0,0 +1,149 @@
#!/usr/bin/env python3
"""
Script to add YAML front-matter to markdown files in trading-platform/docs
"""
import os
import re
from pathlib import Path
docs_path = '/home/isem/workspace-v1/projects/trading-platform/docs'
def get_epic_from_path(path):
"""Extract epic code from path like OQI-001, OQI-002, etc."""
match = re.search(r'OQI-(\d+)', path)
if match:
return f"OQI-{match.group(1)}"
return ""
def get_title_from_content(content, filename):
"""Extract title from first H1 header or filename"""
lines = content.split('\n')
for line in lines:
if line.startswith('# '):
title = line[2:].strip()
if ':' in title:
return title.split(':', 1)[1].strip()
return title
return filename.replace('.md', '').replace('-', ' ')
def create_yaml_frontmatter(file_type, file_id, title, epic):
"""Create YAML front-matter based on file type"""
if file_type == 'RF':
return f'''---
id: "{file_id}"
title: "{title}"
type: "Requirement"
status: "Done"
priority: "Alta"
epic: "{epic}"
project: "trading-platform"
version: "1.0.0"
created_date: "2025-12-05"
updated_date: "2026-01-04"
---
'''
elif file_type == 'ET':
return f'''---
id: "{file_id}"
title: "{title}"
type: "Technical Specification"
status: "Done"
priority: "Alta"
epic: "{epic}"
project: "trading-platform"
version: "1.0.0"
created_date: "2025-12-05"
updated_date: "2026-01-04"
---
'''
elif file_type == 'US':
return f'''---
id: "{file_id}"
title: "{title}"
type: "User Story"
status: "Done"
priority: "Media"
epic: "{epic}"
project: "trading-platform"
story_points: 3
created_date: "2025-12-05"
updated_date: "2026-01-04"
---
'''
elif file_type == 'MAP':
return f'''---
id: "MAP-{file_id}"
title: "Mapa de {file_id}"
type: "Index"
project: "trading-platform"
updated_date: "2026-01-04"
---
'''
else:
return f'''---
id: "{file_id}"
title: "{title}"
type: "Documentation"
project: "trading-platform"
version: "1.0.0"
updated_date: "2026-01-04"
---
'''
def process_file(filepath):
"""Add YAML front-matter to file if missing"""
with open(filepath, 'r', encoding='utf-8') as f:
content = f.read()
if content.strip().startswith('---'):
return False
filename = os.path.basename(filepath)
if filename.startswith('RF-'):
file_type = 'RF'
match = re.match(r'(RF-[A-Z]+-\d+)', filename)
file_id = match.group(1) if match else filename.replace('.md', '')
elif filename.startswith('ET-'):
file_type = 'ET'
match = re.match(r'(ET-[A-Z]+-\d+)', filename)
file_id = match.group(1) if match else filename.replace('.md', '')
elif filename.startswith('US-'):
file_type = 'US'
match = re.match(r'(US-[A-Z]+-\d+)', filename)
file_id = match.group(1) if match else filename.replace('.md', '')
elif filename == '_MAP.md':
file_type = 'MAP'
file_id = os.path.basename(os.path.dirname(filepath))
else:
file_type = 'OTHER'
file_id = filename.replace('.md', '')
epic = get_epic_from_path(filepath)
title = get_title_from_content(content, filename)
yaml_header = create_yaml_frontmatter(file_type, file_id, title, epic)
new_content = yaml_header + content
with open(filepath, 'w', encoding='utf-8') as f:
f.write(new_content)
return True
def main():
processed = 0
skipped = 0
for root, dirs, files in os.walk(docs_path):
for filename in files:
if filename.endswith('.md'):
filepath = os.path.join(root, filename)
if process_file(filepath):
processed += 1
print(f"PROCESSED: {os.path.relpath(filepath, docs_path)}")
else:
skipped += 1
print(f"\n=== SUMMARY ===")
print(f"Processed (added YAML): {processed}")
print(f"Skipped (already had YAML): {skipped}")
print(f"Total: {processed + skipped}")
if __name__ == '__main__':
main()

147
scripts/create-gitea-repos-api.sh Executable file
View File

@ -0,0 +1,147 @@
#!/bin/bash
# =============================================================================
# Script: Crear repositorios en Gitea via API
# Fecha: 2026-01-04
# Uso: ./create-gitea-repos-api.sh <GITEA_TOKEN>
# =============================================================================
GITEA_URL="http://72.60.226.4:3000"
GITEA_USER="rckrdmrd"
# Colores
GREEN='\033[0;32m'
YELLOW='\033[1;33m'
RED='\033[0;31m'
NC='\033[0m'
# Verificar token
if [ -z "$1" ]; then
echo -e "${RED}Error: Se requiere token de API${NC}"
echo ""
echo "Uso: $0 <GITEA_TOKEN>"
echo ""
echo "Para obtener el token:"
echo " 1. Ir a ${GITEA_URL}/${GITEA_USER}"
echo " 2. Settings -> Applications -> Generate New Token"
echo " 3. Dar permisos de 'repo' y 'write:repository'"
exit 1
fi
GITEA_TOKEN="$1"
echo -e "${GREEN}=== Creando repositorios en Gitea via API ===${NC}"
echo ""
# Funcion para crear repositorio
create_repo() {
local repo_name=$1
local description=$2
echo -ne "${YELLOW}Creando: $repo_name... ${NC}"
# Verificar si existe
exists=$(curl -s -o /dev/null -w "%{http_code}" \
"${GITEA_URL}/api/v1/repos/${GITEA_USER}/${repo_name}" \
-H "Authorization: token ${GITEA_TOKEN}")
if [ "$exists" = "200" ]; then
echo -e "${GREEN}Ya existe${NC}"
return 0
fi
# Crear repositorio
response=$(curl -s -X POST \
"${GITEA_URL}/api/v1/user/repos" \
-H "Authorization: token ${GITEA_TOKEN}" \
-H "Content-Type: application/json" \
-d "{
\"name\": \"${repo_name}\",
\"description\": \"${description}\",
\"private\": false,
\"auto_init\": false
}")
# Verificar resultado
if echo "$response" | grep -q "\"name\":\"${repo_name}\""; then
echo -e "${GREEN}Creado${NC}"
else
error=$(echo "$response" | python3 -c "import json,sys; print(json.load(sys.stdin).get('message', 'Unknown error'))" 2>/dev/null)
echo -e "${RED}Error: $error${NC}"
fi
}
# =============================================================================
# REPOSITORIOS PRINCIPALES DE PROYECTOS
# =============================================================================
echo "--- Repositorios Principales ---"
echo ""
# ERP Suite
create_repo "erp-suite" "ERP Suite - Sistema multi-vertical"
# ERP Core
create_repo "erp-core" "ERP Core - Modulos base compartidos"
# ERP Verticales
create_repo "erp-construccion" "ERP para empresas de construccion"
create_repo "erp-clinicas" "ERP para clinicas medicas"
create_repo "erp-retail" "ERP para retail"
create_repo "erp-mecanicas-diesel" "ERP para mecanicas diesel"
create_repo "erp-vidrio-templado" "ERP para fabricas de vidrio templado"
# Otros proyectos
create_repo "trading-platform" "Plataforma de trading y educacion financiera"
create_repo "betting-analytics" "Analytics para apuestas deportivas"
create_repo "inmobiliaria-analytics" "Analytics inmobiliario"
create_repo "platform-marketing-content" "Plataforma de marketing de contenido"
echo ""
echo "--- Subrepositorios ERP Retail ---"
echo ""
create_repo "erp-retail-backend" "ERP Retail - Backend API"
create_repo "erp-retail-frontend-web" "ERP Retail - Frontend Web"
create_repo "erp-retail-database" "ERP Retail - Database Scripts"
echo ""
echo "--- Subrepositorios Trading Platform ---"
echo ""
create_repo "trading-platform-backend" "Trading Platform - Backend API"
create_repo "trading-platform-frontend" "Trading Platform - Frontend Web"
create_repo "trading-platform-database" "Trading Platform - Database Scripts"
create_repo "trading-platform-ml-engine" "Trading Platform - ML Engine"
create_repo "trading-platform-data-service" "Trading Platform - Data Service"
echo ""
echo "--- Subrepositorios Betting Analytics ---"
echo ""
create_repo "betting-analytics-backend" "Betting Analytics - Backend API"
create_repo "betting-analytics-frontend" "Betting Analytics - Frontend Web"
create_repo "betting-analytics-database" "Betting Analytics - Database Scripts"
echo ""
echo "--- Subrepositorios Inmobiliaria Analytics ---"
echo ""
create_repo "inmobiliaria-analytics-backend" "Inmobiliaria Analytics - Backend API"
create_repo "inmobiliaria-analytics-frontend" "Inmobiliaria Analytics - Frontend Web"
create_repo "inmobiliaria-analytics-database" "Inmobiliaria Analytics - Database Scripts"
echo ""
echo "--- Subrepositorios Platform Marketing Content ---"
echo ""
create_repo "platform-marketing-content-backend" "Platform Marketing Content - Backend API"
create_repo "platform-marketing-content-frontend" "Platform Marketing Content - Frontend Web"
create_repo "platform-marketing-content-database" "Platform Marketing Content - Database Scripts"
echo ""
echo -e "${GREEN}=== Proceso completado ===${NC}"
echo ""
echo "Para hacer push de cada proyecto:"
echo " cd /home/isem/workspace-v1/projects/[PROYECTO]"
echo " git push -u origin main"
echo ""
echo "Subrepositorios configurados:"
echo " - erp-construccion: backend, frontend, database (YA PUSHED)"
echo " - erp-core: backend, frontend, database (YA PUSHED)"
echo " - erp-mecanicas-diesel: backend, frontend, database (YA PUSHED)"
echo ""

111
scripts/create-gitea-repos.sh Executable file
View File

@ -0,0 +1,111 @@
#!/bin/bash
# =============================================================================
# Script: Crear repositorios en Gitea para proyectos del workspace
# Fecha: 2025-01-04
# =============================================================================
GITEA_URL="http://72.60.226.4:3000"
GITEA_USER="rckrdmrd"
SSH_HOST="gitea-server"
# Colores
GREEN='\033[0;32m'
YELLOW='\033[1;33m'
RED='\033[0;31m'
NC='\033[0m'
echo -e "${GREEN}=== Creando repositorios en Gitea ===${NC}"
echo ""
# Función para crear repositorio via API (requiere token)
# Por ahora usamos git init y push
create_repo() {
local repo_name=$1
local description=$2
local local_path=$3
echo -e "${YELLOW}Creando: $repo_name${NC}"
if [ -n "$local_path" ] && [ -d "$local_path" ]; then
cd "$local_path"
# Verificar si ya tiene .git
if [ -d ".git" ]; then
echo " Ya tiene .git, verificando remote..."
existing_remote=$(git remote get-url origin 2>/dev/null)
if [ -n "$existing_remote" ]; then
echo " Remote existente: $existing_remote"
return 0
fi
else
git init
fi
# Configurar remote
git remote add origin git@${SSH_HOST}:${GITEA_USER}/${repo_name}.git 2>/dev/null || \
git remote set-url origin git@${SSH_HOST}:${GITEA_USER}/${repo_name}.git
echo -e " ${GREEN}Configurado: git@${SSH_HOST}:${GITEA_USER}/${repo_name}.git${NC}"
else
echo -e " ${RED}Path no existe: $local_path${NC}"
fi
}
# =============================================================================
# REPOSITORIOS PRINCIPALES (proyectos completos)
# =============================================================================
echo "--- Repositorios Principales ---"
# erp-construccion (subrepos ya existen)
create_repo "erp-construccion" "ERP para construccion - proyecto principal" \
"/home/isem/workspace-v1/projects/erp-construccion"
# erp-core (subrepos ya existen)
create_repo "erp-core" "ERP Core - modulos base compartidos" \
"/home/isem/workspace-v1/projects/erp-core"
# erp-mecanicas-diesel (subrepos ya existen)
create_repo "erp-mecanicas-diesel" "ERP para mecanicas diesel" \
"/home/isem/workspace-v1/projects/erp-mecanicas-diesel"
# erp-suite
create_repo "erp-suite" "ERP Suite - multi-vertical" \
"/home/isem/workspace-v1/projects/erp-suite"
# erp-clinicas
create_repo "erp-clinicas" "ERP para clinicas medicas" \
"/home/isem/workspace-v1/projects/erp-clinicas"
# erp-retail
create_repo "erp-retail" "ERP para retail" \
"/home/isem/workspace-v1/projects/erp-retail"
# erp-vidrio-templado
create_repo "erp-vidrio-templado" "ERP para vidrio templado" \
"/home/isem/workspace-v1/projects/erp-vidrio-templado"
# trading-platform
create_repo "trading-platform" "Plataforma de trading" \
"/home/isem/workspace-v1/projects/trading-platform"
# betting-analytics
create_repo "betting-analytics" "Analytics para apuestas deportivas" \
"/home/isem/workspace-v1/projects/betting-analytics"
# inmobiliaria-analytics
create_repo "inmobiliaria-analytics" "Analytics inmobiliario" \
"/home/isem/workspace-v1/projects/inmobiliaria-analytics"
# platform_marketing_content
create_repo "platform-marketing-content" "Plataforma de marketing y contenido" \
"/home/isem/workspace-v1/projects/platform_marketing_content"
echo ""
echo -e "${GREEN}=== Repositorios principales configurados ===${NC}"
echo ""
echo "Para crear los repositorios en Gitea, ejecuta desde cada proyecto:"
echo " git push -u origin main"
echo ""
echo "O crea los repositorios vacios primero en:"
echo " ${GITEA_URL}/${GITEA_USER}"

215
scripts/fix_yaml_frontmatter.py Normal file
View File

@ -0,0 +1,215 @@
#!/usr/bin/env python3
"""
Script para agregar YAML front-matter a archivos markdown que no lo tienen.
Soporta múltiples proyectos del workspace.
"""
import os
import re
from datetime import datetime
from pathlib import Path
def extract_title_from_content(content: str, filename: str) -> str:
"""Extrae título del primer H1 o usa el nombre del archivo."""
match = re.search(r'^#\s+(.+)$', content, re.MULTILINE)
if match:
return match.group(1).strip()
# Fallback: usar nombre de archivo
name = Path(filename).stem
return name.replace('-', ' ').replace('_', ' ').title()
def determine_file_type(filepath: str, filename: str) -> str:
"""Determina el tipo de documento basado en path y nombre."""
filepath_lower = filepath.lower()
filename_lower = filename.lower()
# Por prefijo de archivo
if filename_lower.startswith('rf-'):
return 'Requirement'
elif filename_lower.startswith('us-'):
return 'User Story'
elif filename_lower.startswith('et-'):
return 'Technical Specification'
elif filename_lower.startswith('adr-'):
return 'ADR'
elif filename_lower.startswith('epic-'):
return 'Epic'
elif filename_lower.startswith('pmc-') or filename_lower.startswith('oqi-'):
return 'Module Definition'
# Por nombre específico
if '_map' in filename_lower or '_index' in filename_lower:
return 'Index'
elif 'readme' in filename_lower:
return 'README'
elif 'vision' in filename_lower:
return 'Vision'
elif 'arquitectura' in filename_lower or 'architecture' in filename_lower:
return 'Architecture'
elif 'roadmap' in filename_lower:
return 'Roadmap'
elif 'guia' in filename_lower or 'guide' in filename_lower:
return 'Guide'
elif 'glosario' in filename_lower:
return 'Glossary'
elif 'board' in filename_lower:
return 'Planning'
elif 'definition-of' in filename_lower:
return 'Process'
elif 'auditoria' in filename_lower:
return 'Audit'
elif 'analisis' in filename_lower:
return 'Analysis'
elif 'modelo' in filename_lower or 'esquema' in filename_lower:
return 'Model'
elif 'api' in filename_lower:
return 'API Documentation'
# Por carpeta
if '/requerimientos/' in filepath_lower or '/requirements/' in filepath_lower:
return 'Requirement'
elif '/historias-usuario/' in filepath_lower or '/user-stories/' in filepath_lower:
return 'User Story'
elif '/especificaciones/' in filepath_lower:
return 'Technical Specification'
elif '/adr/' in filepath_lower or '97-adr' in filepath_lower:
return 'ADR'
elif '/planning/' in filepath_lower:
return 'Planning'
elif '/guias/' in filepath_lower or '/guides/' in filepath_lower:
return 'Guide'
return 'Documentation'
def extract_epic_from_path(filepath: str) -> str:
"""Extrae el epic/módulo del path si existe."""
# Buscar patrones como OQI-001, PMC-001, EPIC-001, etc.
match = re.search(r'(OQI-\d+|PMC-\d+|EPIC-\d+|BA-\d+|IA-\d+)', filepath, re.IGNORECASE)
if match:
return match.group(1).upper()
return ''
def generate_id(filename: str) -> str:
"""Genera un ID único basado en el nombre del archivo."""
name = Path(filename).stem
return name.upper().replace(' ', '-')
def determine_status(doc_type: str) -> str:
"""Determina el status por defecto según el tipo."""
if doc_type in ['Requirement', 'User Story', 'Technical Specification']:
return 'Draft'
elif doc_type in ['Vision', 'Architecture', 'Guide']:
return 'Active'
return 'Draft'
def has_yaml_frontmatter(content: str) -> bool:
"""Verifica si el contenido ya tiene YAML front-matter."""
return content.strip().startswith('---')
def add_yaml_frontmatter(filepath: str, project_name: str) -> bool:
"""Agrega YAML front-matter a un archivo si no lo tiene."""
try:
with open(filepath, 'r', encoding='utf-8') as f:
content = f.read()
if has_yaml_frontmatter(content):
return False
filename = os.path.basename(filepath)
title = extract_title_from_content(content, filename)
doc_type = determine_file_type(filepath, filename)
doc_id = generate_id(filename)
epic = extract_epic_from_path(filepath)
status = determine_status(doc_type)
today = datetime.now().strftime('%Y-%m-%d')
# Construir YAML
yaml_lines = [
'---',
f'id: "{doc_id}"',
f'title: "{title}"',
f'type: "{doc_type}"',
]
if epic:
yaml_lines.append(f'epic: "{epic}"')
yaml_lines.extend([
f'status: "{status}"',
f'project: "{project_name}"',
f'version: "1.0.0"',
f'created_date: "{today}"',
f'updated_date: "{today}"',
'---',
''
])
yaml_header = '\n'.join(yaml_lines)
new_content = yaml_header + content
with open(filepath, 'w', encoding='utf-8') as f:
f.write(new_content)
return True
except Exception as e:
print(f"Error procesando {filepath}: {e}")
return False
def process_project(docs_path: str, project_name: str):
"""Procesa todos los archivos .md de un proyecto."""
processed = 0
skipped = 0
errors = 0
for root, dirs, files in os.walk(docs_path):
for filename in files:
if filename.endswith('.md'):
filepath = os.path.join(root, filename)
try:
with open(filepath, 'r', encoding='utf-8') as f:
content = f.read()
if has_yaml_frontmatter(content):
skipped += 1
else:
if add_yaml_frontmatter(filepath, project_name):
processed += 1
print(f"✓ {filepath}")
else:
errors += 1
except Exception as e:
errors += 1
print(f"✗ {filepath}: {e}")
return processed, skipped, errors
def main():
base_path = '/home/isem/workspace-v1/projects'
projects = [
('platform_marketing_content', 'platform_marketing_content'),
('trading-platform', 'trading-platform'),
]
total_processed = 0
total_skipped = 0
total_errors = 0
for folder, project_name in projects:
docs_path = os.path.join(base_path, folder, 'docs')
if os.path.exists(docs_path):
print(f"\n=== Procesando: {project_name} ===")
processed, skipped, errors = process_project(docs_path, project_name)
print(f" Processed: {processed}, Skipped: {skipped}, Errors: {errors}")
total_processed += processed
total_skipped += skipped
total_errors += errors
else:
print(f"No existe: {docs_path}")
print(f"\n=== TOTAL ===")
print(f"Processed: {total_processed}")
print(f"Skipped: {total_skipped}")
print(f"Errors: {total_errors}")
if __name__ == '__main__':
main()

64
scripts/push-all-projects.sh Executable file
View File

@ -0,0 +1,64 @@
#!/bin/bash
# =============================================================================
# Script: Push todos los proyectos a Gitea
# Fecha: 2026-01-04
# Prerrequisito: Ejecutar create-gitea-repos-api.sh primero
# =============================================================================
WORKSPACE="/home/isem/workspace-v1"
# Colores
GREEN='\033[0;32m'
YELLOW='\033[1;33m'
RED='\033[0;31m'
NC='\033[0m'
echo -e "${GREEN}=== Push de proyectos a Gitea ===${NC}"
echo ""
# Proyectos a procesar
PROJECTS=(
"erp-construccion"
"erp-core"
"erp-mecanicas-diesel"
"erp-suite"
"erp-clinicas"
"erp-retail"
"erp-vidrio-templado"
"trading-platform"
"betting-analytics"
"inmobiliaria-analytics"
"platform_marketing_content"
)
for proj in "${PROJECTS[@]}"; do
echo -ne "${YELLOW}Pushing: $proj... ${NC}"
proj_path="${WORKSPACE}/projects/${proj}"
if [ ! -d "$proj_path/.git" ]; then
echo -e "${RED}Sin .git${NC}"
continue
fi
cd "$proj_path"
# Intentar push
result=$(git push -u origin main 2>&1)
if [ $? -eq 0 ]; then
echo -e "${GREEN}OK${NC}"
else
if echo "$result" | grep -q "Everything up-to-date"; then
echo -e "${GREEN}Ya sincronizado${NC}"
elif echo "$result" | grep -q "repository not found\|does not exist"; then
echo -e "${RED}Repo no existe en Gitea${NC}"
else
echo -e "${RED}Error${NC}"
echo " $result" | head -2
fi
fi
done
echo ""
echo -e "${GREEN}=== Proceso completado ===${NC}"

177
shared/README.md Normal file
View File

@ -0,0 +1,177 @@
# Shared - Recursos Compartidos
**Version:** 2.0.0
**Actualizado:** 2026-01-04
## Descripcion
El directorio `shared/` contiene todos los **recursos compartidos** del workspace: codigo reutilizable, catalogo de funcionalidades, tipos, constantes, y base de conocimiento con documentacion.
## Estructura
```
shared/
├── README.md # Este archivo
│
├── catalog/ # Catalogo de funcionalidades reutilizables
│ ├── auth/ # Autenticacion JWT + Passport
│ ├── session-management/ # Gestion de sesiones
│ ├── rate-limiting/ # Limitacion de tasa
│ ├── notifications/ # Sistema de notificaciones
│ ├── multi-tenancy/ # Soporte multi-tenant con RLS
│ ├── feature-flags/ # Feature flags dinamicos
│ ├── websocket/ # Comunicacion WebSocket
│ ├── payments/ # Integracion con Stripe
│ ├── audit-logs/ # Logs de auditoria
│ ├── portales/ # Portales multi-tenant
│ ├── template-saas/ # Template SaaS completo
│ ├── CATALOG-INDEX.yml # Indice maestro
│ └── README.md
│
├── modules/ # Codigo ejecutable compartido
│ ├── utils/ # Utilidades (date, string, validation)
│ ├── auth/ # Modulo de autenticacion
│ ├── billing/ # Modulo de facturacion
│ ├── notifications/ # Modulo de notificaciones
│ ├── payments/ # Modulo de pagos
│ ├── multitenant/ # Modulo multi-tenancy
│ └── package.json
│
├── constants/ # Constantes globales TypeScript
│ ├── enums.constants.ts # Enums universales
│ ├── regex.constants.ts # Patrones regex
│ └── index.ts
│
├── types/ # Tipos TypeScript compartidos
│ ├── api.types.ts # Tipos de API
│ ├── common.types.ts # Tipos comunes
│ └── index.ts
│
└── knowledge-base/ # Base de conocimiento
├── modules/ # Documentacion de modulos
├── platforms/ # Plataformas base (SaaS, ERP, etc.)
├── projects/ # Proyectos de referencia
├── standards/ # Estandares tecnicos
├── architecture/ # Patrones arquitectonicos
├── patterns/ # Patrones de desarrollo
├── propagacion/ # Sistema de propagacion
├── templates/ # Templates
├── reference/ # Referencias legacy
├── CATALOGO-MODULOS.yml # Catalogo de 37 modulos
├── TRAZABILIDAD-PROYECTOS.yml
└── README.md
```
## Uso
### Catalogo de Funcionalidades
```bash
# Buscar funcionalidad disponible
cat shared/catalog/CATALOG-INDEX.yml
# Consultar implementacion especifica
cat shared/catalog/auth/README.md
cat shared/catalog/auth/IMPLEMENTATION.md
```
### Importar Modulos
```typescript
// Utilidades
import { formatDate, slugify, isEmail } from '@shared/modules/utils';
// Constantes
import { UserStatus, PaymentStatus } from '@shared/constants';
import { EMAIL_REGEX, UUID_REGEX } from '@shared/constants/regex.constants';
// Tipos
import { ApiResponse, PaginatedResponse } from '@shared/types';
import { BaseEntity, Address } from '@shared/types/common.types';
```
### Knowledge Base
```bash
# Ver catalogo de modulos
cat shared/knowledge-base/CATALOGO-MODULOS.yml
# Ver trazabilidad de proyectos
cat shared/knowledge-base/TRAZABILIDAD-PROYECTOS.yml
# Consultar documentacion de modulo
cat shared/knowledge-base/modules/authentication/_INDEX.md
```
## Aliases
```yaml
# Catalogo
@CATALOG: shared/catalog/
@CATALOG_INDEX: shared/catalog/CATALOG-INDEX.yml
@CATALOG_AUTH: shared/catalog/auth/
@CATALOG_SESSION: shared/catalog/session-management/
@CATALOG_RATELIMIT: shared/catalog/rate-limiting/
@CATALOG_NOTIFY: shared/catalog/notifications/
@CATALOG_TENANT: shared/catalog/multi-tenancy/
@CATALOG_FLAGS: shared/catalog/feature-flags/
@CATALOG_WS: shared/catalog/websocket/
@CATALOG_PAYMENTS: shared/catalog/payments/
# Modulos
@MODULES: shared/modules/
@MOD_UTILS: shared/modules/utils/
@MOD_AUTH: shared/modules/auth/
@MOD_NOTIFY: shared/modules/notifications/
@MOD_PAYMENTS: shared/modules/payments/
@MOD_BILLING: shared/modules/billing/
@MOD_TENANT: shared/modules/multitenant/
# Tipos y Constantes
@CONSTANTS: shared/constants/
@TYPES: shared/types/
# Knowledge Base
@KB: shared/knowledge-base/
@KB_MODULES: shared/knowledge-base/modules/
@KB_PLATFORMS: shared/knowledge-base/platforms/
@KB_PROJECTS: shared/knowledge-base/projects/
```
## Funcionalidades del Catalogo
| Funcionalidad | Estado | Origen | Stack |
|---------------|--------|--------|-------|
| auth | Production-Ready | Gamilit | NestJS + JWT + Passport |
| session-management | Production-Ready | Gamilit | NestJS + TypeORM |
| rate-limiting | Production-Ready | Gamilit | NestJS + @nestjs/throttler |
| notifications | Production-Ready | Gamilit | NestJS + Email/Push |
| multi-tenancy | Production-Ready | Gamilit | NestJS + PostgreSQL RLS |
| feature-flags | Production-Ready | Gamilit | NestJS + TypeORM |
| websocket | Production-Ready | Trading | NestJS + Socket.io |
| payments | Production-Ready | Trading | NestJS + Stripe |
| audit-logs | Documentando | ERP | NestJS + TypeORM |
| portales | Documentando | PMC | NestJS + Multi-tenant |
| template-saas | Documentando | Workspace | Full-stack |
## Relacion con Proyectos
Los proyectos en `projects/` pueden importar recursos de `shared/`:
```
projects/gamilit/ → usa shared/catalog/auth, shared/modules/utils
projects/erp-core/ → usa shared/catalog/multi-tenancy
projects/trading-platform/ → usa shared/catalog/websocket, payments
```
## Ver Tambien
- [Catalogo de Funcionalidades](catalog/README.md)
- [Knowledge Base](knowledge-base/README.md)
- [Core (Arquitectura)](../core/README.md)
- [Control Plane (Governance)](../control-plane/README.md)
---
**Mantenido por:** Architecture-Analyst
**Ultima actualizacion:** 2026-01-04

26
core/catalog/CATALOG-INDEX.yml → shared/catalog/CATALOG-INDEX.yml
View File

@ -28,7 +28,7 @@ funcionalidades:
auth:
nombre: "Autenticación y Autorización"
path: "core/catalog/auth/"
path: "shared/catalog/auth/"
alias: "@CATALOG_AUTH"
estado: "production-ready" # production-ready | documentando | pendiente
origen: "projects/gamilit"
@ -68,7 +68,7 @@ funcionalidades:
session-management:
nombre: "Gestión de Sesiones"
path: "core/catalog/session-management/"
path: "shared/catalog/session-management/"
alias: "@CATALOG_SESSION"
estado: "production-ready"
origen: "projects/gamilit"
@ -98,7 +98,7 @@ funcionalidades:
rate-limiting:
nombre: "Limitación de Tasa (Rate Limiting)"
path: "core/catalog/rate-limiting/"
path: "shared/catalog/rate-limiting/"
alias: "@CATALOG_RATELIMIT"
estado: "production-ready"
origen: "projects/gamilit"
@ -129,7 +129,7 @@ funcionalidades:
notifications:
nombre: "Sistema de Notificaciones"
path: "core/catalog/notifications/"
path: "shared/catalog/notifications/"
alias: "@CATALOG_NOTIFY"
estado: "production-ready"
origen: "projects/gamilit"
@ -165,7 +165,7 @@ funcionalidades:
websocket:
nombre: "Comunicación WebSocket"
path: "core/catalog/websocket/"
path: "shared/catalog/websocket/"
alias: "@CATALOG_WS"
estado: "production-ready"
origen: "projects/trading-platform"
@ -199,7 +199,7 @@ funcionalidades:
multi-tenancy:
nombre: "Soporte Multi-Tenant"
path: "core/catalog/multi-tenancy/"
path: "shared/catalog/multi-tenancy/"
alias: "@CATALOG_TENANT"
estado: "production-ready"
origen: "projects/gamilit"
@ -233,7 +233,7 @@ funcionalidades:
feature-flags:
nombre: "Feature Flags Dinámicos"
path: "core/catalog/feature-flags/"
path: "shared/catalog/feature-flags/"
alias: "@CATALOG_FLAGS"
estado: "production-ready"
origen: "projects/gamilit"
@ -268,7 +268,7 @@ funcionalidades:
payments:
nombre: "Integración de Pagos"
path: "core/catalog/payments/"
path: "shared/catalog/payments/"
alias: "@CATALOG_PAYMENTS"
estado: "production-ready"
origen: "projects/trading-platform"
@ -304,7 +304,7 @@ funcionalidades:
template-saas:
nombre: "Template SaaS Multi-tenant"
path: "core/catalog/template-saas/"
path: "shared/catalog/template-saas/"
alias: "@CATALOG_SAAS"
estado: "production-ready"
origen: "projects/erp-core, projects/gamilit"
@ -342,7 +342,7 @@ funcionalidades:
portales:
nombre: "Portales y Dashboards"
path: "core/catalog/portales/"
path: "shared/catalog/portales/"
alias: "@CATALOG_PORTALES"
estado: "production-ready"
origen: "projects/gamilit, projects/trading-platform"
@ -379,7 +379,7 @@ funcionalidades:
audit-logs:
nombre: "Sistema de Auditoria"
path: "core/catalog/audit-logs/"
path: "shared/catalog/audit-logs/"
alias: "@CATALOG_AUDIT"
estado: "production-ready"
origen: "projects/gamilit, projects/erp-core"
@ -419,7 +419,7 @@ funcionalidades:
# ─────────────────────────────────────────────────────────────────────────────────
#
# Para buscar funcionalidad por keyword:
# grep -i "{keyword}" core/catalog/CATALOG-INDEX.yml
# grep -i "{keyword}" shared/catalog/CATALOG-INDEX.yml
#
# Ejemplos:
# grep -i "login" → auth
@ -469,7 +469,7 @@ instrucciones:
- Considerar agregar al catálogo después
que_hacer_si_encuentra: |
1. Ir a: core/catalog/{funcionalidad}/
1. Ir a: shared/catalog/{funcionalidad}/
2. Leer: README.md (descripción y trade-offs)
3. Seguir: IMPLEMENTATION.md (pasos)
4. Copiar: _reference/ (código base)

0
core/catalog/CATALOG-USAGE-TRACKING.yml → shared/catalog/CATALOG-USAGE-TRACKING.yml
View File

26
core/catalog/README.md → shared/catalog/README.md
View File

@ -30,7 +30,7 @@ Este catálogo centraliza **código funcional probado y documentado** que puede
## ESTRUCTURA DEL CATÁLOGO
```
core/catalog/
shared/catalog/
├── README.md ← ESTÁS AQUÍ
├── CATALOG-INDEX.yml # Índice máquina-readable
│
@ -103,16 +103,16 @@ core/catalog/
### Alias Disponibles
```yaml
@CATALOG: core/catalog/
@CATALOG_INDEX: core/catalog/CATALOG-INDEX.yml
@CATALOG_AUTH: core/catalog/auth/
@CATALOG_SESSION: core/catalog/session-management/
@CATALOG_RATELIMIT: core/catalog/rate-limiting/
@CATALOG_NOTIFY: core/catalog/notifications/
@CATALOG_TENANT: core/catalog/multi-tenancy/
@CATALOG_FLAGS: core/catalog/feature-flags/
@CATALOG_WS: core/catalog/websocket/
@CATALOG_PAYMENTS: core/catalog/payments/
@CATALOG: shared/catalog/
@CATALOG_INDEX: shared/catalog/CATALOG-INDEX.yml
@CATALOG_AUTH: shared/catalog/auth/
@CATALOG_SESSION: shared/catalog/session-management/
@CATALOG_RATELIMIT: shared/catalog/rate-limiting/
@CATALOG_NOTIFY: shared/catalog/notifications/
@CATALOG_TENANT: shared/catalog/multi-tenancy/
@CATALOG_FLAGS: shared/catalog/feature-flags/
@CATALOG_WS: shared/catalog/websocket/
@CATALOG_PAYMENTS: shared/catalog/payments/
```
---
@ -251,7 +251,7 @@ Una funcionalidad DEBE agregarse al catálogo si cumple **TODOS** estos criterio
```markdown
PASO 1: PREPARAR ESTRUCTURA
[ ] Crear directorio: core/catalog/{nombre-en-kebab-case}/
[ ] Crear directorio: shared/catalog/{nombre-en-kebab-case}/
[ ] Crear README.md vacío
[ ] Crear IMPLEMENTATION.md vacío
@ -286,7 +286,7 @@ PASO 4: ACTUALIZAR ÍNDICES (OBLIGATORIO)
PASO 5: ACTUALIZAR ALIASES (OBLIGATORIO)
[ ] Editar core/orchestration/referencias/ALIASES.yml:
- Agregar alias @CATALOG_{NOMBRE}
- Ejemplo: @CATALOG_AUDIT: "core/catalog/audit-logs/"
- Ejemplo: @CATALOG_AUDIT: "shared/catalog/audit-logs/"
PASO 6: VALIDAR
[ ] Verificar que grep encuentra la funcionalidad en CATALOG-INDEX.yml

0
core/catalog/audit-logs/IMPLEMENTATION.md → shared/catalog/audit-logs/IMPLEMENTATION.md
View File

0
core/catalog/audit-logs/README.md → shared/catalog/audit-logs/README.md
View File

0
core/catalog/auth/IMPLEMENTATION.md → shared/catalog/auth/IMPLEMENTATION.md
View File

0
core/catalog/auth/README.md → shared/catalog/auth/README.md
View File

0
core/catalog/auth/_reference/README.md → shared/catalog/auth/_reference/README.md
View File

0
core/catalog/auth/_reference/auth.service.reference.ts → shared/catalog/auth/_reference/auth.service.reference.ts
View File

0
core/catalog/auth/_reference/jwt-auth.guard.reference.ts → shared/catalog/auth/_reference/jwt-auth.guard.reference.ts
View File

0
core/catalog/auth/_reference/jwt.strategy.reference.ts → shared/catalog/auth/_reference/jwt.strategy.reference.ts
View File

0
core/catalog/auth/_reference/roles.guard.reference.ts → shared/catalog/auth/_reference/roles.guard.reference.ts
View File

0
core/catalog/auth/_reference_frontend/auth-hooks.example.ts → shared/catalog/auth/_reference_frontend/auth-hooks.example.ts
View File

0
core/catalog/feature-flags/IMPLEMENTATION.md → shared/catalog/feature-flags/IMPLEMENTATION.md
View File

0
core/catalog/feature-flags/README.md → shared/catalog/feature-flags/README.md
View File

0
core/catalog/feature-flags/_reference/feature-flags.service.reference.ts → shared/catalog/feature-flags/_reference/feature-flags.service.reference.ts
View File

0
core/catalog/multi-tenancy/IMPLEMENTATION.md → shared/catalog/multi-tenancy/IMPLEMENTATION.md
View File

0
core/catalog/multi-tenancy/README.md → shared/catalog/multi-tenancy/README.md
View File

0
core/catalog/multi-tenancy/_reference/tenant.guard.reference.ts → shared/catalog/multi-tenancy/_reference/tenant.guard.reference.ts
View File

0
core/catalog/notifications/IMPLEMENTATION.md → shared/catalog/notifications/IMPLEMENTATION.md
View File

0
core/catalog/notifications/README.md → shared/catalog/notifications/README.md
View File

0
core/catalog/notifications/_reference/notification.service.reference.ts → shared/catalog/notifications/_reference/notification.service.reference.ts
View File

0
core/catalog/payments/IMPLEMENTATION.md → shared/catalog/payments/IMPLEMENTATION.md
View File

0
core/catalog/payments/README.md → shared/catalog/payments/README.md
View File

0
core/catalog/payments/_reference/README.md → shared/catalog/payments/_reference/README.md
View File

0
core/catalog/payments/_reference/payment.service.reference.ts → shared/catalog/payments/_reference/payment.service.reference.ts
View File

0
core/catalog/portales/IMPLEMENTATION.md → shared/catalog/portales/IMPLEMENTATION.md
View File

0
core/catalog/portales/README.md → shared/catalog/portales/README.md
View File

0
core/catalog/rate-limiting/IMPLEMENTATION.md → shared/catalog/rate-limiting/IMPLEMENTATION.md
View File

0
core/catalog/rate-limiting/README.md → shared/catalog/rate-limiting/README.md
View File

0
core/catalog/rate-limiting/_reference/rate-limiter.service.reference.ts → shared/catalog/rate-limiting/_reference/rate-limiter.service.reference.ts
View File

0
core/catalog/session-management/IMPLEMENTATION.md → shared/catalog/session-management/IMPLEMENTATION.md
View File

0
core/catalog/session-management/README.md → shared/catalog/session-management/README.md
View File

0
core/catalog/session-management/_reference/session-management.service.reference.ts → shared/catalog/session-management/_reference/session-management.service.reference.ts
View File

0
core/catalog/template-saas/IMPLEMENTATION.md → shared/catalog/template-saas/IMPLEMENTATION.md
View File

0
core/catalog/template-saas/README.md → shared/catalog/template-saas/README.md
View File

0
core/catalog/websocket/IMPLEMENTATION.md → shared/catalog/websocket/IMPLEMENTATION.md
View File

0
core/catalog/websocket/README.md → shared/catalog/websocket/README.md
View File

0
core/catalog/websocket/_reference/websocket.gateway.reference.ts → shared/catalog/websocket/_reference/websocket.gateway.reference.ts
View File

2
core/constants/enums.constants.ts → shared/constants/enums.constants.ts
View File

@ -5,7 +5,7 @@
* Estos son los enums "universales" que aplican a múltiples proyectos.
* Los enums específicos de cada proyecto deben estar en su propio repositorio.
*
* @module @core/constants/enums
* @module @shared/constants/enums
* @version 1.0.0
*/

2
core/constants/index.ts → shared/constants/index.ts
View File

@ -3,7 +3,7 @@
*
* Universal constants shared across all projects in the workspace.
*
* @module @core/constants
* @module @shared/constants
* @version 1.0.0
*/

2
core/constants/regex.constants.ts → shared/constants/regex.constants.ts
View File

@ -3,7 +3,7 @@
*
* Regex patterns compartidos entre todos los proyectos del workspace.
*
* @module @core/constants/regex
* @module @shared/constants/regex
* @version 1.0.0
*/

6
shared/knowledge-base/README.md
View File

@ -138,14 +138,14 @@ El Knowledge Base es parte del ecosistema NEXUS:
```
workspace-v1/
├── orchestration/ # Sistema de directivas SIMCO
├── core/catalog/ # Codigo de catalogo (legacy)
├── shared/catalog/ # Codigo de catalogo (legacy)
├── shared/knowledge-base/ # ESTE DIRECTORIO
└── projects/ # Proyectos de produccion
```
### Relacion con core/catalog
### Relacion con shared/catalog
- **core/catalog/**: Codigo legacy, referencia
- **shared/catalog/**: Codigo legacy, referencia
- **shared/knowledge-base/modules/**: Modulos documentados y versionados
---

139
shared/knowledge-base/TRAZABILIDAD-PROPAGACION.yml Normal file
View File

@ -0,0 +1,139 @@
# TRAZABILIDAD DE PROPAGACIÓN
# Sistema: SIMCO - NEXUS v4.0
# Propósito: Tracking de propagaciones entre proyectos y KB
# Versión: 1.0.0
# Fecha: 2026-01-04
# ═══════════════════════════════════════════════════════════════════════════════
# REGISTRO DE PROPAGACIONES
# ═══════════════════════════════════════════════════════════════════════════════
propagaciones:
# Ejemplo de entrada:
# - id: "PROP-2026-01-001"
# fecha: "2026-01-04"
# tipo: "bug_fix"
# origen:
# proyecto: "gamilit"
# archivo: "src/utils/validation.ts"
# tarea: "HU-123"
# descripcion: "Corrección de validación de emails"
# destinos:
# - proyecto: "erp-core"
# estado: "completado"
# fecha_aplicado: "2026-01-04"
# - proyecto: "knowledge-base"
# ubicacion: "patterns/validation/"
# estado: "completado"
# estado_general: "completado"
# notas: ""
# Agregar nuevas propagaciones aquí:
- id: "PROP-TEMPLATE"
fecha: "{YYYY-MM-DD}"
tipo: "{security_fix | bug_fix | feature | refactor | docs}"
origen:
proyecto: "{nombre_proyecto}"
archivo: "{ruta/archivo}"
tarea: "{HU-XXX}"
descripcion_cambio: "{qué se cambió}"
destinos:
- proyecto: "{nombre_destino}"
tipo_destino: "{proyecto | kb | catalog}"
ubicacion: "{ruta si aplica}"
estado: "{pendiente | en_progreso | completado | fallido}"
fecha_aplicado: ""
verificado: false
notas: ""
estado_general: "{pendiente | en_progreso | completado | parcial | fallido}"
migration_guide:
requerido: false
ubicacion: ""
verificacion:
tests_pasados: false
build_pasado: false
revisado_por: ""
notas: ""
# ═══════════════════════════════════════════════════════════════════════════════
# ÍNDICE POR PROYECTO ORIGEN
# ═══════════════════════════════════════════════════════════════════════════════
indice_por_origen:
gamilit: []
trading-platform: []
betting-analytics: []
inmobiliaria-analytics: []
platform_marketing_content: []
erp-suite: []
erp-core: []
erp-clinicas: []
erp-construccion: []
erp-mecanicas-diesel: []
erp-retail: []
erp-vidrio-templado: []
# ═══════════════════════════════════════════════════════════════════════════════
# ÍNDICE POR DESTINO
# ═══════════════════════════════════════════════════════════════════════════════
indice_por_destino:
knowledge-base:
patterns: []
lessons-learned: []
reference: []
antipatterns: []
catalog:
components: []
utils: []
hooks: []
services: []
proyectos:
gamilit: []
trading-platform: []
erp-core: []
# ... otros proyectos
# ═══════════════════════════════════════════════════════════════════════════════
# ESTADÍSTICAS
# ═══════════════════════════════════════════════════════════════════════════════
estadisticas:
total_propagaciones: 0
por_tipo:
security_fix: 0
bug_fix: 0
feature: 0
refactor: 0
docs: 0
por_estado:
completadas: 0
en_progreso: 0
pendientes: 0
fallidas: 0
sla:
security_cumplido: 0
security_incumplido: 0
bug_cumplido: 0
bug_incumplido: 0
ultima_actualizacion: "2026-01-04"
# ═══════════════════════════════════════════════════════════════════════════════
# ALERTAS PENDIENTES
# ═══════════════════════════════════════════════════════════════════════════════
alertas:
security_pendientes: [] # IDs de propagaciones security pendientes
sla_en_riesgo: [] # IDs próximos a vencer SLA
fallidas_sin_resolver: [] # IDs fallidos sin resolución

2
shared/knowledge-base/architecture/PATRON-MULTI-TENANT.md
View File

@ -187,7 +187,7 @@ describe('Tenant Isolation', () => {
## Referencias
- `core/catalog/multi-tenancy/` - Modulo del catalogo
- `shared/catalog/multi-tenancy/` - Modulo del catalogo
- `projects/erp-core/database/ddl/` - Ejemplos de DDL
- PostgreSQL RLS Documentation

2
shared/knowledge-base/lessons-learned/LESSONS-WORKSPACE-V1.md
View File

@ -76,7 +76,7 @@ Migracion del workspace original a workspace-v1 con nueva estructura de:
**Problema:** Codigo duplicado entre proyectos.
**Solucion:** Expandir `core/catalog/` con:
**Solucion:** Expandir `shared/catalog/` con:
- README.md (descripcion, trade-offs)
- IMPLEMENTATION.md (guia paso a paso)
- _reference/ (codigo ejemplo)

2
shared/knowledge-base/patterns/PATRON-RLS-POLICIES.md
View File

@ -234,7 +234,7 @@ ORDER BY schemaname, tablename;
## Referencias
- `architecture/PATRON-MULTI-TENANT.md`
- `core/catalog/multi-tenancy/`
- `shared/catalog/multi-tenancy/`
- PostgreSQL RLS Documentation
---

391
shared/knowledge-base/projects/erp-core/docs/00-vision-general/VISION-ERP-CORE.md
View File

@ -4,6 +4,8 @@
ERP Core es la **base generica reutilizable** que proporciona el 60-70% del codigo compartido para todas las verticales del ERP Suite. Es una adaptacion de los patrones de Odoo al stack TypeScript/Node.js/React.
**Modelo de Negocio:** Plataforma SaaS multi-tenant con facturacion per-seat, integraciones de pago fisico y digital, chatbot IA conversacional, y aplicaciones moviles por perfil de trabajador.
---
## Proposito
@ -18,6 +20,10 @@ Desarrollar ERPs verticales desde cero es costoso y repetitivo. El 60-70% de la
- Productos e inventario
- Ventas y compras
- Contabilidad basica
- **Plataforma SaaS con suscripciones**
- **Procesamiento de pagos (online y terminales)**
- **Asistente IA conversacional**
- **Apps moviles con control de asistencia**
### Solucion
@ -26,6 +32,9 @@ ERP Core provee esta funcionalidad comun de forma:
- **Extensible:** Las verticales pueden extender sin modificar
- **Multi-tenant:** Aislamiento por tenant desde el diseno
- **Documentado:** Documentacion antes de desarrollo
- **SaaS-Ready:** Billing, suscripciones y feature flags incluidos
- **IA-First:** Chatbot inteligente con MCP Server y RAG
- **Mobile-First:** Apps nativas por perfil con biometricos
---
@ -92,23 +101,49 @@ ERP Core provee esta funcionalidad comun de forma:
## Modulos Core (MGN-*)
| Codigo | Modulo | Descripcion | Prioridad | Estado |
|--------|--------|-------------|-----------|--------|
| MGN-001 | auth | Autenticacion JWT, OAuth, sessions | P0 | En desarrollo |
| MGN-002 | users | Gestion de usuarios CRUD | P0 | En desarrollo |
| MGN-003 | roles | Roles y permisos (RBAC) | P0 | Planificado |
| MGN-004 | tenants | Multi-tenancy, aislamiento | P0 | Planificado |
| MGN-005 | catalogs | Catalogos maestros genericos | P1 | Planificado |
| MGN-006 | settings | Configuracion del sistema | P1 | Planificado |
| MGN-007 | audit | Auditoria y logs | P1 | Planificado |
| MGN-008 | notifications | Sistema de notificaciones | P2 | Planificado |
| MGN-009 | reports | Reportes genericos | P2 | Planificado |
| MGN-010 | financial | Contabilidad basica | P1 | Planificado |
| MGN-011 | inventory | Inventario basico | P1 | Planificado |
| MGN-012 | purchasing | Compras basicas | P1 | Planificado |
| MGN-013 | sales | Ventas basicas | P1 | Planificado |
| MGN-014 | crm | CRM basico | P2 | Planificado |
| MGN-015 | projects | Proyectos genericos | P2 | Planificado |
### Fase Foundation (P0) - Modulos Base
| Codigo | Modulo | Descripcion | Estado |
|--------|--------|-------------|--------|
| MGN-001 | auth | Autenticacion JWT, OAuth, sessions, MFA | En desarrollo |
| MGN-002 | users | Gestion de usuarios CRUD, perfiles | En desarrollo |
| MGN-003 | roles | Roles y permisos (RBAC), feature flags | Planificado |
| MGN-004 | tenants | Multi-tenancy, aislamiento RLS | Planificado |
### Fase Core Business (P1) - Modulos de Negocio
| Codigo | Modulo | Descripcion | Estado |
|--------|--------|-------------|--------|
| MGN-005 | catalogs | Catalogos maestros genericos | Planificado |
| MGN-006 | settings | Configuracion del sistema | Planificado |
| MGN-007 | audit | Auditoria y logs | Planificado |
| MGN-008 | notifications | Sistema de notificaciones (email, push, in-app) | Planificado |
| MGN-009 | reports | Reportes genericos y dashboards | Planificado |
| MGN-010 | financial | Contabilidad basica, asientos | Planificado |
| MGN-011 | inventory | Inventario basico, stock | Planificado |
| MGN-012 | purchasing | Compras basicas, ordenes | Planificado |
| MGN-013 | sales | Ventas basicas, facturacion | Planificado |
| MGN-014 | crm | CRM basico, leads, oportunidades | Planificado |
| MGN-015 | projects | Proyectos genericos, tareas | Planificado |
### Fase SaaS Platform (P2) - Monetizacion e Integraciones
| Codigo | Modulo | Descripcion | Estado |
|--------|--------|-------------|--------|
| MGN-016 | billing | Suscripciones SaaS, per-seat pricing, cupones | Backlog |
| MGN-017 | payments | Stripe + terminales (MercadoPago, Clip) | Backlog |
| MGN-018 | whatsapp | WhatsApp Business Cloud API, chatbots | Backlog |
| MGN-019 | ai-agents | MCP Server, RAG, pgvector, knowledge bases | Backlog |
| MGN-020 | onboarding | Wizard de onboarding, setup inicial | Backlog |
| MGN-021 | ai-tokens | Sistema de tokens IA, paquetes, consumo | Backlog |
### Fase Mobile (P3) - Aplicaciones Moviles
| Codigo | Modulo | Descripcion | Estado |
|--------|--------|-------------|--------|
| MGN-022 | mobile-core | Core React Native: auth, sync, biometrics | Backlog |
| MGN-023 | time-attendance | Checador biometrico + GPS, entradas/salidas | Backlog |
| MGN-024 | worker-profiles | Perfiles de trabajador, modulos por rol | Backlog |
---
@ -144,6 +179,275 @@ ERP Core provee esta funcionalidad comun de forma:
| RLS | - | Row-Level Security |
| uuid-ossp | - | Generacion UUIDs |
| pg_trgm | - | Busqueda fuzzy |
| pgvector | 0.5+ | Embeddings para IA |
### Mobile
| Tecnologia | Version | Proposito |
|------------|---------|-----------|
| React Native | 0.73+ | Framework mobile |
| Expo | 50+ | Build y deployment |
| WatermelonDB | 0.27+ | SQLite offline |
| react-native-biometrics | 3.x | Huella y Face ID |
| react-native-camera | 4.x | Fotos geolocalizadas |
### Integraciones
| Tecnologia | Proposito |
|------------|-----------|
| Stripe | Suscripciones y pagos online |
| MercadoPago | Terminales POS fisicas |
| Clip | Terminales POS alternativas |
| WhatsApp Cloud API | Mensajeria y chatbot |
| OpenRouter/OpenAI | LLM para chatbot IA |
| Firebase | Push notifications |
| AWS Rekognition | Reconocimiento facial |
---
## Plataforma SaaS
### Modelo de Monetizacion
```
┌─────────────────────────────────────────────────────────────┐
│ MODELO PER-SEAT │
├─────────────────────────────────────────────────────────────┤
│ Plan Starter │ $99 USD/mes │ 5 usuarios │ Core │
│ Plan Growth │ $249 USD/mes │ 25 usuarios │ + Reports │
│ Plan Enterprise │ Custom │ Ilimitados │ + IA + WA │
├─────────────────────────────────────────────────────────────┤
│ Usuario extra: $12-15 USD/mes segun plan │
│ Tokens IA: Paquetes recargables ($29-299) │
└─────────────────────────────────────────────────────────────┘
```
### Feature Flags por Plan
| Feature | Starter | Growth | Enterprise |
|---------|---------|--------|------------|
| Modulos Core (Auth, Users, Tenants) | ✅ | ✅ | ✅ |
| Catalogs, Inventory, Sales | ✅ | ✅ | ✅ |
| Reports Avanzados | ❌ | ✅ | ✅ |
| CRM Completo | ❌ | ✅ | ✅ |
| WhatsApp Business | ❌ | ❌ | ✅ |
| Chatbot IA | ❌ | ❌ | ✅ |
| Apps Moviles | ❌ | ✅ | ✅ |
| Checador Biometrico | ❌ | ✅ | ✅ |
| Soporte Prioritario | ❌ | ❌ | ✅ |
---
## Integraciones de Pago
### Arquitectura de Pagos
```
┌─────────────────────────────────────────────────────────────┐
│ PAYMENT GATEWAY │
├────────────────────┬────────────────────┬───────────────────┤
│ STRIPE │ MERCADOPAGO │ CLIP │
│ (Suscripciones) │ (Terminal POS) │ (Terminal POS) │
├────────────────────┴────────────────────┴───────────────────┤
│ - OAuth 2.0 │ - OAuth 2.0 │ - API Keys │
│ - Webhooks │ - Webhooks │ - Polling │
│ - Customer Portal │ - Terminales │ - Terminales │
│ - Invoicing │ - QR Payments │ - Refunds │
└─────────────────────────────────────────────────────────────┘
```
### Casos de Uso
1. **Cobro de Suscripcion SaaS:** Stripe (tarjeta guardada, recurrente)
2. **Cobro en Punto de Venta:** MercadoPago/Clip (terminal fisica)
3. **Cobro a Cliente Final:** Link de pago (MercadoPago)
4. **Reembolsos:** Parciales o totales por cualquier proveedor
---
## Chatbot IA (Arquitectura MCP)
### Modelo MCP Server (Model Context Protocol)
Basado en el patron de michangarrito, implementamos un chatbot agnostico a proveedores de LLM:
```
┌─────────────────────────────────────────────────────────────┐
│ CANALES DE ENTRADA │
│ WhatsApp │ Chat Web │ App Movil │
└─────────┬────────────────┬────────────────┬─────────────────┘
│ │ │
└────────────────┼────────────────┘
│
┌──────▼──────┐
│ MCP SERVER │
│ (Gateway) │
└──────┬──────┘
│
┌─────────────────┼─────────────────┐
│ │ │
┌────▼────┐ ┌─────▼─────┐ ┌────▼────┐
│OpenRouter│ │ Anthropic │ │ Ollama │
│(Default) │ │ (Claude) │ │ (Local) │
└─────────┘ └───────────┘ └─────────┘
```
### Componentes del MCP Server
| Componente | Proposito |
|------------|-----------|
| **Providers** | Adaptadores para OpenRouter, OpenAI, Anthropic, Ollama |
| **Tools** | Funciones que el LLM puede invocar (ventas, inventario, etc.) |
| **Prompts** | System prompts por rol (admin, vendedor, cliente) |
| **RAG Service** | Busqueda en knowledge bases con pgvector |
| **Token Counter** | Tracking de consumo de tokens por usuario |
### Tools Disponibles para el LLM
| Tool | Modulo | Descripcion |
|------|--------|-------------|
| `get_sales_summary` | Sales | Resumen de ventas por periodo |
| `check_inventory` | Inventory | Consulta de stock |
| `get_customer_info` | CRM | Informacion de cliente |
| `create_order` | Sales | Crear orden de venta |
| `get_pending_invoices` | Financial | Facturas pendientes |
| `schedule_appointment` | CRM | Agendar cita |
| `generate_report` | Reports | Generar reporte |
### Sistema de Tokens IA
```
Consumo por operacion:
- Consulta simple: ~500 tokens
- Consulta con RAG: ~1,500 tokens
- Generacion de reporte: ~3,000 tokens
Paquetes recargables:
- Basico: $29 → 1,000 tokens
- Plus: $69 → 3,000 tokens
- Pro: $149 → 8,000 tokens
- Enterprise: $299 → 20,000 tokens
```
---
## Apps Moviles por Perfil
### Arquitectura Mobile
```
apps/mobile/
├── packages/
│ ├── core/ # Auth, API, Storage compartido
│ ├── biometrics/ # Facial, Fingerprint
│ ├── camera/ # Fotos geolocalizadas
│ ├── sync/ # Sincronizacion offline
│ ├── location/ # GPS tracking
│ └── ui/ # Componentes compartidos
├── apps/
│ ├── admin/ # App Administrador
│ ├── worker/ # App Trabajador (generica)
│ ├── warehouse/ # App Almacenista
│ ├── sales/ # App Vendedor
│ ├── field/ # App Campo (instaladores, tecnicos)
│ └── customer/ # App Cliente Portal
└── package.json
```
### Perfiles de Trabajador y Modulos
| Perfil | Modulos Disponibles | Biometrico |
|--------|---------------------|------------|
| **Administrador** | Todos los modulos | Opcional |
| **Gerente** | Reports, Sales, Inventory, HR | Opcional |
| **Vendedor** | POS, Inventory, CRM, Quotes | Opcional |
| **Almacenista** | Inventory, Purchases, Transfers | Requerido |
| **Operador** | Production, Quality, Orders | Requerido |
| **Tecnico/Instalador** | Work Orders, Photos, Signatures | Requerido |
| **Cliente** | Portal, Orders, Documents | Opcional |
### Caracteristicas por App
| Caracteristica | Admin | Worker | Warehouse | Field |
|----------------|-------|--------|-----------|-------|
| Login JWT | ✅ | ✅ | ✅ | ✅ |
| Check-in/out Biometrico | ❌ | ✅ | ✅ | ✅ |
| Geolocalizacion | ❌ | ✅ | ❌ | ✅ |
| Modo Offline | ✅ | ✅ | ✅ | ✅ |
| Fotos con GPS | ❌ | ❌ | ✅ | ✅ |
| Push Notifications | ✅ | ✅ | ✅ | ✅ |
| Dashboard | ✅ | ❌ | ❌ | ❌ |
---
## Sistema de Checador (Time & Attendance)
### Funcionalidades del Checador
```
┌─────────────────────────────────────────────────────────────┐
│ CHECADOR BIOMETRICO │
├─────────────────────────────────────────────────────────────┤
│ ┌─────────────────┐ ┌─────────────────┐ │
│ │ Reconocimiento │ │ Huella │ │
│ │ Facial │ │ Dactilar │ │
│ │ (Liveness) │ │ (Nativo) │ │
│ └────────┬────────┘ └────────┬────────┘ │
│ │ │ │
│ └──────────┬───────────┘ │
│ │ │
│ ┌───────▼───────┐ │
│ │ Validacion │ │
│ │ de Ubicacion │ │
│ │ (Geocerca) │ │
│ └───────┬───────┘ │
│ │ │
│ ┌───────▼───────┐ │
│ │ Registro de │ │
│ │ Entrada/Salida│ │
│ └───────────────┘ │
└─────────────────────────────────────────────────────────────┘
```
### Reglas de Negocio del Checador
1. **Validacion Biometrica:**
- Reconocimiento facial con liveness detection (anti-spoofing)
- Huella dactilar nativa del dispositivo
- Fallback a PIN si biometrico falla
2. **Validacion de Ubicacion:**
- Geocercas configurables por ubicacion de trabajo
- Radio de tolerancia configurable (50-500m)
- Registro de coordenadas GPS en cada check
3. **Tipos de Registro:**
- Check-in (entrada)
- Check-out (salida)
- Break start/end (descansos)
- Overtime start/end (horas extra)
4. **Reportes:**
- Asistencia diaria/semanal/mensual
- Retardos y faltas
- Horas trabajadas vs esperadas
- Incidencias (check fuera de geocerca)
### Flujo de Check-in
```
1. Usuario abre app mobile
2. App verifica si esta en geocerca permitida
3. Si OK, solicita biometrico (facial o huella)
4. Valida identidad con liveness detection
5. Registra entrada con:
- user_id
- timestamp
- coordenadas GPS
- tipo de check (in/out)
- metodo biometrico usado
- foto (opcional)
6. Sincroniza con backend
7. Muestra confirmacion al usuario
```
---
@ -168,28 +472,40 @@ Un lugar para cada dato. Sincronizacion automatica.
## Entregables por Fase
### Fase 1: Foundation (Actual)
- [ ] MGN-001 Auth completo
- [ ] MGN-002 Users completo
- [ ] MGN-003 Roles completo
- [ ] MGN-004 Tenants completo
### Fase 1: Foundation (En Progreso)
- [ ] MGN-001 Auth completo (JWT, OAuth, MFA)
- [ ] MGN-002 Users completo (CRUD, perfiles)
- [ ] MGN-003 Roles completo (RBAC, feature flags)
- [ ] MGN-004 Tenants completo (RLS, aislamiento)
- [ ] Documentacion de todos los modulos
### Fase 2: Core Business
- [ ] MGN-005 Catalogs
- [ ] MGN-010 Financial basico
- [ ] MGN-011 Inventory
- [ ] MGN-012 Purchasing
- [ ] MGN-013 Sales
### Fase 3: Extended
- [ ] MGN-006 Settings
- [ ] MGN-007 Audit
- [ ] MGN-008 Notifications
- [ ] MGN-009 Reports
- [ ] MGN-010 Financial basico
- [ ] MGN-011 Inventory
- [ ] MGN-012 Purchasing
- [ ] MGN-013 Sales
- [ ] MGN-014 CRM
- [ ] MGN-015 Projects
### Fase 3: SaaS Platform
- [ ] MGN-016 Billing (suscripciones per-seat)
- [ ] MGN-017 Payments (Stripe + MercadoPago + Clip)
- [ ] MGN-018 WhatsApp Business
- [ ] MGN-019 AI Agents (MCP Server + RAG)
- [ ] MGN-020 Onboarding
- [ ] MGN-021 AI Tokens
### Fase 4: Mobile Platform
- [ ] MGN-022 Mobile Core (React Native base)
- [ ] MGN-023 Time & Attendance (Checador)
- [ ] MGN-024 Worker Profiles (perfiles por rol)
- [ ] Apps por vertical (Construccion, Vidrio, Retail, etc.)
---
## Referencias
@ -199,7 +515,7 @@ Un lugar para cada dato. Sincronizacion automatica.
| Directivas | `orchestration/directivas/` |
| Patrones Odoo | `orchestration/directivas/DIRECTIVA-PATRONES-ODOO.md` |
| Templates | `orchestration/templates/` |
| Catálogo central | `core/catalog/` *(patrones reutilizables)* |
| Catálogo central | `shared/catalog/` *(patrones reutilizables)* |
---
@ -211,7 +527,22 @@ Un lugar para cada dato. Sincronizacion automatica.
| Documentacion | 100% antes de desarrollo |
| Reutilizacion en verticales | >60% |
| Tiempo de setup nueva vertical | <1 semana |
| MRR por tenant (promedio) | $150-300 USD |
| Churn rate mensual | <5% |
| NPS de usuarios | >40 |
---
*Ultima actualizacion: Diciembre 2025*
## Resumen de Modulos
| Fase | Modulos | Story Points Est. | Estado |
|------|---------|-------------------|--------|
| Foundation | MGN-001 a MGN-004 | 205 SP | En progreso |
| Core Business | MGN-005 a MGN-015 | 192 SP | Planificado |
| SaaS Platform | MGN-016 a MGN-021 | 230 SP | Backlog |
| Mobile Platform | MGN-022 a MGN-024 + Apps | 150 SP | Backlog |
| **Total** | **24 modulos** | **~777 SP** | - |
---
*Ultima actualizacion: Enero 2026*

2
shared/knowledge-base/projects/erp-core/docs/01-analisis-referencias/gamilit/backend-patterns.md
View File

@ -347,7 +347,7 @@ import { validateLoginDto } from '@modules/auth/dtos/login.dto';
"@config/*": ["config/*"],
"@database/*": ["database/*"],
"@modules/*": ["modules/*"],
"@core/*": ["modules/core/*"],
"@shared/*": ["modules/core/*"],
"@accounting/*": ["modules/accounting/*"],
"@budgets/*": ["modules/budgets/*"],
"@purchasing/*": ["modules/purchasing/*"]

18
shared/knowledge-base/projects/erp-core/docs/02-fase-core-business/MGN-005-catalogs/especificaciones/ET-CATALOG-backend.md
View File

@ -77,7 +77,7 @@ import {
Entity, PrimaryGeneratedColumn, Column, ManyToOne, OneToMany,
JoinColumn, CreateDateColumn, UpdateDateColumn, Index
} from 'typeorm';
import { TenantEntity } from '@core/entities/tenant.entity';
import { TenantEntity } from '@shared/entities/tenant.entity';
import { Country } from './country.entity';
import { State } from './state.entity';
import { Currency } from './currency.entity';
@ -286,7 +286,7 @@ import {
Entity, PrimaryGeneratedColumn, Column, ManyToOne,
JoinColumn, CreateDateColumn, UpdateDateColumn
} from 'typeorm';
import { TenantEntity } from '@core/entities/tenant.entity';
import { TenantEntity } from '@shared/entities/tenant.entity';
import { UomCategory } from './uom-category.entity';
export enum UomType {
@ -465,7 +465,7 @@ export class CreateContactDto {
// dto/contacts/contact-query.dto.ts
import { IsOptional, IsEnum, IsString, IsBoolean, IsArray } from 'class-validator';
import { Transform, Type } from 'class-transformer';
import { PaginationDto } from '@core/dto/pagination.dto';
import { PaginationDto } from '@shared/dto/pagination.dto';
import { ContactType, ContactRole } from '../entities/contact.entity';
export class ContactQueryDto extends PaginationDto {
@ -522,8 +522,8 @@ import { ContactTag } from '../entities/contact-tag.entity';
import { CreateContactDto } from '../dto/contacts/create-contact.dto';
import { UpdateContactDto } from '../dto/contacts/update-contact.dto';
import { ContactQueryDto } from '../dto/contacts/contact-query.dto';
import { TenantContext } from '@core/decorators/tenant.decorator';
import { PaginatedResult } from '@core/interfaces/pagination.interface';
import { TenantContext } from '@shared/decorators/tenant.decorator';
import { PaginatedResult } from '@shared/interfaces/pagination.interface';
@Injectable()
export class ContactsService {
@ -764,7 +764,7 @@ import { Repository, LessThanOrEqual } from 'typeorm';
import { CurrencyRate } from '../entities/currency-rate.entity';
import { Currency } from '../entities/currency.entity';
import { CreateRateDto } from '../dto/currencies/create-rate.dto';
import { TenantContext } from '@core/decorators/tenant.decorator';
import { TenantContext } from '@shared/decorators/tenant.decorator';
@Injectable()
export class CurrencyRatesService {
@ -876,7 +876,7 @@ import { Repository } from 'typeorm';
import { Uom, UomType } from '../entities/uom.entity';
import { UomCategory } from '../entities/uom-category.entity';
import { CreateUomDto } from '../dto/uom/create-uom.dto';
import { TenantContext } from '@core/decorators/tenant.decorator';
import { TenantContext } from '@shared/decorators/tenant.decorator';
@Injectable()
export class UomService {
@ -1003,7 +1003,7 @@ import { ApiTags, ApiOperation, ApiBearerAuth } from '@nestjs/swagger';
import { JwtAuthGuard } from '@modules/auth/guards/jwt-auth.guard';
import { RbacGuard } from '@modules/rbac/guards/rbac.guard';
import { Permissions } from '@modules/rbac/decorators/permissions.decorator';
import { TenantId } from '@core/decorators/tenant.decorator';
import { TenantId } from '@shared/decorators/tenant.decorator';
import { ContactsService } from '../services/contacts.service';
import { CreateContactDto } from '../dto/contacts/create-contact.dto';
import { UpdateContactDto } from '../dto/contacts/update-contact.dto';
@ -1104,7 +1104,7 @@ import {
} from '@nestjs/common';
import { ApiTags, ApiOperation, ApiBearerAuth } from '@nestjs/swagger';
import { JwtAuthGuard } from '@modules/auth/guards/jwt-auth.guard';
import { TenantId } from '@core/decorators/tenant.decorator';
import { TenantId } from '@shared/decorators/tenant.decorator';
import { CurrenciesService } from '../services/currencies.service';
import { CurrencyRatesService } from '../services/currency-rates.service';
import { CreateRateDto } from '../dto/currencies/create-rate.dto';

2
shared/knowledge-base/projects/erp-core/docs/02-fase-core-business/MGN-005-catalogs/especificaciones/ET-CATALOG-frontend.md
View File

@ -283,7 +283,7 @@ import { create } from 'zustand';
import { devtools } from 'zustand/middleware';
import { Contact, ContactFilters, CreateContactDto } from '../types/contact.types';
import { contactsService } from '../services/contacts.service';
import { PaginatedResult } from '@core/types/pagination';
import { PaginatedResult } from '@shared/types/pagination';
interface ContactsState {
// Data

2
shared/knowledge-base/projects/erp-core/docs/04-modelado/especificaciones-tecnicas/transversal/SPEC-PROYECTOS-DEPENDENCIAS-BURNDOWN.md
View File

@ -303,7 +303,7 @@ CREATE TRIGGER trg_update_blocked_state
```typescript
// src/modules/projects/domain/entities/task-dependency.entity.ts
import { Entity, AggregateRoot } from '@core/domain';
import { Entity, AggregateRoot } from '@shared/domain';
export enum DependencyType {
FINISH_TO_START = 'finish_to_start',

161
shared/knowledge-base/projects/erp-core/docs/08-epicas/EPIC-MGN-019-ai-agents.md
View File

@ -5,30 +5,175 @@
| Campo | Valor |
|-------|-------|
| **ID** | EPIC-MGN-019 |
| **Nombre** | AI Agents (RAG + Tools) |
| **Nombre** | AI Agents (MCP Server + RAG + Tools) |
| **Modulo** | ai-agents |
| **Fase** | Fase 4 - SaaS Platform |
| **Prioridad** | P3 |
| **Prioridad** | P2 |
| **Estado** | Backlog |
| **Story Points** | 55 |
| **Story Points** | 68 |
| **Sprint(s)** | Sprint 26-30 |
---
## Descripcion
Sistema de agentes inteligentes con RAG (Retrieval Augmented Generation) usando pgvector para embeddings. Permite crear agentes configurables por tenant, knowledge bases con documentos, definicion de tools/funciones, conversaciones con historial y ejecucion de tools en tiempo real.
Sistema de agentes inteligentes basado en **MCP Server (Model Context Protocol)** con RAG (Retrieval Augmented Generation) usando pgvector para embeddings. Implementa un gateway agnostico a proveedores de LLM (OpenRouter, OpenAI, Anthropic, Ollama) siguiendo el patron de michangarrito. Permite crear agentes configurables por tenant, knowledge bases con documentos, definicion de tools/funciones, conversaciones con historial y ejecucion de tools en tiempo real a traves de multiples canales (WhatsApp, Chat Web, App Movil).
---
## Objetivo de Negocio
Proveer agentes AI que:
- Automaticen atencion al cliente
- Respondan preguntas basadas en documentacion
- Ejecuten acciones en el sistema
- Automaticen atencion al cliente via WhatsApp, chat web y app movil
- Respondan preguntas basadas en documentacion (RAG)
- Ejecuten acciones en el sistema (tools)
- Escalen soporte sin aumentar personal
- Mejoren experiencia del usuario
- Generen reportes y consultas de datos conversacionalmente
- Sean agnosticos al proveedor de LLM (OpenRouter, OpenAI, Anthropic, Ollama)
---
## Arquitectura MCP Server (Model Context Protocol)
### Vision General
```
┌─────────────────────────────────────────────────────────────┐
│ CANALES DE ENTRADA │
│ WhatsApp Cloud API │ Chat Web │ App Movil │
└────────────┬──────────────────┬──────────────┬──────────────┘
│ │ │
└──────────────────┼──────────────┘
│
┌──────▼──────┐
│ MCP SERVER │
│ Gateway │
└──────┬──────┘
│
┌─────────────────┼─────────────────┐
│ │ │
┌────▼────┐ ┌─────▼─────┐ ┌────▼────┐
│OpenRouter│ │ Anthropic │ │ Ollama │
│(Default) │ │ (Claude) │ │ (Local) │
└─────────┘ └───────────┘ └─────────┘
```
### Componentes del MCP Server
```
apps/backend/src/modules/mcp-server/
├── providers/ # Adaptadores LLM
│ ├── base.provider.ts # Interface comun
│ ├── openrouter.provider.ts # OpenRouter (default)
│ ├── openai.provider.ts # OpenAI directo
│ ├── anthropic.provider.ts # Anthropic Claude
│ └── ollama.provider.ts # Ollama local
│
├── tools/ # Herramientas disponibles
│ ├── sales.tools.ts # get_sales, create_order
│ ├── inventory.tools.ts # check_stock, get_alerts
│ ├── crm.tools.ts # get_customer, create_lead
│ ├── financial.tools.ts # get_invoices, get_balance
│ ├── reports.tools.ts # generate_report
│ └── hr.tools.ts # get_attendance, get_employee
│
├── prompts/ # System prompts por rol
│ ├── base.prompt.ts # Prompt base
│ ├── sales.prompt.ts # Vendedor
│ ├── manager.prompt.ts # Gerente
│ ├── support.prompt.ts # Soporte
│ └── customer.prompt.ts # Cliente externo
│
├── rag/ # Retrieval Augmented Generation
│ ├── embedding.service.ts # Generacion de embeddings
│ ├── chunker.service.ts # Particion de documentos
│ └── retriever.service.ts # Busqueda en pgvector
│
├── handlers/ # Procesamiento
│ ├── message.handler.ts # Procesa mensaje entrante
│ └── tool-call.handler.ts # Ejecuta tools invocadas
│
├── mcp.module.ts
└── mcp.service.ts
```
### Flujo de Procesamiento
```
1. MENSAJE ENTRANTE (WhatsApp/Chat/App)
"¿Cuanto vendimos esta semana?"
│
▼
2. MESSAGE HANDLER
- Identifica tenant y usuario
- Carga historial de conversacion (Redis)
- Obtiene contexto del usuario (rol, permisos)
│
▼
3. RAG SERVICE (si aplica)
- Genera embedding de la pregunta
- Busca chunks similares en pgvector
- Obtiene top K documentos relevantes
│
▼
4. PROMPT BUILDER
- Selecciona system prompt por rol
- Inyecta contexto de RAG
- Inyecta historial de conversacion
- Lista tools disponibles segun permisos
│
▼
5. LLM PROVIDER
- Envia al provider configurado (OpenRouter/OpenAI/etc)
- Recibe respuesta + tool_calls
│
▼
6. TOOL CALL HANDLER (si hay tool_calls)
- Valida parametros
- Ejecuta tool contra Backend API
- Retorna resultado al LLM
- LLM genera respuesta final
│
▼
7. RESPONSE
- Guarda en historial
- Registra consumo de tokens
- Envia respuesta al canal de origen
```
### Tools Disponibles por Modulo
| Tool | Modulo | Parametros | Descripcion |
|------|--------|------------|-------------|
| `get_sales_summary` | Sales | periodo, filtros | Resumen de ventas |
| `get_top_products` | Sales | periodo, limit | Productos mas vendidos |
| `create_quote` | Sales | cliente, items | Crear cotizacion |
| `check_inventory` | Inventory | product_id, warehouse | Consultar stock |
| `get_stock_alerts` | Inventory | - | Productos con stock bajo |
| `get_customer_info` | CRM | customer_id | Info de cliente |
| `create_lead` | CRM | name, phone, source | Crear lead |
| `get_pending_invoices` | Financial | customer_id, days | Facturas vencidas |
| `get_balance` | Financial | account_id | Saldo de cuenta |
| `generate_report` | Reports | type, periodo | Generar reporte PDF |
| `get_attendance` | HR | employee_id, fecha | Asistencia de empleado |
| `schedule_meeting` | CRM | participants, datetime | Agendar reunion |
### Configuracion de Providers
```typescript
// .env configuration
LLM_PROVIDER=openrouter // openrouter | openai | anthropic | ollama
LLM_API_KEY=sk-xxx
LLM_MODEL=anthropic/claude-3-haiku // Modelo a usar
LLM_BASE_URL=https://openrouter.ai/api/v1
LLM_MAX_TOKENS=4096
LLM_TEMPERATURE=0.7
// Fallback chain
LLM_FALLBACK_PROVIDER=ollama // Si falla el principal
LLM_FALLBACK_MODEL=llama3
```
---
@ -148,3 +293,5 @@ Proveer agentes AI que:
**Creada por:** Requirements-Analyst
**Fecha:** 2025-12-05
**Actualizada por:** Orquestador
**Ultima actualizacion:** 2026-01-04 (Arquitectura MCP Server agregada)

106
shared/knowledge-base/projects/erp-core/docs/08-epicas/EPIC-MGN-019-mobile-apps.md
View File

@ -1,23 +1,24 @@
# EPICA: EPIC-MGN-019 - Apps Moviles por Perfil
# EPICA: EPIC-MGN-019B - Apps Moviles por Perfil
## Metadata
| Campo | Valor |
|-------|-------|
| **ID** | EPIC-MGN-019 |
| **ID** | EPIC-MGN-019B |
| **Nombre** | Apps Moviles por Perfil de Usuario |
| **Modulo** | mobile |
| **Fase** | Fase 5 - Mobile Platform |
| **Fase** | Fase 4 - Mobile Platform |
| **Prioridad** | P1 |
| **Estado** | Backlog |
| **Story Points** | 89 |
| **Sprint(s)** | Sprint 29-36 |
| **Story Points** | 110 |
| **Sprint(s)** | Sprint 29-40 |
| **Relacionado** | MGN-022 (Mobile Core), MGN-023 (Time & Attendance), MGN-024 (Worker Profiles) |
---
## Descripcion
Desarrollo de apps moviles React Native para diferentes perfiles de usuario en cada vertical. Incluye funcionalidades biometricas (reconocimiento facial, huella), modo offline, y sincronizacion con backend.
Desarrollo de apps moviles React Native para diferentes perfiles de usuario en cada vertical. Cada perfil de trabajador tiene acceso a modulos y herramientas especificos segun su rol. Incluye funcionalidades biometricas (reconocimiento facial, huella), modo offline con sincronizacion, checador integrado, y sistema de perfiles dinamicos que determina que modulos y herramientas estan disponibles para cada usuario.
---
@ -25,8 +26,97 @@ Desarrollo de apps moviles React Native para diferentes perfiles de usuario en c
- Digitalizar operaciones en campo
- Capturar datos en tiempo real
- Validar asistencia con biometricos
- Validar asistencia con biometricos (checador)
- Aumentar productividad de usuarios moviles
- Proporcionar herramientas especificas por perfil de trabajador
- Permitir trabajo offline con sincronizacion automatica
- Integrar chatbot IA para consultas rapidas
---
## Sistema de Perfiles de Trabajador
### Arquitectura de Perfiles
Cada usuario tiene asignado uno o mas perfiles que determinan:
1. **Modulos accesibles:** Que secciones de la app puede ver
2. **Acciones permitidas:** Que operaciones puede realizar
3. **Biometrico requerido:** Si necesita validacion biometrica
4. **Checador integrado:** Si debe registrar entradas/salidas
5. **Geocerca:** Si esta restringido a ubicaciones especificas
### Perfiles Disponibles
| Perfil | Codigo | Modulos | Biometrico | Checador |
|--------|--------|---------|------------|----------|
| **Administrador** | ADMIN | Todos | Opcional | No |
| **Gerente** | MANAGER | Reports, Sales, Inventory, HR, CRM | Opcional | No |
| **Vendedor** | SALES | POS, Inventory, CRM, Quotes, Customers | Opcional | Configurable |
| **Almacenista** | WAREHOUSE | Inventory, Purchases, Transfers, Receiving | Requerido | Si |
| **Operador** | OPERATOR | Production, Quality, Work Orders | Requerido | Si |
| **Tecnico/Instalador** | FIELD | Work Orders, Photos, Signatures, GPS | Requerido | Si + GPS |
| **Repartidor** | DELIVERY | Deliveries, Routes, POD, GPS | Requerido | Si + GPS |
| **Cliente Portal** | CUSTOMER | Orders, Documents, Tickets, Payments | Opcional | No |
### Modulos por Perfil
```
┌─────────────────────────────────────────────────────────────┐
│ MODULOS DISPONIBLES │
├─────────────────────────────────────────────────────────────┤
│ │
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
│ │ CHECADOR │ │ POS │ │ INVENTARIO │ │
│ │ Check-in/out │ │ Punto venta │ │ Stock/Transf │ │
│ │ Biometrico │ │ Cobros │ │ Conteos │ │
│ └──────────────┘ └──────────────┘ └──────────────┘ │
│ │
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
│ │ ORDENES │ │ FOTOS │ │ REPORTES │ │
│ │ Work orders │ │ Geolocalizad │ │ Dashboards │ │
│ │ Asignaciones │ │ Evidencias │ │ KPIs │ │
│ └──────────────┘ └──────────────┘ └──────────────┘ │
│ │
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
│ │ CHATBOT │ │ ENTREGAS │ │ CLIENTES │ │
│ │ Asistente IA │ │ Rutas │ │ CRM basico │ │
│ │ Consultas │ │ POD/Firmas │ │ Historial │ │
│ └──────────────┘ └──────────────┘ └──────────────┘ │
│ │
└─────────────────────────────────────────────────────────────┘
```
### Configuracion de Perfiles (Backend)
```typescript
// Ejemplo de configuracion de perfil
{
"code": "WAREHOUSE",
"name": "Almacenista",
"modules": [
{ "id": "checador", "required": true },
{ "id": "inventory", "required": true },
{ "id": "purchases", "required": false },
{ "id": "transfers", "required": true },
{ "id": "receiving", "required": true },
{ "id": "chatbot", "required": false }
],
"biometric": {
"required": true,
"methods": ["fingerprint", "facial"],
"fallback_pin": true
},
"attendance": {
"required": true,
"geofence_required": true,
"photo_required": false
},
"permissions": [
"inventory.view", "inventory.count", "inventory.transfer",
"purchases.receive", "checador.check_in", "checador.check_out"
]
}
```
---
@ -157,3 +247,5 @@ apps/mobile/
**Creado por:** Requirements-Analyst
**Fecha:** 2025-12-05
**Actualizado por:** Orquestador
**Ultima actualizacion:** 2026-01-04 (Sistema de perfiles de trabajador detallado)

355
shared/knowledge-base/projects/erp-core/docs/08-epicas/EPIC-MGN-023-time-attendance.md Normal file
View File

@ -0,0 +1,355 @@
# EPICA: EPIC-MGN-023 - Time & Attendance (Checador)
## Metadata
| Campo | Valor |
|-------|-------|
| **ID** | EPIC-MGN-023 |
| **Nombre** | Time & Attendance - Checador Biometrico con GPS |
| **Modulo** | time-attendance |
| **Fase** | Fase 4 - Mobile Platform |
| **Prioridad** | P1 |
| **Estado** | Backlog |
| **Story Points** | 55 |
| **Sprint(s)** | Sprint 37-40 |
---
## Descripcion
Sistema de control de asistencia (Time & Attendance) con validacion biometrica (reconocimiento facial y huella dactilar) y geolocalizacion. Permite registrar entradas, salidas, descansos y horas extra con validacion de ubicacion mediante geocercas configurables por sitio de trabajo.
---
## Objetivo de Negocio
Proveer un sistema de checador que:
- Elimine el fraude en registro de asistencia (buddy punching)
- Valide que el trabajador este fisicamente en el sitio
- Automatice el calculo de horas trabajadas
- Genere reportes de asistencia en tiempo real
- Integre con nomina para calculo automatico
- Funcione offline con sincronizacion posterior
---
## Stakeholders
| Rol | Nombre/Equipo | Responsabilidad |
|-----|---------------|-----------------|
| Product Owner | Equipo Producto | Definicion de reglas de negocio |
| Tech Lead | Equipo Mobile | Arquitectura biometrica y GPS |
| RRHH | Recursos Humanos | Definicion de politicas de asistencia |
| Supervisor | Operaciones | Validacion de incidencias |
| Trabajador | Usuario final | Uso diario del checador |
---
## Historias de Usuario
| ID | Historia | Prioridad | SP | Estado |
|----|----------|-----------|-----|--------|
| US-MGN023-001 | Como admin, quiero configurar geocercas por ubicacion de trabajo | P0 | 5 | Backlog |
| US-MGN023-002 | Como admin, quiero definir horarios de trabajo por empleado/grupo | P0 | 5 | Backlog |
| US-MGN023-003 | Como trabajador, quiero hacer check-in con reconocimiento facial | P0 | 8 | Backlog |
| US-MGN023-004 | Como trabajador, quiero hacer check-in con huella dactilar | P0 | 5 | Backlog |
| US-MGN023-005 | Como trabajador, quiero hacer check-out al terminar mi jornada | P0 | 3 | Backlog |
| US-MGN023-006 | Como trabajador, quiero registrar inicio/fin de descanso | P1 | 3 | Backlog |
| US-MGN023-007 | Como trabajador, quiero registrar horas extra | P1 | 3 | Backlog |
| US-MGN023-008 | Como supervisor, quiero ver asistencia en tiempo real de mi equipo | P0 | 5 | Backlog |
| US-MGN023-009 | Como supervisor, quiero aprobar/rechazar incidencias | P1 | 5 | Backlog |
| US-MGN023-010 | Como admin, quiero generar reportes de asistencia | P0 | 5 | Backlog |
| US-MGN023-011 | Como trabajador, quiero que mi check funcione sin internet | P0 | 8 | Backlog |
**Total Story Points:** 55 SP
---
## Criterios de Aceptacion de la Epica
**Funcionales:**
- [ ] Geocercas configurables (poligonos o circulos) por ubicacion
- [ ] Radio de tolerancia configurable (50-500m)
- [ ] Reconocimiento facial con liveness detection (anti-spoofing)
- [ ] Huella dactilar usando biometrico nativo del dispositivo
- [ ] Fallback a PIN si biometrico no disponible
- [ ] Registro de coordenadas GPS en cada check
- [ ] Foto opcional al momento del check
- [ ] Tipos de check: entrada, salida, descanso_inicio, descanso_fin, extra_inicio, extra_fin
- [ ] Calculo automatico de horas trabajadas
- [ ] Deteccion de retardos segun horario configurado
- [ ] Modo offline con sincronizacion al recuperar conexion
- [ ] Resolucion de conflictos de sincronizacion
**No Funcionales:**
- [ ] Tiempo de reconocimiento facial < 2 segundos
- [ ] Precision de GPS < 10 metros
- [ ] Almacenamiento offline de hasta 7 dias de checks
- [ ] Sincronizacion automatica en background
- [ ] Bateria: bajo consumo de GPS (sampling inteligente)
- [ ] Seguridad: datos biometricos nunca salen del dispositivo
**Tecnicos:**
- [ ] Cobertura de tests > 80%
- [ ] Integracion con AWS Rekognition o Azure Face
- [ ] Soporte Android 9+ e iOS 14+
- [ ] WatermelonDB para persistencia offline
---
## Arquitectura Tecnica
### Flujo de Check-in
```
┌─────────────────────────────────────────────────────────────┐
│ FLUJO DE CHECK-IN │
├─────────────────────────────────────────────────────────────┤
│ │
│ 1. Usuario abre app │
│ │ │
│ ▼ │
│ 2. Obtener ubicacion GPS │
│ │ │
│ ▼ │
│ 3. Validar geocerca ─────────────────┐ │
│ │ │ │
│ │ (Dentro) │ (Fuera) │
│ ▼ ▼ │
│ 4. Solicitar biometrico Mostrar error │
│ (Facial o Huella) "Fuera de ubicacion" │
│ │ │
│ ▼ │
│ 5. Validar identidad │
│ (Liveness detection) │
│ │ │
│ │ (OK) │
│ ▼ │
│ 6. Capturar foto (opcional) │
│ │ │
│ ▼ │
│ 7. Crear registro local │
│ (WatermelonDB) │
│ │ │
│ ▼ │
│ 8. Sincronizar con backend │
│ (si hay conexion) │
│ │ │
│ ▼ │
│ 9. Mostrar confirmacion │
│ │
└─────────────────────────────────────────────────────────────┘
```
### Modelo de Datos
```
┌────────────────────┐ ┌────────────────────┐
│ work_locations │ │ work_schedules │
├────────────────────┤ ├────────────────────┤
│ id │ │ id │
│ tenant_id │ │ tenant_id │
│ name │ │ name │
│ address │ │ work_location_id │
│ geofence_type │◄─────│ monday_start │
│ geofence_polygon │ │ monday_end │
│ geofence_radius │ │ tuesday_start... │
│ tolerance_meters │ │ break_duration_min │
│ is_active │ │ is_active │
└────────────────────┘ └────────────────────┘
│ │
│ │
▼ ▼
┌────────────────────────────────────────────────┐
│ time_attendance_records │
├────────────────────────────────────────────────┤
│ id │
│ tenant_id │
│ user_id │
│ work_location_id │
│ work_schedule_id │
│ check_type (in/out/break_start/break_end/...) │
│ check_timestamp │
│ latitude │
│ longitude │
│ accuracy_meters │
│ biometric_method (facial/fingerprint/pin) │
│ photo_url │
│ device_id │
│ is_synced │
│ sync_timestamp │
│ is_valid │
│ validation_notes │
│ created_at │
└────────────────────────────────────────────────┘
│
│
▼
┌────────────────────────────────────────────────┐
│ attendance_incidents │
├────────────────────────────────────────────────┤
│ id │
│ tenant_id │
│ user_id │
│ incident_date │
│ incident_type (late/early_leave/absent/...) │
│ expected_time │
│ actual_time │
│ difference_minutes │
│ status (pending/approved/rejected) │
│ supervisor_id │
│ supervisor_notes │
│ created_at │
└────────────────────────────────────────────────┘
```
---
## Dependencias
**Esta epica depende de:**
| Epica/Modulo | Estado | Bloqueante |
|--------------|--------|------------|
| EPIC-MGN-001 Auth | Ready | Si |
| EPIC-MGN-002 Users | Ready | Si |
| EPIC-MGN-004 Tenants | Ready | Si |
| EPIC-MGN-022 Mobile Core | Backlog | Si |
| AWS Rekognition / Azure Face | External | Si |
| Google Maps / Mapbox | External | Si (geocercas) |
**Esta epica bloquea:**
| Epica/Modulo | Razon |
|--------------|-------|
| Integracion con Nomina | Calculo de horas trabajadas |
| HR Analytics | Metricas de asistencia |
---
## Desglose Tecnico
**Database:**
- [ ] Schema: `hr`
- [ ] Tablas: 5 (work_locations, work_schedules, schedule_assignments, time_attendance_records, attendance_incidents)
- [ ] Funciones: calculate_worked_hours, detect_incidents
- [ ] Triggers: auto_create_incident (retardos, faltas)
- [ ] Indices: Por user_id, check_timestamp, work_location_id
- [ ] RLS Policies: Si (por tenant)
**Backend:**
- [ ] Modulo: `time-attendance`
- [ ] Services: AttendanceService, GeofenceService, IncidentService, ReportService
- [ ] Controllers: AttendanceController, LocationsController, SchedulesController, IncidentsController
- [ ] Endpoints: 20+ (check in/out, locations CRUD, schedules CRUD, incidents, reports)
- [ ] Jobs: DailyIncidentDetectorJob, AttendanceSummaryJob
- [ ] Tests: 40+
**Mobile (React Native):**
- [ ] Screens: 5 (CheckIn, CheckHistory, LocationMap, IncidentsList, Settings)
- [ ] Components: BiometricPrompt, GeofenceValidator, SyncIndicator, CheckConfirmation
- [ ] Hooks: useGeolocation, useBiometrics, useOfflineSync
- [ ] Storage: WatermelonDB schemas para offline
- [ ] Services: AttendanceSync, LocationTracker
**Frontend (Admin):**
- [ ] Paginas: 6 (Locations, Schedules, Attendance, Incidents, Reports, Settings)
- [ ] Componentes: GeofenceEditor, ScheduleCalendar, AttendanceTable, IncidentApproval
- [ ] Stores: 1 (attendanceStore)
---
## Reportes
| Reporte | Descripcion | Frecuencia |
|---------|-------------|------------|
| Asistencia Diaria | Lista de checks por dia | Diario |
| Resumen Semanal | Horas trabajadas por empleado | Semanal |
| Incidencias Pendientes | Retardos/faltas sin aprobar | Diario |
| Comparativo Horarios | Esperado vs Real | Mensual |
| Costo de Horas Extra | Horas extra por departamento | Quincenal |
---
## Integraciones
### Reconocimiento Facial
| Proveedor | Pros | Contras |
|-----------|------|---------|
| AWS Rekognition | Alta precision, liveness detection | Costo por uso |
| Azure Face | Buena precision, anti-spoofing | Requiere Azure |
| Google Vision | Integracion con Firebase | Menos features |
| On-device (ML Kit) | Sin costo de API, privacidad | Menor precision |
**Recomendacion:** AWS Rekognition con fallback a ML Kit on-device.
### Geofencing
| Proveedor | Uso |
|-----------|-----|
| Google Maps | Geocoding, visualizacion de mapas |
| Mapbox | Alternativa a Google Maps |
| react-native-geofencing | Deteccion de entrada/salida |
---
## Riesgos
| Riesgo | Probabilidad | Impacto | Mitigacion |
|--------|--------------|---------|------------|
| GPS impreciso en interiores | Alta | Medio | Tolerancia configurable, WiFi positioning |
| Fallo en reconocimiento facial | Media | Alto | Fallback a huella y PIN |
| Sincronizacion fallida | Media | Alto | Retry automatico, alertas |
| Bateria agotada rapidamente | Media | Medio | Sampling inteligente de GPS |
| Spoofing de foto | Baja | Critico | Liveness detection obligatorio |
---
## Definition of Ready (DoR)
- [x] Historias de usuario definidas
- [x] Criterios de aceptacion claros
- [x] Dependencias identificadas
- [x] Estimacion completada
- [ ] Cuenta AWS/Azure para biometricos
- [ ] API Key de Google Maps/Mapbox
- [ ] Politicas de asistencia definidas por RRHH
- [x] Sin bloqueadores activos
## Definition of Done (DoD)
- [ ] Codigo implementado y revisado
- [ ] Tests pasando (unit, integration, e2e)
- [ ] Check-in/out funcionando con facial
- [ ] Check-in/out funcionando con huella
- [ ] Geocercas validando correctamente
- [ ] Modo offline funcionando
- [ ] Sincronizacion automatica
- [ ] Reportes generandose
- [ ] Documentacion actualizada
- [ ] Inventarios actualizados
- [ ] Demo realizada
- [ ] Product Owner aprobo
---
## Documentacion Relacionada
- Vision General: `docs/00-vision-general/VISION-ERP-CORE.md`
- Requerimientos: `docs/03-requerimientos/RF-time-attendance/`
- User Stories: `docs/05-user-stories/mgn-023/`
- DDL Spec: `docs/04-modelado/database-design/DDL-SPEC-hr_attendance.md`
- Mobile Core: `EPIC-MGN-022-mobile-core.md`
---
## Historial
| Fecha | Cambio | Autor |
|-------|--------|-------|
| 2026-01-04 | Creacion de epica | Orquestador |
---
**Creada por:** Orquestador
**Fecha:** 2026-01-04
**Ultima actualizacion:** 2026-01-04

59
shared/knowledge-base/projects/erp-core/docs/README.md
View File

@ -113,16 +113,26 @@ Crear el **ERP Genérico** como base reutilizable (60-70%) para los 3 ERPs espec
| **MGN-013** | Portal de Usuarios | portal |
| **MGN-014** | Mensajería y Notificaciones | mail |
### Fase SaaS Platform (4 módulos - Prioridad P3)
### Fase SaaS Platform (6 módulos - Prioridad P2)
| Código | Nombre | Descripción |
|--------|--------|-------------|
| **MGN-016** | Billing SaaS | Per-seat pricing, suscripciones, feature flags |
| **MGN-017** | Payments POS | MercadoPago, Clip, terminales de pago |
| **MGN-017** | Payments | Stripe (suscripciones) + MercadoPago/Clip (terminales POS) |
| **MGN-018** | WhatsApp Business | Cloud API, chatbots, campañas |
| **MGN-019** | AI Agents | RAG, pgvector, knowledge bases, tools |
| **MGN-019** | AI Agents | MCP Server, RAG, pgvector, knowledge bases, tools |
| **MGN-020** | Onboarding | Wizard de setup inicial, configuración guiada |
| **MGN-021** | AI Tokens | Sistema de tokens IA, paquetes recargables |
**Total:** 19 módulos (14 core + 1 projects + 4 SaaS)
### Fase Mobile Platform (3 módulos - Prioridad P1)
| Código | Nombre | Descripción |
|--------|--------|-------------|
| **MGN-022** | Mobile Core | React Native base: auth, sync, biometrics |
| **MGN-023** | Time & Attendance | Checador biométrico + GPS, entradas/salidas |
| **MGN-024** | Worker Profiles | Perfiles de trabajador, módulos por rol |
**Total:** 24 módulos (14 core + 6 SaaS + 3 mobile + apps por vertical)
---
@ -354,7 +364,42 @@ Ver directiva: `/workspace/core/orchestration/directivas/DIRECTIVA-ESTRUCTURA-DO
---
**Última actualización:** 2025-12-05
**Coordinador:** Architecture-Analyst
**Última actualización:** 2026-01-04
**Coordinador:** Architecture-Analyst / Orquestador
**Estado:** 📋 Fase 2 - Modelado en progreso
**Próximo paso:** Completar especificaciones técnicas de módulos SaaS
**Próximo paso:** Implementar módulos SaaS Platform y Mobile Platform
---
## NUEVAS CARACTERÍSTICAS (Enero 2026)
Se han agregado las siguientes características a la visión del proyecto:
### Plataforma SaaS Completa
- Modelo de monetización per-seat con 3 planes (Starter, Growth, Enterprise)
- Feature flags por plan para controlar acceso a módulos
### Integraciones de Pago
- **Stripe:** Suscripciones recurrentes, webhooks, customer portal
- **MercadoPago:** Terminales POS físicas, QR, links de pago
- **Clip:** Terminales POS alternativas
### Chatbot IA (MCP Server)
- Arquitectura agnóstica a proveedores LLM (OpenRouter, OpenAI, Anthropic, Ollama)
- RAG con pgvector para knowledge bases
- Tools que ejecutan acciones en el sistema
- Integración con WhatsApp, Chat Web y App Móvil
### Apps Móviles por Perfil
- React Native con Expo
- Perfiles de trabajador con módulos específicos
- Biométricos (facial y huella)
- Modo offline con sincronización
### Sistema de Checador (Time & Attendance)
- Validación biométrica con liveness detection
- Geocercas configurables por ubicación
- Registro de entradas/salidas/descansos
- Reportes de asistencia
Ver detalles completos en: [VISION-ERP-CORE.md](00-vision-general/VISION-ERP-CORE.md)

12
shared/knowledge-base/projects/gamilit/README.md
View File

@ -37,11 +37,11 @@ Los siguientes patrones fueron extraidos de gamilit al catalogo:
| Patron | Ubicacion Catalogo |
|--------|-------------------|
| Auth + Sessions | `core/catalog/auth/` |
| Multi-tenancy | `core/catalog/multi-tenancy/` |
| Notifications | `core/catalog/notifications/` |
| Rate Limiting | `core/catalog/rate-limiting/` |
| Feature Flags | `core/catalog/feature-flags/` |
| Auth + Sessions | `shared/catalog/auth/` |
| Multi-tenancy | `shared/catalog/multi-tenancy/` |
| Notifications | `shared/catalog/notifications/` |
| Rate Limiting | `shared/catalog/rate-limiting/` |
| Feature Flags | `shared/catalog/feature-flags/` |
## Lecciones Aprendidas
@ -54,7 +54,7 @@ Los siguientes patrones fueron extraidos de gamilit al catalogo:
- Proyecto: `projects/gamilit/`
- Legacy: `shared/knowledge-base/reference/erp-inmobiliaria-legacy/gamilit/`
- Catalogo: `core/catalog/` (modulos extraidos)
- Catalogo: `shared/catalog/` (modulos extraidos)
---

Some files were not shown because too many files have changed in this diff Show More