How hrid1402/gymsystem works
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: routes/index.js API routes · payments.controller.js Payment processing · client.js API client · db/index.js PostgreSQL / Supabase
Components 31
Web application
- App routes
frontend/src/routes/AppRouter.jsx - Session context
frontend/src/context/AuthContext.jsx - Client management
frontend/src/pages/dashboard/Clientes.jsx - Memberships UI
frontend/src/pages/dashboard/Membresias.jsx - Access screens
frontend/src/pages/dashboard/Acceso.jsx - Manual access
frontend/src/pages/dashboard/AccesoManual.jsx - Facial access
frontend/src/pages/dashboard/ControlFacial.jsx - Dashboard views
frontend/src/pages/dashboard/Estadisticas.jsx - API client
frontend/src/api/client.js - Auth API
frontend/src/api/authApi.js - Users API
frontend/src/api/usersApi.js - Memberships API
frontend/src/api/membershipsApi.js - Payments API
frontend/src/api/paymentsApi.js
Backend API
- Express API
backend/src/app.js - API routes
backend/src/routes/index.js - Authentication
backend/src/controllers/auth.controller.js
Gym operations
- Access control
backend/src/controllers/access.controller.js - User management
backend/src/controllers/users.controller.js - Plan management
backend/src/controllers/plans.controller.js - Payment processing
backend/src/controllers/payments.controller.js - Invoice issuing
backend/src/services/invoices.service.js
Persistence and integrations
- Attendance records
backend/src/db/attendances.js - Membership records
backend/src/db/memberships.js - User records
backend/src/db/users.js - Plan records
backend/src/db/plans.js - Payment records
backend/src/db/payments.js - Invoice records
backend/src/db/invoices.js - PostgreSQL / Supabase
backend/src/db/index.js
Other components
- Member or staff
- Culqi
- APISPERU / SUNAT
Connections 38
- Member or staff → App routes: uses
frontend/src/routes/AppRouter.jsx - App routes → Session context: loads session
frontend/src/App.jsx - Session context → Auth API: checks session
frontend/src/context/AuthContext.jsx - Client management → Users API: manages clients
frontend/src/pages/dashboard/Clientes.jsx - Client management → Memberships API: loads memberships
frontend/src/pages/dashboard/Clientes.jsx - Memberships UI → Memberships API: manages memberships
frontend/src/pages/dashboard/Membresias.jsx - Memberships UI → Payments API: starts payment
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
frontend/src/api/authApi.js - API client → Express API: sends HTTP requests
- Express API → API routes: mounts routes
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
backend/src/controllers/access.controller.js - Access control → Membership records: checks membership
backend/src/controllers/access.controller.js - Access control → Attendance records: records entry
backend/src/controllers/access.controller.js - Authentication → User records: loads profile
backend/src/controllers/auth.controller.js - User management → User records: manages users
backend/src/controllers/users.controller.js - Plan management → Plan records: manages plans
backend/src/controllers/plans.controller.js - Payment processing → Plan records: checks plan
backend/src/controllers/payments.controller.js - Payment processing → Membership records: checks membership
backend/src/controllers/payments.controller.js - Payment processing → Payment records: records payment
backend/src/controllers/payments.controller.js - Payment processing → Invoice issuing: issues invoice
backend/src/controllers/payments.controller.js - Payment processing → Culqi: charges online
- Invoice issuing → Invoice records: stores invoice
backend/src/services/invoices.service.js - Invoice issuing → APISPERU / SUNAT: requests e-invoice
backend/src/services/invoices.service.js - User records → PostgreSQL / Supabase: queries database
backend/src/db/users.js - Membership records → PostgreSQL / Supabase: queries database
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