Project_roadmap v.2

General
1

PROYECTO_ROADMAP

yoDEV AI Persona Platform - Roadmap del Proyecto

Visión

Plataforma SaaS multi-tenant para el compromiso comunitario impulsado por IA en Discourse, con funciones especializadas para reclutamiento y compromiso empresarial en la comunidad tecnológica latinoamericana.

Fase 1: MVP - Sistema de Respuesta Automática por Webhook (Semana 1-2)

Objetivo

Hacer que funcione el flujo básico de webhook → respuesta de IA → publicación de vuelta en Railway

Pila Tecnológica

  • Node.js + Express + TypeScript
  • MongoDB (complemento de Railway)
  • Mongoose ODM
  • SDK de Anthropic
  • API de Discourse

Funcionalidades

  • Endpoint receptor de webhooks
  • Analizar eventos de webhooks de Discourse (respuesta, mención)
  • Cargar la configuración de la persona desde MongoDB
  • Llamar a la API de Claude con contexto de la persona
  • Publicar la respuesta generada por IA de vuelta en Discourse
  • Manejo básico de errores y registro

Colecciones de Base de Datos

// conversaciones
{
  topic_id: Number,
  persona: String,
  posts: Array,
  pending_reply: Boolean,
  last_activity: Date
}

// personas (migradas desde JSON)
{
  name: String,
  username: String,
  api_key: String,
  discourse_username: String,
  config: Object
}

// webhook_events (para depuración)
{
  event_type: String,
  payload: Object,
  processed: Boolean,
  timestamp: Date
}

Entregables

  • Servicio de webhook funcional en Railway
  • Respuestas automáticas a menciones de personas
  • Panel de administración simple (HTML) para ver actividad

Fase 2: Panel Web (Semana 3-4)

Objetivo

Construir una interfaz de administración para control y monitoreo manual

Funcionalidades

  • Autenticación (solo administradores inicialmente)
  • Ver todas las conversaciones
  • Creación manual de publicaciones (seleccionar persona, redactar, publicar)
  • Gestión de personas (CRUD)
  • Registros de actividad
  • Activar/desactivar respuesta automática por persona

Tecnología

  • Aplicación simple de React o HTML/CSS/JS
  • Puntos de acceso API para todas las operaciones
  • Actualizaciones en tiempo real (opcional: WebSockets)

Fase 3: Fundamento Multi-Tenant (Semana 5-6)

Objetivo

Soportar múltiples espacios de trabajo (tú + 1-2 clientes piloto)

Nuevas Colecciones

// workspaces
{
  name: String,
  type: "admin" | "recruiter" | "sponsor",
  discourse_url: String,
  discourse_api_key: String,
  settings: Object,
  subscription_tier: String,
  created_at: Date
}

// users
{
  workspace_id: ObjectId,
  email: String,
  role: "admin" | "user",
  permissions: Array
}

Funcionalidades

  • Aislamiento de espacios de trabajo (personas, conversaciones limitadas al espacio)
  • Autenticación de usuarios por espacio
  • Cambio de espacio en el panel
  • Invitar usuarios al espacio

Fase 4: Funcionalidades para Reclutadores (Semana 7-8)

Objetivo

Añadir valor adicional para firmas de reclutamiento

Funcionalidades

  • Monitoreo de palabras clave: Interacción automática cuando se mencionan habilidades específicas
  • Búsqueda de talento: Consultar la base de datos de CV de yoDEV desde el panel
  • Análisis de compromiso: Rastrear qué desarrolladores han interactuado con las personas
  • Sistema de presentaciones cálidas: Marcar candidatos para seguimiento humano

Puntos de Integración

  • Base de datos de CV de yoDEV (acceso de solo lectura)
  • Perfiles de usuarios de Discourse
  • Métricas de actividad del foro

Fase 5: Funcionalidades Empresariales (Semana 9-10)

Objetivo

Características premium para grandes empresas tecnológicas

Funcionalidades

  • Coincidencia de talento con IA: Describir el puesto → obtener candidatos clasificados
  • Entrenamiento personalizado de personas: Cargar documentos de la empresa para entrenar a las personas
  • Seguimiento de sentimiento de marca: Monitorear cómo percibe la comunidad a la empresa
  • Acceso a API: API RESTful para integración con ATS
  • Informes semanales: Resumen por correo electrónico de los mejores talentos y métricas de compromiso

Fase 6: Monetización y Escalabilidad (Semana 11-12)

Funcionalidades

  • Integración con Stripe para suscripciones
  • Cuotas de uso por nivel
  • Panel de facturación
  • Onboarding autónomo
  • Sitio web de marketing público

Niveles de Precios

Estándar - $200/mes

  • 1 espacio
  • 1 persona
  • 100 publicaciones de IA/mes
  • Análisis básicos

Pro - $500/mes

  • 1 espacio
  • 3 personas
  • 500 publicaciones de IA/mes
  • Monitoreo de palabras clave
  • Búsqueda de CV

Empresarial - $2000/mes

  • Personas ilimitadas
  • Publicaciones ilimitadas
  • Entrenamiento personalizado
  • Acceso a API
  • Soporte dedicado

Arquitectura Técnica

Estructura del Proyecto

discourse-ai-platform/
├── backend/
│   ├── src/
│   │   ├── routes/
│   │   │   ├── webhooks.ts
│   │   │   ├── api/
│   │   │   │   ├── personas.ts
│   │   │   │   ├── conversaciones.ts
│   │   │   │   ├── workspaces.ts
│   │   ├── models/
│   │   │   ├── Persona.ts
│   │   │   ├── Conversation.ts
│   │   │   ├── Workspace.ts
│   │   │   ├── User.ts
│   │   ├── services/
│   │   │   ├── claude.service.ts
│   │   │   ├── discourse.service.ts
│   │   │   ├── webhook.service.ts
│   │   ├── middleware/
│   │   │   ├── auth.ts
│   │   │   ├── workspace.ts
│   │   ├── index.ts
│   ├── package.json
│   ├── tsconfig.json
├── frontend/
│   ├── src/
│   │   ├── components/
│   │   ├── pages/
│   │   ├── api/
│   ├── package.json
├── shared/
│   ├── types/
│   ├── utils/
├── railway.json
├── docker-compose.yml
└── README.md

Variables de Entorno

# Anthropic
ANTHROPIC_API_KEY=

# MongoDB
MONGODB_URI=

# Discourse (por defecto - puede ser sobrescrito por espacio)
DISCOURSE_URL=
DISCOURSE_API_KEY=

# Autenticación
JWT_SECRET=
SESSION_SECRET=

# Aplicación
PORT=3000
NODE_ENV=production

Despliegue en Railway

Servicios a Desplegar

  1. Aplicación Principal (Node.js)
  2. MongoDB (complemento de Railway)

Configuración Inicial

# Instalar CLI de Railway
npm install -g @railway/cli

# Iniciar sesión
railway login

# Crear proyecto
railway init

# Añadir MongoDB
railway add

# Desplegar
railway up

Métricas de Éxito

Fase 1

  • Tasa de éxito del 100% en entrega de webhooks
  • Tiempo de respuesta < 2 segundos para respuestas automáticas
  • 0 mensajes perdidos

Fase 4

  • 5 clientes piloto reclutadores
  • 50+ interacciones generadas por IA/semana
  • 10+ presentaciones cálidas realizadas

Fase 6

  • 10 clientes pagadores
  • $5k MRR
  • Tasa de rotación < 5%

Próximos Pasos para Mañana

  1. Crear nuevo repositorio: discourse-ai-platform
  2. Iniciar proyecto de Node.js con TypeScript
  3. Configurar MongoDB en Railway
  4. Construir el endpoint receptor de webhooks
  5. Probar con webhook de Discourse

Recursos y Enlaces

Notas

  • Mantener el servidor MCP local para publicaciones manuales mediante Claude Desktop
  • El servicio remoto maneja solo la automatización
  • Ambos usan el mismo personas.json inicialmente (migrar a MongoDB en la Fase 2)
  • Empezar simple, añadir complejidad según sea necesario
  • Validar con clientes piloto antes de construir funcionalidades empresariales