How ampexqt/junta works
Junta is an environmental-event platform for participants, organizers, and administrators. The central workflow is event creation and moderation, followed by volunteer discovery and joining, event completion, ratings, and XP/organizer rewards. Its frontend provides map, calendar, participation, notification, KYC, and administration experiences; an Express API handles authentication, uploads, and event operations, with Firebase-backed state. The graph combines sampled imports and calls with explicitly documented README flows; some frontend-to-API and unsampled subsystem links are therefore documented or left unasserted.
Main entry points: events.ts Event API · App.tsx Route application · auth.ts Authentication and KYC API · index.ts Express API router
Components 25
Web application
- Route application
src/App.tsx - Registration and login
src/app/auth/RegisterPage.tsx - Session and profile
src/features/auth/AuthContext.tsx
Event lifecycle
- Event discovery
src/app/events/EventsPage.tsx - Live event map
src/app/events/MapViewPage.tsx - Event calendar
src/app/events/SchedulePage.tsx - Event creation
src/features/events/components/CreateEventModal.tsx - Organizer management
src/app/organizer/OrganizerMyEventsPage.tsx - Participation tracking
src/app/user/MyParticipationPage.tsx - Event and participant ratings
src/features/events/components/RateEventModal.tsx
Identity and trust
- Event and user administration
src/app/admin/EventApprovalsPage.tsx - Identity review
src/app/admin/UserVerificationPage.tsx
API and services
- Express API router
server/index.ts - Authentication and KYC API
server/routes/auth.ts - Event API
server/routes/events.ts - Upload API
server/routes/upload.ts - JWT access control
server/middleware/auth.ts - XP and organizer rewards
server/services/gamification.ts - Notifications
server/services/notifications.ts
Persistence and integrations
- Client Firebase services
src/lib/firebase.ts - Firebase Admin services
server/config/firebase-admin.ts - Image storage
server/config/cloudinary.ts - Face++ verification
- Email delivery
server/config/mailer.ts
Other components
- Platform users
Connections 34
- Platform users → Route application: uses
- Route application → Registration and login: routes to
src/App.tsx - Route application → Session and profile: provides session
src/App.tsx - Route application → Event discovery: routes to
src/App.tsx - Route application → Live event map: routes to
src/App.tsx - Route application → Event calendar: routes to
src/App.tsx - Route application → Participation tracking: routes to
src/App.tsx - Route application → Event and user administration: routes to
src/App.tsx - Registration and login → Authentication and KYC API: registers through
- Event creation → Event API: submits events
- Organizer management → Event API: manages events
- Event and user administration → Event API: approves events
- Event discovery → Event API: loads events
- Live event map → Event API: shows events
- Event calendar → Event API: shows schedule
- Participation tracking → Event API: joins events
- Event and participant ratings → Event API: submits ratings
- Identity review → Authentication and KYC API: reviews identity
- Express API router → Authentication and KYC API: mounts route
server/index.ts - Express API router → Event API: mounts route
server/index.ts - Express API router → Upload API: mounts route
server/index.ts - Express API router → JWT access control: protects endpoint
server/index.ts - Authentication and KYC API → Email delivery: sends email
server/routes/auth.ts - Authentication and KYC API → XP and organizer rewards: grants registration rewards
server/routes/auth.ts - Authentication and KYC API → Image storage: uploads KYC images
server/routes/auth.ts - Authentication and KYC API → Face++ verification: checks identity
server/routes/auth.ts - Authentication and KYC API → Firebase Admin services: persists profiles
server/routes/auth.ts - Event API → Firebase Admin services: reads and writes
server/routes/events.ts - Event API → XP and organizer rewards: awards event rewards
server/routes/events.ts - Event API → Notifications: creates alerts
server/routes/events.ts - XP and organizer rewards → Firebase Admin services: updates reward state
server/services/gamification.ts - XP and organizer rewards → Notifications: notifies milestones
server/services/gamification.ts - Session and profile → Client Firebase services: subscribes to profile
src/features/auth/AuthContext.tsx - Platform users → Image storage: stores profile images