How balchaki/meetspace works
Project type and purpose
• This is a full-stack room-reservation system comprised of:
• A Vue 3 single-page app (frontend)
• A Spring Boot (Java 17) REST API (backend)
• A PostgreSQL database (with Flyway migrations)
• Purpose: allow users to view available meeting rooms, make/cancel bookings, and allow administrators to manage rooms, users, and reservations.
File structure
• Top-level “frontend” folder: Vue 3 code, components, views, router, store, API service, Tailwind/CSS, Vite build.
• Top-level “src/main/java/br/balchaki/meetspace”: Spring Boot app entrypoint, controllers (HTTP endpoints), domain entities & repositories, DTOs, services, security, global config, exception handling.
• src/main/resources/db/migration: Flyway SQL scripts (V1…V5) initialize/update tables.
• application.properties: DB credentials and server configuration.
• Security: JwtAuthenticationFilter, JwtRequestFilter, JwtUtil, SecurityConfig.
• Tests: basic Spring Boot integration test.
Key architecture insights from README
• Frontend served separately by Vite (http://localhost:5173).
• Backend runs on Spring Boot embedded server.
• DB auto-migrations on startup.
• Main features: room availability check, room/user/reservation management via admin panel.
Main components & interactions
a. Components:
1. Client Browser (Vue SPA)
2. Frontend App (components, router, Vuex/store)
3. REST API Gateway (Spring Boot controllers)
4. Service Layer (business logic: ReserveService, RoomService, UserService, AdminService, JwtService)
5. Data Access Layer (JPA Repositories for User, Room, Reserve)
6. PostgreSQL Database (with schema managed by Flyway)
7. Security Modules (JWT filters, authentication endpoint)
b. Interactions:
• User → Browser UI → API calls (axios/fetch via /api/*)
• API Gateway → delegates to Services → uses Repositories → queries/updates DB
• JWT filters intercept secured endpoints, validate tokens (login/refresh flows)
• Admin UI calls protected endpoints for CRUD operations
c. Architectural patterns:
• Layered (Controller → Service → Repository → DB)
• MVC (in backend controllers/views of REST)
• JWT-based stateless authentication
• Flyway for DB migrations
• SPA + REST separation
d. Technologies & frameworks:
• Frontend: Vue 3, Vue Router, Pinia/Vuex (store), Vite, Tailwind CSS, Axios
• Backend: Spring Boot, Spring Security, Spring Data JPA, Flyway, Maven
• DB: PostgreSQL