Soportix

Índice

• Stack técnico
• Landing y demo pública
• Roles del sistema
• Cuentas de prueba
• Requisitos previos
• Instalación
• Levantar el proyecto
• Variables de entorno
• Estructura del proyecto

Stack técnico

Backend

• Django 5.2 + Django REST Framework
• Autenticación JWT (djangorestframework-simplejwt) con refresco automático de token, login con usuario o email
• PostgreSQL (producción, vía Neon) o SQLite (desarrollo local, por defecto)
• django-filter, django-cors-headers

Frontend

• Angular 22 (componentes standalone, signals, zoneless)
• Angular Material + Angular CDK
• Chart.js para las gráficas del dashboard
• Tipografía Geist + Switzer (Fontshare) + Material Symbols Outlined

Landing y demo pública

El dominio raíz (/) muestra una landing pública (no requiere sesión) con:

• Botón "Probar demo": inicia sesión al instante con la cuenta demo de solo lectura, sin formularios.
• Registro real (/register) que crea la cuenta, inicia sesión automáticamente y lleva a un onboarding de 3 pasos (bienvenida → primer ticket guiado → listo) antes del dashboard.

Roles del sistema

Rol	Puede hacer
Usuario final	Crear tickets y darles seguimiento a los propios
Agente de soporte	Ver y gestionar todos los tickets, cambiar estado, comentar, asignarse tickets
Administrador	Todo lo del agente, más gestión de usuarios (roles/estado), categorías y reportes

El rol se asigna desde el panel de administración (/admin/usuarios) o desde el admin nativo de Django — el registro público siempre crea usuarios con rol user.

Cuentas de prueba

Rol	Usuario	Email	Contraseña
Administrador	admin	[email protected]	Admin123456
Agente de soporte	agente	[email protected]	Agente123456
Usuario final	usertest	[email protected]	Usertest123456

Son credenciales de demo para desarrollo/pruebas. Cámbialas antes de usar esta base de datos en un entorno real.

Además existe una cuenta demo / Demo123456 (rol user, de solo lectura) usada por el botón "Probar demo" de la landing pública: puede navegar toda la app pero tiene bloqueada cualquier escritura (crear/editar/borrar) a nivel de API, para que varios visitantes puedan probarla a la vez sin corromper los datos de ejemplo. Se crea/actualiza con:

python manage.py seed_demo_user

Requisitos previos

• Python 3.12+
• Node.js 20+ y npm
• PostgreSQL (opcional — sin configurar, usa SQLite automáticamente)

Instalación

1. Clonar el repositorio

git clone https://github.com/bleidys16/Soportix.git
cd Soportix

2. Backend (Django)

cd helpdesk-backend
python -m venv .venv
.venv\Scripts\activate          # Windows
# source .venv/bin/activate     # macOS/Linux

pip install -r requirements.txt

Crea un archivo .env dentro de helpdesk-backend/ (no se versiona) con al menos:

SECRET_KEY=una-clave-secreta-cualquiera
DEBUG=True
ALLOWED_HOSTS=*
CORS_ALLOWED_ORIGINS=http://localhost:4200

Para usar PostgreSQL en vez de SQLite, agrega además:

DB_ENGINE=django.db.backends.postgresql
DB_NAME=tu_bd
DB_USER=tu_usuario
DB_PASSWORD=tu_password
DB_HOST=tu_host
DB_PORT=5432

Aplica las migraciones y crea un superusuario:

python manage.py migrate
python manage.py createsuperuser

3. Frontend (Angular)

cd helpdesk-frontend
npm install

Levantar el proyecto

Con dos terminales abiertas en paralelo:

# Terminal 1 — backend (http://localhost:8000)
cd helpdesk-backend
.venv\Scripts\python.exe manage.py runserver

# Terminal 2 — frontend (http://localhost:4200)
cd helpdesk-frontend
npm start

Abre http://localhost:4200 en el navegador. El superusuario que creaste con createsuperuser tiene rol de administrador automáticamente.

Variables de entorno (backend)

Variable	Requerida	Descripción
SECRET_KEY	Sí	Clave secreta de Django
DEBUG	No (default True)	Modo debug
ALLOWED_HOSTS	No (default *)	Hosts permitidos, separados por coma
CORS_ALLOWED_ORIGINS	No (default http://localhost:4200)	Orígenes permitidos para CORS
DB_ENGINE	No (default SQLite)	django.db.backends.postgresql para usar Postgres
DB_NAME / DB_USER / DB_PASSWORD / DB_HOST / DB_PORT	Solo si usas Postgres	Credenciales de conexión
CLOUDINARY_URL	No	Si se define, los adjuntos de tickets se guardan en Cloudinary en vez de disco local (necesario en Render, cuyo disco es efímero). Formato: cloudinary://api_key:api_secret@cloud_name

Estructura del proyecto

Soportix/
├── helpdesk-backend/     # API REST en Django
│   └── apps/
│       ├── users/        # Autenticación, perfiles y roles
│       ├── tickets/      # Tickets, categorías, comentarios
│       └── dashboard/    # Endpoints de métricas y reportes
└── helpdesk-frontend/    # SPA en Angular
    └── src/app/
        ├── auth/         # Login y registro
        ├── core/         # Servicios, guards, modelos, componentes compartidos
        ├── features/     # Landing, onboarding, dashboard, tickets, admin, agente
        └── layout/       # Navbar superior compartido