How ryuo-00/fittrack-gym-management-system works
FitTrack is a gym-administration web application. An administrator signs in, then uses protected pages to manage members, trainers, plans, subscriptions and renewals, payments, and attendance; dashboard and date-filtered reports provide operational summaries. The React client sends cookie-authenticated requests to Express, whose routes validate and dispatch to controllers and PostgreSQL access. The README also documents SQL-backed views, procedures, and audit/eligibility triggers, but their files are absent from the supplied tree, so they are represented only as database capabilities. Edges reflect excerpts, indexed references, or README statements; unsampled wiring is omitted.
Main entry points: App.tsx App routing · api.ts Business API routes · pool.ts PostgreSQL access · auth.ts Authentication routes
Components 27
Admin client
- App routing
client/src/App.tsx - Admin layout
client/src/components/AppLayout.tsx - Dashboard
client/src/pages/DashboardPage.tsx - Members
client/src/pages/MembersPage.tsx - Trainers
client/src/pages/TrainersPage.tsx - Membership plans
client/src/pages/PlansPage.tsx - Subscriptions
client/src/pages/SubscriptionsPage.tsx - Payments
client/src/pages/PaymentsPage.tsx - Attendance
client/src/pages/AttendancePage.tsx - Reports
client/src/pages/ReportsPage.tsx - Settings
client/src/pages/SettingsPage.tsx - API client
client/src/lib/api.ts - UI primitives
client/src/components/ui
API and domain
- Business API routes
server/src/routes/api.ts - Authentication routes
server/src/routes/auth.ts - Authentication
server/src/controllers/auth.ts - Catalog operations
server/src/controllers/catalog.ts - Subscription operations
server/src/controllers/subscriptions.ts - Payment operations
server/src/controllers/payments.ts - Attendance operations
server/src/controllers/attendance.ts - Dashboard queries
server/src/controllers/dashboard.ts - Report queries
server/src/controllers/reports.ts
Shared runtime
- Cookie sessions
server/src/middleware/auth.ts - Request validation
server/src/validators/index.ts
Persistence
- PostgreSQL access
server/src/database/pool.ts - PostgreSQL
Other components
- Administrator
Connections 34
- Administrator → App routing: uses
client/src/App.tsx - App routing → Admin layout: renders
client/src/App.tsx - App routing → API client: checks session
client/src/App.tsx - App routing → Dashboard: routes to
client/src/App.tsx - App routing → Members: routes to
client/src/App.tsx - App routing → Trainers: routes to
client/src/App.tsx - App routing → Membership plans: routes to
client/src/App.tsx - App routing → Subscriptions: routes to
client/src/App.tsx - App routing → Payments: routes to
client/src/App.tsx - App routing → Attendance: routes to
client/src/App.tsx - App routing → Reports: routes to
client/src/App.tsx - App routing → Settings: routes to
client/src/App.tsx - Administrator → Authentication routes: signs in
README.md - API client → Business API routes: sends API requests
- Business API routes → Catalog operations: dispatches
server/src/routes/api.ts - Business API routes → Subscription operations: dispatches
server/src/routes/api.ts - Business API routes → Payment operations: dispatches
server/src/routes/api.ts - Business API routes → Attendance operations: dispatches
server/src/routes/api.ts - Business API routes → Dashboard queries: dispatches
server/src/routes/api.ts - Business API routes → Report queries: dispatches
server/src/routes/api.ts - Authentication routes → Authentication: dispatches
server/src/routes/auth.ts - Business API routes → Cookie sessions: protects routes
server/src/routes/api.ts - Authentication routes → Cookie sessions: checks sessions
server/src/routes/auth.ts - Business API routes → Request validation: validates input
server/src/routes/api.ts - Authentication routes → Request validation: validates input
server/src/routes/auth.ts - Authentication → PostgreSQL access: queries
server/src/controllers/auth.ts - Dashboard queries → PostgreSQL access: queries
server/src/controllers/dashboard.ts - Payment operations → PostgreSQL access: queries
server/src/controllers/payments.ts - Subscription operations → PostgreSQL access: queries
server/src/controllers/subscriptions.ts - Report queries → PostgreSQL access: queries
server/src/controllers/reports.ts - Catalog operations → PostgreSQL access: queries
- Attendance operations → PostgreSQL access: queries
- PostgreSQL access → PostgreSQL: reads and writes
server/src/database/pool.ts - PostgreSQL → Administrator: stores operations data
README.md