How ashutosh-vaishnav/ngo-ashu works
This is an NGO management application with a React client and Express API. Users authenticate and enter role-protected dashboards to manage campaigns, donations, people, events, reports, and settings; donors can initiate payments and review donation history. The donation path is the best-evidenced user-to-result workflow: the client donation page uses donation services, while the API controller delegates donation actions to its service. The repository index documents additional management areas, but their detailed call paths were not sampled, so those links are shown only where supported.
Main entry points: AppRoutes.jsx Role-based routes · routes API routes · App.jsx Web app · authRoutes.js Auth routes
Components 27
Web client
- Web app
client/src/App.jsx - Role-based routes
client/src/routes/AppRoutes.jsx - Auth state
client/src/context/AuthContext.jsx - Auth client
client/src/services/authService.js - Donations page
client/src/pages/donations/DonationsPage.jsx - Reports page
client/src/pages/reports/ReportsPage.jsx - Settings page
client/src/pages/settings/SettingsPage.jsx - Entity pages
client/src/pages - API client
client/src/services/api.js - Donation service client
client/src/services/donationService.js
API and access
- Express app
server/src/app.js - API routes
server/src/routes - Auth routes
server/src/routes/authRoutes.js - Auth middleware
server/src/middleware/auth.js - Auth controller
server/src/controllers/authController.js - Donation routes
server/src/routes/donationRoutes.js
Management domains
- Auth service
server/src/services/authService.js - Donation controller
server/src/controllers/donationController.js - Donation service
server/src/services/donationService.js - Management services
server/src/services - Report service
server/src/services/reportService.js - Settings controller
server/src/controllers/settingsController.js
Data and payments
- User model
server/src/models/User.js - Donation models
server/src/models - Payment service
server/src/services/paymentService.js - Database setup
server/src/config/database.js
Other components
- User
Connections 28
- User → Web app: uses
- Web app → Role-based routes: renders
client/src/App.jsx - Web app → Auth state: provides auth
client/src/App.jsx - Role-based routes → Donations page: routes to
client/src/routes/AppRoutes.jsx - Role-based routes → Reports page: routes to
client/src/routes/AppRoutes.jsx - Role-based routes → Settings page: routes to
client/src/routes/AppRoutes.jsx - Role-based routes → Entity pages: routes to
client/src/routes/AppRoutes.jsx - Auth state → Auth client: calls
client/src/context/AuthContext.jsx - Auth client → API client: uses
client/src/services/authService.js - Donations page → Donation service client: uses
client/src/pages/donations/DonationsPage.jsx - Donation service client → API client: uses
client/src/services/donationService.js - API client → API routes: requests
- Express app → API routes: mounts
server/src/app.js - API routes → Auth routes: registers
- Auth routes → Auth controller: dispatches
server/src/routes/authRoutes.js - Auth routes → Auth middleware: applies
server/src/routes/authRoutes.js - Auth controller → Auth service: delegates to
- Auth service → User model: reads and writes
server/src/services/authService.js - API routes → Donation routes: registers
- Donation routes → Donation controller: dispatches
server/src/routes/donationRoutes.js - Donation routes → Auth middleware: applies
server/src/routes/donationRoutes.js - Donation controller → Donation service: delegates to
server/src/controllers/donationController.js - Donation service → Donation models: uses
server/src/services/donationService.js - Donation service → Payment service: calls
server/src/services/donationService.js - API routes → Management services: registers
- Reports page → Report service: uses
client/src/pages/reports/ReportsPage.jsx - Settings page → Settings controller: requests
- Database setup → Donation models: backs