# basuki-rahmat/jap architecture

> Architecture diagram of the GitHub repository basuki-rahmat/jap, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-08). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/basuki-rahmat/jap
- Repository: https://github.com/basuki-rahmat/jap

## Overview

JAP is a land-rental and referral-marketing platform for Battery Swap Station sites. Landowners submit site details and documents; marketing members recruit through referral codes and manage their network; administrators review applications and operate the platform. The graph follows the documented workflows and sampled imports. Several capabilities are documented but their implementation was not sampled, so those links cite the README rather than implying inspected call paths.

Main entry points: [`models/db.js`](https://github.com/basuki-rahmat/jap/blob/main/models/db.js) (Database Queries), [`controllers/adminController.js`](https://github.com/basuki-rahmat/jap/blob/main/controllers/adminController.js) (Admin Operations), [`routes/publicRoutes.js`](https://github.com/basuki-rahmat/jap/blob/main/routes/publicRoutes.js) (Public Routes), [`app.js`](https://github.com/basuki-rahmat/jap/blob/main/app.js) (Express Application)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_public["Public Land Intake"]
  node_public_routes["Public Routes<br/>[publicRoutes.js]"]
  node_land_submission["Land Submission<br/>[publicRoutes.js]"]
  node_public_views["Public Pages"]
end

subgraph group_marketing["Referral Marketing"]
  node_marketing_registration["Marketing Registration"]
  node_marketing_routes["Marketing Routes<br/>[marketingRoutes.js]"]
  node_marketing_management["Marketing Portal"]
  node_marketing_views["Marketing Pages"]
end

subgraph group_admin["Administration"]
  node_admin_routes["Admin Routes<br/>[adminRoutes.js]"]
  node_admin_management["Admin Operations<br/>[adminController.js]"]
  node_admin_views["Admin Pages"]
  node_documents["Proposal and SPPL PDFs<br/>[proposalPdf.js]"]
end

subgraph group_shared["Shared Platform"]
  node_app["Express Application<br/>[app.js]"]
  node_auth_routes["Authentication Routes<br/>[authRoutes.js]"]
  node_auth_controller["Authentication<br/>[authController.js]"]
  node_password_reset["Password Reset"]
  node_auth_guard["Role and Session Guard<br/>[authMiddleware.js]"]
  node_notifications["Notifications<br/>[notifRoutes.js]"]
  node_email["Transactional Email<br/>[mailer.js]"]
  node_settings["Company Settings<br/>[settings.js]"]
  node_company_profile["Company Profile<br/>[companyProfile.js]"]
  node_field_rules["Owner Field Rules<br/>[ownerFields.js]"]
  node_db_helpers["Database Queries<br/>[db.js]"]
  node_mysql[("MySQL Store<br/>[database.js]")]
end

node_landowner(("Landowner"))
node_marketer(("Marketing Member"))
node_administrator(("Administrator"))

node_app -->|"mounts"| node_public_routes
node_app -->|"mounts"| node_auth_routes
node_app -->|"mounts"| node_admin_routes
node_app -->|"mounts"| node_marketing_routes
node_app -->|"mounts"| node_notifications
node_landowner -->|"browses"| node_public_routes
node_public_routes -.->|"renders"| node_public_views
node_landowner -->|"submits site"| node_land_submission
node_public_routes -->|"handles submission"| node_land_submission
node_land_submission -->|"validates fields"| node_field_rules
node_land_submission -.->|"stores application"| node_db_helpers
node_marketer -->|"registers by referral"| node_marketing_registration
node_public_routes -->|"routes registration"| node_marketing_registration
node_marketing_registration -->|"checks and records"| node_db_helpers
node_marketing_registration -->|"sends verification"| node_email
node_administrator -->|"manages platform"| node_admin_routes
node_admin_routes -->|"dispatches"| node_admin_management
node_admin_routes -->|"requires role"| node_auth_guard
node_admin_management -->|"reads and updates"| node_db_helpers
node_admin_management -->|"sends status mail"| node_email
node_admin_management -.->|"manages alerts"| node_notifications
node_admin_management -->|"generates documents"| node_documents
node_admin_management -.->|"saves configuration"| node_settings
node_admin_routes -.->|"serves admin pages"| node_admin_views
node_marketer -->|"uses portal"| node_marketing_routes
node_marketing_routes -->|"dispatches"| node_marketing_management
node_marketing_routes -->|"requires session"| node_auth_guard
node_marketing_management -->|"reads and updates"| node_db_helpers
node_marketing_management -->|"validates profile"| node_field_rules
node_marketing_routes -.->|"serves portal pages"| node_marketing_views
node_auth_routes -->|"dispatches"| node_auth_controller
node_public_routes -->|"routes reset"| node_password_reset
node_password_reset -.->|"sends reset mail"| node_email
node_notifications -->|"checks session"| node_auth_guard
node_notifications -->|"reads notifications"| node_db_helpers
node_email -->|"loads branding"| node_company_profile
node_company_profile -->|"reads settings"| node_settings
node_settings -->|"queries settings"| node_db_helpers
node_db_helpers -->|"queries pool"| node_mysql

click node_app "https://github.com/basuki-rahmat/jap/blob/main/app.js"
click node_public_routes "https://github.com/basuki-rahmat/jap/blob/main/routes/publicRoutes.js"
click node_land_submission "https://github.com/basuki-rahmat/jap/blob/main/routes/publicRoutes.js"
click node_public_views "https://github.com/basuki-rahmat/jap/tree/main/views/public"
click node_marketing_registration "https://github.com/basuki-rahmat/jap/blob/main/controllers/registerController.js"
click node_marketing_routes "https://github.com/basuki-rahmat/jap/blob/main/routes/marketingRoutes.js"
click node_marketing_management "https://github.com/basuki-rahmat/jap/blob/main/controllers/marketingController.js"
click node_marketing_views "https://github.com/basuki-rahmat/jap/tree/main/views/marketing"
click node_admin_routes "https://github.com/basuki-rahmat/jap/blob/main/routes/adminRoutes.js"
click node_admin_management "https://github.com/basuki-rahmat/jap/blob/main/controllers/adminController.js"
click node_admin_views "https://github.com/basuki-rahmat/jap/tree/main/views/admin"
click node_auth_routes "https://github.com/basuki-rahmat/jap/blob/main/routes/authRoutes.js"
click node_auth_controller "https://github.com/basuki-rahmat/jap/blob/main/controllers/authController.js"
click node_password_reset "https://github.com/basuki-rahmat/jap/blob/main/controllers/passwordResetController.js"
click node_auth_guard "https://github.com/basuki-rahmat/jap/blob/main/middlewares/authMiddleware.js"
click node_notifications "https://github.com/basuki-rahmat/jap/blob/main/routes/notifRoutes.js"
click node_email "https://github.com/basuki-rahmat/jap/blob/main/utils/mailer.js"
click node_documents "https://github.com/basuki-rahmat/jap/blob/main/utils/proposalPdf.js"
click node_settings "https://github.com/basuki-rahmat/jap/blob/main/utils/settings.js"
click node_company_profile "https://github.com/basuki-rahmat/jap/blob/main/utils/companyProfile.js"
click node_field_rules "https://github.com/basuki-rahmat/jap/blob/main/utils/ownerFields.js"
click node_db_helpers "https://github.com/basuki-rahmat/jap/blob/main/models/db.js"
click node_mysql "https://github.com/basuki-rahmat/jap/blob/main/config/database.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_public_routes,node_land_submission,node_public_views toneBlue
class node_marketing_registration,node_marketing_routes,node_marketing_management,node_marketing_views toneAmber
class node_admin_routes,node_admin_management,node_admin_views,node_documents toneMint
class node_app,node_auth_routes,node_auth_controller,node_password_reset,node_auth_guard,node_notifications,node_email,node_settings,node_company_profile,node_field_rules,node_db_helpers,node_mysql toneRose
class node_landowner,node_marketer,node_administrator toneIndigo
```

## Components

### Public Land Intake

- [Public Routes](https://github.com/basuki-rahmat/jap/blob/main/routes/publicRoutes.js): `routes/publicRoutes.js`
- [Land Submission](https://github.com/basuki-rahmat/jap/blob/main/routes/publicRoutes.js): `routes/publicRoutes.js`
- [Public Pages](https://github.com/basuki-rahmat/jap/tree/main/views/public): `views/public`

### Referral Marketing

- [Marketing Registration](https://github.com/basuki-rahmat/jap/blob/main/controllers/registerController.js): `controllers/registerController.js`
- [Marketing Routes](https://github.com/basuki-rahmat/jap/blob/main/routes/marketingRoutes.js): `routes/marketingRoutes.js`
- [Marketing Portal](https://github.com/basuki-rahmat/jap/blob/main/controllers/marketingController.js): `controllers/marketingController.js`
- [Marketing Pages](https://github.com/basuki-rahmat/jap/tree/main/views/marketing): `views/marketing`

### Administration

- [Admin Routes](https://github.com/basuki-rahmat/jap/blob/main/routes/adminRoutes.js): `routes/adminRoutes.js`
- [Admin Operations](https://github.com/basuki-rahmat/jap/blob/main/controllers/adminController.js): `controllers/adminController.js`
- [Admin Pages](https://github.com/basuki-rahmat/jap/tree/main/views/admin): `views/admin`
- [Proposal and SPPL PDFs](https://github.com/basuki-rahmat/jap/blob/main/utils/proposalPdf.js): `utils/proposalPdf.js`

### Shared Platform

- [Express Application](https://github.com/basuki-rahmat/jap/blob/main/app.js): `app.js`
- [Authentication Routes](https://github.com/basuki-rahmat/jap/blob/main/routes/authRoutes.js): `routes/authRoutes.js`
- [Authentication](https://github.com/basuki-rahmat/jap/blob/main/controllers/authController.js): `controllers/authController.js`
- [Password Reset](https://github.com/basuki-rahmat/jap/blob/main/controllers/passwordResetController.js): `controllers/passwordResetController.js`
- [Role and Session Guard](https://github.com/basuki-rahmat/jap/blob/main/middlewares/authMiddleware.js): `middlewares/authMiddleware.js`
- [Notifications](https://github.com/basuki-rahmat/jap/blob/main/routes/notifRoutes.js): `routes/notifRoutes.js`
- [Transactional Email](https://github.com/basuki-rahmat/jap/blob/main/utils/mailer.js): `utils/mailer.js`
- [Company Settings](https://github.com/basuki-rahmat/jap/blob/main/utils/settings.js): `utils/settings.js`
- [Company Profile](https://github.com/basuki-rahmat/jap/blob/main/utils/companyProfile.js): `utils/companyProfile.js`
- [Owner Field Rules](https://github.com/basuki-rahmat/jap/blob/main/utils/ownerFields.js): `utils/ownerFields.js`
- [Database Queries](https://github.com/basuki-rahmat/jap/blob/main/models/db.js): `models/db.js`
- [MySQL Store](https://github.com/basuki-rahmat/jap/blob/main/config/database.js): `config/database.js`

### Other components

- **Landowner**
- **Marketing Member**
- **Administrator**

## Connections

- Express Application → Public Routes: mounts (evidence: `app.js`)
- Express Application → Authentication Routes: mounts (evidence: `app.js`)
- Express Application → Admin Routes: mounts (evidence: `app.js`)
- Express Application → Marketing Routes: mounts (evidence: `app.js`)
- Express Application → Notifications: mounts (evidence: `app.js`)
- Landowner → Public Routes: browses (evidence: `README.md`)
- Public Routes → Public Pages: renders
- Landowner → Land Submission: submits site (evidence: `README.md`)
- Public Routes → Land Submission: handles submission (evidence: `routes/publicRoutes.js`)
- Land Submission → Owner Field Rules: validates fields (evidence: `routes/publicRoutes.js`)
- Land Submission → Database Queries: stores application (evidence: `routes/publicRoutes.js`)
- Marketing Member → Marketing Registration: registers by referral (evidence: `README.md`)
- Public Routes → Marketing Registration: routes registration (evidence: `routes/publicRoutes.js`)
- Marketing Registration → Database Queries: checks and records (evidence: `controllers/registerController.js`)
- Marketing Registration → Transactional Email: sends verification (evidence: `controllers/registerController.js`)
- Administrator → Admin Routes: manages platform (evidence: `README.md`)
- Admin Routes → Admin Operations: dispatches (evidence: `routes/adminRoutes.js`)
- Admin Routes → Role and Session Guard: requires role (evidence: `routes/adminRoutes.js`)
- Admin Operations → Database Queries: reads and updates (evidence: `controllers/adminController.js`)
- Admin Operations → Transactional Email: sends status mail (evidence: `controllers/adminController.js`)
- Admin Operations → Notifications: manages alerts
- Admin Operations → Proposal and SPPL PDFs: generates documents (evidence: `controllers/adminController.js`)
- Admin Operations → Company Settings: saves configuration (evidence: `controllers/adminController.js`)
- Admin Routes → Admin Pages: serves admin pages
- Marketing Member → Marketing Routes: uses portal (evidence: `README.md`)
- Marketing Routes → Marketing Portal: dispatches (evidence: `routes/marketingRoutes.js`)
- Marketing Routes → Role and Session Guard: requires session (evidence: `routes/marketingRoutes.js`)
- Marketing Portal → Database Queries: reads and updates (evidence: `controllers/marketingController.js`)
- Marketing Portal → Owner Field Rules: validates profile (evidence: `controllers/marketingController.js`)
- Marketing Routes → Marketing Pages: serves portal pages
- Authentication Routes → Authentication: dispatches (evidence: `routes/authRoutes.js`)
- Public Routes → Password Reset: routes reset (evidence: `routes/publicRoutes.js`)
- Password Reset → Transactional Email: sends reset mail
- Notifications → Role and Session Guard: checks session (evidence: `routes/notifRoutes.js`)
- Notifications → Database Queries: reads notifications (evidence: `routes/notifRoutes.js`)
- Transactional Email → Company Profile: loads branding (evidence: `utils/mailer.js`)
- Company Profile → Company Settings: reads settings (evidence: `utils/companyProfile.js`)
- Company Settings → Database Queries: queries settings (evidence: `utils/settings.js`)
- Database Queries → MySQL Store: queries pool (evidence: `models/db.js`)
