# Knowledge Base Index
# ====================
# Indice maestro de la base de conocimiento

version: "1.0.0"
fecha_actualizacion: "2025-12-27"
ubicacion: "shared/knowledge-base/"

# Categorias principales
categorias:

  architecture:
    descripcion: "Patrones y decisiones arquitectonicas"
    path: "architecture/"
    documentos:
      - nombre: "PATRON-MULTI-TENANT.md"
        descripcion: "Patron de multi-tenancy con RLS"
        keywords: ["multi-tenant", "rls", "isolation"]
      - nombre: "PATRON-MODULAR-MONOLITH.md"
        descripcion: "Arquitectura modular monolitica"
        keywords: ["modular", "monolith", "nestjs"]

  patterns:
    descripcion: "Patrones de desarrollo y codigo"
    path: "patterns/"
    documentos:
      - nombre: "PATRON-RLS-POLICIES.md"
        descripcion: "Politicas de Row-Level Security"
        keywords: ["rls", "security", "postgresql"]
      - nombre: "PATRON-ENTITY-AUDIT.md"
        descripcion: "Auditoria automatica de entidades"
        keywords: ["audit", "tracking", "typeorm"]

  database:
    descripcion: "Convenios y patrones de base de datos"
    path: "database/"
    documentos:
      - nombre: "CONVENIOS-NOMENCLATURA.md"
        descripcion: "Convenios de nombres para BD"
        keywords: ["naming", "conventions", "schema"]
      - nombre: "PATRON-MIGRACIONES.md"
        descripcion: "Patron de migraciones seguras"
        keywords: ["migrations", "typeorm", "rollback"]

  lessons-learned:
    descripcion: "Lecciones aprendidas de proyectos"
    path: "lessons-learned/"
    documentos:
      - nombre: "LESSONS-WORKSPACE-V1.md"
        descripcion: "Lecciones de migracion workspace"
        keywords: ["migration", "workspace", "organization"]
      - nombre: "LESSONS-GAMILIT.md"
        descripcion: "Lecciones del proyecto gamilit"
        keywords: ["gamilit", "education", "gamification"]

  projects:
    descripcion: "Documentacion especifica por proyecto"
    path: "projects/"
    subdirectorios:
      - nombre: "gamilit/"
        descripcion: "Documentacion extraida de gamilit"
      - nombre: "erp-suite/"
        descripcion: "Documentacion extraida de erp-suite"
      - nombre: "trading-platform/"
        descripcion: "Documentacion extraida de trading-platform"

  troubleshooting:
    descripcion: "Solucion de problemas comunes"
    path: "troubleshooting/"
    documentos:
      - nombre: "POSTGRES-COMMON-ISSUES.md"
        descripcion: "Problemas comunes de PostgreSQL"
        keywords: ["postgresql", "errors", "performance"]
      - nombre: "NESTJS-COMMON-ISSUES.md"
        descripcion: "Problemas comunes de NestJS"
        keywords: ["nestjs", "errors", "debugging"]

  reference:
    descripcion: "Codigo de referencia y legacy"
    path: "reference/"
    subdirectorios:
      - nombre: "odoo/"
        descripcion: "Codigo fuente Odoo 18.0 para referencia"
        size: "~1GB"
      - nombre: "erp-inmobiliaria-legacy/"
        descripcion: "ERP Inmobiliaria codigo legacy"
      - nombre: "gamilit-legacy/"
        descripcion: "Gamilit codigo legacy"

# Busqueda
busqueda:
  instrucciones: |
    Para buscar en el knowledge base:
    1. Usar grep: grep -ri "{keyword}" shared/knowledge-base/
    2. Buscar por categoria en este INDEX.yml
    3. Consultar reference/ para codigo de ejemplo

  keywords_principales:
    - multi-tenant
    - rls
    - audit
    - migration
    - patterns
    - nestjs
    - postgresql
    - typeorm

# Mantenimiento
mantenimiento:
  responsable: "Equipo de desarrollo"
  frecuencia: "Actualizar con cada nuevo proyecto/modulo"
  reglas:
    - "Todo documento debe tener metadata YAML"
    - "Usar markdown estandar"
    - "Incluir ejemplos de codigo cuando aplique"
    - "Referenciar proyectos fuente"