¿Qué es miVecinal?

Para qué sirve

Muchos centros vecinales llevan hoy su información en un cuaderno, en planillas sueltas y en grupos de mensajería. Cuando cambia la comisión, buena parte de esa historia se pierde. miVecinal guarda esa información en la institución y no en las personas: el padrón, los pagos, los reclamos y las actas quedan ordenados, buscables y disponibles para quien tenga permiso.

El sistema tiene dos caras. La comisión trabaja en un panel de administración; los vecinos entran a un portal público con el nombre, los colores y los banners del centro vecinal. Lo que la comisión publica o actualiza aparece al instante del lado del vecino.

Qué incluye

• Socios y padrón. Altas, bajas y datos de contacto siempre actualizados, con filtros por estado y tipo de socio y vínculo con la cuenta del vecino.
• Cuotas y cobranzas. Cuotas por período, pagos con comprobante y vencidas marcadas automáticamente. El vecino ve sus pagos desde el portal.
• Reclamos. El vecino carga el pedido con fotos y sigue su estado. La comisión asigna, comenta y lo cierra con una solución escrita.
• Libro de actas. Actas de asamblea y de reunión con temas, presentes y adjuntos, buscables y disponibles para toda la comisión.
• Tesorería y balance. Caja mensual con cierres, comprobantes numerados, inventario de bienes y un balance anual que se calcula a partir de los movimientos.
• Noticias y eventos. Publicás una novedad y aparece al instante en el portal público del barrio.
• Formularios. Encuestas, inscripciones y relevamientos online, con las respuestas en el panel. Sin planillas sueltas ni idas y vueltas por chat.
• Portal público. Un sitio propio para el centro vecinal, con su nombre, sus colores y sus banners. Se instala en el celular como una app.

Cómo funciona un reclamo, de punta a punta

1. El vecino entra al portal con su cuenta y carga el reclamo, con descripción y fotos.
2. La comisión lo recibe en el panel, lo asigna a un responsable y puede comentarlo.
3. Se le cambia el estado a medida que avanza y, al resolverlo, se carga la solución por escrito.
4. El vecino ve cada cambio desde su portal, con su historial completo.

Cómo está hecho

• Frontend: React + TypeScript + Vite. Portal público y panel de administración en una misma aplicación, con rutas separadas por rol. Instalable como app (PWA).
• Interfaz: Tailwind CSS + shadcn/ui. Componentes accesibles y un sistema visual propio, con tema claro y oscuro.
• Backend: Java 21 + Spring Boot. API REST con Spring Data JPA sobre MariaDB, documentada con OpenAPI: socios, cuotas, reclamos, actas, tesorería y contenido público.
• Infraestructura: Docker Compose. Frontend, API, base de datos, Keycloak y almacenamiento de archivos (MinIO) en contenedores. La demo se restaura sola cada hora.
• Seguridad: Keycloak + permisos por módulo. Inicio de sesión con OpenID Connect. Cada miembro de la comisión ve o gestiona solo los módulos que le corresponden.

Si querés ver cómo se organiza un centro vecinal con herramientas digitales, la guía cómo digitalizar un centro vecinal recorre el proceso paso a paso.

Preguntas frecuentes