# hrid1402/gymsystem architecture

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

## Overview

GymSystem is a gym-management web application. Members and staff use the React dashboard to manage accounts, plans, memberships and payments; access workflows issue QR tokens or record manual/facial entry and attendance. The Express API enforces authentication and roles, applies domain operations, and persists records in PostgreSQL/Supabase. Payment processing can trigger electronic invoicing through APIsPERU/SUNAT. The README documents these integrations; several implementation modules are unsampled, so their internal links are omitted or marked unverified.

Main entry points: [`backend/src/routes/index.js`](https://github.com/hrid1402/gymsystem/blob/main/backend/src/routes/index.js) (API routes), [`backend/src/controllers/payments.controller.js`](https://github.com/hrid1402/gymsystem/blob/main/backend/src/controllers/payments.controller.js) (Payment processing), [`frontend/src/api/client.js`](https://github.com/hrid1402/gymsystem/blob/main/frontend/src/api/client.js) (API client), [`backend/src/db/index.js`](https://github.com/hrid1402/gymsystem/blob/main/backend/src/db/index.js) (PostgreSQL / Supabase)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_router["App routes<br/>[AppRouter.jsx]"]
  node_authui["Session context<br/>[AuthContext.jsx]"]
  node_clients["Client management<br/>[Clientes.jsx]"]
  node_membershipsui["Memberships UI<br/>[Membresias.jsx]"]
  node_accessui["Access screens<br/>[Acceso.jsx]"]
  node_manualui["Manual access<br/>[AccesoManual.jsx]"]
  node_facialui["Facial access<br/>[ControlFacial.jsx]"]
  node_dashboard["Dashboard views<br/>[Estadisticas.jsx]"]
  node_apiclient["API client<br/>[client.js]"]
  node_authapi["Auth API<br/>[authApi.js]"]
  node_usersapi["Users API<br/>[usersApi.js]"]
  node_membershipsapi["Memberships API<br/>[membershipsApi.js]"]
  node_paymentsapi["Payments API<br/>[paymentsApi.js]"]
end

subgraph group_api["Backend API"]
  node_api["Express API<br/>[app.js]"]
  node_routes["API routes<br/>[index.js]"]
  node_auth["Authentication<br/>[auth.controller.js]"]
end

subgraph group_domain["Gym operations"]
  node_access["Access control"]
  node_users["User management"]
  node_plans["Plan management"]
  node_payments["Payment processing"]
  node_invoices["Invoice issuing"]
end

subgraph group_platform["Persistence and integrations"]
  node_attendance[("Attendance records<br/>[attendances.js]")]
  node_membershipdata[("Membership records<br/>[memberships.js]")]
  node_userdata[("User records<br/>[users.js]")]
  node_plandata[("Plan records<br/>[plans.js]")]
  node_paymentdata[("Payment records<br/>[payments.js]")]
  node_invoicedata[("Invoice records<br/>[invoices.js]")]
  node_postgres[("PostgreSQL / Supabase<br/>[index.js]")]
end

node_member(("Member or staff"))
node_culqi["Culqi"]
node_apisperu["APISPERU / SUNAT"]

node_member -->|"uses"| node_router
node_router -->|"loads session"| node_authui
node_authui -->|"checks session"| node_authapi
node_clients -->|"manages clients"| node_usersapi
node_clients -->|"loads memberships"| node_membershipsapi
node_membershipsui -->|"manages memberships"| node_membershipsapi
node_membershipsui -->|"starts payment"| node_paymentsapi
node_accessui -.->|"requests access"| node_apiclient
node_manualui -.->|"requests access"| node_apiclient
node_facialui -.->|"submits face match"| node_apiclient
node_dashboard -.->|"loads statistics"| node_apiclient
node_authapi -->|"uses client"| node_apiclient
node_apiclient -.->|"sends HTTP requests"| node_api
node_api -->|"mounts routes"| node_routes
node_routes -.->|"routes auth"| node_auth
node_routes -->|"routes access"| node_access
node_routes -->|"routes users"| node_users
node_routes -->|"routes plans"| node_plans
node_routes -->|"routes payments"| node_payments
node_access -->|"looks up users"| node_userdata
node_access -->|"checks membership"| node_membershipdata
node_access -->|"records entry"| node_attendance
node_auth -->|"loads profile"| node_userdata
node_users -->|"manages users"| node_userdata
node_plans -->|"manages plans"| node_plandata
node_payments -->|"checks plan"| node_plandata
node_payments -->|"checks membership"| node_membershipdata
node_payments -->|"records payment"| node_paymentdata
node_payments -->|"issues invoice"| node_invoices
node_payments -.->|"charges online"| node_culqi
node_invoices -->|"stores invoice"| node_invoicedata
node_invoices -->|"requests e-invoice"| node_apisperu
node_userdata -->|"queries database"| node_postgres
node_membershipdata -->|"queries database"| node_postgres
node_attendance -.->|"queries database"| node_postgres
node_plandata -.->|"queries database"| node_postgres
node_paymentdata -.->|"queries database"| node_postgres
node_invoicedata -.->|"queries database"| node_postgres

click node_router "https://github.com/hrid1402/gymsystem/blob/main/frontend/src/routes/AppRouter.jsx"
click node_authui "https://github.com/hrid1402/gymsystem/blob/main/frontend/src/context/AuthContext.jsx"
click node_clients "https://github.com/hrid1402/gymsystem/blob/main/frontend/src/pages/dashboard/Clientes.jsx"
click node_membershipsui "https://github.com/hrid1402/gymsystem/blob/main/frontend/src/pages/dashboard/Membresias.jsx"
click node_accessui "https://github.com/hrid1402/gymsystem/blob/main/frontend/src/pages/dashboard/Acceso.jsx"
click node_manualui "https://github.com/hrid1402/gymsystem/blob/main/frontend/src/pages/dashboard/AccesoManual.jsx"
click node_facialui "https://github.com/hrid1402/gymsystem/blob/main/frontend/src/pages/dashboard/ControlFacial.jsx"
click node_dashboard "https://github.com/hrid1402/gymsystem/blob/main/frontend/src/pages/dashboard/Estadisticas.jsx"
click node_apiclient "https://github.com/hrid1402/gymsystem/blob/main/frontend/src/api/client.js"
click node_authapi "https://github.com/hrid1402/gymsystem/blob/main/frontend/src/api/authApi.js"
click node_usersapi "https://github.com/hrid1402/gymsystem/blob/main/frontend/src/api/usersApi.js"
click node_membershipsapi "https://github.com/hrid1402/gymsystem/blob/main/frontend/src/api/membershipsApi.js"
click node_paymentsapi "https://github.com/hrid1402/gymsystem/blob/main/frontend/src/api/paymentsApi.js"
click node_api "https://github.com/hrid1402/gymsystem/blob/main/backend/src/app.js"
click node_routes "https://github.com/hrid1402/gymsystem/blob/main/backend/src/routes/index.js"
click node_auth "https://github.com/hrid1402/gymsystem/blob/main/backend/src/controllers/auth.controller.js"
click node_access "https://github.com/hrid1402/gymsystem/blob/main/backend/src/controllers/access.controller.js"
click node_users "https://github.com/hrid1402/gymsystem/blob/main/backend/src/controllers/users.controller.js"
click node_plans "https://github.com/hrid1402/gymsystem/blob/main/backend/src/controllers/plans.controller.js"
click node_payments "https://github.com/hrid1402/gymsystem/blob/main/backend/src/controllers/payments.controller.js"
click node_invoices "https://github.com/hrid1402/gymsystem/blob/main/backend/src/services/invoices.service.js"
click node_attendance "https://github.com/hrid1402/gymsystem/blob/main/backend/src/db/attendances.js"
click node_membershipdata "https://github.com/hrid1402/gymsystem/blob/main/backend/src/db/memberships.js"
click node_userdata "https://github.com/hrid1402/gymsystem/blob/main/backend/src/db/users.js"
click node_plandata "https://github.com/hrid1402/gymsystem/blob/main/backend/src/db/plans.js"
click node_paymentdata "https://github.com/hrid1402/gymsystem/blob/main/backend/src/db/payments.js"
click node_invoicedata "https://github.com/hrid1402/gymsystem/blob/main/backend/src/db/invoices.js"
click node_postgres "https://github.com/hrid1402/gymsystem/blob/main/backend/src/db/index.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_router,node_authui,node_clients,node_membershipsui,node_accessui,node_manualui,node_facialui,node_dashboard,node_apiclient,node_authapi,node_usersapi,node_membershipsapi,node_paymentsapi toneBlue
class node_api,node_routes,node_auth toneAmber
class node_access,node_users,node_plans,node_payments,node_invoices,node_apisperu toneMint
class node_attendance,node_membershipdata,node_userdata,node_plandata,node_paymentdata,node_invoicedata,node_postgres toneRose
class node_member,node_culqi toneIndigo
```

## Components

### Web application

- [App routes](https://github.com/hrid1402/gymsystem/blob/main/frontend/src/routes/AppRouter.jsx): `frontend/src/routes/AppRouter.jsx`
- [Session context](https://github.com/hrid1402/gymsystem/blob/main/frontend/src/context/AuthContext.jsx): `frontend/src/context/AuthContext.jsx`
- [Client management](https://github.com/hrid1402/gymsystem/blob/main/frontend/src/pages/dashboard/Clientes.jsx): `frontend/src/pages/dashboard/Clientes.jsx`
- [Memberships UI](https://github.com/hrid1402/gymsystem/blob/main/frontend/src/pages/dashboard/Membresias.jsx): `frontend/src/pages/dashboard/Membresias.jsx`
- [Access screens](https://github.com/hrid1402/gymsystem/blob/main/frontend/src/pages/dashboard/Acceso.jsx): `frontend/src/pages/dashboard/Acceso.jsx`
- [Manual access](https://github.com/hrid1402/gymsystem/blob/main/frontend/src/pages/dashboard/AccesoManual.jsx): `frontend/src/pages/dashboard/AccesoManual.jsx`
- [Facial access](https://github.com/hrid1402/gymsystem/blob/main/frontend/src/pages/dashboard/ControlFacial.jsx): `frontend/src/pages/dashboard/ControlFacial.jsx`
- [Dashboard views](https://github.com/hrid1402/gymsystem/blob/main/frontend/src/pages/dashboard/Estadisticas.jsx): `frontend/src/pages/dashboard/Estadisticas.jsx`
- [API client](https://github.com/hrid1402/gymsystem/blob/main/frontend/src/api/client.js): `frontend/src/api/client.js`
- [Auth API](https://github.com/hrid1402/gymsystem/blob/main/frontend/src/api/authApi.js): `frontend/src/api/authApi.js`
- [Users API](https://github.com/hrid1402/gymsystem/blob/main/frontend/src/api/usersApi.js): `frontend/src/api/usersApi.js`
- [Memberships API](https://github.com/hrid1402/gymsystem/blob/main/frontend/src/api/membershipsApi.js): `frontend/src/api/membershipsApi.js`
- [Payments API](https://github.com/hrid1402/gymsystem/blob/main/frontend/src/api/paymentsApi.js): `frontend/src/api/paymentsApi.js`

### Backend API

- [Express API](https://github.com/hrid1402/gymsystem/blob/main/backend/src/app.js): `backend/src/app.js`
- [API routes](https://github.com/hrid1402/gymsystem/blob/main/backend/src/routes/index.js): `backend/src/routes/index.js`
- [Authentication](https://github.com/hrid1402/gymsystem/blob/main/backend/src/controllers/auth.controller.js): `backend/src/controllers/auth.controller.js`

### Gym operations

- [Access control](https://github.com/hrid1402/gymsystem/blob/main/backend/src/controllers/access.controller.js): `backend/src/controllers/access.controller.js`
- [User management](https://github.com/hrid1402/gymsystem/blob/main/backend/src/controllers/users.controller.js): `backend/src/controllers/users.controller.js`
- [Plan management](https://github.com/hrid1402/gymsystem/blob/main/backend/src/controllers/plans.controller.js): `backend/src/controllers/plans.controller.js`
- [Payment processing](https://github.com/hrid1402/gymsystem/blob/main/backend/src/controllers/payments.controller.js): `backend/src/controllers/payments.controller.js`
- [Invoice issuing](https://github.com/hrid1402/gymsystem/blob/main/backend/src/services/invoices.service.js): `backend/src/services/invoices.service.js`

### Persistence and integrations

- [Attendance records](https://github.com/hrid1402/gymsystem/blob/main/backend/src/db/attendances.js): `backend/src/db/attendances.js`
- [Membership records](https://github.com/hrid1402/gymsystem/blob/main/backend/src/db/memberships.js): `backend/src/db/memberships.js`
- [User records](https://github.com/hrid1402/gymsystem/blob/main/backend/src/db/users.js): `backend/src/db/users.js`
- [Plan records](https://github.com/hrid1402/gymsystem/blob/main/backend/src/db/plans.js): `backend/src/db/plans.js`
- [Payment records](https://github.com/hrid1402/gymsystem/blob/main/backend/src/db/payments.js): `backend/src/db/payments.js`
- [Invoice records](https://github.com/hrid1402/gymsystem/blob/main/backend/src/db/invoices.js): `backend/src/db/invoices.js`
- [PostgreSQL / Supabase](https://github.com/hrid1402/gymsystem/blob/main/backend/src/db/index.js): `backend/src/db/index.js`

### Other components

- **Member or staff**
- **Culqi**
- **APISPERU / SUNAT**

## Connections

- Member or staff → App routes: uses (evidence: `frontend/src/routes/AppRouter.jsx`)
- App routes → Session context: loads session (evidence: `frontend/src/App.jsx`)
- Session context → Auth API: checks session (evidence: `frontend/src/context/AuthContext.jsx`)
- Client management → Users API: manages clients (evidence: `frontend/src/pages/dashboard/Clientes.jsx`)
- Client management → Memberships API: loads memberships (evidence: `frontend/src/pages/dashboard/Clientes.jsx`)
- Memberships UI → Memberships API: manages memberships (evidence: `frontend/src/pages/dashboard/Membresias.jsx`)
- Memberships UI → Payments API: starts payment (evidence: `frontend/src/pages/dashboard/Membresias.jsx`)
- Access screens → API client: requests access
- Manual access → API client: requests access
- Facial access → API client: submits face match
- Dashboard views → API client: loads statistics
- Auth API → API client: uses client (evidence: `frontend/src/api/authApi.js`)
- API client → Express API: sends HTTP requests
- Express API → API routes: mounts routes (evidence: `backend/src/app.js`)
- API routes → Authentication: routes auth
- API routes → Access control: routes access
- API routes → User management: routes users
- API routes → Plan management: routes plans
- API routes → Payment processing: routes payments
- Access control → User records: looks up users (evidence: `backend/src/controllers/access.controller.js`)
- Access control → Membership records: checks membership (evidence: `backend/src/controllers/access.controller.js`)
- Access control → Attendance records: records entry (evidence: `backend/src/controllers/access.controller.js`)
- Authentication → User records: loads profile (evidence: `backend/src/controllers/auth.controller.js`)
- User management → User records: manages users (evidence: `backend/src/controllers/users.controller.js`)
- Plan management → Plan records: manages plans (evidence: `backend/src/controllers/plans.controller.js`)
- Payment processing → Plan records: checks plan (evidence: `backend/src/controllers/payments.controller.js`)
- Payment processing → Membership records: checks membership (evidence: `backend/src/controllers/payments.controller.js`)
- Payment processing → Payment records: records payment (evidence: `backend/src/controllers/payments.controller.js`)
- Payment processing → Invoice issuing: issues invoice (evidence: `backend/src/controllers/payments.controller.js`)
- Payment processing → Culqi: charges online
- Invoice issuing → Invoice records: stores invoice (evidence: `backend/src/services/invoices.service.js`)
- Invoice issuing → APISPERU / SUNAT: requests e-invoice (evidence: `backend/src/services/invoices.service.js`)
- User records → PostgreSQL / Supabase: queries database (evidence: `backend/src/db/users.js`)
- Membership records → PostgreSQL / Supabase: queries database (evidence: `backend/src/db/memberships.js`)
- Attendance records → PostgreSQL / Supabase: queries database
- Plan records → PostgreSQL / Supabase: queries database
- Payment records → PostgreSQL / Supabase: queries database
- Invoice records → PostgreSQL / Supabase: queries database
