🎯 Funcions Principals
👥 Gestió d'Advocats
- Alta/baixa d'advocats
- Assignar especialitats
- Configurar disponibilitat
- Consultar històric
📅 Gestió de Guardias
- Generar rotacions setmanals
- Modificar assignacions
- Ajustar ordre de rotació
- Consultar calendari
⭐ Complements de Guàrdia
- Afegir advocats voluntaris
- Activar/desactivar
- Gestionar ordre FIFO
- Consultar llistat
🔐 API Keys Integracions
- Crear claus per integracions
- Configurar permisos
- Establir expiració
- Revocar claus
📊 Estadístiques Globals
- Total d'assistències
- Temps mitjà de resposta
- Taxa d'acceptació
- Exportar informes
⚙️ Configuració Sistema
- Temps entre reintents
- Màxim reintents (guardias: 3)
- Plantilles email
- Notificacions push
🔄 Sistema de Cascada
Ordre de notificació automàtica:
1. GUARDIAS (ordre fix 1→2→3) → notificació push a l'app mòbil
2. COMPLEMENTS (ordre FIFO) → notificació push sense espera
3. ALFABÈTIC (cognoms) → notificació push sense espera
📋 Gestió de Complements
Accés: /admin/complements des del menú Sistema
| Acció |
Descripció |
| Afegir Complement |
Seleccionar advocat disponible del desplegable |
| Ordre FIFO |
Assignat automàticament (primer inscrit, primer trucat) |
| Activar/Desactivar |
Toggle sense perdre ordre d'inscripció |
| Eliminar |
Soft delete (conserva històric) |
🔑 Gestió d'API Keys (GUA-43)
✅ Recomanació: Utilitzar la interfície web en /admin/api-keys
Crear API Key (Interfície Web):
- Login amb credencials admin
- Click en "API Keys" (menú Sistema)
- Click "Crear API Key"
- Emplenar: Nom, Dies expiració (opcional), Permisos
- ⚠️ COPIAR clau completa IMMEDIATAMENT (només es mostra 1 vegada)
- Guardar en lloc segur (variables entorn, secrets manager)
⚠️ Seguretat:
• NEVER commitear API keys a Git
• Usar HTTPS en producció (Ngrok proporciona SSL)
• Revocar immediatament si sospita de compromís
• Configurar expiració apropiada (6-12 mesos en producció)
• Donar permisos mínims necessaris (least privilege)
⚙️ Paràmetres del Sistema
| Paràmetre |
Valor |
Descripció |
| WAIT_TIME_SECONDS |
300 seg (5 min) |
Espera entre reintentos (només guardias) |
| MAX_REINTENTOS_GUARDIA |
5 intents |
Màxim reintentos per guardias |
| Complements |
1 intent |
Hardcoded, sense espera |
| Alfabètics |
1 intent |
Hardcoded, sense espera |
📞 Contacte
Col·legi d'Advocats de Tarragona:
📞 General: 977 21 23 60
🚨 Emergències guardias: A especificar
📧 Suport: A especificar