rckrdmrd
50a821a415
- HERENCIA-SIMCO.md actualizado con directivas v3.7 y v3.8 - Actualizaciones de configuracion Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
207 lines
6.0 KiB
Markdown
207 lines
6.0 KiB
Markdown
# HERENCIA SIMCO - Template SaaS
|
|
|
|
**Proyecto:** template-saas
|
|
**Tipo:** STANDALONE
|
|
**Version SIMCO:** 3.8.0
|
|
**Última actualización:** 2026-01-10
|
|
|
|
---
|
|
|
|
## Directivas Heredadas del Workspace
|
|
|
|
Este proyecto hereda las siguientes directivas SIMCO del workspace-v1:
|
|
|
|
### Directivas de Estructura (SIMCO-ESTRUCTURA)
|
|
|
|
| Directiva | Ubicacion | Aplicacion |
|
|
|-----------|-----------|------------|
|
|
| SIMCO-ESTRUCTURA-REPOS | `orchestration/directivas/simco/` | Estructura de carpetas |
|
|
| SIMCO-NIVELES | `orchestration/directivas/simco/` | Nivel STANDALONE |
|
|
| SIMCO-MODULOS-COMPARTIDOS | `orchestration/directivas/simco/` | Uso de shared/ |
|
|
|
|
### Directivas de Tarea (SIMCO-TAREA)
|
|
|
|
| Directiva | Aplicacion |
|
|
|-----------|------------|
|
|
| SIMCO-TAREA | Ejecucion de tareas por agentes |
|
|
| SIMCO-BUSCAR | Busqueda en codebase |
|
|
| SIMCO-CREAR | Creacion de nuevos archivos |
|
|
| SIMCO-CONTRIBUIR-CATALOGO | Contribuciones a shared/catalog |
|
|
|
|
### Directivas de Contexto
|
|
|
|
| Directiva | Aplicacion |
|
|
|-----------|------------|
|
|
| SIMCO-CONTEXT-RESOLUTION | Resolucion de contexto de proyecto |
|
|
| DIRECTIVA-CARGA-CONTEXTO | Carga de contexto en sesiones |
|
|
|
|
---
|
|
|
|
## Directivas de Documentación (SIMCO v3.7) - NUEVO
|
|
|
|
Ubicación: `workspace/orchestration/directivas/simco/`
|
|
|
|
**Directivas de estandarización de documentación:**
|
|
|
|
| Alias | Directiva | Propósito | Aplica |
|
|
|-------|-----------|-----------|--------|
|
|
| `@DOC_PROYECTO` | `SIMCO-DOCUMENTACION-PROYECTO.md` | Estructura base de documentación | **SÍ** |
|
|
| `@NOMENCLATURA` | `SIMCO-NOMENCLATURA.md` | Convenciones de nomenclatura (SAAS-) | **SÍ** |
|
|
| `@ESTRUCTURA_DOCS` | `SIMCO-ESTRUCTURA-DOCS.md` | Estructura interna de documentos | **SÍ** |
|
|
| `@INVENTARIOS` | `SIMCO-INVENTARIOS.md` | Estándares de inventarios YAML | **SÍ** |
|
|
| `@TESTING` | `SIMCO-TESTING.md` | Cobertura y estándares de testing | **SÍ** |
|
|
| `@MIGRACIONES` | `SIMCO-MIGRACIONES-BD.md` | Migraciones y DDL | **SÍ** |
|
|
| `@INTEGRACIONES` | `SIMCO-INTEGRACIONES-EXTERNAS.md` | Documentación de integraciones | **SÍ** |
|
|
|
|
### Checklists Asociados
|
|
|
|
| Alias | Checklist | Items |
|
|
|-------|-----------|-------|
|
|
| `@CHK_DOCUMENTACION` | `CHECKLIST-DOCUMENTACION-PROYECTO.md` | 44 |
|
|
| `@CHK_INVENTARIOS` | `CHECKLIST-INVENTARIOS.md` | 63 |
|
|
| `@CHK_NOMENCLATURA` | `CHECKLIST-NOMENCLATURA.md` | 40 |
|
|
|
|
### Templates Disponibles
|
|
|
|
| Alias | Template | Uso |
|
|
|-------|----------|-----|
|
|
| `@TPL_INVENTARIO` | `TEMPLATE-INVENTARIO-PROYECTO.md` | Crear inventarios YAML |
|
|
| `@TPL_INTEGRACION` | `TEMPLATE-INTEGRACION-EXTERNA.md` | Documentar integraciones externas |
|
|
| `@TPL_MODULO_ESTANDAR` | `TEMPLATE-MODULO-ESTANDAR.md` | Documentar módulos SaaS |
|
|
|
|
**Nota:** Como proyecto TEMPLATE, estos estándares son obligatorios para proyectos derivados.
|
|
|
|
---
|
|
|
|
## Directivas de Mantenimiento de Documentación (SIMCO v3.8) - NUEVO
|
|
|
|
Ubicación: `workspace/orchestration/directivas/simco/`
|
|
|
|
**Nuevas directivas agregadas en v3.8 para mantenimiento, purga y sincronización de documentación:**
|
|
|
|
| Alias | Directiva | Propósito | Aplica |
|
|
|-------|-----------|-----------|--------|
|
|
| `@MANTENIMIENTO_DOCS` | `SIMCO-MANTENIMIENTO-DOCUMENTACION.md` | Ciclo de mantenimiento, purga y deprecación | **SÍ** |
|
|
| `@SYNC_BD` | `SIMCO-SINCRONIZACION-BD.md` | Sincronización BD ↔ Código ↔ Docs | **SÍ** |
|
|
|
|
### Checklists de Mantenimiento
|
|
|
|
| Alias | Checklist | Items |
|
|
|-------|-----------|-------|
|
|
| `@CHK_MANTENIMIENTO` | `CHECKLIST-MANTENIMIENTO-DOCS.md` | 80 |
|
|
| `@CHK_SYNC_BD` | `CHECKLIST-SINCRONIZACION-BD.md` | 70 |
|
|
|
|
### Templates y Perfiles
|
|
|
|
| Alias | Archivo | Uso |
|
|
|-------|---------|-----|
|
|
| `@TPL_DEPRECACION` | `TEMPLATE-DEPRECACION.md` | Marcar documentos como deprecados |
|
|
| `@PERFIL_DOC_MAINT` | `PERFIL-DOCUMENTATION-MAINTAINER.md` | Perfil especializado en mantenimiento |
|
|
|
|
### Cuándo Usar
|
|
|
|
| Evento | Acción |
|
|
|--------|--------|
|
|
| Tarea completada (código) | `@MANTENIMIENTO_DOCS` nivel básico |
|
|
| Cambio en DDL | `@SYNC_BD` + `@CHK_SYNC_BD` |
|
|
| Fin de sprint/fase | `@CHK_MANTENIMIENTO` completo |
|
|
| Deprecar documentos | `@TPL_DEPRECACION` |
|
|
|
|
**Nota:** Como proyecto TEMPLATE, estas directivas de mantenimiento deben incluirse en proyectos derivados.
|
|
|
|
---
|
|
|
|
## Configuracion Especifica
|
|
|
|
### Variables del Proyecto
|
|
|
|
```yaml
|
|
PROJECT_ID: template-saas
|
|
PROJECT_TYPE: standalone
|
|
PROJECT_CATEGORY: saas
|
|
SIMCO_LEVEL: 0 (template/referencia)
|
|
```
|
|
|
|
### Aplicacion de SIMCO-NIVELES
|
|
|
|
Como proyecto STANDALONE de tipo TEMPLATE:
|
|
|
|
1. **Auto-contenido** - No depende de otros proyectos
|
|
2. **Referencia** - Sirve como base para nuevos proyectos SaaS
|
|
3. **Catalogo** - Contribuye patrones a `shared/catalog/`
|
|
|
|
---
|
|
|
|
## Integracion con shared/
|
|
|
|
### Uso de shared/catalog
|
|
|
|
```yaml
|
|
catalogo_consumido:
|
|
- auth (patrones de autenticacion)
|
|
- multi-tenancy (RLS patterns)
|
|
- billing (Stripe integration)
|
|
- notifications (templates)
|
|
|
|
catalogo_contribuido:
|
|
- template-saas (todo el proyecto como template)
|
|
```
|
|
|
|
### Uso de shared/knowledge-base
|
|
|
|
```yaml
|
|
knowledge_base:
|
|
- patterns/PATRON-RLS-POLICIES.md
|
|
- patterns/PATRON-MULTI-TENANT.md
|
|
- architecture/PATRON-SAAS.md
|
|
```
|
|
|
|
---
|
|
|
|
## Agentes Aplicables
|
|
|
|
### Agentes Primarios
|
|
|
|
| Agente | Responsabilidad |
|
|
|--------|-----------------|
|
|
| Database-Agent | DDL, RLS, migraciones |
|
|
| Backend-Agent | Modulos NestJS/Express |
|
|
| Frontend-Agent | Portales React |
|
|
| DevOps-Agent | Docker, CI/CD |
|
|
|
|
### Agentes Secundarios
|
|
|
|
| Agente | Responsabilidad |
|
|
|--------|-----------------|
|
|
| Security-Auditor | Revision de seguridad |
|
|
| Testing-Agent | Tests unitarios e integracion |
|
|
| Requirements-Analyst | Documentacion de specs |
|
|
|
|
---
|
|
|
|
## Propagacion
|
|
|
|
### Origen
|
|
|
|
Este template recibe patrones de:
|
|
- `projects/gamilit` - Arquitectura multi-tenant
|
|
- `projects/erp-core` - Patrones de modulos
|
|
|
|
### Destino
|
|
|
|
Este template propaga a:
|
|
- Nuevos proyectos SaaS creados en el workspace
|
|
- `shared/catalog/template-saas/` - Referencia en catalogo
|
|
|
|
---
|
|
|
|
## Referencias
|
|
|
|
- SIMCO Index: `workspace-v1/orchestration/directivas/simco/_INDEX.md`
|
|
- Aliases: `workspace-v1/orchestration/referencias/ALIASES.yml`
|
|
- Contexto: `CONTEXTO-PROYECTO.md`
|
|
|
|
---
|
|
|
|
**Actualizado:** 2026-01-10
|