# michelljk/be_boilerplate_is_2026 architecture

> Architecture diagram of the GitHub repository michelljk/be_boilerplate_is_2026, 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/michelljk/be_boilerplate_is_2026
- Repository: https://github.com/michelljk/be_boilerplate_is_2026

## Overview

SI Backend Boilerplate is a NestJS REST API for gym operations, backed by Prisma and PostgreSQL. The principal workflow is an authenticated user or staff member calling an API endpoint, which delegates to a domain service and, where shown, persists or queries gym data. The graph preserves the major operational areas visible in the source tree: memberships, access, payments, classes, training, progress, and reporting. Several connections are omitted because their implementation was not sampled; edges cite only visible calls or dependencies.

Main entry points: [`src/access/controllers/access.controller.ts`](https://github.com/michelljk/be_boilerplate_is_2026/blob/main/src/access/controllers/access.controller.ts) (Member access), [`src/personal-sessions/repositories/personal-sessions.repository.ts`](https://github.com/michelljk/be_boilerplate_is_2026/blob/main/src/personal-sessions/repositories/personal-sessions.repository.ts) (Personal sessions), [`src/prisma/services/prisma.service.ts`](https://github.com/michelljk/be_boilerplate_is_2026/blob/main/src/prisma/services/prisma.service.ts) (Prisma access), [`src/memberships`](https://github.com/michelljk/be_boilerplate_is_2026/tree/main/src/memberships) (Memberships)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity and platform"]
  node_auth["Authentication"]
  node_users["User management"]
  node_prisma["Prisma access<br/>[prisma.service.ts]"]
end

subgraph group_members["Member operations"]
  node_memberships["Memberships"]
  node_access["Member access"]
  node_member_search["Member search"]
  node_checkin["Check-in service<br/>[access.service.ts]"]
  node_payments["Payments"]
end

subgraph group_classes["Classes and training"]
  node_class_admin["Class administration"]
  node_class_queries["Class queries"]
  node_reservations["Class reservations"]
  node_attendance["Class attendance"]
  node_routines["Routine assignment"]
  node_routine_queries["Routine queries"]
  node_personal_sessions["Personal sessions"]
  node_trainer_schedule["Trainer scheduling"]
end

subgraph group_operations["Gym operations"]
  node_gkds["Gym desk workflows<br/>[gkds.service.ts]"]
  node_machines["Machine maintenance"]
  node_notifications["Notifications"]
  node_progress["Progress tracking"]
end

subgraph group_insights["Feedback and reporting"]
  node_reviews["Session reviews"]
  node_review_service["Review rules<br/>[reviews.service.ts]"]
  node_review_store["Review queries"]
  node_reports["Operational reports"]
  node_report_service["Report calculations<br/>[reports.service.ts]"]
end

node_user(("API user"))
node_postgres[("PostgreSQL")]

node_user -->|"calls API"| node_access
node_access -->|"searches members"| node_member_search
node_access -->|"registers check-in"| node_checkin
node_memberships -.->|"membership status"| node_member_search
node_user -->|"calls API"| node_reviews
node_reviews -->|"delegates"| node_review_service
node_review_service -->|"queries reviews"| node_review_store
node_review_store -->|"queries database"| node_prisma
node_user -->|"calls API"| node_reports
node_reports -->|"requests reports"| node_report_service
node_gkds -->|"sends notices"| node_notifications
node_personal_sessions -->|"uses notifications"| node_notifications
node_personal_sessions -->|"checks eligibility"| node_memberships
node_prisma -->|"connects"| node_postgres

click node_auth "https://github.com/michelljk/be_boilerplate_is_2026/tree/main/src/auth"
click node_users "https://github.com/michelljk/be_boilerplate_is_2026/tree/main/src/users"
click node_prisma "https://github.com/michelljk/be_boilerplate_is_2026/blob/main/src/prisma/services/prisma.service.ts"
click node_memberships "https://github.com/michelljk/be_boilerplate_is_2026/tree/main/src/memberships"
click node_access "https://github.com/michelljk/be_boilerplate_is_2026/blob/main/src/access/controllers/access.controller.ts"
click node_member_search "https://github.com/michelljk/be_boilerplate_is_2026/blob/main/src/access/services/member-search.service.ts"
click node_checkin "https://github.com/michelljk/be_boilerplate_is_2026/blob/main/src/access/services/access.service.ts"
click node_payments "https://github.com/michelljk/be_boilerplate_is_2026/tree/main/src/payments"
click node_class_admin "https://github.com/michelljk/be_boilerplate_is_2026/blob/main/src/class-administration/controllers/class-administration.controller.ts"
click node_class_queries "https://github.com/michelljk/be_boilerplate_is_2026/tree/main/src/class-queries"
click node_reservations "https://github.com/michelljk/be_boilerplate_is_2026/tree/main/src/class-reservations"
click node_attendance "https://github.com/michelljk/be_boilerplate_is_2026/blob/main/src/class-attendance/controllers/class-attendance.controller.ts"
click node_routines "https://github.com/michelljk/be_boilerplate_is_2026/tree/main/src/routine-assignment"
click node_routine_queries "https://github.com/michelljk/be_boilerplate_is_2026/blob/main/src/routine-queries/services/routine-queries.service.ts"
click node_personal_sessions "https://github.com/michelljk/be_boilerplate_is_2026/blob/main/src/personal-sessions/repositories/personal-sessions.repository.ts"
click node_trainer_schedule "https://github.com/michelljk/be_boilerplate_is_2026/tree/main/src/trainer-agenda"
click node_gkds "https://github.com/michelljk/be_boilerplate_is_2026/blob/main/src/gkds/services/gkds.service.ts"
click node_machines "https://github.com/michelljk/be_boilerplate_is_2026/tree/main/src/machine-administration"
click node_notifications "https://github.com/michelljk/be_boilerplate_is_2026/blob/main/src/notifications/services/notification.service.ts"
click node_progress "https://github.com/michelljk/be_boilerplate_is_2026/tree/main/src/progress"
click node_reviews "https://github.com/michelljk/be_boilerplate_is_2026/blob/main/src/reviews/controllers/reviews.controller.ts"
click node_review_service "https://github.com/michelljk/be_boilerplate_is_2026/blob/main/src/reviews/services/reviews.service.ts"
click node_review_store "https://github.com/michelljk/be_boilerplate_is_2026/blob/main/src/reviews/repositories/reviews.repository.ts"
click node_reports "https://github.com/michelljk/be_boilerplate_is_2026/blob/main/src/reports/reports.controller.ts"
click node_report_service "https://github.com/michelljk/be_boilerplate_is_2026/blob/main/src/reports/reports.service.ts"

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_auth,node_users,node_prisma,node_user toneBlue
class node_memberships,node_access,node_member_search,node_checkin,node_payments,node_postgres toneAmber
class node_class_admin,node_class_queries,node_reservations,node_attendance,node_routines,node_routine_queries,node_personal_sessions,node_trainer_schedule toneMint
class node_gkds,node_machines,node_notifications,node_progress toneRose
class node_reviews,node_review_service,node_review_store,node_reports,node_report_service toneIndigo
```

## Components

### Identity and platform

- [Authentication](https://github.com/michelljk/be_boilerplate_is_2026/tree/main/src/auth): `src/auth`
- [User management](https://github.com/michelljk/be_boilerplate_is_2026/tree/main/src/users): `src/users`
- [Prisma access](https://github.com/michelljk/be_boilerplate_is_2026/blob/main/src/prisma/services/prisma.service.ts): `src/prisma/services/prisma.service.ts`

### Member operations

- [Memberships](https://github.com/michelljk/be_boilerplate_is_2026/tree/main/src/memberships): `src/memberships`
- [Member access](https://github.com/michelljk/be_boilerplate_is_2026/blob/main/src/access/controllers/access.controller.ts): `src/access/controllers/access.controller.ts`
- [Member search](https://github.com/michelljk/be_boilerplate_is_2026/blob/main/src/access/services/member-search.service.ts): `src/access/services/member-search.service.ts`
- [Check-in service](https://github.com/michelljk/be_boilerplate_is_2026/blob/main/src/access/services/access.service.ts): `src/access/services/access.service.ts`
- [Payments](https://github.com/michelljk/be_boilerplate_is_2026/tree/main/src/payments): `src/payments`

### Classes and training

- [Class administration](https://github.com/michelljk/be_boilerplate_is_2026/blob/main/src/class-administration/controllers/class-administration.controller.ts): `src/class-administration/controllers/class-administration.controller.ts`
- [Class queries](https://github.com/michelljk/be_boilerplate_is_2026/tree/main/src/class-queries): `src/class-queries`
- [Class reservations](https://github.com/michelljk/be_boilerplate_is_2026/tree/main/src/class-reservations): `src/class-reservations`
- [Class attendance](https://github.com/michelljk/be_boilerplate_is_2026/blob/main/src/class-attendance/controllers/class-attendance.controller.ts): `src/class-attendance/controllers/class-attendance.controller.ts`
- [Routine assignment](https://github.com/michelljk/be_boilerplate_is_2026/tree/main/src/routine-assignment): `src/routine-assignment`
- [Routine queries](https://github.com/michelljk/be_boilerplate_is_2026/blob/main/src/routine-queries/services/routine-queries.service.ts): `src/routine-queries/services/routine-queries.service.ts`
- [Personal sessions](https://github.com/michelljk/be_boilerplate_is_2026/blob/main/src/personal-sessions/repositories/personal-sessions.repository.ts): `src/personal-sessions/repositories/personal-sessions.repository.ts`
- [Trainer scheduling](https://github.com/michelljk/be_boilerplate_is_2026/tree/main/src/trainer-agenda): `src/trainer-agenda`

### Gym operations

- [Gym desk workflows](https://github.com/michelljk/be_boilerplate_is_2026/blob/main/src/gkds/services/gkds.service.ts): `src/gkds/services/gkds.service.ts`
- [Machine maintenance](https://github.com/michelljk/be_boilerplate_is_2026/tree/main/src/machine-administration): `src/machine-administration`
- [Notifications](https://github.com/michelljk/be_boilerplate_is_2026/blob/main/src/notifications/services/notification.service.ts): `src/notifications/services/notification.service.ts`
- [Progress tracking](https://github.com/michelljk/be_boilerplate_is_2026/tree/main/src/progress): `src/progress`

### Feedback and reporting

- [Session reviews](https://github.com/michelljk/be_boilerplate_is_2026/blob/main/src/reviews/controllers/reviews.controller.ts): `src/reviews/controllers/reviews.controller.ts`
- [Review rules](https://github.com/michelljk/be_boilerplate_is_2026/blob/main/src/reviews/services/reviews.service.ts): `src/reviews/services/reviews.service.ts`
- [Review queries](https://github.com/michelljk/be_boilerplate_is_2026/blob/main/src/reviews/repositories/reviews.repository.ts): `src/reviews/repositories/reviews.repository.ts`
- [Operational reports](https://github.com/michelljk/be_boilerplate_is_2026/blob/main/src/reports/reports.controller.ts): `src/reports/reports.controller.ts`
- [Report calculations](https://github.com/michelljk/be_boilerplate_is_2026/blob/main/src/reports/reports.service.ts): `src/reports/reports.service.ts`

### Other components

- **API user**
- **PostgreSQL**

## Connections

- API user → Member access: calls API (evidence: `README.md`)
- Member access → Member search: searches members (evidence: `src/access/controllers/access.controller.ts`)
- Member access → Check-in service: registers check-in (evidence: `src/access/controllers/access.controller.ts`)
- Memberships → Member search: membership status
- API user → Session reviews: calls API (evidence: `README.md`)
- Session reviews → Review rules: delegates (evidence: `src/reviews/controllers/reviews.controller.ts`)
- Review rules → Review queries: queries reviews (evidence: `src/reviews/services/reviews.service.ts`)
- Review queries → Prisma access: queries database (evidence: `src/reviews/repositories/reviews.repository.ts`)
- API user → Operational reports: calls API (evidence: `README.md`)
- Operational reports → Report calculations: requests reports (evidence: `src/reports/reports.controller.ts`)
- Gym desk workflows → Notifications: sends notices (evidence: `src/gkds/services/gkds.service.ts`)
- Personal sessions → Notifications: uses notifications (evidence: `src/personal-sessions/repositories/personal-sessions.repository.ts`)
- Personal sessions → Memberships: checks eligibility (evidence: `src/personal-sessions/repositories/personal-sessions.repository.ts`)
- Prisma access → PostgreSQL: connects (evidence: `README.md`)
