# kylaaz/jakarta-park-finder architecture

> Architecture diagram of the GitHub repository kylaaz/jakarta-park-finder, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-10). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kylaaz/jakarta-park-finder
- Repository: https://github.com/kylaaz/jakarta-park-finder

## Overview

##### Project Type and Purpose
- Full-stack web application called “Jakarta Park Finder.”
- React-based single-page application (SPA) frontend for end-users and administrators.
- Node.js/Express REST API backend exposing endpoints for parks, damage reports, users, reviews.
- MySQL relational database for persisting parks, users, reports, reviews.
- File storage for uploaded damage photos (under `/backend/public/uploads`).
- Integrates with Leaflet (map/tile service) to render park locations.

##### File Structure Analysis
- Top level: two directories, `/frontend` and `/backend`, each with its own package.json and docs.
- Backend follows MVC-ish layout:
- `src/models` (data schemas),
- `src/controllers` (business logic),
- `src/routes` (API routing),
- `src/middleware` (auth, roles, errors),
- `src/config/database.js` (MySQL connection),
- `src/utils/jwt.js` (JWT handling),
- `public/uploads` (static file hosting).
- Frontend uses React + Vite:
- `src/pages` & `src/view/pages` (page components),
- `src/components` (reusable UI pieces: auth, park cards, forms),
- `src/admin` (admin-only routes and layouts),
- `src/services` (Axios API wrappers),
- `src/context/AuthContext.jsx` (JWT token & user state),
- `index.html` → `main.jsx` → `App.jsx` → routed via React Router.

##### Key Insights from README
- Features: park discovery, search, damage reporting, admin dashboard, reviews.
- Tech stack: React/Vite/Tailwind, Node/Express, MySQL, JWT, CORS, Express-fileupload.
- Deployment: Heroku for both backend and frontend.
- Environment variables: API URL, database creds, JWT secret.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Client Layer
    subgraph "Client (React SPA)"
        direction TB
        SPA["React SPA"]:::frontend
        subgraph "Public UI"
            direction TB
            Home["HomePage"]:::frontend
            ParkDetail["ParkDetailPage"]:::frontend
            DamageReport["DamageReportPage"]:::frontend
            Auth["AuthPage"]:::frontend
        end
        subgraph "Admin UI"
            direction TB
            Dashboard["Dashboard"]:::frontend
            ParkMgmt["ParkManagement"]:::frontend
            DamageMgmt["DamagedParkManagement"]:::frontend
            RepairedMgmt["RepairedParkManagement"]:::frontend
            UserMgmt["UserManagement"]:::frontend
        end
        subgraph "Service Layer"
            direction TB
            APIClient["API Services (Axios)"]:::service
        end
    end

    %% API Server Layer
    subgraph "API Server (Express.js)"
        direction TB
        subgraph "Routes"
            direction TB
            AuthRoutes["authRoutes"]:::backend
            ParkRoutes["parkRoutes"]:::backend
            DamageRoutes["damageRoutes"]:::backend
            DamagedParkRoutes["damagedParkRoutes"]:::backend
            RepairedParkRoutes["repairedParkRoutes"]:::backend
            ReviewRoutes["reviewRoutes"]:::backend
            UserRoutes["userRoutes"]:::backend
            SeedRoutes["seedRoutes"]:::backend
            IndexRoutes["index.js"]:::backend
        end
        subgraph "Middleware"
            direction TB
            AuthM["authMiddleware"]:::middleware
            RoleM["roleMiddleware"]:::middleware
            ErrorM["errorMiddleware"]:::middleware
        end
        subgraph "Controllers"
            direction TB
            AuthCtrl["AuthController"]:::controller
            ParkCtrl["ParkController"]:::controller
            DamageCtrl["DamageController"]:::controller
            DamagedParkCtrl["DamagedParkController"]:::controller
            RepairedParkCtrl["RepairedParkController"]:::controller
            ReviewCtrl["ReviewController"]:::controller
            UserCtrl["UserController"]:::controller
        end
        subgraph "Models"
            direction TB
            ParkModel["ParkModel"]:::model
            UserModel["UserModel"]:::model
            DamageModel["DamageModel"]:::model
            RepairedParkModel["RepairedParkModel"]:::model
            ReviewModel["ReviewModel"]:::model
        end
        ConfigDB["database.js"]:::backend
        JWTUtil["jwt.js"]:::backend
        FileStorage["/public/uploads"]:::backend
    end

    %% Database and External
    DB["MySQL Database"]:::db
    Leaflet["Leaflet Tile Service"]:::ext
    Heroku["Heroku Hosting"]:::ext

    %% Connections
    SPA -->|"HTTP requests (GET/POST/PUT/DELETE)"| APIClient
    APIClient -->|"Axios calls"| AuthRoutes
    APIClient --> ParkRoutes
    APIClient --> DamageRoutes
    APIClient --> DamagedParkRoutes
    APIClient --> RepairedParkRoutes
    APIClient --> ReviewRoutes
    APIClient --> UserRoutes

    AuthRoutes --> AuthM
    ParkRoutes --> AuthM
    DamageRoutes --> AuthM
    DamagedParkRoutes --> AuthM
    RepairedParkRoutes --> AuthM
    ReviewRoutes --> AuthM
    UserRoutes --> AuthM

    AuthM --> RoleM
    RoleM --> ErrorM
    ErrorM --> AuthCtrl
    AuthCtrl --> UserModel
    AuthCtrl --> JWTUtil

    ParkRoutes --> ParkCtrl
    ParkCtrl --> ParkModel

    DamageRoutes --> DamageCtrl
    DamageCtrl --> DamageModel
    DamagedParkRoutes --> DamagedParkCtrl
    DamagedParkCtrl --> DamageModel
    RepairedParkRoutes --> RepairedParkCtrl
    RepairedParkCtrl --> RepairedParkModel
    ReviewRoutes --> ReviewCtrl
    ReviewCtrl --> ReviewModel
    UserRoutes --> UserCtrl
    UserCtrl --> UserModel

    ConfigDB --> DB
    ParkModel --> DB
    UserModel --> DB
    DamageModel --> DB
    RepairedParkModel --> DB
    ReviewModel --> DB

    FileStorage -->|"save/read images"| APIClient

    SPA -->|"Tile requests"| Leaflet
    SPA -->|"Hosted on"| Heroku
    APIClient -->|"Hosted on"| Heroku

    %% Click Events - Frontend
    click SPA "https://github.com/kylaaz/jakarta-park-finder/tree/main/frontend/src"
    click Home "https://github.com/kylaaz/jakarta-park-finder/blob/main/frontend/src/view/pages/HomePage.jsx"
    click ParkDetail "https://github.com/kylaaz/jakarta-park-finder/blob/main/frontend/src/view/pages/ParkDetailPage.jsx"
    click DamageReport "https://github.com/kylaaz/jakarta-park-finder/blob/main/frontend/src/view/pages/DamageReportPage.jsx"
    click Auth "https://github.com/kylaaz/jakarta-park-finder/blob/main/frontend/src/view/pages/AuthPage.jsx"
    click Dashboard "https://github.com/kylaaz/jakarta-park-finder/blob/main/frontend/src/admin/pages/Dashboard.jsx"
    click ParkMgmt "https://github.com/kylaaz/jakarta-park-finder/blob/main/frontend/src/admin/pages/ParkManagement.jsx"
    click DamageMgmt "https://github.com/kylaaz/jakarta-park-finder/blob/main/frontend/src/admin/pages/DamagedParkManagement.jsx"
    click RepairedMgmt "https://github.com/kylaaz/jakarta-park-finder/blob/main/frontend/src/admin/pages/RepairedParkManagement.jsx"
    click UserMgmt "https://github.com/kylaaz/jakarta-park-finder/blob/main/frontend/src/admin/pages/UserManagement.jsx"
    click APIClient "https://github.com/kylaaz/jakarta-park-finder/blob/main/frontend/src/services/api.js"
    click AuthRoutes "https://github.com/kylaaz/jakarta-park-finder/blob/main/backend/src/routes/authRoutes.js"
    click ParkRoutes "https://github.com/kylaaz/jakarta-park-finder/blob/main/backend/src/routes/parkRoutes.js"
    click DamageRoutes "https://github.com/kylaaz/jakarta-park-finder/blob/main/backend/src/routes/damageRoutes.js"
    click DamagedParkRoutes "https://github.com/kylaaz/jakarta-park-finder/blob/main/backend/src/routes/damagedParkRoutes.js"
    click RepairedParkRoutes "https://github.com/kylaaz/jakarta-park-finder/blob/main/backend/src/routes/repairedParkRoutes.js"
    click ReviewRoutes "https://github.com/kylaaz/jakarta-park-finder/blob/main/backend/src/routes/reviewRoutes.js"
    click UserRoutes "https://github.com/kylaaz/jakarta-park-finder/blob/main/backend/src/routes/userRoutes.js"
    click ConfigDB "https://github.com/kylaaz/jakarta-park-finder/blob/main/backend/src/config/database.js"
    click JWTUtil "https://github.com/kylaaz/jakarta-park-finder/blob/main/backend/src/utils/jwt.js"
    click FileStorage "https://github.com/kylaaz/jakarta-park-finder/tree/main/backend/public/uploads"

    %% Styles
    classDef frontend fill:#D6EAF8,stroke:#3498DB,stroke-width:2px
    classDef backend fill:#FADBD8,stroke:#E74C3C,stroke-width:2px
    classDef service fill:#FCF3CF,stroke:#F1C40F,stroke-width:2px
    classDef middleware fill:#D5F5E3,stroke:#27AE60,stroke-width:2px
    classDef controller fill:#FDEBD0,stroke:#D35400,stroke-width:2px
    classDef model fill:#E8DAEF,stroke:#8E44AD,stroke-width:2px
    classDef db fill:#D5DBDB,stroke:#7F8C8D,stroke-width:2px
    classDef ext fill:#F0F3F4,stroke:#BDC3C7,stroke-width:2px
```
