MVP + ejemplo de módulo · documento para el ayuntamiento
Una plataforma municipal que crece por módulos.
Muniva reúne el acceso, los usuarios, los permisos, el dashboard y la gestión de módulos en una base común. Cada ayuntamiento tiene su propio despliegue y activa solo lo que necesita.
MVP núcleo + dashboardMódulos en calienteIncidencias ejemploTeléfono canal opcional
El MVP deja la plataforma lista para operar y para recibir módulos. No incluye incidencias, telefonía, apps nativas ni portal de proveedores: esas piezas llegan después.
↳
Acceso y sesiones
Entrada al panel del ayuntamiento con el rol asignado y cierre de sesión seguro.
◈
Marca del ayuntamiento
Nombre, logo, colores y textos configurable por despliegue. Nada hardcodeado.
◎
Usuarios y roles
Invitación, edición, suspensión y permisos granulares por módulo y recurso.
▦
Dashboard
Widgets independientes: bienvenida, resumen, notificaciones, actividad y salud del sistema.
⬡
Gestión de módulos
Instalar, activar, actualizar, desactivar, quitar y purgar sin recompilar ni reiniciar.
≋
Auditoría y avisos
Registro de acciones relevantes, notificaciones internas y trabajos en segundo plano.
Importante: el MVP no incluye incidencias, tickets, playas, residuos, telefonía, app ciudadana, apps nativas ni portal de proveedores. Todo eso se incorpora como módulos posteriores.
02 · Demostración
Qué se puede enseñar en 15 minutos.
Un recorrido pensado para validar el alcance con el ayuntamiento sin entrar en detalles técnicos.
01
Entrar como administrador
El acceso está separado por rol y cada usuario ve solo lo que le corresponde.
02
Ver el dashboard
La plataforma ya es útil sin módulos de negocio: resumen, avisos, actividad y accesos.
03
Cambiar la marca
Logo, color y textos se aplican al instante. La identidad es configuración, no código.
04
Invitar a un trabajador
Se asigna rol y permisos. El trabajador solo verá los widgets y módulos permitidos.
05
Abrir «Módulos»
El catálogo puede estar vacío y la sección sigue siendo operativa.
06
Instalar y activar un módulo
Se instala en caliente, sin recompilar ni reiniciar. El módulo añade su widget al dashboard.
07
Desactivar y comprobar
Los datos se conservan; solo se oculta el uso. La auditoría registra la operación.
08
Probar un fallo controlado
Un módulo caído no tumba el dashboard ni el resto de la plataforma.
03 · Ejemplo de módulo
Incidencias urbanas en tres canales.
Un vecino avisa por teléfono de una baldosa rota; el ayuntamiento lo ve en el dashboard, un operario la revisa con la tablet y el proveedor recibe la orden. Todo con un único modelo de incidencia.
▦Backoffice
Dashboard de gestión
Ver, priorizar, triar, asignar, comentar y verificar. Widgets de abiertas, urgentes y SLA.
Ver, priorizar, asignar
▭PDA / tablet
Formulario de campo
Ubicación, categoría, detalles y hasta seis fotos. Pensado para pantalla táctil y uso con una mano.
Alta rápida en calle
☎Teléfono
Aviso ciudadano
Llamada, grabación y transcripción local. Si el ayuntamiento lo activa, SMS para añadir ubicación y fotos.
Canal opcional
03.1 · Backoffice
El listado que ve el equipo municipal.
M
Concello da Coruñaconcello-da-coruna
InicioMobiliario urbanoIncidenciasSubvencionesEstadísticasEncuestasNoticiasReserva de espacios
IncidenciasIncidenciasProveedoresPermisosAjustes
Incidencias
Gestiona las incidencias del ayuntamiento: crea, edita y elimina incidencias, áreas, categorías y proveedores.
+ Crear incidencia
1.807Todas
214Abiertas
12Por verificar
Buscar
Fecha de creación⌄
≡
Título
Estado
Creado por
Asignado a
Proveedor
Ducha con fuga en rampa 3
Por verificar
LPLaura Pena
LPLaura Pena
Fontanería Atlántica
Desagüe de ducha atascado
Abierta
LPLaura Pena
Sin usuario
Fontanería Atlántica
Contenedores sucios
Resuelta
MVMarta Vidal
MVMarta Vidal
Limpiezas Coruña
Fuga de agua acometida
En curso
LPLaura Pena
HGHugo García
Fontanería Atlántica
Pasarela rota
En curso
MVMarta Vidal
HGHugo García
Carpintería Oza
03.2 · PDA / tablet
Alta en calle, en cinco pasos.
Formulario web responsive; la app nativa con modo sin conexión queda para una fase posterior.
10:24▮▮▮ 100%
INCIDENCIA · 1 PLAYA1/5
¿En qué lugar?
⌕ Buscar calle, plaza o punto
◎
Rúa Real, 12320 m · Centro
◎
Praza de María Pita410 m · Centro
◎
Paseo Marítimo, rampa 3650 m · Orzán
◎
Parque de Santa Margarita1,2 km · A Coruña
Continuar
10:24▮▮▮ 100%
INCIDENCIA · 4 FOTOS4/5
Añade fotos
Opcional, pero las incidencias con foto se resuelven un 40 % más rápido. Hasta 6 fotos.
foto 1
foto 2
+
iLa primera foto se usará como portada de la incidencia.
!Evita rostros identificables. Las caras se difuminan automáticamente cuando la política lo exige.
Continuar
Podrás añadir más tarde desde el detalle
03.3 · Teléfono
El aviso ciudadano, sin app y sin cuenta.
La llamada se graba y se transcribe en infraestructura propia. La transcripción genera un borrador; el equipo municipal lo revisa. Si el ciudadano quiere, recibe un SMS para completar ubicación y fotos.
10:31▮▮▮ 100%
LLAMADA ENTRANTE
+34 6XX XXX XXX
REC
Sistema · avisoLe informamos de que la llamada puede ser grabada y transcrita.
Ciudadano · 00:12Hola, hay una baldosa rota en la acera, junto a la parada del autobús. Se mueve mucho.
Sistema · 00:22Gracias. Si lo desea, recibirá un enlace por SMS para añadir la ubicación exacta y una foto.
Listado de llamadas, estado de grabación y transcripción, audio, texto por turnos y enlace al borrador o incidencia. La incidencia conserva la referencia externa de la llamada.
!Límite importante: una llamada no aporta el GPS del ciudadano. La ubicación se pide por SMS o se completa a mano. La transcripción puede tener errores y siempre pasa por revisión humana.
Un solo modelo: dashboard, tablet, teléfono y API crean la misma entidad. El canal se guarda en source; no hay modelos paralelos. Una incidencia existe aunque falle la llamada, el SMS o la foto.
04 · Referencias visuales
Los mockups que inspiran la aplicación.
Material de diseño de assets/referencia/. No es especificación final, pero fija la dirección visual: fondo cálido, superficies claras, azul de acción, tipografía Instrument Sans y metadatos en IBM Plex Mono.
Backoffice · listadoBúsqueda, filtros, estados y tabla de incidencias.Backoffice · detalleAntes/después, verificación y panel lateral.
App · inicioAccesos, borradores y tareas.App · alta 1/3Ubicación y categoría.App · alta 2/3Detalles y fotos.App · alta 3/3Resumen, envío y seguimiento.App · inspecciónSecciones, revisión y envío.App · proveedorResolver y adjuntar evidencia.
Formulario ciudadanoCategoría, lugar y descripción.Formulario · tipologíasÁrbol de categorías configurable.
05 · Sistema de diseño
Tokens vivos, no una captura.
Todo lo que ves aquí usa las variables CSS de la aplicación. Modifica los controles de la derecha y comprueba el efecto en la documentación, los mockups y los componentes.
Paleta
Acción#1b3fd6
Logo#0b9ad8
Texto#161616
Secundario#6f6f6f
Borde#d8d7d1
Éxito#2e7d5b
Aviso#a87419
Error#b4422e
Información#3a53cd
Verificación#7c5ce5
Escala tipográfica
DisplayIncidencias
H1Gestión municipal
H2Ducha con fuga en rampa 3
BodyLa ducha junto a la rampa 3 pierde agua de forma continua y se forma un charco sobre el pavimento.
SmallCreado por Laura Pena · 13/10/2026 10:31
MonoINC-2026-0871 · EN REVISIÓN
06 · Componentes
La misma pieza en cualquier módulo.
Botones, campos, etiquetas, tarjetas y tablas comparten tokens. Cambiar el radio base o el color de acción actualiza todo el sistema.
Botones
Crear incidenciaVolver al listadoCancelarRechazar
GuardarEditarDeshabilitado
Etiquetas de estado
AbiertaEn cursoPor verificarResueltaUrgente
Prioridad AltaOrigen TeléfonoSLA 24 h
Campos
Mensajes y progreso
✓Incidencia verificada y cerrada correctamente.
!El ticket está a 2 horas de incumplir el SLA.
×No se pudo guardar. Revisa la conexión e inténtalo de nuevo.
iLa primera foto se usará como portada.
Resolución del ticket
Tabla de incidencias
Referencia
Título
Estado
Asignado
Proveedor
INC-2026-0871
Ducha con fuga en rampa 3
Por verificar
LPLaura Pena
Fontanería Atlántica
INC-2026-0870
Baldosa rota en la acera
Abierta
Sin usuario
Sin proveedor
INC-2026-0869
Contenedores sucios
Resuelta
MVMarta Vidal
Limpiezas Coruña
Tokens actuales
Token
Valor
Uso
07 · Accesibilidad
Contraste y formas bajo control.
La configuración comprueba el contraste de los pares principales y avisa si algún radio supera el máximo de 6 px definido para botones, campos, tarjetas y etiquetas.
Checklist de revisión
08 · Guardar cambios
Un botón, un prompt y una decisión trazable.
«Guardar» no publica nada: genera un archivo prompt-diseno-muniva.md con los tokens, las instrucciones y los avisos. Ese archivo se puede entregar al equipo de desarrollo o a un agente para aplicar el diseño.
Qué incluye el prompt
Cómo usarlo
01
Ajusta
Prueba tipografías, colores, radios y densidad.
02
Pulsa «Guardar»
Se descarga el prompt en Markdown con la configuración actual.
03
Entrega o aplica
El equipo lo convierte en cambios de CSS y documentación.
Nota: el navegador no puede escribir directamente en el repositorio. El archivo se descarga; si se abre el HTML desde el repo, se puede mover a docs/logs/ o adjuntar a la tarea.