cb4c0681d3
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>
197 lines
5.9 KiB
Markdown
197 lines
5.9 KiB
Markdown
# Knowledge Base - Workspace v1
|
|
|
|
**Version:** 2.0.0
|
|
**Sistema:** NEXUS v3.4 + SIMCO
|
|
**Actualizado:** 2026-01-04
|
|
|
|
Base de conocimiento centralizada y catalogo de modulos genericos reutilizables.
|
|
|
|
---
|
|
|
|
## Indice Rapido
|
|
|
|
| Recurso | Descripcion | Ubicacion |
|
|
|---------|-------------|-----------|
|
|
| **Catalogo de Modulos** | Registro maestro de modulos | [CATALOGO-MODULOS.yml](./CATALOGO-MODULOS.yml) |
|
|
| **Trazabilidad** | Mapeo proyectos-modulos | [TRAZABILIDAD-PROYECTOS.yml](./TRAZABILIDAD-PROYECTOS.yml) |
|
|
| **Modulos** | Codigo reutilizable | [modules/](./modules/) |
|
|
| **Plataformas** | Bases de proyecto completas | [platforms/](./platforms/) |
|
|
| **Templates** | Plantillas para nuevos modulos | [templates/](./templates/) |
|
|
|
|
---
|
|
|
|
## Estructura
|
|
|
|
```
|
|
knowledge-base/
|
|
├── README.md # Este archivo
|
|
├── CATALOGO-MODULOS.yml # Registro maestro de 37 modulos
|
|
├── TRAZABILIDAD-PROYECTOS.yml # Mapeo 12 proyectos
|
|
├── INDEX.yml # Indice de busqueda legacy
|
|
│
|
|
├── modules/ # MODULOS GENERICOS (8 categorias)
|
|
│ ├── _INDEX.md # Indice de modulos
|
|
│ ├── authentication/ # Auth: JWT, OAuth, Sessions
|
|
│ ├── payments/ # Pagos: Stripe, PayPal
|
|
│ ├── notifications/ # Notificaciones: Email, Push, SMS
|
|
│ ├── user-management/ # Usuarios: Roles, Perfiles
|
|
│ ├── ui-components/ # UI: Dashboard, Tables, Forms
|
|
│ ├── api-patterns/ # API: REST, GraphQL, Pagination
|
|
│ ├── database-patterns/ # BD: Audit, Multi-tenant, Soft-delete
|
|
│ └── integrations/ # Ext: Odoo, QuickBooks, Google
|
|
│
|
|
├── platforms/ # PLATAFORMAS BASE (5)
|
|
│ ├── _INDEX.md # Indice de plataformas
|
|
│ ├── saas-base/ # Template SaaS
|
|
│ ├── erp-base/ # Base ERP
|
|
│ ├── pos-base/ # Punto de Venta
|
|
│ ├── gamification-platform/ # Gamificacion
|
|
│ └── trading-base/ # Trading
|
|
│
|
|
├── templates/ # TEMPLATES
|
|
│ └── module-template/ # Template para nuevos modulos
|
|
│ ├── README.md
|
|
│ ├── USAGE.md
|
|
│ ├── CHANGELOG.md
|
|
│ └── API.md
|
|
│
|
|
├── architecture/ # Patrones arquitectonicos
|
|
├── patterns/ # Patrones de desarrollo
|
|
├── lessons-learned/ # Lecciones aprendidas
|
|
├── database/ # Convenios de BD
|
|
├── development/ # Guias de desarrollo
|
|
├── api-docs/ # Documentacion de APIs
|
|
├── troubleshooting/ # Solucion de problemas
|
|
├── projects/ # Docs por proyecto (espejo)
|
|
│ ├── gamilit/
|
|
│ ├── erp-core/
|
|
│ └── trading-platform/
|
|
└── reference/ # Referencias legacy (~1GB)
|
|
├── odoo/
|
|
└── erp-inmobiliaria-legacy/
|
|
```
|
|
|
|
---
|
|
|
|
## Como Usar
|
|
|
|
### 1. Buscar un Modulo
|
|
|
|
```bash
|
|
# Revisar catalogo
|
|
cat shared/knowledge-base/CATALOGO-MODULOS.yml
|
|
|
|
# Buscar por funcionalidad
|
|
grep -i "jwt\|auth" shared/knowledge-base/CATALOGO-MODULOS.yml
|
|
```
|
|
|
|
### 2. Usar un Modulo Existente
|
|
|
|
1. Navegar a `modules/{categoria}/{modulo}/`
|
|
2. Leer `README.md` para entender el modulo
|
|
3. Seguir `USAGE.md` para implementar
|
|
4. Consultar `API.md` para referencia
|
|
|
|
### 3. Verificar que Proyectos Usan un Modulo
|
|
|
|
```bash
|
|
# Consultar trazabilidad
|
|
grep -A5 "auth-jwt-nestjs" shared/knowledge-base/TRAZABILIDAD-PROYECTOS.yml
|
|
```
|
|
|
|
### 4. Contribuir un Nuevo Modulo
|
|
|
|
1. Copiar template: `templates/module-template/`
|
|
2. Rellenar README, USAGE, CHANGELOG, API
|
|
3. Colocar en `modules/{categoria}/{modulo}/`
|
|
4. Actualizar `CATALOGO-MODULOS.yml`
|
|
5. Actualizar `TRAZABILIDAD-PROYECTOS.yml`
|
|
|
|
---
|
|
|
|
## Estadisticas
|
|
|
|
| Metrica | Valor |
|
|
|---------|-------|
|
|
| Total Modulos | 37 |
|
|
| Categorias | 8 |
|
|
| Plataformas | 5 |
|
|
| Proyectos Mapeados | 12 |
|
|
| Modulos en Production | 30 |
|
|
| Modulos en Beta | 7 |
|
|
|
|
### Modulos mas Usados
|
|
|
|
| Modulo | Proyectos |
|
|
|--------|-----------|
|
|
| auth-jwt-nestjs | 6 |
|
|
| users-roles-permissions | 2 |
|
|
| ui-admin-dashboard | 2 |
|
|
| payments-stripe-checkout | 2 |
|
|
|
|
---
|
|
|
|
## Integracion con Sistema NEXUS
|
|
|
|
El Knowledge Base es parte del ecosistema NEXUS:
|
|
|
|
```
|
|
workspace-v1/
|
|
├── orchestration/ # Sistema de directivas SIMCO
|
|
├── shared/catalog/ # Codigo de catalogo (legacy)
|
|
├── shared/knowledge-base/ # ESTE DIRECTORIO
|
|
└── projects/ # Proyectos de produccion
|
|
```
|
|
|
|
### Relacion con shared/catalog
|
|
|
|
- **shared/catalog/**: Codigo legacy, referencia
|
|
- **shared/knowledge-base/modules/**: Modulos documentados y versionados
|
|
|
|
---
|
|
|
|
## Validacion
|
|
|
|
```bash
|
|
# Validar estructura
|
|
/home/isem/workspace-v1/devtools/scripts/validate-kb.sh
|
|
|
|
# Verificar YAML
|
|
python3 -c "import yaml; yaml.safe_load(open('CATALOGO-MODULOS.yml'))"
|
|
```
|
|
|
|
---
|
|
|
|
## Documentos Principales
|
|
|
|
| Documento | Descripcion |
|
|
|-----------|-------------|
|
|
| `architecture/PATRON-MULTI-TENANT.md` | Multi-tenancy con RLS |
|
|
| `patterns/PATRON-RLS-POLICIES.md` | Politicas de Row-Level Security |
|
|
| `lessons-learned/LESSONS-WORKSPACE-V1.md` | Lecciones de reorganizacion |
|
|
| `modules/authentication/_INDEX.md` | Modulos de autenticacion |
|
|
| `platforms/_INDEX.md` | Plataformas disponibles |
|
|
|
|
---
|
|
|
|
## Mantenimiento
|
|
|
|
### Actualizar Catalogo
|
|
|
|
1. Editar `CATALOGO-MODULOS.yml`
|
|
2. Actualizar `total_modulos` y estadisticas
|
|
3. Validar YAML
|
|
|
|
### Actualizar Trazabilidad
|
|
|
|
1. Editar `TRAZABILIDAD-PROYECTOS.yml`
|
|
2. Actualizar seccion `modulos_a_proyectos`
|
|
3. Validar YAML
|
|
|
|
---
|
|
|
|
**Mantenedor:** @Architecture-Analyst
|
|
**Ubicacion:** /home/isem/workspace-v1/shared/knowledge-base/
|
|
**Archivos totales:** ~1,200
|
|
**Tamano aproximado:** 1.1 GB (principalmente reference/odoo)
|