# anjalichilukuri61/local-opportunity-intelligence architecture

> Architecture diagram of the GitHub repository anjalichilukuri61/local-opportunity-intelligence, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-08). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/anjalichilukuri61/local-opportunity-intelligence
- Repository: https://github.com/anjalichilukuri61/local-opportunity-intelligence

## Overview

Local Opportunity Intelligence System helps people find, map, save, and apply to local opportunities, while administrators manage listings. The main user flow runs from the React app through authenticated API routes to opportunity, bookmark, and application operations backed by MongoDB; profile interests and location support recommendations. Scheduled RSS ingestion adds listings, and deadline and account/application events can send email. The graph follows documented routes and indexed imports; frontend-to-backend calls are shown as unverified because the excerpts do not expose those request paths.

Main entry points: [`backend/server.js`](https://github.com/anjalichilukuri61/local-opportunity-intelligence/blob/main/backend/server.js) (API route dispatch), [`frontend/src/App.jsx`](https://github.com/anjalichilukuri61/local-opportunity-intelligence/blob/main/frontend/src/App.jsx) (React app routes), [`backend/controllers/opportunityController.js`](https://github.com/anjalichilukuri61/local-opportunity-intelligence/blob/main/backend/controllers/opportunityController.js) (Opportunity search), [`backend/controllers/applicationController.js`](https://github.com/anjalichilukuri61/local-opportunity-intelligence/blob/main/backend/controllers/applicationController.js) (Application handling)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web application"]
  node_app["React app routes<br/>[App.jsx]"]
  node_authstate["Session state<br/>[AuthContext.jsx]"]
  node_discoverui["Map and listings<br/>[Opportunities.jsx]"]
  node_dashboardui["Dashboard<br/>[Dashboard.jsx]"]
  node_profileui["Profile settings<br/>[Profile.jsx]"]
  node_adminui["Admin tools<br/>[Admin.jsx]"]
  node_apiaccess["API client hooks<br/>[useApi.js]"]
end

subgraph group_api["API and access"]
  node_routes["API route dispatch<br/>[server.js]"]
  node_authroutes["Auth routes<br/>[authRoutes.js]"]
  node_opproutes["Opportunity routes"]
  node_app_routes["Application routes"]
  node_bookmarkroutes["Bookmark routes<br/>[bookmarkRoutes.js]"]
  node_dashboardroutes["Dashboard routes<br/>[dashboardRoutes.js]"]
  node_adminroutes["Admin routes<br/>[adminRoutes.js]"]
  node_authguard["JWT verification<br/>[authMiddleware.js]"]
end

subgraph group_discovery["Opportunity discovery"]
  node_opportunity["Opportunity search"]
  node_oppdata[("Opportunity records<br/>[opportunity.js]")]
end

subgraph group_engagement["User engagement"]
  node_application["Application handling"]
  node_appdata[("Application records<br/>[application.js]")]
  node_bookmarks["Bookmark handling"]
  node_bookmarkdata[("Bookmark records<br/>[Bookmark.js]")]
  node_dashboard["Dashboard data"]
  node_auth["Account and profile<br/>[authController.js]"]
  node_userdata[("User profiles<br/>[User.js]")]
end

subgraph group_operations["Ingestion and alerts"]
  node_ingest["RSS fetcher"]
  node_scheduler["Ingestion scheduler<br/>[fetchScheduler.js]"]
  node_saveingest["Save fetched listings"]
  node_deadline["Deadline alerts<br/>[deadlineCron.js]"]
  node_email["Email delivery<br/>[sendEmail.js]"]
  node_templates["Email templates<br/>[emailTemplates.js]"]
end

node_visitor(("User / admin"))
node_mongo[("MongoDB")]
node_rss(("RSS feeds"))
node_mailservice(("Email service"))

node_visitor -->|"uses"| node_app
node_app -->|"provides session"| node_authstate
node_app -->|"routes to"| node_discoverui
node_app -->|"routes to"| node_dashboardui
node_app -->|"routes to"| node_profileui
node_app -->|"routes to"| node_adminui
node_discoverui -.->|"requests data"| node_apiaccess
node_dashboardui -->|"requests data"| node_apiaccess
node_profileui -->|"requests data"| node_apiaccess
node_adminui -->|"requests data"| node_apiaccess
node_apiaccess -.->|"HTTP requests"| node_routes
node_routes -->|"mounts"| node_authroutes
node_routes -->|"mounts"| node_opproutes
node_routes -->|"mounts"| node_app_routes
node_routes -->|"mounts"| node_bookmarkroutes
node_routes -->|"mounts"| node_dashboardroutes
node_routes -->|"mounts"| node_adminroutes
node_authroutes -->|"dispatches"| node_auth
node_opproutes -->|"dispatches"| node_opportunity
node_app_routes -->|"dispatches"| node_application
node_bookmarkroutes -->|"dispatches"| node_bookmarks
node_dashboardroutes -->|"dispatches"| node_dashboard
node_adminroutes -->|"checks access"| node_authguard
node_opproutes -->|"checks access"| node_authguard
node_opportunity -->|"queries"| node_oppdata
node_opportunity -->|"reads profiles"| node_userdata
node_opportunity -->|"counts applications"| node_appdata
node_opportunity -->|"counts bookmarks"| node_bookmarkdata
node_application -->|"creates and reads"| node_appdata
node_application -->|"loads opportunity"| node_oppdata
node_application -->|"loads applicant"| node_userdata
node_application -->|"uses template"| node_templates
node_auth -->|"reads and updates"| node_userdata
node_auth -->|"sends account email"| node_email
node_auth -->|"uses welcome template"| node_templates
node_bookmarks -->|"queries"| node_bookmarkdata
node_dashboard -->|"reads"| node_bookmarkdata
node_dashboard -->|"reads"| node_appdata
node_dashboard -->|"reads"| node_oppdata
node_routes -->|"loads scheduler"| node_scheduler
node_routes -->|"loads alerts"| node_deadline
node_scheduler -->|"runs fetcher"| node_ingest
node_scheduler -->|"runs persistence"| node_saveingest
node_ingest -.->|"reads feeds"| node_rss
node_saveingest -->|"saves listings"| node_oppdata
node_deadline -->|"checks deadlines"| node_oppdata
node_deadline -->|"finds recipients"| node_userdata
node_deadline -->|"sends alerts"| node_email

click node_app "https://github.com/anjalichilukuri61/local-opportunity-intelligence/blob/main/frontend/src/App.jsx"
click node_authstate "https://github.com/anjalichilukuri61/local-opportunity-intelligence/blob/main/frontend/src/context/AuthContext.jsx"
click node_discoverui "https://github.com/anjalichilukuri61/local-opportunity-intelligence/blob/main/frontend/src/pages/Opportunities.jsx"
click node_dashboardui "https://github.com/anjalichilukuri61/local-opportunity-intelligence/blob/main/frontend/src/pages/Dashboard.jsx"
click node_profileui "https://github.com/anjalichilukuri61/local-opportunity-intelligence/blob/main/frontend/src/pages/Profile.jsx"
click node_adminui "https://github.com/anjalichilukuri61/local-opportunity-intelligence/blob/main/frontend/src/pages/Admin.jsx"
click node_apiaccess "https://github.com/anjalichilukuri61/local-opportunity-intelligence/blob/main/frontend/src/hooks/useApi.js"
click node_routes "https://github.com/anjalichilukuri61/local-opportunity-intelligence/blob/main/backend/server.js"
click node_authroutes "https://github.com/anjalichilukuri61/local-opportunity-intelligence/blob/main/backend/routes/authRoutes.js"
click node_opproutes "https://github.com/anjalichilukuri61/local-opportunity-intelligence/blob/main/backend/routes/opportunityRoutes.js"
click node_app_routes "https://github.com/anjalichilukuri61/local-opportunity-intelligence/blob/main/backend/routes/applicationRoutes.js"
click node_bookmarkroutes "https://github.com/anjalichilukuri61/local-opportunity-intelligence/blob/main/backend/routes/bookmarkRoutes.js"
click node_dashboardroutes "https://github.com/anjalichilukuri61/local-opportunity-intelligence/blob/main/backend/routes/dashboardRoutes.js"
click node_adminroutes "https://github.com/anjalichilukuri61/local-opportunity-intelligence/blob/main/backend/routes/adminRoutes.js"
click node_authguard "https://github.com/anjalichilukuri61/local-opportunity-intelligence/blob/main/backend/middleware/authMiddleware.js"
click node_opportunity "https://github.com/anjalichilukuri61/local-opportunity-intelligence/blob/main/backend/controllers/opportunityController.js"
click node_oppdata "https://github.com/anjalichilukuri61/local-opportunity-intelligence/blob/main/backend/models/opportunity.js"
click node_ingest "https://github.com/anjalichilukuri61/local-opportunity-intelligence/blob/main/backend/utils/freeOpportunityFetcher.js"
click node_scheduler "https://github.com/anjalichilukuri61/local-opportunity-intelligence/blob/main/backend/cron/fetchScheduler.js"
click node_saveingest "https://github.com/anjalichilukuri61/local-opportunity-intelligence/blob/main/backend/utils/saveOpportunities.js"
click node_deadline "https://github.com/anjalichilukuri61/local-opportunity-intelligence/blob/main/backend/cron/deadlineCron.js"
click node_application "https://github.com/anjalichilukuri61/local-opportunity-intelligence/blob/main/backend/controllers/applicationController.js"
click node_appdata "https://github.com/anjalichilukuri61/local-opportunity-intelligence/blob/main/backend/models/application.js"
click node_bookmarks "https://github.com/anjalichilukuri61/local-opportunity-intelligence/blob/main/backend/controllers/bookmarkController.js"
click node_bookmarkdata "https://github.com/anjalichilukuri61/local-opportunity-intelligence/blob/main/backend/models/Bookmark.js"
click node_dashboard "https://github.com/anjalichilukuri61/local-opportunity-intelligence/blob/main/backend/controllers/dashboardController.js"
click node_auth "https://github.com/anjalichilukuri61/local-opportunity-intelligence/blob/main/backend/controllers/authController.js"
click node_userdata "https://github.com/anjalichilukuri61/local-opportunity-intelligence/blob/main/backend/models/User.js"
click node_email "https://github.com/anjalichilukuri61/local-opportunity-intelligence/blob/main/backend/utils/sendEmail.js"
click node_templates "https://github.com/anjalichilukuri61/local-opportunity-intelligence/blob/main/backend/utils/emailTemplates.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_authstate,node_discoverui,node_dashboardui,node_profileui,node_adminui,node_apiaccess,node_visitor toneBlue
class node_routes,node_authroutes,node_opproutes,node_app_routes,node_bookmarkroutes,node_dashboardroutes,node_adminroutes,node_authguard,node_mongo toneAmber
class node_opportunity,node_oppdata toneMint
class node_application,node_appdata,node_bookmarks,node_bookmarkdata,node_dashboard,node_auth,node_userdata toneRose
class node_ingest,node_scheduler,node_saveingest,node_deadline,node_email,node_templates,node_rss,node_mailservice toneIndigo
```

## Components

### Web application

- [React app routes](https://github.com/anjalichilukuri61/local-opportunity-intelligence/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Session state](https://github.com/anjalichilukuri61/local-opportunity-intelligence/blob/main/frontend/src/context/AuthContext.jsx): `frontend/src/context/AuthContext.jsx`
- [Map and listings](https://github.com/anjalichilukuri61/local-opportunity-intelligence/blob/main/frontend/src/pages/Opportunities.jsx): `frontend/src/pages/Opportunities.jsx`
- [Dashboard](https://github.com/anjalichilukuri61/local-opportunity-intelligence/blob/main/frontend/src/pages/Dashboard.jsx): `frontend/src/pages/Dashboard.jsx`
- [Profile settings](https://github.com/anjalichilukuri61/local-opportunity-intelligence/blob/main/frontend/src/pages/Profile.jsx): `frontend/src/pages/Profile.jsx`
- [Admin tools](https://github.com/anjalichilukuri61/local-opportunity-intelligence/blob/main/frontend/src/pages/Admin.jsx): `frontend/src/pages/Admin.jsx`
- [API client hooks](https://github.com/anjalichilukuri61/local-opportunity-intelligence/blob/main/frontend/src/hooks/useApi.js): `frontend/src/hooks/useApi.js`

### API and access

- [API route dispatch](https://github.com/anjalichilukuri61/local-opportunity-intelligence/blob/main/backend/server.js): `backend/server.js`
- [Auth routes](https://github.com/anjalichilukuri61/local-opportunity-intelligence/blob/main/backend/routes/authRoutes.js): `backend/routes/authRoutes.js`
- [Opportunity routes](https://github.com/anjalichilukuri61/local-opportunity-intelligence/blob/main/backend/routes/opportunityRoutes.js): `backend/routes/opportunityRoutes.js`
- [Application routes](https://github.com/anjalichilukuri61/local-opportunity-intelligence/blob/main/backend/routes/applicationRoutes.js): `backend/routes/applicationRoutes.js`
- [Bookmark routes](https://github.com/anjalichilukuri61/local-opportunity-intelligence/blob/main/backend/routes/bookmarkRoutes.js): `backend/routes/bookmarkRoutes.js`
- [Dashboard routes](https://github.com/anjalichilukuri61/local-opportunity-intelligence/blob/main/backend/routes/dashboardRoutes.js): `backend/routes/dashboardRoutes.js`
- [Admin routes](https://github.com/anjalichilukuri61/local-opportunity-intelligence/blob/main/backend/routes/adminRoutes.js): `backend/routes/adminRoutes.js`
- [JWT verification](https://github.com/anjalichilukuri61/local-opportunity-intelligence/blob/main/backend/middleware/authMiddleware.js): `backend/middleware/authMiddleware.js`

### Opportunity discovery

- [Opportunity search](https://github.com/anjalichilukuri61/local-opportunity-intelligence/blob/main/backend/controllers/opportunityController.js): `backend/controllers/opportunityController.js`
- [Opportunity records](https://github.com/anjalichilukuri61/local-opportunity-intelligence/blob/main/backend/models/opportunity.js): `backend/models/opportunity.js`

### User engagement

- [Application handling](https://github.com/anjalichilukuri61/local-opportunity-intelligence/blob/main/backend/controllers/applicationController.js): `backend/controllers/applicationController.js`
- [Application records](https://github.com/anjalichilukuri61/local-opportunity-intelligence/blob/main/backend/models/application.js): `backend/models/application.js`
- [Bookmark handling](https://github.com/anjalichilukuri61/local-opportunity-intelligence/blob/main/backend/controllers/bookmarkController.js): `backend/controllers/bookmarkController.js`
- [Bookmark records](https://github.com/anjalichilukuri61/local-opportunity-intelligence/blob/main/backend/models/Bookmark.js): `backend/models/Bookmark.js`
- [Dashboard data](https://github.com/anjalichilukuri61/local-opportunity-intelligence/blob/main/backend/controllers/dashboardController.js): `backend/controllers/dashboardController.js`
- [Account and profile](https://github.com/anjalichilukuri61/local-opportunity-intelligence/blob/main/backend/controllers/authController.js): `backend/controllers/authController.js`
- [User profiles](https://github.com/anjalichilukuri61/local-opportunity-intelligence/blob/main/backend/models/User.js): `backend/models/User.js`

### Ingestion and alerts

- [RSS fetcher](https://github.com/anjalichilukuri61/local-opportunity-intelligence/blob/main/backend/utils/freeOpportunityFetcher.js): `backend/utils/freeOpportunityFetcher.js`
- [Ingestion scheduler](https://github.com/anjalichilukuri61/local-opportunity-intelligence/blob/main/backend/cron/fetchScheduler.js): `backend/cron/fetchScheduler.js`
- [Save fetched listings](https://github.com/anjalichilukuri61/local-opportunity-intelligence/blob/main/backend/utils/saveOpportunities.js): `backend/utils/saveOpportunities.js`
- [Deadline alerts](https://github.com/anjalichilukuri61/local-opportunity-intelligence/blob/main/backend/cron/deadlineCron.js): `backend/cron/deadlineCron.js`
- [Email delivery](https://github.com/anjalichilukuri61/local-opportunity-intelligence/blob/main/backend/utils/sendEmail.js): `backend/utils/sendEmail.js`
- [Email templates](https://github.com/anjalichilukuri61/local-opportunity-intelligence/blob/main/backend/utils/emailTemplates.js): `backend/utils/emailTemplates.js`

### Other components

- **User / admin**
- **MongoDB**
- **RSS feeds**
- **Email service**

## Connections

- User / admin → React app routes: uses (evidence: `README.md`)
- React app routes → Session state: provides session (evidence: `frontend/src/App.jsx`)
- React app routes → Map and listings: routes to (evidence: `frontend/src/App.jsx`)
- React app routes → Dashboard: routes to (evidence: `frontend/src/App.jsx`)
- React app routes → Profile settings: routes to (evidence: `frontend/src/App.jsx`)
- React app routes → Admin tools: routes to (evidence: `frontend/src/App.jsx`)
- Map and listings → API client hooks: requests data
- Dashboard → API client hooks: requests data (evidence: `frontend/src/pages/Dashboard.jsx`)
- Profile settings → API client hooks: requests data (evidence: `frontend/src/pages/Profile.jsx`)
- Admin tools → API client hooks: requests data (evidence: `frontend/src/pages/Admin.jsx`)
- API client hooks → API route dispatch: HTTP requests
- API route dispatch → Auth routes: mounts (evidence: `backend/server.js`)
- API route dispatch → Opportunity routes: mounts (evidence: `backend/server.js`)
- API route dispatch → Application routes: mounts (evidence: `backend/server.js`)
- API route dispatch → Bookmark routes: mounts (evidence: `backend/server.js`)
- API route dispatch → Dashboard routes: mounts (evidence: `backend/server.js`)
- API route dispatch → Admin routes: mounts (evidence: `backend/server.js`)
- Auth routes → Account and profile: dispatches (evidence: `backend/routes/authRoutes.js`)
- Opportunity routes → Opportunity search: dispatches (evidence: `backend/routes/opportunityRoutes.js`)
- Application routes → Application handling: dispatches (evidence: `backend/routes/applicationRoutes.js`)
- Bookmark routes → Bookmark handling: dispatches (evidence: `backend/routes/bookmarkRoutes.js`)
- Dashboard routes → Dashboard data: dispatches (evidence: `backend/routes/dashboardRoutes.js`)
- Admin routes → JWT verification: checks access (evidence: `backend/routes/adminRoutes.js`)
- Opportunity routes → JWT verification: checks access (evidence: `backend/routes/opportunityRoutes.js`)
- Opportunity search → Opportunity records: queries (evidence: `backend/controllers/opportunityController.js`)
- Opportunity search → User profiles: reads profiles (evidence: `backend/controllers/opportunityController.js`)
- Opportunity search → Application records: counts applications (evidence: `backend/controllers/opportunityController.js`)
- Opportunity search → Bookmark records: counts bookmarks (evidence: `backend/controllers/opportunityController.js`)
- Application handling → Application records: creates and reads (evidence: `backend/controllers/applicationController.js`)
- Application handling → Opportunity records: loads opportunity (evidence: `backend/controllers/applicationController.js`)
- Application handling → User profiles: loads applicant (evidence: `backend/controllers/applicationController.js`)
- Application handling → Email templates: uses template (evidence: `backend/controllers/applicationController.js`)
- Account and profile → User profiles: reads and updates (evidence: `backend/controllers/authController.js`)
- Account and profile → Email delivery: sends account email (evidence: `backend/controllers/authController.js`)
- Account and profile → Email templates: uses welcome template (evidence: `backend/controllers/authController.js`)
- Bookmark handling → Bookmark records: queries (evidence: `backend/controllers/bookmarkController.js`)
- Dashboard data → Bookmark records: reads (evidence: `backend/controllers/dashboardController.js`)
- Dashboard data → Application records: reads (evidence: `backend/controllers/dashboardController.js`)
- Dashboard data → Opportunity records: reads (evidence: `backend/controllers/dashboardController.js`)
- API route dispatch → Ingestion scheduler: loads scheduler (evidence: `backend/server.js`)
- API route dispatch → Deadline alerts: loads alerts (evidence: `backend/server.js`)
- Ingestion scheduler → RSS fetcher: runs fetcher (evidence: `backend/cron/fetchScheduler.js`)
- Ingestion scheduler → Save fetched listings: runs persistence (evidence: `backend/cron/fetchScheduler.js`)
- RSS fetcher → RSS feeds: reads feeds (evidence: `README.md`)
- Save fetched listings → Opportunity records: saves listings (evidence: `backend/utils/saveOpportunities.js`)
- Deadline alerts → Opportunity records: checks deadlines (evidence: `backend/cron/deadlineCron.js`)
- Deadline alerts → User profiles: finds recipients (evidence: `backend/cron/deadlineCron.js`)
- Deadline alerts → Email delivery: sends alerts (evidence: `backend/cron/deadlineCron.js`)
