# sevynix/peminjamanbuku architecture

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

- Interactive diagram: https://gitdiagram.com/sevynix/peminjamanbuku
- Repository: https://github.com/sevynix/peminjamanbuku

## Overview

Peminjaman Buku API serves REST requests for account access, book and user administration, and book loans. The main workflow is a client request routed through Fiber middleware and endpoints to a service, which applies domain rules and uses repositories to access PostgreSQL; loan listing can return CSV. Authentication includes JWT access tokens and refresh-token lifecycle, while permission checks and login rate limiting protect access. The graph uses README-documented capabilities where implementation excerpts were unavailable; edges are limited to relationships shown in excerpts or documented by the README.

Main entry points: [`database/postgres.go`](https://github.com/sevynix/peminjamanbuku/blob/main/database/postgres.go) (PostgreSQL), [`route/route.go`](https://github.com/sevynix/peminjamanbuku/blob/main/route/route.go) (Endpoint routing), [`app/service/auth_service.go`](https://github.com/sevynix/peminjamanbuku/blob/main/app/service/auth_service.go) (Account lifecycle), [`middleware/middleware.go`](https://github.com/sevynix/peminjamanbuku/blob/main/middleware/middleware.go) (Request middleware)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["API runtime"]
  node_startup["Startup wiring<br/>[main.go]"]
  node_app["Fiber app<br/>[app.go]"]
  node_routes["Endpoint routing<br/>[route.go]"]
  node_middleware["Request middleware<br/>[middleware.go]"]
  node_response_model["Response models<br/>[response.go]"]
end

subgraph group_identity["Identity and access"]
  node_auth_mw["JWT authentication<br/>[auth.go]"]
  node_authz_mw["Permission gate<br/>[authz.go]"]
  node_rate_limit["Login rate limit<br/>[ratelimit.go]"]
  node_auth_service["Account lifecycle<br/>[auth_service.go]"]
  node_permissions["Role permissions<br/>[authz.go]"]
  node_token_repo["Refresh token store"]
  node_role_repo["Role repository<br/>[role_repository.go]"]
end

subgraph group_catalog["Catalog and users"]
  node_book_service["Book management<br/>[book_service.go]"]
  node_user_service["User management<br/>[user_service.go]"]
  node_book_rules["Book rules<br/>[book_rules.go]"]
  node_user_rules["User rules<br/>[user_rules.go]"]
  node_book_model["Book model<br/>[book.go]"]
  node_user_model["User model<br/>[user.go]"]
end

subgraph group_loans["Loans and persistence"]
  node_loan_service["Loan workflow<br/>[loan_service.go]"]
  node_loan_rules["Loan rules<br/>[loan_rules.go]"]
  node_loan_model["Loan model<br/>[loan.go]"]
  node_book_repo["Book repository<br/>[book_repository.go]"]
  node_user_repo["User repository<br/>[user_repository.go]"]
  node_loan_repo["Loan repository<br/>[loan_repository.go]"]
  node_postgres[("PostgreSQL<br/>[postgres.go]")]
  node_csv["Loan CSV output<br/>[csv.go]"]
end

node_client(("API client"))

node_client -->|"sends requests"| node_app
node_startup -->|"opens pool"| node_postgres
node_startup -->|"configures app"| node_app
node_app -->|"registers middleware"| node_middleware
node_app -->|"registers routes"| node_routes
node_middleware -.->|"authenticates"| node_auth_mw
node_middleware -.->|"checks permissions"| node_authz_mw
node_middleware -.->|"limits login"| node_rate_limit
node_routes -.->|"dispatches auth"| node_auth_service
node_routes -.->|"dispatches books"| node_book_service
node_routes -.->|"dispatches users"| node_user_service
node_routes -.->|"dispatches loans"| node_loan_service
node_auth_service -->|"reads and creates users"| node_user_repo
node_auth_service -->|"manages refresh tokens"| node_token_repo
node_auth_service -->|"lists permissions"| node_permissions
node_auth_service -->|"uses account data"| node_user_model
node_loan_service -->|"borrows and lists"| node_loan_repo
node_loan_service -->|"checks loan access"| node_permissions
node_loan_service -->|"writes CSV"| node_csv
node_loan_repo -->|"queries loan and book data"| node_postgres
node_book_repo -.->|"queries books"| node_postgres
node_user_repo -->|"queries users"| node_postgres
node_token_repo -.->|"stores refresh tokens"| node_postgres
node_role_repo -.->|"loads role permissions"| node_postgres

click node_startup "https://github.com/sevynix/peminjamanbuku/blob/main/main.go"
click node_app "https://github.com/sevynix/peminjamanbuku/blob/main/config/app.go"
click node_routes "https://github.com/sevynix/peminjamanbuku/blob/main/route/route.go"
click node_middleware "https://github.com/sevynix/peminjamanbuku/blob/main/middleware/middleware.go"
click node_auth_mw "https://github.com/sevynix/peminjamanbuku/blob/main/middleware/auth.go"
click node_authz_mw "https://github.com/sevynix/peminjamanbuku/blob/main/middleware/authz.go"
click node_rate_limit "https://github.com/sevynix/peminjamanbuku/blob/main/middleware/ratelimit.go"
click node_auth_service "https://github.com/sevynix/peminjamanbuku/blob/main/app/service/auth_service.go"
click node_permissions "https://github.com/sevynix/peminjamanbuku/blob/main/helper/authz.go"
click node_book_service "https://github.com/sevynix/peminjamanbuku/blob/main/app/service/book_service.go"
click node_user_service "https://github.com/sevynix/peminjamanbuku/blob/main/app/service/user_service.go"
click node_book_rules "https://github.com/sevynix/peminjamanbuku/blob/main/app/service/book_rules.go"
click node_user_rules "https://github.com/sevynix/peminjamanbuku/blob/main/app/service/user_rules.go"
click node_book_model "https://github.com/sevynix/peminjamanbuku/blob/main/app/model/book.go"
click node_user_model "https://github.com/sevynix/peminjamanbuku/blob/main/app/model/user.go"
click node_loan_service "https://github.com/sevynix/peminjamanbuku/blob/main/app/service/loan_service.go"
click node_loan_rules "https://github.com/sevynix/peminjamanbuku/blob/main/app/service/loan_rules.go"
click node_loan_model "https://github.com/sevynix/peminjamanbuku/blob/main/app/model/loan.go"
click node_response_model "https://github.com/sevynix/peminjamanbuku/blob/main/app/model/response.go"
click node_book_repo "https://github.com/sevynix/peminjamanbuku/blob/main/app/repository/book_repository.go"
click node_user_repo "https://github.com/sevynix/peminjamanbuku/blob/main/app/repository/user_repository.go"
click node_loan_repo "https://github.com/sevynix/peminjamanbuku/blob/main/app/repository/loan_repository.go"
click node_token_repo "https://github.com/sevynix/peminjamanbuku/blob/main/app/repository/token_repository.go"
click node_role_repo "https://github.com/sevynix/peminjamanbuku/blob/main/app/repository/role_repository.go"
click node_postgres "https://github.com/sevynix/peminjamanbuku/blob/main/database/postgres.go"
click node_csv "https://github.com/sevynix/peminjamanbuku/blob/main/helper/csv.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_startup,node_app,node_routes,node_middleware,node_response_model,node_client toneBlue
class node_auth_mw,node_authz_mw,node_rate_limit,node_auth_service,node_permissions,node_token_repo,node_role_repo toneAmber
class node_book_service,node_user_service,node_book_rules,node_user_rules,node_book_model,node_user_model toneMint
class node_loan_service,node_loan_rules,node_loan_model,node_book_repo,node_user_repo,node_loan_repo,node_postgres,node_csv toneRose
```

## Components

### API runtime

- [Startup wiring](https://github.com/sevynix/peminjamanbuku/blob/main/main.go): `main.go`
- [Fiber app](https://github.com/sevynix/peminjamanbuku/blob/main/config/app.go): `config/app.go`
- [Endpoint routing](https://github.com/sevynix/peminjamanbuku/blob/main/route/route.go): `route/route.go`
- [Request middleware](https://github.com/sevynix/peminjamanbuku/blob/main/middleware/middleware.go): `middleware/middleware.go`
- [Response models](https://github.com/sevynix/peminjamanbuku/blob/main/app/model/response.go): `app/model/response.go`

### Identity and access

- [JWT authentication](https://github.com/sevynix/peminjamanbuku/blob/main/middleware/auth.go): `middleware/auth.go`
- [Permission gate](https://github.com/sevynix/peminjamanbuku/blob/main/middleware/authz.go): `middleware/authz.go`
- [Login rate limit](https://github.com/sevynix/peminjamanbuku/blob/main/middleware/ratelimit.go): `middleware/ratelimit.go`
- [Account lifecycle](https://github.com/sevynix/peminjamanbuku/blob/main/app/service/auth_service.go): `app/service/auth_service.go`
- [Role permissions](https://github.com/sevynix/peminjamanbuku/blob/main/helper/authz.go): `helper/authz.go`
- [Refresh token store](https://github.com/sevynix/peminjamanbuku/blob/main/app/repository/token_repository.go): `app/repository/token_repository.go`
- [Role repository](https://github.com/sevynix/peminjamanbuku/blob/main/app/repository/role_repository.go): `app/repository/role_repository.go`

### Catalog and users

- [Book management](https://github.com/sevynix/peminjamanbuku/blob/main/app/service/book_service.go): `app/service/book_service.go`
- [User management](https://github.com/sevynix/peminjamanbuku/blob/main/app/service/user_service.go): `app/service/user_service.go`
- [Book rules](https://github.com/sevynix/peminjamanbuku/blob/main/app/service/book_rules.go): `app/service/book_rules.go`
- [User rules](https://github.com/sevynix/peminjamanbuku/blob/main/app/service/user_rules.go): `app/service/user_rules.go`
- [Book model](https://github.com/sevynix/peminjamanbuku/blob/main/app/model/book.go): `app/model/book.go`
- [User model](https://github.com/sevynix/peminjamanbuku/blob/main/app/model/user.go): `app/model/user.go`

### Loans and persistence

- [Loan workflow](https://github.com/sevynix/peminjamanbuku/blob/main/app/service/loan_service.go): `app/service/loan_service.go`
- [Loan rules](https://github.com/sevynix/peminjamanbuku/blob/main/app/service/loan_rules.go): `app/service/loan_rules.go`
- [Loan model](https://github.com/sevynix/peminjamanbuku/blob/main/app/model/loan.go): `app/model/loan.go`
- [Book repository](https://github.com/sevynix/peminjamanbuku/blob/main/app/repository/book_repository.go): `app/repository/book_repository.go`
- [User repository](https://github.com/sevynix/peminjamanbuku/blob/main/app/repository/user_repository.go): `app/repository/user_repository.go`
- [Loan repository](https://github.com/sevynix/peminjamanbuku/blob/main/app/repository/loan_repository.go): `app/repository/loan_repository.go`
- [PostgreSQL](https://github.com/sevynix/peminjamanbuku/blob/main/database/postgres.go): `database/postgres.go`
- [Loan CSV output](https://github.com/sevynix/peminjamanbuku/blob/main/helper/csv.go): `helper/csv.go`

### Other components

- **API client**

## Connections

- API client → Fiber app: sends requests
- Startup wiring → PostgreSQL: opens pool (evidence: `main.go`)
- Startup wiring → Fiber app: configures app (evidence: `main.go`)
- Fiber app → Request middleware: registers middleware (evidence: `config/app.go`)
- Fiber app → Endpoint routing: registers routes (evidence: `config/app.go`)
- Request middleware → JWT authentication: authenticates
- Request middleware → Permission gate: checks permissions
- Request middleware → Login rate limit: limits login
- Endpoint routing → Account lifecycle: dispatches auth
- Endpoint routing → Book management: dispatches books
- Endpoint routing → User management: dispatches users
- Endpoint routing → Loan workflow: dispatches loans
- Account lifecycle → User repository: reads and creates users (evidence: `app/service/auth_service.go`)
- Account lifecycle → Refresh token store: manages refresh tokens (evidence: `app/service/auth_service.go`)
- Account lifecycle → Role permissions: lists permissions (evidence: `app/service/auth_service.go`)
- Account lifecycle → User model: uses account data (evidence: `app/service/auth_service.go`)
- Loan workflow → Loan repository: borrows and lists (evidence: `app/service/loan_service.go`)
- Loan workflow → Role permissions: checks loan access (evidence: `app/service/loan_service.go`)
- Loan workflow → Loan CSV output: writes CSV (evidence: `app/service/loan_service.go`)
- Loan repository → PostgreSQL: queries loan and book data (evidence: `app/repository/loan_repository.go`)
- Book repository → PostgreSQL: queries books
- User repository → PostgreSQL: queries users (evidence: `app/repository/user_repository.go`)
- Refresh token store → PostgreSQL: stores refresh tokens
- Role repository → PostgreSQL: loads role permissions
