How ceezey/pathways works
PATHWAYS is a project information management platform for humanitarian and development organizations. Staff authenticate into a role- and workspace-scoped application, manage projects and delivery activities, maintain beneficiary profiles and journeys, configure metadata-driven collection, then monitor indicators and review analytics, alerts, and reports. A controlled public tracker exposes published project information. The graph preserves these distinct product stages and the rule-evaluation layer. README capabilities guide the broader map; sampled controllers confirm selected service calls, while unsampled module wiring is not inferred.
Main entry points: layout.tsx PATHWAYS workspace · activities.controller.ts Activity operations · storage.service.ts Private file access · login-form.tsx Sign-in workflows
Components 21
Access and workspace
- PATHWAYS workspace
apps/web/src/app/(dashboard)/layout.tsx - Sign-in workflows
apps/web/src/features/auth/login-form.tsx - Authentication API
apps/api/src/modules/auth/auth.controller.ts - Token verification
apps/api/src/modules/auth/token-auth.service.ts
Project delivery
- Projects and activities
apps/api/src/modules/projects/projects.service.ts - Activity operations
apps/api/src/modules/activities/activities.controller.ts - Beneficiary profiles
apps/api/src/modules/beneficiaries/beneficiaries.service.ts - Beneficiary journeys
apps/api/src/modules/participants/participants.service.ts - Budgets and expenses
apps/api/src/modules/finance/finance.controller.ts
Collection and monitoring
- Form metadata
apps/api/src/modules/metadata/metadata.service.ts - Data imports
apps/api/src/modules/imports/imports.service.ts - Indicators
apps/api/src/modules/indicators/indicators.service.ts
Decision and reporting
- Dashboards and analytics
apps/api/src/modules/dashboards/analytics.service.ts - Rule evaluation
apps/api/src/modules/rules/rule-engine.ts - Reporting
apps/api/src/modules/reports/reports.service.ts - Public project tracker
apps/api/src/modules/public/public.service.ts
Platform services
- Supabase Auth
- PostgreSQL
- Supabase Storage
- Private file access
apps/api/src/modules/storage/storage.service.ts
Other components
- Organization staff
Connections 21
- Organization staff → PATHWAYS workspace: uses workspace
- Organization staff → Sign-in workflows: signs in
- Sign-in workflows → Authentication API: requests access
- Authentication API → Token verification: verifies token
- Token verification → Supabase Auth: verifies identity
- PATHWAYS workspace → Projects and activities: manages projects
- PATHWAYS workspace → Activity operations: records delivery
- Activity operations → Projects and activities: uses project scope
- PATHWAYS workspace → Beneficiary profiles: manages profiles
- PATHWAYS workspace → Beneficiary journeys: records journeys
- PATHWAYS workspace → Form metadata: configures forms
- PATHWAYS workspace → Data imports: prepares imports
- PATHWAYS workspace → Indicators: tracks indicators
- PATHWAYS workspace → Budgets and expenses: manages finances
- PATHWAYS workspace → Dashboards and analytics: reviews monitoring
- PATHWAYS workspace → Rule evaluation: configures decision support
- PATHWAYS workspace → Reporting: creates reports
- PATHWAYS workspace → Public project tracker: views published projects
- Activity operations → Private file access: inspects proof
- Private file access → Supabase Storage: reads private files
- Budgets and expenses → Private file access: handles receipts