103 lines
4.8 KiB
Markdown
103 lines
4.8 KiB
Markdown
# LabRe — Sistema de Préstamos LSC UABC
|
|
|
|
Aplicación web para gestionar préstamos de material del Laboratorio de Sistemas Computacionales (Facultad de Ingeniería, UABC). Modela el vale físico multi-ítem: un trámite agrupa varios materiales, cada renglón con cantidad y descripción.
|
|
|
|
**Producción**: https://prestamos.buglabs.dev · **Login**: exclusivo Google con correo `@uabc.edu.mx`
|
|
|
|
## Roles
|
|
|
|
- **Alumno**: navega el catálogo con búsqueda por texto y filtro por categoría, arma un vale multi-ítem, consulta el estado de sus préstamos.
|
|
- **Admin**: aprueba/rechaza/marca devoluciones, gestiona inventario (grid con fotos), rastrea equipos por unidad individual (laptops, proyectores), reasigna unidades entre préstamos, consulta estadísticas con gráficas y exporta reportes CSV.
|
|
|
|
## Stack
|
|
|
|
- **Frontend**: Astro 7 (SSR, `output: 'server'`) + React 19 islands + Tailwind v4 (tokens en `src/styles/global.css`)
|
|
- **Backend**: Supabase self-hosted (Postgres 15, GoTrue, PostgREST, Storage, Realtime)
|
|
- **Aislamiento**: schema Postgres propio `prestamos` (coexiste con otras apps en la misma instancia)
|
|
- **Auth**: Google OAuth restringido a `@uabc.edu.mx` (verificación a nivel aplicación en middleware)
|
|
- **Gráficas**: recharts
|
|
- **Hosting**: Docker + adaptador `@astrojs/node` detrás de Cloudflare Tunnel
|
|
- **CI/deploy**: git + `docker compose up -d --build` en el homelab
|
|
|
|
## Requisitos
|
|
|
|
- Node 22.12+
|
|
- Acceso a una instancia de Supabase con el schema `prestamos` (ver migraciones)
|
|
- Cuenta Google `@uabc.edu.mx` para probar el flujo
|
|
|
|
## Setup local
|
|
|
|
```sh
|
|
cp .env.example .env # llenar PUBLIC_SUPABASE_URL, PUBLIC_SUPABASE_ANON_KEY, SUPABASE_SERVICE_ROLE_KEY, PUBLIC_APP_URL
|
|
npm install
|
|
npm run dev # http://localhost:4321
|
|
```
|
|
|
|
Antes del primer login, aplica las migraciones y promuévete a admin manualmente:
|
|
|
|
```sql
|
|
update prestamos.profiles set rol = 'admin' where email = 'tu-correo@uabc.edu.mx';
|
|
```
|
|
|
|
## Base de datos
|
|
|
|
Migraciones en `supabase/migrations/`, aplican con `psql -f <archivo>` contra la instancia. Cada migración es idempotente (usa `if not exists`, `drop policy if exists`, etc.) y trae su propio `BEGIN`/`COMMIT`.
|
|
|
|
- `0001_init.sql` — schema, tablas base, RLS, triggers, seed.
|
|
- `0002_solicitudes_multi_item.sql` — rediseño a "1 vale = N renglones", RPC `crear_solicitud`.
|
|
- `0003_grid_unidades_realtime.sql` — imagen del material, unidades individuales, RPC `reasignar_unidad`, publication realtime, bucket público `materiales-fotos`.
|
|
|
|
## Estructura
|
|
|
|
```text
|
|
src/
|
|
├── layouts/
|
|
│ └── AppLayout.astro # sidebar desktop + dock móvil + toaster + badge realtime
|
|
├── lib/
|
|
│ ├── supabase.ts # server/browser clients (schema 'prestamos')
|
|
│ ├── date.ts # todayMX() con Intl + DST correcto
|
|
│ └── materialImg.ts # URL pública del bucket
|
|
├── middleware.ts # auth + dominio + verificación de rol
|
|
├── pages/
|
|
│ ├── login.astro
|
|
│ ├── alumno/
|
|
│ │ ├── catalogo.astro # grid + filtro categorías + buscador
|
|
│ │ └── mis-prestamos.astro
|
|
│ ├── admin/
|
|
│ │ ├── index.astro # panel con KPIs
|
|
│ │ ├── solicitudes/ # bandeja, activos, historial
|
|
│ │ ├── inventario/ # grid CRUD + categorías
|
|
│ │ ├── estadisticas.astro # 6 KPIs + 3 gráficas recharts
|
|
│ │ └── reportes.astro # filtros + export CSV
|
|
│ └── api/ # endpoints REST (guardados por middleware)
|
|
├── components/
|
|
│ ├── alumno/ # SolicitudCart, AgregarMaterial, FiltroCategorias, BuscadorCatalogo
|
|
│ ├── admin/ # solicitudes, inventario (MaterialForm, UnidadesManager), estadisticas (Chart), BadgeSolicitudes
|
|
│ └── Toaster.tsx # notificaciones globales estilo Sileo
|
|
└── styles/global.css # tokens paleta UABC + sistema neobrutalista
|
|
```
|
|
|
|
## Deploy
|
|
|
|
Ver `deploy/README.md` para el detalle. Flujo resumido:
|
|
|
|
```sh
|
|
git push
|
|
ssh buglabs 'cd ~/labre-web && git pull && docker compose up -d --build'
|
|
```
|
|
|
|
## Comandos
|
|
|
|
| Comando | Acción |
|
|
| :---------------- | :-------------------------------------------- |
|
|
| `npm install` | Instala dependencias |
|
|
| `npm run dev` | Dev server en `localhost:4321` |
|
|
| `npm run build` | Compila a `./dist/` (SSR bundle) |
|
|
| `npm run preview` | Preview del build |
|
|
|
|
## Documentación interna
|
|
|
|
- `AGENTS.md` — decisiones de arquitectura, bitácora de sesiones, backlog. Fuente única de verdad del progreso.
|
|
- `DESIGN.md` — sistema de diseño (paleta UABC, tipografía, sombra dura, Text-on-Fill Rule).
|
|
- `PRODUCT.md` — visión de producto y brand commitments.
|