How malek-shammout/hamak-ai-robotics-club-platform works
HMK is a bilingual, role-governed club operations platform. Members discover opportunities, apply and complete screening, then progress through learning, equipment custody, clearance, and certification; staff administer those workflows alongside consultations and published content. The graph emphasizes that member journey and major operational branches. README documents database-enforced authorization and storage behavior; sampled files show selected action, query, and certificate routes, so unsampled feature wiring is not inferred.
Main entry points: [locale] Localized app routes · page.tsx Staff workspace · lms/actions.ts Learning and attendance · requisitions/actions.ts Hardware requisitions
Components 24
Bilingual experience
- Localized app routes
src/app/[locale] - Locale routing
src/i18n/routing.ts - Public discovery
src/lib/queries/public.ts - Registration and login
src/app/[locale]/register/page.tsx
Admissions and learning
- Application workflow
src/lib/admissions/actions.ts - Readiness scoring
src/lib/admissions/readiness-actions.ts - Offers and allocation
src/lib/admissions/staff-actions.ts - Screening and grading
src/lib/assessment/actions.ts - Learning and attendance
src/lib/lms/actions.ts - Certificate issuance
src/lib/certificates/issue-document.ts - Certificate delivery
src/app/api/certificates/[id]/document/route.ts
Club operations
- Consultations
src/lib/consultations/actions.ts - Hardware requisitions
src/lib/requisitions/actions.ts - Custody and liabilities
src/lib/logistics/actions.ts - Completion clearance
src/lib/clearance/actions.ts - Editorial workflow
src/lib/authoring/actions.ts - Staff workspace
src/app/[locale]/staff/page.tsx
Identity and data
- Authentication actions
src/lib/auth/actions.ts - Email confirmation
src/app/auth/callback/route.ts - PostgreSQL and RPC
- RLS-bound server client
src/lib/supabase/server.ts
Other components
- Member / visitor
- Supabase Auth
- Private certificate storage
Connections 38
- Member / visitor → Localized app routes: browses / submits
- Localized app routes → Locale routing: resolves locale
- Localized app routes → Public discovery: loads discovery
- Localized app routes → Registration and login: registers / signs in
- Registration and login → Authentication actions: invokes
- Authentication actions → Supabase Auth: authenticates
- Email confirmation → Supabase Auth: exchanges code
- Email confirmation → Localized app routes: redirects
- Localized app routes → Application workflow: submits application
- Application workflow → PostgreSQL and RPC: writes application
- Application workflow → Readiness scoring: requests scoring
- Readiness scoring → PostgreSQL and RPC: computes readiness
- Staff workspace → Offers and allocation: runs allocation
- Offers and allocation → PostgreSQL and RPC: allocates seats
- Localized app routes → Screening and grading: takes screening
- Screening and grading → PostgreSQL and RPC: stores attempts
- Localized app routes → Learning and attendance: tracks learning
- Learning and attendance → PostgreSQL and RPC: records completion
- Learning and attendance → Certificate issuance: qualifies for certificate
- Certificate issuance → PostgreSQL and RPC: records certificate
- Certificate issuance → Private certificate storage: stores document
- Localized app routes → Certificate delivery: requests document
- Certificate delivery → RLS-bound server client: checks access
- RLS-bound server client → PostgreSQL and RPC: reads certificate
- Certificate delivery → Private certificate storage: mints signed URL
- Localized app routes → Consultations: requests consultation
- Consultations → PostgreSQL and RPC: updates requests
- Localized app routes → Hardware requisitions: requests equipment
- Hardware requisitions → PostgreSQL and RPC: reserves stock
- Hardware requisitions → Custody and liabilities: supports custody
- Custody and liabilities → PostgreSQL and RPC: records custody
- Completion clearance → PostgreSQL and RPC: checks preconditions
- Learning and attendance → Completion clearance: provides completion state
- Staff workspace → Editorial workflow: manages publication
- Editorial workflow → PostgreSQL and RPC: writes transitions
- Staff workspace → Consultations: triages requests
- Staff workspace → Hardware requisitions: reviews requests
- RLS-bound server client → PostgreSQL and RPC: queries with RLS