salesforce_admin

🚀 Salesforce Admin Learning Platform (MVP v0.30.0)

Plataforma Web Interactiva para la gestión y aprendizaje del curso Salesforce Administrator.
Diseñada para el equipo VISIONARY ADMINS (Grupo 3).

🏛️ Sobre el Proyecto: “Lumina Tech”

Esta plataforma no es solo un repositorio de documentación. Es el Centro de Comando digital donde simulamos la implementación real de Salesforce para nuestro cliente ficticio, la universidad Lumina Tech.

Permite a los estudiantes (rol Admin) y profesores (rol Stakeholders) visualizar el avance del Sprint, validar requisitos y acceder a la documentación técnica centralizada.

🌟 Características Principales (MVP)

🔐 Autenticación Segura: Sistema de Login/Registro con JWT.
📊 Centro de Comando (Dashboard):
- Visualización de avance por Sprints.
- Filtrado por Roles (Admin, Consultant, QA).
- KPIs de Calidad de Datos.
📄 Documentación Viva: Motor de renderizado Markdown que convierte apuntes de clase en guías visuales (Soporte Mermaid.js).
📱 Diseño Responsivo: Interfaz moderna adaptable a cualquier dispositivo (Dark Mode incluido).

🛠️ Stack Tecnológico

La plataforma ha sido migrada de una web estática a una aplicación Full-Stack robusta:

Capa	Tecnología	Descripción
Backend		API REST asíncrona de alto rendimiento.
Database		Persistencia de usuarios, tareas y progreso.
Frontend		Estilos utilitarios y diseño responsivo.
Templating		Renderizado del lado del servidor (SSR).
Interactivity		Micro-interacciones sin la complejidad de React.

📂 Estructura del Proyecto

salesforce_admin/
├── app/
│   ├── main.py              # 🚀 Punto de entrada FastAPI
│   ├── models/              # 🗄️ Modelos de Base de Datos (User, Progress)
│   ├── routers/             # 🚦 Endpoints de la API (Auth, Docs)
│   ├── services/            # 🧠 Lógica de Negocio (Markdown Parser)
│   └── templates/           # 🎨 Vistas HTML (Jinja2)
│       ├── lumina_dashboard.html  # Centro de Comando
│       └── doc_viewer.html        # Visor de Documentación
├── content/                 # 📚 Documentación del Curso (Markdown)
│   └── Lumina_Tech/         # Proyecto Práctico
├── docs/                    # 📋 Documentación del Sistema (SDLC, Roadmap)
└── scripts/                 # 🛠️ Scripts de utilidad (Seed Data)

🚀 Cómo Iniciar (Local)

Sigue estos pasos para levantar el Centro de Comando en tu máquina:

1. Prerrequisitos

Python 3.10+
PostgreSQL (o Docker)

2. Instalación

# Clonar repositorio
git clone https://github.com/tu-usuario/admin_salesforce.git
cd admin_salesforce

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

# Instalar dependencias
# Instalar dependencias Python
pip install -r requirements.txt

# Instalar dependencias Frontend (Tailwind)
npm install
npm run build:css

3. Configuración

Crea un archivo .env en la raíz (puedes copiar .env.example):

DATABASE_URL=postgresql://user:pass@localhost/salesforce_db
SECRET_KEY=tu_secreto_super_seguro

4. Ejecutar

# Iniciar servidor de desarrollo
uvicorn app.main:app --reload

Visita http://localhost:8000 para ver el Dashboard.

🗺️ Roadmap & Progreso

Estamos en la fase de Mantenimiento y Evolución (v0.32.0).

Fase 1: Infraestructura Backend ✅
Fase 2: Autenticación y Usuarios ✅
Fase 3: Motor de Documentación ✅
Fase 4: Dashboard Interactivo “Lumina” ✅
Fase 7: Mantenimiento & DevOps (Backups, Sentry) ✅

📚 Documentación Técnica y Estratégica

Hemos profesionalizado el proyecto con guías especializadas:

📘 Manual de Mantenimiento: Protocolos de actualización, backups y respuesta a incidentes.
🏛️ Arquitectura & Stack: Análisis del stack tecnológico y estrategia de migración futura.
🚀 Manual de Mejoras Futuras: Vision del Product Manager para la v1.0 (Admin Panel, Gamification).
🛡️ SDLC & Roles: Marco de trabajo y ciclo de vida del software.

👥 Equipo Visionary Admins - Grupo 3

Product Owner: (Tu Nombre)
Salesforce Admin: (Tu Nombre)
AI Developer Agent: Gemini

Hecho con ❤️ y ☕ para dominar Salesforce.