MiComuna360
Tu comuna en un solo lugar. Plataforma web ciudadana y multicomuna para
Chile que reúne la información pública de cada comuna —trámites, beneficios,
lugares, presupuesto e indicadores— en lenguaje simple, con la fuente y la
fecha de verificación de cada dato.
Sitio: https://micomuna360.vercel.app
Comunas
El proyecto usa un solo conjunto de páginas para todas las comunas. Cada
comuna tiene su configuración y su propio conjunto de datos:
- La Pintana (
/la-pintana): comuna publicada, con información pública
real y verificada.
- Los Aromos (
/los-aromos): comuna de ejemplo con datos ficticios,
usada para probar funcionalidades. No aparece en el portal ni en los menús;
se abre por su URL y cada página indica que sus datos son ficticios.
Funcionalidades
| Sección | Ruta | Descripción |
|---|
| Inicio | /[comuna] | Portada con buscador y accesos a cada sección |
| Servicios | /servicios | Trámites y pagos con enlace al sitio oficial de cada institución. El permiso de circulación y la licencia de conducir tienen ficha plegable (se abre al presionarla o al llegar con #<id> de la tarjeta): para quién, costo, dónde, plazo, paso a paso y qué llevar |
| Beneficios | /beneficios | Orientador «¿A qué puedo postular?» según la situación del hogar; funciona en el navegador, sin pedir datos personales |
| Deportes | /deportes | Escuelas y talleres deportivos con días, horario, lugar y cómo inscribirse; filtro por deporte, día, tipo y sector |
| Mapa y lugares | /mapa | Municipio, centros de salud, recintos deportivos y seguridad sobre OpenStreetMap (límite comunal, sectores, marcadores agrupados, lista sincronizada, «cerca de mí», Street View) y, debajo, las ferias libres y persas de cada día y la ficha de cada lugar con horario, teléfono, fuente y cómo llegar. /directorio redirige aquí; solo la comuna de ejemplo, sin mapa real, lo mantiene como página propia |
| Transparencia | /transparencia | Derecho de acceso a la información, ejecución presupuestaria, informes mensuales, pasivos, balance y estados financieros |
| Datos | /datos | Indicadores de la comuna (población, salud, educación, finanzas municipales) comparados con su historia y con el promedio regional |
| Buscar | /buscar | Buscador sobre el contenido de la comuna |
| Agenda | /actividades | Teatro, deporte y actividades con fecha, lugar y cómo entrar; las pasadas se ocultan solas |
| Teléfonos | /telefonos | Emergencias, oficinas municipales, salud y líneas de apoyo, para llamar con un toque |
| Noticias, comunidad, trámites, reportar | varias | Módulos disponibles en la comuna de ejemplo |
Las secciones de cada comuna se activan con feature flags en
src/config/communes/<comuna>.ts; una sección desactivada responde 404.
Datos y fuentes
- Cada dato real referencia una fuente del registro de la comuna
(
src/data/communes/la-pintana/sources.ts), con institución, enlace, fecha
de verificación y vigencia. La interfaz muestra esa procedencia junto al
dato. Hay un espejo legible en docs/fuentes-la-pintana.md.
- Fuentes principales de La Pintana: sitio municipal pintana.cl,
Corporación Municipal de Deportes, Transparencia Activa, geoportal
GeoPintana, SINIM, MINEDUC Datos Abiertos, ChileAtiende y OpenStreetMap.
- Fotos reales con autor y licencia (
src/data/communes/<comuna>/photos.ts);
criterios en docs/imagenes.md.
docs/fuentes/ guarda los respaldos de cada carga de datos: CSV
normalizados, metodología o control de calidad y huellas SHA-256 de los
archivos originales.src/lib/data-integrity.ts valida los datasets con zod al cargarse (fuentes
existentes, fechas, coordenadas dentro de la comuna, cuadratura de las
cifras presupuestarias), de modo que un dato inconsistente se detecta en el
build.
Arquitectura
src/
├── app/(public)/(portal)/ # portada multicomuna y /nosotros
├── app/(public)/[comuna]/ # páginas de cada comuna
├── app/(admin)/ # panel municipal (estructura inicial)
├── components/ # ui/ (shadcn), data/ (gráficos), map/, transparency/,
│ # indicators/, benefits/, home/, layout/, shared/
├── config/communes/ # registro de comunas y feature flags
├── data/communes/<comuna>/ # datasets por comuna
├── lib/ # repositories/, data-integrity.ts, format.ts, search.ts
└── types/ # tipos de dominio
docs/ # arquitectura, modelo de datos, fuentes
supabase/ # migraciones del modelo de datos
La interfaz accede a los datos a través de src/lib/repositories, que
reciben el identificador de la comuna. Más detalle en
docs/arquitectura-multicomuna.md, docs/arquitectura.md,
docs/modelo-datos.md y docs/design-brief.md.
Stack
- Next.js 16 (App Router) y React 19 — ver
AGENTS.md sobre las diferencias
de esta versión
- TypeScript, Tailwind CSS 4, componentes shadcn/ui en
src/components/ui
- Leaflet + OpenStreetMap para mapas (cargados en el cliente con
next/dynamic)
- Gráficos propios en HTML/SVG (
src/components/data)
- zod para validación de datos
- Despliegue en Vercel desde GitHub
Desarrollo
npm install
npm run dev # http://localhost:3000
npm run lint
npm run build # build de producción (incluye la validación de datos)
npm run test:e2e # pruebas de recorridos (después del build)
Agregar o actualizar datos de una comuna
- Registrar la fuente en
sources.ts de la comuna.
- Agregar los datos al dataset con su
sourceId y, si vienen de un archivo,
guardar el respaldo en docs/fuentes/.
- Activar el flag de la sección en la configuración de la comuna.
- Correr
npm run lint, npm run build y npm run test:e2e.
Para una comuna nueva: crear su configuración en src/config/communes/, su
carpeta en src/data/communes/ y registrarla en ambos índices.
Estado y próximos pasos
- La Pintana publicada con servicios, beneficios, deportes, directorio, mapa,
transparencia e indicadores.
- La hoja de ruta (
docs/hoja-de-ruta.md) ordena lo que sigue: mantener los
datos al día, sumar contenido público (seguridad, agenda, teléfonos) y
después las funciones con cuenta y base de datos.
Privacidad
El sitio no requiere cuenta ni solicita datos personales. El diseño sigue los
principios de la Ley 21.719 de protección de datos personales.
