How cleinerfg/skyline-ground-api works
Skyline Ground is a Spring Boot real-estate management API. The visible user workflow registers or authenticates an account, then uses authenticated requests to create projects; project creation validates input, resolves the creator, persists the project, and returns a response. The README also names construction, asset, finance, inventory, contract, and audit capabilities, but the supplied tree exposes no corresponding modules, so they are not expanded here. PostgreSQL is documented; unsampled module connections are omitted where evidence is unavailable.
Main entry points: CreateProjectService.java Project Creation · AuthController.java Auth Endpoints · LoginService.java Login Service · ProjectController.java Project Endpoints
Components 17
Identity & Access
- Auth Endpoints
src/main/java/com/skylineground/modules/identity/auth/web/AuthController.java - User Registration
src/main/java/com/skylineground/modules/identity/user/service/CreateUserService.java - Login Service
src/main/java/com/skylineground/modules/identity/auth/service/LoginService.java - User Repository
src/main/java/com/skylineground/modules/identity/user/persistence/UserRepository.java - User Account
src/main/java/com/skylineground/modules/identity/user/persistence/User.java - JWT Service
src/main/java/com/skylineground/core/security/jwt/TokenService.java - JWT Filter
src/main/java/com/skylineground/core/security/config/SecurityFilter.java - Security Context
src/main/java/com/skylineground/core/security/SecurityContextService.java - Token Claims
src/main/java/com/skylineground/core/security/jwt/TokenPayload.java
Project Management
- Project Endpoints
src/main/java/com/skylineground/modules/project/web/ProjectController.java - Project Creation
src/main/java/com/skylineground/modules/project/service/CreateProjectService.java - Project Repository
src/main/java/com/skylineground/modules/project/persistence/ProjectRepository.java - Project Record
src/main/java/com/skylineground/modules/project/persistence/Project.java
Platform Services
- Spring Boot API
src/main/java/com/skylineground/SkylineGroundApplication.java - API Error Mapping
src/main/java/com/skylineground/core/exception/web/RestExceptionHandler.java
Persistence
- PostgreSQL
Other components
- API Client
Connections 18
- API Client → Auth Endpoints: registers or logs in
src/main/java/com/skylineground/modules/identity/auth/web/AuthController.java - Auth Endpoints → User Registration: registers user
src/main/java/com/skylineground/modules/identity/auth/web/AuthController.java - Auth Endpoints → Login Service: authenticates
src/main/java/com/skylineground/modules/identity/auth/web/AuthController.java - User Registration → User Repository: checks and saves
src/main/java/com/skylineground/modules/identity/user/service/CreateUserService.java - Login Service → JWT Service: issues token
src/main/java/com/skylineground/modules/identity/auth/service/LoginService.java - Login Service → User Account: uses authenticated user
src/main/java/com/skylineground/modules/identity/auth/service/LoginService.java - JWT Service → User Account: reads identity
src/main/java/com/skylineground/core/security/jwt/TokenService.java - JWT Filter → JWT Service: validates token
src/main/java/com/skylineground/core/security/config/SecurityFilter.java - JWT Filter → Token Claims: sets claims
src/main/java/com/skylineground/core/security/config/SecurityFilter.java - Security Context → Token Claims: returns claims
src/main/java/com/skylineground/core/security/SecurityContextService.java - API Client → Project Endpoints: requests project
src/main/java/com/skylineground/modules/project/web/ProjectController.java - Project Endpoints → Security Context: gets creator identity
src/main/java/com/skylineground/modules/project/web/ProjectController.java - Project Endpoints → Project Creation: creates project
src/main/java/com/skylineground/modules/project/web/ProjectController.java - Project Creation → Project Repository: checks and saves
src/main/java/com/skylineground/modules/project/service/CreateProjectService.java - Project Creation → User Repository: resolves creator summary
src/main/java/com/skylineground/modules/project/service/CreateProjectService.java - Project Creation → Project Record: maps project data
src/main/java/com/skylineground/modules/project/service/CreateProjectService.java - User Repository → PostgreSQL: persists accounts
README.md - Project Repository → PostgreSQL: persists projects
README.md