erp-suite/orchestration/prompts/PROMPT-DATABASE-AGENT.md

124 lines
3.3 KiB
Markdown

# PROMPT DATABASE-AGENT - EXTENSIÓN ERP-SUITE
**Versión:** 1.0.0
**Fecha:** 2025-12-05
**Tipo:** Extensión de prompt global
**Proyecto:** ERP Suite - Sistema ERP Multi-Vertical
---
## HERENCIA
```yaml
EXTIENDE: core/orchestration/agents/PROMPT-DATABASE-AGENT.md
CONTEXTO: orchestration/00-guidelines/CONTEXTO-PROYECTO.md
```
**IMPORTANTE:** Este archivo NO duplica el prompt global. Solo contiene:
1. Resolución de variables para ERP-Suite
2. Extensiones específicas del proyecto (si las hay)
---
## RESOLUCIÓN DE VARIABLES PARA ERP-SUITE
Al leer el prompt global, resolver estos placeholders:
```yaml
{PROJECT_NAME}: ERP-Suite
{DB_NAME}: erp_platform
{DB_DDL_PATH}: apps/erp-core/database/ddl
{DB_SCRIPTS_PATH}: apps/erp-core/database
{DB_SEEDS_PATH}: apps/erp-core/database/seeds
{RECREATE_CMD}: drop-and-recreate-database.sh
{AUTH_SCHEMA}: auth_management
```
---
## ARQUITECTURA MULTI-VERTICAL
ERP-Suite tiene una arquitectura de herencia:
```
erp-core (60-70% código base)
├── verticales/construccion (35% avanzado)
├── verticales/vidrio-templado (0%)
├── verticales/mecanicas-diesel (0%)
├── verticales/retail (0%)
└── verticales/clinicas (0%)
```
### Schemas Core (erp-core)
| Schema | Propósito |
|--------|-----------|
| `auth_management` | Autenticación, usuarios, roles |
| `catalog_management` | Catálogos compartidos |
| `audit_management` | Logs de auditoría |
### Schemas Vertical Construcción
| Schema | Propósito |
|--------|-----------|
| `project_management` | Proyectos, desarrollos, fases |
| `financial_management` | Presupuestos, estimaciones |
| `purchasing_management` | Compras, proveedores |
| `construction_management` | Avances, recursos |
| `quality_management` | Inspecciones, calidad |
| `infonavit_management` | Integración INFONAVIT |
---
## RUTAS DE TRABAJO
### Core
```bash
apps/erp-core/database/ddl/schemas/{schema}/tables/*.sql
apps/erp-core/database/seeds/dev/{schema}/*.sql
```
### Vertical Construcción
```bash
apps/verticales/construccion/database/ddl/schemas/{schema}/tables/*.sql
apps/verticales/construccion/database/seeds/dev/{schema}/*.sql
```
---
## EXTENSIONES ESPECÍFICAS
### Multi-tenant con RLS
ERP-Suite usa Row Level Security basado en `constructora_id`:
```sql
-- Contexto de sesión
SET app.current_constructora_id = '{uuid}';
-- Policy RLS típica
CREATE POLICY tenant_isolation ON {schema}.{tabla}
USING (constructora_id = current_setting('app.current_constructora_id')::uuid);
```
### Documentación de Referencia
Antes de crear schemas para vertical construcción, consultar:
```
docs/verticales/construccion/02-modelado/database-design/schemas/
```
---
## FLUJO DE INICIO
Cuando el usuario diga "lee el prompt de Database Agent para ERP-Suite":
1. **Leer prompt global:** `core/orchestration/agents/PROMPT-DATABASE-AGENT.md`
2. **Leer este archivo:** Para resolver variables y ver extensiones
3. **Leer contexto:** `orchestration/00-guidelines/CONTEXTO-PROYECTO.md`
4. **Listo para recibir tarea**
---
**Nota:** Cualquier mejora a las directivas generales se hace en `core/orchestration/agents/PROMPT-DATABASE-AGENT.md` y se refleja automáticamente en todos los proyectos.