rckrdmrd/platform-marketing-content
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
d0f47896e7
platform-marketing-content/docs/03-requerimientos/RF-PMC-002-CRM.md

13 KiB
Raw Blame History

Requerimientos Funcionales - PMC-002 CRM

Módulo: CRM Versión: 1.0.0 Fecha: 2025-12-08

Gestión de Clientes

RF-PMC-002-001: Crear Cliente

Campo Valor
ID RF-PMC-002-001
Nombre Crear Cliente
Prioridad P1
Actor Creative, Analyst, Tenant Admin

Descripción: El sistema debe permitir registrar un nuevo cliente de la agencia.

Datos de entrada:

  • name: string (requerido)
  • legal_name: string (opcional)
  • tax_id: string (opcional)
  • industry: string (opcional)
  • size: enum (opcional)
  • website: string (opcional)
  • notes: text (opcional)

Criterios de aceptación:

  • Cliente se crea con status "prospect"
  • tenant_id se asigna automáticamente
  • Validación de datos funciona

RF-PMC-002-002: Editar Cliente

Campo Valor
ID RF-PMC-002-002
Nombre Editar Cliente
Prioridad P1
Actor Creative, Analyst, Tenant Admin

Descripción: El sistema debe permitir modificar datos de un cliente existente.

Criterios de aceptación:

  • Todos los campos editables se actualizan
  • Cambio de status registra historial
  • Audit log registra modificaciones

RF-PMC-002-003: Listar Clientes

Campo Valor
ID RF-PMC-002-003
Nombre Listar Clientes
Prioridad P1
Actor Todos los roles

Descripción: El sistema debe mostrar lista de clientes con filtros y paginación.

Filtros disponibles:

  • status: prospect, active, inactive, churned
  • industry: string
  • size: enum
  • search: nombre o legal_name

Criterios de aceptación:

  • Paginación funciona correctamente
  • Filtros se combinan con AND
  • Ordenamiento por nombre/fecha

RF-PMC-002-004: Ver Ficha de Cliente

Campo Valor
ID RF-PMC-002-004
Nombre Ver Ficha de Cliente
Prioridad P1
Actor Todos los roles

Descripción: El sistema debe mostrar vista detallada del cliente con información relacionada.

Datos mostrados:

  • Información básica
  • Contactos asociados
  • Marcas del cliente
  • Proyectos activos
  • Oportunidades abiertas
  • Historial de actividad

Criterios de aceptación:

  • Tabs organizan información
  • Datos relacionados cargan correctamente
  • Acciones rápidas disponibles

RF-PMC-002-005: Eliminar Cliente

Campo Valor
ID RF-PMC-002-005
Nombre Eliminar Cliente
Prioridad P3
Actor Tenant Admin

Descripción: El sistema debe permitir eliminar un cliente (soft delete).

Validaciones:

  • No tiene proyectos activos
  • Confirmación requerida

Criterios de aceptación:

  • Soft delete funciona
  • Validaciones impiden eliminación si hay dependencias activas

Gestión de Contactos

RF-PMC-002-006: Crear Contacto

Campo Valor
ID RF-PMC-002-006
Nombre Crear Contacto
Prioridad P1
Actor Creative, Analyst, Tenant Admin

Datos de entrada:

  • client_id: UUID (requerido)
  • first_name: string (requerido)
  • last_name: string (requerido)
  • email: string (requerido)
  • phone: string (opcional)
  • position: string (opcional)
  • is_primary: boolean (default false)

Criterios de aceptación:

  • Contacto se asocia al cliente
  • Email validado (formato)
  • Solo un contacto primario por cliente

RF-PMC-002-007: Editar Contacto

Campo Valor
ID RF-PMC-002-007
Nombre Editar Contacto
Prioridad P2
Actor Creative, Analyst, Tenant Admin

Criterios de aceptación:

  • Campos se actualizan correctamente
  • Cambio de is_primary actualiza otros contactos

RF-PMC-002-008: Listar Contactos

Campo Valor
ID RF-PMC-002-008
Nombre Listar Contactos
Prioridad P2
Actor Todos los roles

Descripción: Listar contactos del tenant o de un cliente específico.

Criterios de aceptación:

  • Filtro por cliente funciona
  • Búsqueda por nombre/email
  • Paginación implementada

RF-PMC-002-009: Marcar Contacto Primario

Campo Valor
ID RF-PMC-002-009
Nombre Marcar Contacto Primario
Prioridad P2
Actor Creative, Analyst, Tenant Admin

Descripción: Designar un contacto como principal del cliente.

Criterios de aceptación:

  • Solo un contacto primario por cliente
  • Al marcar uno, otros se desmarcan automáticamente

Gestión de Marcas

RF-PMC-002-010: Crear Marca

Campo Valor
ID RF-PMC-002-010
Nombre Crear Marca
Prioridad P1
Actor Creative, Tenant Admin

Datos de entrada:

  • client_id: UUID (requerido)
  • name: string (requerido)
  • description: text (opcional)
  • identity: object (opcional)
    • logo_url
    • primary_color
    • secondary_colors
    • typography
    • tone_of_voice
    • keywords
    • forbidden_words
    • visual_style

Criterios de aceptación:

  • Marca se asocia al cliente
  • Identity se almacena como JSONB
  • Logo se puede subir o referenciar URL

RF-PMC-002-011: Editar Marca

Campo Valor
ID RF-PMC-002-011
Nombre Editar Marca
Prioridad P1
Actor Creative, Tenant Admin

Criterios de aceptación:

  • Todos los campos de identity editables
  • Preview de colores en tiempo real
  • Cambios se propagan a nuevas generaciones

RF-PMC-002-012: Definir Identidad Visual

Campo Valor
ID RF-PMC-002-012
Nombre Definir Identidad Visual
Prioridad P1
Actor Creative, Tenant Admin

Descripción: Configurar todos los elementos de identidad visual de la marca.

Campos de identidad:

  • Logo (principal y variaciones)
  • Paleta de colores
  • Tipografías
  • Tono de voz
  • Keywords positivas
  • Palabras prohibidas
  • Estilo visual preferido

Criterios de aceptación:

  • Formulario estructurado para cada sección
  • Upload de logos funciona
  • Preview visual de paleta de colores

RF-PMC-002-013: Asociar LoRA a Marca

Campo Valor
ID RF-PMC-002-013
Nombre Asociar LoRA a Marca
Prioridad P1
Actor Creative, Tenant Admin

Descripción: Vincular modelos LoRA entrenados con una marca.

Flujo:

  1. Usuario accede a configuración de marca
  2. Selecciona "Modelos IA"
  3. Elige LoRA(s) del catálogo del tenant
  4. Sistema vincula LoRA con marca
  5. LoRA se usa automáticamente en generaciones de la marca

Criterios de aceptación:

  • Múltiples LoRAs pueden asociarse
  • LoRA se aplica por defecto en generación
  • Desasociación funciona

RF-PMC-002-014: Listar Marcas

Campo Valor
ID RF-PMC-002-014
Nombre Listar Marcas
Prioridad P1
Actor Todos los roles

Criterios de aceptación:

  • Filtro por cliente funciona
  • Preview de logo/colores en lista
  • Búsqueda por nombre

Gestión de Productos

RF-PMC-002-015: Crear Producto

Campo Valor
ID RF-PMC-002-015
Nombre Crear Producto
Prioridad P1
Actor Creative, Analyst

Datos de entrada:

  • brand_id: UUID (requerido)
  • name: string (requerido)
  • sku: string (opcional)
  • description: text (opcional)
  • category: string (opcional)
  • attributes: object (precio, features, etc.)
  • reference_images: array[file] (opcional)

Criterios de aceptación:

  • Producto se asocia a marca
  • Imágenes de referencia se almacenan
  • Status inicial "active"

RF-PMC-002-016: Editar Producto

Campo Valor
ID RF-PMC-002-016
Nombre Editar Producto
Prioridad P2
Actor Creative, Analyst

Criterios de aceptación:

  • Campos se actualizan correctamente
  • Imágenes de referencia pueden agregarse/quitarse

RF-PMC-002-017: Subir Imágenes de Referencia

Campo Valor
ID RF-PMC-002-017
Nombre Subir Imágenes de Referencia
Prioridad P1
Actor Creative, Analyst

Descripción: Agregar fotos reales del producto para usar como referencia en generación.

Criterios de aceptación:

  • Upload múltiple funciona
  • Formatos: JPG, PNG, WebP
  • Tamaño máximo: 10MB por imagen
  • Thumbnails generados automáticamente

RF-PMC-002-018: Trigger Generación desde Producto

Campo Valor
ID RF-PMC-002-018
Nombre Trigger Generación desde Producto
Prioridad P1
Actor Creative

Descripción: Iniciar generación de contenido directamente desde la ficha de producto.

Flujo:

  1. Usuario ve ficha de producto
  2. Selecciona "Generar contenido"
  3. Elige workflow template
  4. Configura opciones (cantidad, estilo)
  5. Sistema crea job de generación
  6. Sistema redirige a monitor o muestra progreso

Criterios de aceptación:

  • Datos del producto se cargan al job
  • Identidad de marca se incluye
  • LoRAs se aplican automáticamente

RF-PMC-002-019: Listar Productos

Campo Valor
ID RF-PMC-002-019
Nombre Listar Productos
Prioridad P1
Actor Todos los roles

Criterios de aceptación:

  • Filtro por marca funciona
  • Vista de catálogo con imágenes
  • Búsqueda por nombre/SKU

Gestión de Oportunidades

RF-PMC-002-020: Crear Oportunidad

Campo Valor
ID RF-PMC-002-020
Nombre Crear Oportunidad
Prioridad P2
Actor Analyst, Tenant Admin

Datos de entrada:

  • client_id: UUID (requerido)
  • name: string (requerido)
  • description: text (opcional)
  • value: decimal (opcional)
  • currency: string (default: USD)
  • expected_close_date: date (opcional)

Criterios de aceptación:

  • Stage inicial "lead"
  • Probability calculada por stage

RF-PMC-002-021: Mover Oportunidad en Pipeline

Campo Valor
ID RF-PMC-002-021
Nombre Mover Oportunidad en Pipeline
Prioridad P2
Actor Analyst, Tenant Admin

Descripción: Cambiar stage de una oportunidad mediante drag & drop o acción directa.

Stages:

  • lead → qualified → proposal → negotiation → won/lost

Criterios de aceptación:

  • Drag & drop en vista Kanban
  • Probability se actualiza automáticamente
  • Registro de historial de cambios

RF-PMC-002-022: Cerrar Oportunidad como Ganada

Campo Valor
ID RF-PMC-002-022
Nombre Cerrar Oportunidad como Ganada
Prioridad P2
Actor Analyst, Tenant Admin

Flujo:

  1. Usuario mueve a stage "won"
  2. Sistema solicita valor final confirmado
  3. Sistema marca como ganada
  4. Sistema ofrece crear proyecto

Criterios de aceptación:

  • actual_close_date se registra
  • Opción de crear proyecto disponible

RF-PMC-002-023: Cerrar Oportunidad como Perdida

Campo Valor
ID RF-PMC-002-023
Nombre Cerrar Oportunidad como Perdida
Prioridad P2
Actor Analyst, Tenant Admin

Flujo:

  1. Usuario mueve a stage "lost"
  2. Sistema solicita motivo de pérdida
  3. Sistema registra lost_reason
  4. Sistema marca como perdida

Criterios de aceptación:

  • lost_reason es requerido
  • Oportunidad no editable después de cerrar

RF-PMC-002-024: Convertir Oportunidad en Proyecto

Campo Valor
ID RF-PMC-002-024
Nombre Convertir Oportunidad en Proyecto
Prioridad P2
Actor Analyst, Tenant Admin

Descripción: Crear proyecto automáticamente desde oportunidad ganada.

Flujo:

  1. Usuario selecciona "Convertir a proyecto"
  2. Sistema muestra formulario pre-llenado
  3. Usuario confirma/modifica datos
  4. Sistema crea proyecto vinculado al cliente
  5. Sistema vincula oportunidad con proyecto

Criterios de aceptación:

  • Datos del cliente se heredan
  • Descripción de oportunidad se copia a proyecto
  • Relación bidireccional establecida

RF-PMC-002-025: Vista Kanban de Oportunidades

Campo Valor
ID RF-PMC-002-025
Nombre Vista Kanban de Oportunidades
Prioridad P2
Actor Analyst, Tenant Admin

Descripción: Mostrar pipeline de oportunidades en formato Kanban.

Características:

  • Columnas por stage
  • Cards con info resumida
  • Drag & drop entre columnas
  • Filtros por cliente, fecha, valor
  • Totales por columna

Criterios de aceptación:

  • Drag & drop funciona
  • Totales se calculan correctamente
  • Filtros se aplican en tiempo real

Resumen

Prioridad Cantidad
P1 14
P2 10
P3 1
Total 25

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