rckrdmrd 74b5ed7f38 feat: Complete documentation update and orchestration configuration

- Update vision, architecture and technical documentation
- Update module definitions (PMC-001 to PMC-008)
- Update requirements documentation
- Add CONTEXT-MAP.yml and ENVIRONMENT-INVENTORY.yml
- Add orchestration guidelines and references

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

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

2026-01-07 05:38:31 -06:00

5.5 KiB

Raw Blame History

Contexto de Proyecto: Platform Marketing Content

Versi贸n: 1.0.0 Fecha: 2025-12-08 Nivel SIMCO: NIVEL_2B (Proyecto independiente)

Identificaci贸n del Proyecto

Proyecto: platform_marketing_content
Alias: PMC
Tipo: SaaS Platform
Dominio: Marketing Digital / Generaci贸n de Contenido IA
Estado: An谩lisis y Documentaci贸n

Descripci贸n

Platform Marketing Content (PMC) es una plataforma SaaS para agencias de publicidad que combina:

Motor de Generaci贸n de Contenido con IA - Im谩genes y copys autom谩ticos
CRM Integrado - Gesti贸n de clientes, marcas y campa帽as
Automatizaci贸n Creativa - Flujos desde brief hasta entrega
DAM - Biblioteca de activos digitales

Stack Tecnol贸gico

Backend:
  - NestJS + TypeScript
  - PostgreSQL 15+
  - Redis
  - Bull/BullMQ

Frontend:
  - React 18 + Vite
  - TailwindCSS
  - Shadcn/UI

Motor IA:
  - ComfyUI
  - Stable Diffusion XL
  - ComfyDeploy

Automatizaci贸n:
  - n8n

Almacenamiento:
  - S3/MinIO

Estructura de Documentaci贸n

projects/platform_marketing_content/
鉁斺攢鉁? docs/
鉁?   鉁斺攢鉁? 00-vision-general/        # Visi贸n, arquitectura, glosario
鉁?   鉁斺攢鉁? 01-analisis-referencias/  # Investigaci贸n, benchmarks
鉁?   鉁斺攢鉁? 02-definicion-modulos/    # Especificaciones por m贸dulo
鉁?   鉁斺攢鉁? 03-requerimientos/        # Requerimientos funcionales
鉁?   鉁斺攢鉁? 04-modelado/              # Modelos de dominio, DB design
鉁?   鉁斺攢鉁? 05-user-stories/          # Historias de usuario
鉁?   鉁斺攢鉁? 95-guias-desarrollo/      # Gu铆as y convenciones
鉁?   鉁斺攢鉁? 97-adr/                   # Decisiones arquitect贸nicas
鉁?
鉁斺攢鉁? orchestration/
鉁?   鉁斺攢鉁? 00-guidelines/            # Contexto, herencias
鉁?   鉁斺攢鉁? inventarios/              # Inventarios de implementaci贸n
鉁?   鉁斺攢鉁? trazas/                   # Trazas de tareas
鉁?
鉁斺攢鉁? apps/
    鉁斺攢鉁? backend/                  # C贸digo NestJS
    鉁斺攢鉁? frontend/                 # C贸digo React
    鉁斺攢鉁? comfyui/                  # Workflows ComfyUI

M贸dulos Funcionales

ID	M贸dulo	Descripci贸n	Prioridad
PMC-001	Tenants	Arquitectura multi-tenant	Alta
PMC-002	CRM	Clientes, marcas, productos	Alta
PMC-003	Projects	Proyectos y campa帽as	Alta
PMC-004	Generation	Motor de generaci贸n IA	Alta
PMC-005	Automation	Flujos automatizados	Media
PMC-006	Assets	DAM - biblioteca de activos	Alta
PMC-007	Admin	Administraci贸n SaaS	Media
PMC-008	Analytics	Reportes y dashboards	Baja

Aliases del Proyecto

# Documentaci贸n
@PMC_DOCS: projects/platform_marketing_content/docs/
@PMC_VISION: projects/platform_marketing_content/docs/00-vision-general/
@PMC_MODULES: projects/platform_marketing_content/docs/02-definicion-modulos/
@PMC_REQS: projects/platform_marketing_content/docs/03-requerimientos/
@PMC_ADR: projects/platform_marketing_content/docs/97-adr/

# Orchestration
@PMC_ORCH: projects/platform_marketing_content/orchestration/
@PMC_INVENTORY: projects/platform_marketing_content/orchestration/inventarios/
@PMC_TRAZA: projects/platform_marketing_content/orchestration/trazas/

# C贸digo
@PMC_BACKEND: projects/platform_marketing_content/apps/backend/
@PMC_FRONTEND: projects/platform_marketing_content/apps/frontend/

Dependencias del Catalogo Core

Funcionalidades reutilizables del catalogo:

Requeridas:
  - @CATALOG_AUTH:
      path: shared/catalog/auth/
      uso: Autenticacion JWT + OAuth
      modulo: PMC-007
  - @CATALOG_SESSION:
      path: shared/catalog/session-management/
      uso: Gestion de sesiones
      modulo: PMC-007
  - @CATALOG_TENANT:
      path: shared/catalog/multi-tenancy/
      uso: Multi-tenancy con RLS
      modulo: PMC-001
  - @CATALOG_NOTIFY:
      path: shared/catalog/notifications/
      uso: Notificaciones email/push
      modulo: PMC-005
  - @CATALOG_RATELIMIT:
      path: shared/catalog/rate-limiting/
      uso: Limites de generacion
      modulo: PMC-004
  - @CATALOG_WS:
      path: shared/catalog/websocket/
      uso: Progreso en tiempo real
      modulo: PMC-004

Opcionales (Fase 4):
  - @CATALOG_PAYMENTS:
      path: shared/catalog/payments/
      uso: Billing y suscripciones
      modulo: PMC-001
  - @CATALOG_FLAGS:
      path: shared/catalog/feature-flags/
      uso: Feature toggles
      modulo: PMC-007

Ver analisis detallado: docs/01-analisis-referencias/ANALISIS-CATALOGO.md

Roadmap de Fases

Fase 1 - MVP Core (Semanas 1-8):
  - Arquitectura base
  - CRM b谩sico
  - Motor de generaci贸n (2-3 workflows)
  - DAM b谩sico
  - Admin usuarios

Fase 2 - Personalizaci贸n (Semanas 9-14):
  - LoRAs por marca
  - Avatares consistentes
  - Integraci贸n CRM鈫扜eneraci贸n

Fase 3 - Contenido Enriquecido (Semanas 15-22):
  - GIFs/cinemagraphs
  - Video b谩sico
  - Portal cliente

Fase 4 - Multi-tenant Comercial (Semanas 23+):
  - SaaS p煤blico
  - Planes de suscripci贸n

Contactos y Responsables

Product Owner: [Por definir]
Tech Lead: [Por definir]
Requirements Analyst: Agente IA

Referencias

Documento generado por: Requirements-Analyst Fecha: 2025-12-08

5.5 KiB Raw Blame History