MonchoKK/back2kasi

A digital platform connecting customers with rental businesses in South Africa. # Back2Kasi > A platform connecting people to affordable township accommodation and rental units. --- ## Table of Contents 1. Project Overview 2. Tech Stack 3. Project Structure 4. Prerequisites 5. Local Development Setup 6. Running the Application 7. Environment Configuration 8. API Overview 9. Git Workflow 10. Documentation --- ## Project Overview Back2Kasi is a full-stack platform built to help people find and book rental units in townships. The backend exposes a RESTful API consumed by a mobile/web frontend. **Current status:** 🚧 In active development --- ## Tech Stack ### Backend (`/backend`) | Technology | Version | Purpose | |---|---|---| | Java | 21 | Language | | Spring Boot | 3.5.3 | Application framework | | Spring Data JPA | — | ORM / database access | | Hibernate | 6.6.x | JPA implementation | | PostgreSQL | 18.x | Relational database | | Lombok | — | Boilerplate reduction | | Spring Validation | — | Request validation | | Spring DevTools | — | Auto-restart on save | | Maven | 3.x | Build tool | ### Frontend (`/app`) > To be documented. --- ## Project Structure ``` back2kasi/ ├── backend/ ← Spring Boot REST API │ └── src/main/java/com/back2kasi/ │ ├── Back2KasiApplication.java │ ├── config/ ← Cross-cutting config (Security, CORS, …) │ ├── common/ ← Shared utilities, exceptions, response wrapper │ ├── auth/ ← Authentication & authorisation │ ├── business/ ← Business/owner profiles │ ├── booking/ ← Reservation lifecycle │ └── rentalunit/ ← Rental unit listings & availability │ ├── app/ ← Mobile / frontend application ├── docs/ ← Project-level documentation │ └── DEVELOPMENT_STANDARDS.md └── README.MD ``` --- ## Prerequisites Make sure you have the following installed before starting: | Tool | Version | Download | |---|---|--- …