LaUapi — Project Overview

Que es LaUapi

LaUapi es una API REST para una plataforma académica y social universitaria. Conecta estudiantes, aspirantes y egresados a través de publicaciones, mensajería en tiempo real, herramientas de productividad (Pomodoro/Tasks) y búsqueda de música.

Arquitectura Dual

El repositorio tiene dos superficies:

Superficie	Prefijo	Autenticación	Propósito
API REST	`/api`	Laravel Sanctum (tokens Bearer)	Backend para clientes móviles y asíncronos
Panel SU	`/us/su/lau`	Guard `auth:super` (modelo `su_ad`)	Administración web (universidades, carreras, usuarios, insignias, banners, actualizaciones)

Las vistas Blade activas son exclusivamente las del panel SU:

resources/views/su/* (10 vistas)
resources/views/layouts/app-su.blade.php

Stack Tecnológico

Backend: Laravel 12 + PHP 8.2
Autenticación API: Laravel Sanctum (tokens por dispositivo)
Base de Datos: MySQL
Mensajería en tiempo real: Pusher (canales privados private-chatify.{userId})
Notificaciones Push: Firebase Cloud Messaging (FCM v1 HTTP API)
Búsqueda de música: iTunes Search API (con cache de 1 hora)
Procesamiento de imágenes: Intervention Image (WebP dual: full 1200px + mini 600px)
Build frontend (solo panel SU): Vite + Tailwind CSS
Webhook externo: Make.com (para reportes de usuarios)

Estructura de Alto Nivel

LaUapi/
├── app/Http/Controllers/
│   ├── Api/              ← 15 controladores REST
│   └── SUController.php  ← Lógica del panel de administración
├── app/Models/           ← 18 modelos Eloquent
├── app/Services/
│   └── NotificationService.php  ← Lógica de notificaciones + push
├── routes/
│   ├── api.php           ← Endpoints de la API (Sanctum)
│   └── web.php           ← Panel SU (auth:super)
├── resources/views/
│   ├── su/               ← Vistas del panel SU
│   └── layouts/
│       └── app-su.blade.php  ← Layout base del panel SU
└── database/
    ├── migrations/       ← Esquema completo
    └── seeders/          ← Datos de prueba

LaUapi — Project Overview

Que es LaUapi

Arquitectura Dual

Stack Tecnológico

Estructura de Alto Nivel

Siguente página