# adriankiv/web-umkm architecture

> Architecture diagram of the GitHub repository adriankiv/web-umkm, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/adriankiv/web-umkm
- Repository: https://github.com/adriankiv/web-umkm

## Overview

This is a Laravel application for discovering and managing local UMKM businesses, with public listings, maps, ratings, recommendations, user-submitted business/menu proposals, and an admin review interface. The principal flow is browsing or filtering businesses, using preference and activity signals for recommendations, and viewing results on the map; users can also submit proposals for admin approval. A Go service provides an optional recommendation engine. The Go internals and several routes are represented from the file tree, not inspected excerpts, so their internal links are limited or marked unverified.

Main entry points: [`app/Http/Controllers/DataUmkmController.php`](https://github.com/adriankiv/web-umkm/blob/main/app/Http/Controllers/DataUmkmController.php) (UMKM Discovery), [`app/Http/Controllers/PublicUmkmSubmissionController.php`](https://github.com/adriankiv/web-umkm/blob/main/app/Http/Controllers/PublicUmkmSubmissionController.php) (Public Proposals), [`go-umkm/internal/httpapi/server.go`](https://github.com/adriankiv/web-umkm/blob/main/go-umkm/internal/httpapi/server.go) (Go Recommendation API), [`app/Http/Controllers/Admin/AdminDashboardController.php`](https://github.com/adriankiv/web-umkm/blob/main/app/Http/Controllers/Admin/AdminDashboardController.php) (Admin Dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_public["Public Discovery"]
  node_discovery["UMKM Discovery"]
  node_map["Map View<br/>[map.js]"]
  node_business[("UMKM Records<br/>[Umkm.php]")]
  node_categories[("Categories<br/>[Kategori.php]")]
  node_ratings[("Ratings<br/>[Rating.php]")]
end

subgraph group_submissions["Submissions and Admin"]
  node_public_submission["Public Proposals"]
  node_proposal_records[("Proposal Records<br/>[UmkmSubmission.php]")]
  node_menu_proposals[("Menu Proposals<br/>[MenuSubmission.php]")]
  node_admin["Admin Dashboard"]
  node_admin_umkm["UMKM Administration"]
  node_image_upload["Image Upload"]
end

subgraph group_identity["Identity and Activity"]
  node_activity[("User Activity<br/>[UserActivity.php]")]
  node_auth["Authentication"]
  node_login["Login Activity"]
end

subgraph group_recommendations["Recommendation Service"]
  node_recommendation_client["Recommendation Client"]
  node_go_api["Go Recommendation API<br/>[server.go]"]
  node_go_scoring["CBF Scoring<br/>[score.go]"]
  node_go_repository[("Recommendation Data<br/>[rekomendasi.go]")]
  node_go_cache["TTL Cache<br/>[ttl.go]"]
  node_go_database[("MySQL Access<br/>[mysql.go]")]
end

node_visitor(("Visitor"))

node_visitor -.->|"browses"| node_discovery
node_discovery -->|"queries"| node_business
node_discovery -->|"loads"| node_categories
node_discovery -->|"reads activity"| node_activity
node_discovery -->|"ranks by rating"| node_ratings
node_visitor -.->|"views map"| node_map
node_map -.->|"requests map data"| node_discovery
node_visitor -.->|"submits proposal"| node_public_submission
node_public_submission -->|"creates proposals"| node_proposal_records
node_public_submission -->|"creates menu proposals"| node_menu_proposals
node_public_submission -->|"uploads images"| node_image_upload
node_admin -->|"reviews proposals"| node_proposal_records
node_admin -->|"reviews menu proposals"| node_menu_proposals
node_admin -->|"publishes approved businesses"| node_business
node_admin_umkm -->|"manages records"| node_business
node_admin_umkm -->|"loads categories"| node_categories
node_admin_umkm -->|"uploads images"| node_image_upload
node_visitor -.->|"registers"| node_auth
node_auth -->|"records activity"| node_activity
node_login -->|"attaches activities"| node_activity
node_discovery -->|"requests recommendations"| node_recommendation_client
node_recommendation_client -->|"posts request"| node_go_api
node_go_api -.->|"computes scores"| node_go_scoring
node_go_api -.->|"loads recommendation data"| node_go_repository
node_go_api -.->|"uses cache"| node_go_cache
node_go_repository -.->|"queries MySQL"| node_go_database

click node_discovery "https://github.com/adriankiv/web-umkm/blob/main/app/Http/Controllers/DataUmkmController.php"
click node_map "https://github.com/adriankiv/web-umkm/blob/main/resources/js/map.js"
click node_business "https://github.com/adriankiv/web-umkm/blob/main/app/Models/Umkm.php"
click node_categories "https://github.com/adriankiv/web-umkm/blob/main/app/Models/Kategori.php"
click node_ratings "https://github.com/adriankiv/web-umkm/blob/main/app/Models/Rating.php"
click node_activity "https://github.com/adriankiv/web-umkm/blob/main/app/Models/UserActivity.php"
click node_auth "https://github.com/adriankiv/web-umkm/blob/main/app/Http/Controllers/Auth/RegisteredUserController.php"
click node_login "https://github.com/adriankiv/web-umkm/blob/main/app/Http/Controllers/Auth/AuthenticatedSessionController.php"
click node_public_submission "https://github.com/adriankiv/web-umkm/blob/main/app/Http/Controllers/PublicUmkmSubmissionController.php"
click node_proposal_records "https://github.com/adriankiv/web-umkm/blob/main/app/Models/UmkmSubmission.php"
click node_menu_proposals "https://github.com/adriankiv/web-umkm/blob/main/app/Models/MenuSubmission.php"
click node_admin "https://github.com/adriankiv/web-umkm/blob/main/app/Http/Controllers/Admin/AdminDashboardController.php"
click node_admin_umkm "https://github.com/adriankiv/web-umkm/blob/main/app/Http/Controllers/Admin/UmkmAdminController.php"
click node_image_upload "https://github.com/adriankiv/web-umkm/blob/main/app/Support/WebpImageUploader.php"
click node_recommendation_client "https://github.com/adriankiv/web-umkm/blob/main/app/Services/RekomendasiClient.php"
click node_go_api "https://github.com/adriankiv/web-umkm/blob/main/go-umkm/internal/httpapi/server.go"
click node_go_scoring "https://github.com/adriankiv/web-umkm/blob/main/go-umkm/internal/cbf/score.go"
click node_go_repository "https://github.com/adriankiv/web-umkm/blob/main/go-umkm/internal/repo/rekomendasi.go"
click node_go_cache "https://github.com/adriankiv/web-umkm/blob/main/go-umkm/internal/cache/ttl.go"
click node_go_database "https://github.com/adriankiv/web-umkm/blob/main/go-umkm/internal/db/mysql.go"

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_discovery,node_map,node_business,node_categories,node_ratings toneBlue
class node_public_submission,node_proposal_records,node_menu_proposals,node_admin,node_admin_umkm,node_image_upload toneAmber
class node_activity,node_auth,node_login toneMint
class node_recommendation_client,node_go_api,node_go_scoring,node_go_repository,node_go_cache,node_go_database toneRose
class node_visitor toneIndigo
```

## Components

### Public Discovery

- [UMKM Discovery](https://github.com/adriankiv/web-umkm/blob/main/app/Http/Controllers/DataUmkmController.php): `app/Http/Controllers/DataUmkmController.php`
- [Map View](https://github.com/adriankiv/web-umkm/blob/main/resources/js/map.js): `resources/js/map.js`
- [UMKM Records](https://github.com/adriankiv/web-umkm/blob/main/app/Models/Umkm.php): `app/Models/Umkm.php`
- [Categories](https://github.com/adriankiv/web-umkm/blob/main/app/Models/Kategori.php): `app/Models/Kategori.php`
- [Ratings](https://github.com/adriankiv/web-umkm/blob/main/app/Models/Rating.php): `app/Models/Rating.php`

### Submissions and Admin

- [Public Proposals](https://github.com/adriankiv/web-umkm/blob/main/app/Http/Controllers/PublicUmkmSubmissionController.php): `app/Http/Controllers/PublicUmkmSubmissionController.php`
- [Proposal Records](https://github.com/adriankiv/web-umkm/blob/main/app/Models/UmkmSubmission.php): `app/Models/UmkmSubmission.php`
- [Menu Proposals](https://github.com/adriankiv/web-umkm/blob/main/app/Models/MenuSubmission.php): `app/Models/MenuSubmission.php`
- [Admin Dashboard](https://github.com/adriankiv/web-umkm/blob/main/app/Http/Controllers/Admin/AdminDashboardController.php): `app/Http/Controllers/Admin/AdminDashboardController.php`
- [UMKM Administration](https://github.com/adriankiv/web-umkm/blob/main/app/Http/Controllers/Admin/UmkmAdminController.php): `app/Http/Controllers/Admin/UmkmAdminController.php`
- [Image Upload](https://github.com/adriankiv/web-umkm/blob/main/app/Support/WebpImageUploader.php): `app/Support/WebpImageUploader.php`

### Identity and Activity

- [User Activity](https://github.com/adriankiv/web-umkm/blob/main/app/Models/UserActivity.php): `app/Models/UserActivity.php`
- [Authentication](https://github.com/adriankiv/web-umkm/blob/main/app/Http/Controllers/Auth/RegisteredUserController.php): `app/Http/Controllers/Auth/RegisteredUserController.php`
- [Login Activity](https://github.com/adriankiv/web-umkm/blob/main/app/Http/Controllers/Auth/AuthenticatedSessionController.php): `app/Http/Controllers/Auth/AuthenticatedSessionController.php`

### Recommendation Service

- [Recommendation Client](https://github.com/adriankiv/web-umkm/blob/main/app/Services/RekomendasiClient.php): `app/Services/RekomendasiClient.php`
- [Go Recommendation API](https://github.com/adriankiv/web-umkm/blob/main/go-umkm/internal/httpapi/server.go): `go-umkm/internal/httpapi/server.go`
- [CBF Scoring](https://github.com/adriankiv/web-umkm/blob/main/go-umkm/internal/cbf/score.go): `go-umkm/internal/cbf/score.go`
- [Recommendation Data](https://github.com/adriankiv/web-umkm/blob/main/go-umkm/internal/repo/rekomendasi.go): `go-umkm/internal/repo/rekomendasi.go`
- [TTL Cache](https://github.com/adriankiv/web-umkm/blob/main/go-umkm/internal/cache/ttl.go): `go-umkm/internal/cache/ttl.go`
- [MySQL Access](https://github.com/adriankiv/web-umkm/blob/main/go-umkm/internal/db/mysql.go): `go-umkm/internal/db/mysql.go`

### Other components

- **Visitor**

## Connections

- Visitor → UMKM Discovery: browses
- UMKM Discovery → UMKM Records: queries (evidence: `app/Http/Controllers/DataUmkmController.php`)
- UMKM Discovery → Categories: loads (evidence: `app/Http/Controllers/DataUmkmController.php`)
- UMKM Discovery → User Activity: reads activity (evidence: `app/Http/Controllers/DataUmkmController.php`)
- UMKM Discovery → Ratings: ranks by rating (evidence: `app/Http/Controllers/DataUmkmController.php`)
- Visitor → Map View: views map
- Map View → UMKM Discovery: requests map data
- Visitor → Public Proposals: submits proposal
- Public Proposals → Proposal Records: creates proposals (evidence: `app/Http/Controllers/PublicUmkmSubmissionController.php`)
- Public Proposals → Menu Proposals: creates menu proposals (evidence: `app/Http/Controllers/PublicUmkmSubmissionController.php`)
- Public Proposals → Image Upload: uploads images (evidence: `app/Http/Controllers/PublicUmkmSubmissionController.php`)
- Admin Dashboard → Proposal Records: reviews proposals (evidence: `app/Http/Controllers/Admin/AdminDashboardController.php`)
- Admin Dashboard → Menu Proposals: reviews menu proposals (evidence: `app/Http/Controllers/Admin/AdminDashboardController.php`)
- Admin Dashboard → UMKM Records: publishes approved businesses (evidence: `app/Http/Controllers/Admin/AdminDashboardController.php`)
- UMKM Administration → UMKM Records: manages records (evidence: `app/Http/Controllers/Admin/UmkmAdminController.php`)
- UMKM Administration → Categories: loads categories (evidence: `app/Http/Controllers/Admin/UmkmAdminController.php`)
- UMKM Administration → Image Upload: uploads images (evidence: `app/Http/Controllers/Admin/UmkmAdminController.php`)
- Visitor → Authentication: registers
- Authentication → User Activity: records activity (evidence: `app/Http/Controllers/Auth/RegisteredUserController.php`)
- Login Activity → User Activity: attaches activities (evidence: `app/Http/Controllers/Auth/AuthenticatedSessionController.php`)
- UMKM Discovery → Recommendation Client: requests recommendations (evidence: `app/Http/Controllers/DataUmkmController.php`)
- Recommendation Client → Go Recommendation API: posts request (evidence: `app/Services/RekomendasiClient.php`)
- Go Recommendation API → CBF Scoring: computes scores
- Go Recommendation API → Recommendation Data: loads recommendation data
- Go Recommendation API → TTL Cache: uses cache
- Recommendation Data → MySQL Access: queries MySQL
