Comunidades Vecinos is a comprehensive web application that gives Spanish residential homeowners communities a single, self-managed hub for every administrative task they face day to day. From issuing fee receipts and tracking community finances to publishing notices and sharing documents, the platform replaces scattered spreadsheets and paper-based processes with a structured, role-aware interface accessible from any browser.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/GuillermoNavarro/Proyecto_comunidades/llms.txt
Use this file to discover all available pages before exploring further.
Problems it solves
Managing a comunidad de propietarios involves coordinating fees, expenses, communications, and resident records across people with very different levels of technical confidence. Comunidades Vecinos addresses this by:- Automating fee and receipt management — community quotas are created once and individual receipts are generated for every resident automatically, with real-time payment-status tracking.
- Centralising financial records — income and expense movements are recorded against each community, giving presidents and treasurers an up-to-date ledger without a separate accounting tool.
- Providing a resident portal — ordinary residents can check their own receipts, download community documents, and read announcements without contacting the administrator.
- Enforcing data isolation — every community’s data is scoped by design; a user belonging to one community never sees data from another.
- Eliminating paper distribution — official documents (meeting minutes, regulations, certificates) are uploaded once and available instantly to all authorised members.
- Streamlining incident reporting — residents can raise issues or announcements, which administrators can moderate and resolve within the same interface.
Key features
Communities
Create and manage multiple homeowners communities, each with its own address, residents, finances, and documents.
Users & Roles
Fine-grained access control with three roles: resident (USER), community administrator (ADMIN), and platform operator (SUPER_ADMIN).
Fees & Receipts
Define ordinary, extraordinary, or individual quotas and issue individual receipts to residents, with PENDIENTE / PAGADO status tracking.
Finances
Record income and expense movements per community, linked to receipts where applicable, for a full financial audit trail.
Documents
Upload and manage community documents (PDFs, meeting minutes, regulations) with per-file descriptions and timestamps.
Announcements
Post news items and incident reports (NOTICIA / INCIDENCIA) with optional images, moderation flags, and resolution dates.
User roles
The platform models three distinct roles, defined in theRol enum on the backend:
| Role | Spanish equivalent | Permissions |
|---|---|---|
USER | Vecino (resident) | View own receipts, community documents, announcements, and personal profile. |
ADMIN | Presidente / Tesorero | All USER permissions plus full management of residents, quotas, receipts, finances, and publications within their community. |
SUPER_ADMIN | Gestor de plataforma | All ADMIN permissions across every community plus the ability to create new communities and assign ADMIN users. |
@EnableMethodSecurity) and the frontend React Router layer, where protected routes check the decoded JWT role before rendering.
A special
ROLE_PRE_AUTH authority is granted to any user whose cambiarPass flag is true. Users in this state are forced to change their password before they can access the application. See the Security model section for details.Tech stack
Backend
| Component | Technology |
|---|---|
| Language | Java 21 |
| Framework | Spring Boot 4.0.5 |
| Persistence | Spring Data JPA + Hibernate (MariaDB dialect) |
| Database | MariaDB / MySQL (comunidad_vecinos schema) |
| Security | Spring Security 6 — stateless JWT filter chain |
| JWT library | JJWT 0.11.5 (jjwt-api / jjwt-impl / jjwt-jackson) |
| API docs | SpringDoc OpenAPI 2.3.0 (Swagger UI) |
| Spring Boot Mail (configurable SMTP) | |
| Build tool | Maven (Spring Boot Maven Plugin) |
Frontend
| Component | Technology |
|---|---|
| UI library | React 19 |
| Build tool | Vite 8 |
| Styling | Bootstrap 5.3 + Bootstrap Icons 1.13 |
| Routing | React Router DOM 7 |
| HTTP client | Axios 1.13 |
| Auth state | jwt-decode 4 (client-side token decoding) |