Skip to content

Roniel543/fagsol

BranchesTags

Repository files navigation

🎓 FagSol Escuela Virtual

Plataforma educativa en línea con sistema de roles, cursos, pagos y certificados

Django Next.js PostgreSQL Docker

📋 TABLA DE CONTENIDOS

✨ CARACTERÍSTICAS

Para Estudiantes:

  • ✅ Registro e inicio de sesión seguro
  • ✅ Explorar catálogo de cursos
  • ✅ Ver precios en moneda local (detección automática por país)
  • ✅ Comprar cursos con tarjetas reales (Mercado Pago)
  • ✅ Inscribirse automáticamente después del pago
  • ✅ Acceder a contenido educativo
  • ✅ Seguir progreso de aprendizaje
  • ✅ Obtener certificados al completar cursos
  • ✅ Solicitar ser instructor

Para Instructores:

  • ✅ Sistema de solicitud y aprobación
  • ✅ Crear y gestionar cursos propios
  • ✅ Dashboard con estadísticas
  • ✅ Ver estudiantes e inscripciones
  • ✅ Rutas específicas para gestión

Para Administradores:

  • ✅ Panel de control completo
  • ✅ Gestionar solicitudes de instructores
  • ✅ Crear y editar cursos
  • ✅ Gestionar usuarios y permisos
  • ✅ Estadísticas del sistema
  • ✅ Ver historial de pagos

Sistema de Pagos:

  • ✅ Integración con Mercado Pago (CardPayment Brick)
  • ✅ Pagos con tarjetas reales (Visa, Mastercard, Amex)
  • ✅ Tokenización client-side (PCI DSS compliant)
  • ✅ Webhooks automáticos para confirmación de pagos
  • ✅ Enrollments automáticos después del pago
  • ✅ Emails de confirmación de pago

Sistema Multi-Moneda:

  • ✅ Detección automática de país por IP
  • ✅ Precios en moneda local (COP, MXN, BRL, CLP, ARS, etc.)
  • ✅ Conversión automática desde USD
  • ✅ Precios fijos en PEN (base del negocio)
  • ✅ Modelo híbrido: PEN como base + USD fijo para internacional

🏗️ ARQUITECTURA

Backend:

  • Framework: Django 5.0
  • Arquitectura: Clean Architecture
  • API: Django REST Framework + Swagger
  • Base de Datos: PostgreSQL 15
  • Autenticación: JWT con refresh tokens
  • Seguridad: Django AXES, rate limiting, validaciones

Frontend:

  • Framework: Next.js 14 + TypeScript
  • Arquitectura: Feature-based
  • Estilos: Tailwind CSS
  • Data Fetching: SWR
  • Autenticación: JWT en sessionStorage

Infraestructura:

  • Containerización: Docker + Docker Compose
  • Base de Datos: PostgreSQL
  • Caché: Redis
  • Tareas Asíncronas: Celery

Pagos y Moneda:

  • Procesador de Pagos: Mercado Pago
  • Tokenización: CardPayment Brick (client-side)
  • Monedas Soportadas: PEN, USD, COP, MXN, BRL, CLP, ARS, BOB
  • Detección de País: ipapi.co
  • Tasas de Cambio: ExchangeRate API

🚀 INICIO RÁPIDO CON DOCKER

Prerrequisitos:

  • Docker Desktop (Windows/Mac) o Docker Engine + Docker Compose (Linux)
  • Git

Pasos:

# 1. Clonar repositorio
git clone <url-del-repositorio>
cd fagsol

# 2. Configurar variables de entorno
cp .env.example .env
# Editar .env si es necesario (valores por defecto funcionan para desarrollo)

# 3. Levantar todos los servicios
docker-compose up -d

# 4. Ver logs
docker-compose logs -f

# 5. Crear superusuario (primera vez)
docker-compose exec backend python manage.py createsuperuser

# 6. Acceder a la aplicación
# Frontend: http://localhost:3000
# Backend API: http://localhost:8000
# Swagger: http://localhost:8000/swagger/
# Admin: http://localhost:8000/admin/

📖 Ver DOCKER_SETUP.md para documentación completa de Docker

🛠️ INSTALACIÓN MANUAL

Backend:

cd backend

# Crear entorno virtual
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

# Instalar dependencias
pip install -r requirements.txt

# Configurar variables de entorno
cp .env.example .env
# Editar .env con tus configuraciones

# Aplicar migraciones
python manage.py migrate

# Crear superusuario
python manage.py createsuperuser

# Iniciar servidor
python manage.py runserver

Frontend:

cd frontend

# Instalar dependencias
npm install

# Configurar variables de entorno
cp .env.example .env.local
# Editar .env.local con NEXT_PUBLIC_API_URL

# Iniciar servidor de desarrollo
npm run dev

📁 ESTRUCTURA DEL PROYECTO

fagsol/
├── backend/                 # Django Backend
│   ├── apps/               # Aplicaciones Django
│   │   ├── core/          # Modelos base (UserProfile, InstructorApplication)
│   │   ├── users/         # Usuarios y permisos
│   │   ├── courses/       # Cursos, módulos, lecciones
│   │   └── payments/      # Pagos y transacciones
│   ├── config/            # Configuración Django
│   ├── domain/            # Entidades y reglas de negocio
│   ├── application/       # Casos de uso
│   ├── infrastructure/    # Servicios y repositorios
│   └── presentation/      # Views, serializers, URLs
│
├── frontend/              # Next.js Frontend
│   ├── src/
│   │   ├── app/          # Rutas de Next.js
│   │   ├── features/     # Módulos por funcionalidad
│   │   │   ├── auth/    # Autenticación
│   │   │   ├── dashboard/ # Dashboards
│   │   │   ├── academy/  # Cursos y catálogo
│   │   │   ├── admin/    # Panel admin
│   │   │   └── instructor/ # Panel instructor
│   │   └── shared/       # Componentes y servicios compartidos
│   └── public/           # Archivos estáticos
│
├── docker-compose.yml     # Orquestación Docker
├── .env.example          # Variables de entorno de ejemplo
└── README.md            # Este archivo

📚 DOCUMENTACIÓN

Documentos Principales:

Documentación Organizada:

API Documentation:

🔌 API ENDPOINTS

Autenticación:

  • POST /api/v1/auth/register/ - Registro de estudiantes
  • POST /api/v1/auth/login/ - Inicio de sesión
  • POST /api/v1/auth/logout/ - Cerrar sesión
  • GET /api/v1/auth/me/ - Usuario actual
  • POST /api/v1/auth/apply-instructor/ - Solicitar ser instructor

Dashboard:

  • GET /api/v1/dashboard/stats/ - Estadísticas según rol
  • GET /api/v1/dashboard/student/stats/ - Estadísticas de estudiante
  • GET /api/v1/dashboard/instructor/stats/ - Estadísticas de instructor
  • GET /api/v1/dashboard/admin/stats/ - Estadísticas de admin

Admin:

  • GET /api/v1/admin/instructor-applications/ - Listar solicitudes
  • POST /api/v1/admin/instructor-applications/{id}/approve/ - Aprobar
  • POST /api/v1/admin/instructor-applications/{id}/reject/ - Rechazar

Cursos:

  • GET /api/v1/courses/ - Listar cursos
  • GET /api/v1/courses/slug/{slug}/ - Obtener curso por slug
  • POST /api/v1/courses/ - Crear curso (instructor/admin)
  • GET /api/v1/courses/{id}/ - Detalle de curso
  • PUT /api/v1/courses/{id}/update/ - Actualizar curso

Pagos:

  • POST /api/v1/payments/intent/ - Crear payment intent
  • POST /api/v1/payments/process/ - Procesar pago
  • GET /api/v1/payments/intent/{id}/ - Obtener payment intent
  • GET /api/v1/payments/history/ - Historial de pagos
  • POST /api/v1/payments/webhook/ - Webhook de Mercado Pago

Moneda:

  • GET /api/v1/currency/detect/ - Detectar país y moneda
  • GET /api/v1/currency/convert/ - Convertir precio USD a moneda local

Ver Swagger para documentación completa: http://localhost:8000/swagger/

👥 SISTEMA DE ROLES

Estudiante (student):

  • Ver cursos publicados
  • Inscribirse en cursos
  • Acceder a contenido
  • Solicitar ser instructor

Instructor (instructor):

  • Requiere aprobación de admin
  • Crear cursos (draft)
  • Gestionar sus cursos
  • Ver estadísticas
  • PoW

Administrador (admin):

  • Acceso completo
  • Aprobar/rechazar instructores
  • Aprobar/rechazar cursos
  • Gestionar usuarios

💻 DESARROLLO

Comandos Útiles:

Backend:

# Migraciones
python manage.py makemigrations
python manage.py migrate

# Crear superusuario
python manage.py createsuperuser

# Shell de Django
python manage.py shell

# Tests
python manage.py test

# Comandos personalizados
python manage.py fix_user_auth email@example.com
python manage.py unlock_all_users

Frontend:

# Desarrollo
npm run dev

# Build
npm run build

# Producción
npm start

# Tests
npm test
npm run test:e2e

Hot Reload:

  • ✅ Frontend: Automático con Next.js
  • ✅ Backend: Auto-reload con runserver

🚢 DESPLIEGUE

Producción con Docker:

# Build para producción
docker-compose -f docker-compose.prod.yml build

# Levantar en producción
docker-compose -f docker-compose.prod.yml up -d

Variables de Entorno Importantes:

  • DEBUG=False en producción
  • SECRET_KEY único y seguro
  • ALLOWED_HOSTS con tu dominio
  • DB_PASSWORD fuerte
  • Configurar HTTPS

Ver DOCKER_SETUP.md para más detalles

🔐 SEGURIDAD

  • ✅ JWT con refresh tokens
  • ✅ Rate limiting (Django AXES)
  • ✅ Validación de permisos en backend
  • ✅ Sanitización de inputs
  • ✅ CORS configurado
  • ✅ Tokens en sessionStorage (no localStorage)

📊 ESTADO DEL PROYECTO

✅ Completado:

  • ✅ Sistema de autenticación completo (JWT)
  • ✅ Sistema de roles y permisos
  • ✅ Flujo de solicitud de instructor
  • ✅ Panel admin completo
  • ✅ Dashboard para todos los roles
  • ✅ CRUD completo de cursos
  • ✅ Sistema de pagos con Mercado Pago
  • ✅ Pagos con tarjetas reales funcionando
  • ✅ Webhooks de Mercado Pago
  • ✅ Sistema multi-moneda (detección automática)
  • ✅ Precios internacionales (Opción C: Híbrido)
  • ✅ Enrollments automáticos después del pago
  • ✅ Emails de confirmación de pago
  • ✅ Historial de pagos
  • ✅ UI moderna y responsive

🚀 Listo para Producción:

  • ✅ Pagos funcionando con tarjetas reales
  • ✅ Webhooks configurados y funcionando
  • ✅ Sistema multi-moneda probado
  • ✅ Seguridad implementada (PCI DSS compliant)
  • ⚠️ Pendiente: Configurar credenciales de producción

🤝 CONTRIBUIR

  1. Fork el proyecto
  2. Crea una rama (git checkout -b feature/AmazingFeature)
  3. Commit tus cambios (git commit -m 'Add some AmazingFeature')
  4. Push a la rama (git push origin feature/AmazingFeature)
  5. Abre un Pull Request

About

fagsol-iwli.vercel.app

Resources

Readme
Activity

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

No releases published

Packages

 
 
 

Contributors

Languages