Bienvenida a la Documentación de TalentBricksAI

Esta es la documentación interna del equipo. Está escrita para empleados, desarrolladores y cualquier persona que necesite operar, mantener o extender la plataforma.

No es documentación de usuario final. Los usuarios de la plataforma no ven esto — ellos usan la app directamente.

¿Para quién es esta documentación?

Persona	Qué encontrarás aquí
Desarrollador nuevo	Arquitectura, configuración local, cómo funciona el código
Operador / soporte	Cómo resolver problemas de usuarios, cómo usar el panel admin
Devops	Cómo desplegar, qué variables de entorno configurar
Product manager	Changelog, decisiones técnicas, estado del roadmap

Mapa Rápido: Si necesitas X, ve a Y

Si necesitas…	Ve a…
Levantar el proyecto por primera vez	Configuración Local
Desplegar a producción	Despliegue a Producción
Resolver un problema de un usuario	Problemas Comunes
Usar el panel admin para soporte	Panel de Administración
Ver qué variables de entorno configurar	Variables de Entorno
Entender cómo funciona la base de datos	Base de Datos
Crear o editar un curso	Crear un Curso
Entender cómo funciona el sistema de pagos	Configurar Pagos
Ver qué cambió recientemente	Changelog

Nuestra Documentación vs. Open SaaS Docs

TalentBricksAI está construido sobre Open SaaS (un template de Wasp). Algunas funcionalidades vienen del template y están documentadas allá — nosotros las referenciamos en lugar de duplicar.

Qué encontrar aquí (nuestra doc)	Qué está en Open SaaS Docs
Cursos, lecciones, inscripciones, certificados	Auth básica, configuración de email
Pagos específicos de TalentBricks (precios, productos)	Lemon Squeezy y Polar (solo usamos Stripe)
Panel admin personalizado	Admin dashboard template
Sistema i18n personalizado	—
Despliegue en Fly.io + Neon	Guías genéricas de deployment

Open SaaS Docs: docs.opensaas.sh

Estructura de la Documentación

Inicio               ← Estás aquí
Arquitectura         ← Cómo está construida la plataforma
Soporte              ← Cómo resolver problemas operacionales
Gestión de Contenido ← Cómo crear y gestionar cursos, videos, certificados
Operaciones          ← Despliegue, variables de entorno, pagos, email
Referencia Técnica   ← Auth, API, i18n, tests
Cambios y Decisiones ← Changelog e historial de decisiones técnicas

Tecnología Base

Capa	Tecnología
Framework	Wasp v0.21+
Frontend	React 19 + TypeScript
Backend	Node.js + Express (via Wasp)
Base de datos	PostgreSQL via Prisma
UI Components	ShadCN (New York) + Tailwind CSS
Pagos	Stripe
Almacenamiento de videos	AWS S3 + CloudFront
Email	SendGrid (producción) / Dummy (desarrollo)
Hosting	Fly.io (app) + Neon.tech (DB)