How sevynix/peminjamanbuku works
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: postgres.go PostgreSQL · route.go Endpoint routing · auth_service.go Account lifecycle · middleware.go Request middleware
Components 27
API runtime
- Startup wiring
main.go - Fiber app
config/app.go - Endpoint routing
route/route.go - Request middleware
middleware/middleware.go - Response models
app/model/response.go
Identity and access
- JWT authentication
middleware/auth.go - Permission gate
middleware/authz.go - Login rate limit
middleware/ratelimit.go - Account lifecycle
app/service/auth_service.go - Role permissions
helper/authz.go - Refresh token store
app/repository/token_repository.go - Role repository
app/repository/role_repository.go
Catalog and users
- Book management
app/service/book_service.go - User management
app/service/user_service.go - Book rules
app/service/book_rules.go - User rules
app/service/user_rules.go - Book model
app/model/book.go - User model
app/model/user.go
Loans and persistence
- Loan workflow
app/service/loan_service.go - Loan rules
app/service/loan_rules.go - Loan model
app/model/loan.go - Book repository
app/repository/book_repository.go - User repository
app/repository/user_repository.go - Loan repository
app/repository/loan_repository.go - PostgreSQL
database/postgres.go - Loan CSV output
helper/csv.go
Other components
- API client
Connections 24
- API client → Fiber app: sends requests
- Startup wiring → PostgreSQL: opens pool
main.go - Startup wiring → Fiber app: configures app
main.go - Fiber app → Request middleware: registers middleware
config/app.go - Fiber app → Endpoint routing: registers routes
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
app/service/auth_service.go - Account lifecycle → Refresh token store: manages refresh tokens
app/service/auth_service.go - Account lifecycle → Role permissions: lists permissions
app/service/auth_service.go - Account lifecycle → User model: uses account data
app/service/auth_service.go - Loan workflow → Loan repository: borrows and lists
app/service/loan_service.go - Loan workflow → Role permissions: checks loan access
app/service/loan_service.go - Loan workflow → Loan CSV output: writes CSV
app/service/loan_service.go - Loan repository → PostgreSQL: queries loan and book data
app/repository/loan_repository.go - Book repository → PostgreSQL: queries books
- User repository → PostgreSQL: queries users
app/repository/user_repository.go - Refresh token store → PostgreSQL: stores refresh tokens
- Role repository → PostgreSQL: loads role permissions