Bienvenida
Documentación de STB
Guía interactiva de los apartados y funcionalidades de la aplicación del clan. El contenido se irá ampliando conforme avancemos en el desarrollo.
Cartografía
Directorio y Mapa
Cartografía
Clanes
Comunicación
Mensajería
Comunicación
Anuncios y Actualizaciones
Clan
Miembros
Recursos · Aportaciones
Recaudación
El módulo de Recaudación organiza las campañas de aportación de recursos del clan. Cada campaña define un recurso y una cuota diaria por miembro; los miembros registran sus entregas y el sistema calcula cobertura, pendientes, donaciones y deudas.
Recursos
Las campañas se gestionan sobre cinco recursos, todos con las mismas funciones, criterios y participación en los conteos:
| Recurso | Español | English | Italiano | Русский |
|---|---|---|---|---|
| plata | Plata | Silver | Argento | Серебро |
| madera | Madera | Wood | Legno | Дерево |
| piedra | Piedra | Stone | Pietra | Камень |
| metal | Metal | Metal | Metallo | Металл |
| comida | Comida | Food | Cibo | Еда |
Panel de recursos
Es la pantalla principal del módulo. Muestra:
- El lema del clan y accesos rápidos a las campañas activas.
- Recursos destacados: lo entregado en campañas activas por recurso.
- Los accesos directos (nueva campaña, donaciones, deudas) según tus permisos.
- El estado de las campañas (activas, programadas, en revisión, históricas y archivadas).
Campañas
Una campaña (o periodo de recaudación) define:
- Nombre de la campaña.
- Recurso que se aporta.
- Cuota diaria exigida a cada miembro.
- Fechas de inicio y fin (ambas inclusive).
- Días de gracia (mínimo 3 días completos) tras el fin antes de revisar/cerrar.
- Zona horaria (solo administrador).
Estados de una campaña
| Estado | Descripción |
|---|---|
| Programada | Definida pero aún no abierta. Se activa en su fecha de inicio. |
| Activa | Abierta: se pueden registrar entregas. |
| En revisión | Cerrada a entregas; pendiente de revisión/cierre. |
| Archivada | Cerrada definitivamente; genera deudas y donaciones. |
| Histórica | Campaña pasada añadida a posteriori (cierre directo, sin revisión). |
Las campañas se agrupan en pestañas: Activas · Programadas · En revisión · Históricas · Archivadas.
Detalle de campaña
Al abrir una campaña ves sus KPIs (cuota diaria, participantes y % recaudado) y dos bloques:
Resumen por miembro
- Entregado frente a la cuota, con estado por miembro: cubierto, parcial, deuda o donación.
- Incidencias (⚠): entregas registradas con un recurso distinto al de la campaña.
- Donaciones por excedente: lo entregado por encima de la cuota.
- Búsqueda de miembros.
Entregas
- Registrar entrega: jugador, cantidad, recurso, fecha de recepción y nota.
- Editar o borrar entregas (según permisos y estado de la campaña).
- El recurso de la entrega es seleccionable; si difiere del de la campaña, se marca como incidencia.
Exportar
Descarga un extracto .xlsx con tres hojas: Resumen, Entregas y Donaciones.
Donaciones
Apartado que resume las aportaciones extra de los miembros:
- Ranking por miembro con desglose por recurso.
- Historial filtrable por ventanas de 7 o 15 días (y total).
- Leyenda:
+excedente sobre cuota ·⚠recurso distinto al de la campaña.
Deudas y Deudores
El panel se divide en tres listas independientes, cada una con su propio buscador:
- Deudores — miembros del clan con deuda pendiente.
- Deudores históricos — personas que ya no están en el clan (etiqueta «Ya no en el clan»).
- Histórico de deudores — miembros con la deuda ya saldada.
- Registrar entrega desde el panel descuenta la deuda (y queda registrado el recurso).
- Detalles por deudor: de qué campaña viene cada deuda, sus fechas y las entregas registradas (revertibles).
- Barra de progreso de liquidación por deudor.
Campañas históricas
Si creas una campaña cuya fecha de fin es anterior a hoy, se añade como histórica:
- Se crea abierta (permite registrar entregas) y aparece en la pestaña Históricas (etiqueta azul).
- Se cierra directamente sin pasar por revisión.
- Permite reconstruir el histórico de aportaciones de periodos pasados.
Miembros históricos
En una campaña histórica puede haber miembros que ya no están en el clan:
- Botón «Añadir miembro histórico» en la gestión de la campaña histórica.
- El miembro añadido queda etiquetado como «Histórico» en la lista de miembros de la campaña.
- Su conteo entra en el resumen y en el progreso de la campaña.
- No se añade al clan actual (solo a esa campaña).
Deudores históricos
Los deudores que ya no pertenecen al clan aparecen en lista aparte, etiquetados «Ya no en el clan». Pueden eliminarse manualmente con doble confirmación, lo que borra sus entregas, liquidaciones y deuda.
Tributos (vista personal)
La vista «Tributos» (🪙) muestra tu aporte personal: cuotas, entregas y donaciones por campaña, con barra de progreso. Está disponible para todos los usuarios, no solo para gestores.
Reset del módulo
El botón «Resetear recaudación» (solo administrador) borra todas las campañas, entregas, donaciones, deudas y la lista negra. Requiere:
- Ser administrador.
- Doble confirmación con aviso de que la acción no se puede deshacer.
- Contraseña de administrador (si no se rellena o es incorrecta, no tiene efecto).
Permisos de recaudación
| Permiso | Alcance | Qué permite |
|---|---|---|
recaudacion.ver | official | Ver recaudación (periodos, resumen, deudas, ranking, extracto). |
recaudacion.registrar | official | Registrar y corregir entregas. |
recaudacion.crear_periodo | superior | Crear y editar campañas. |
recaudacion.transicionar | superior | Activar / revisar / cerrar campañas. |
recaudacion.borrar_entrega | superior | Borrar entregas. |
recaudacion.borrar_campana | admin | Borrar campañas archivadas. |
recaudacion.borrar_deudoreshistoricos | admin | Borrar deudores históricos (individual). |
El paquete «Recaudador» agrupa: ver, registrar, crear_periodo, transicionar y borrar_entrega (activable por ítem).
Administración
Permisos
Administración