# bhanu-developer5161/linguacare architecture

> Architecture diagram of the GitHub repository bhanu-developer5161/linguacare, 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/bhanu-developer5161/linguacare
- Repository: https://github.com/bhanu-developer5161/linguacare

## Overview

LinguaCare connects families seeking language care with educators: users register or log in, browse educator listings and profiles, send interest requests, and—after acceptance—message through role-specific dashboards. The graph covers the documented-in-code client/server flow, including authentication, profiles, requests, conversations, and Mongo-backed records. Client page-to-service usage is identified in the source index, but detailed UI calls and database setup are not shown in excerpts; uncertain wiring is omitted.

Main entry points: [`client/src/App.jsx`](https://github.com/bhanu-developer5161/linguacare/blob/main/client/src/App.jsx) (Page routing), [`client/src/services/api.js`](https://github.com/bhanu-developer5161/linguacare/blob/main/client/src/services/api.js) (API client), [`server/server.js`](https://github.com/bhanu-developer5161/linguacare/blob/main/server/server.js) (HTTP server), [`server/routes/requestRoutes.js`](https://github.com/bhanu-developer5161/linguacare/blob/main/server/routes/requestRoutes.js) (Request routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_router["Page routing<br/>[App.jsx]"]
  node_home["Landing page<br/>[Home.jsx]"]
  node_directory["Educator directory<br/>[Educators.jsx]"]
  node_educator_profile["Educator profile"]
  node_registration["Registration<br/>[Register.jsx]"]
  node_login["Login<br/>[Login.jsx]"]
  node_family_dashboard["Family dashboard"]
  node_educator_dashboard["Educator dashboard"]
  node_conversation["Conversation view<br/>[Conversation.jsx]"]
  node_client_api["API client<br/>[api.js]"]
end

subgraph group_api["API and access"]
  node_server["HTTP server<br/>[server.js]"]
  node_auth_routes["Auth routes<br/>[authRoutes.js]"]
  node_user_routes["User routes<br/>[userRoutes.js]"]
  node_request_routes["Request routes<br/>[requestRoutes.js]"]
  node_auth_guard["JWT guard<br/>[authMiddleware.js]"]
  node_auth_logic["Account auth<br/>[authController.js]"]
end

subgraph group_domain["Matching and communication"]
  node_user_logic["Profile and directory<br/>[userController.js]"]
  node_request_logic["Interest workflow"]
  node_message_logic["Messaging"]
end

subgraph group_records["Persistent records"]
  node_user_store[("User records<br/>[User.js]")]
  node_request_store[("Interest requests<br/>[InterestRequest.js]")]
  node_message_store[("Messages<br/>[Message.js]")]
  node_database_connection[("Mongo connection<br/>[db.js]")]
end

node_families(("Families"))
node_educators(("Educators"))

node_families -->|"uses"| node_router
node_educators -->|"uses"| node_router
node_router -->|"routes to"| node_home
node_router -->|"routes to"| node_directory
node_router -->|"routes to"| node_educator_profile
node_router -->|"routes to"| node_registration
node_router -->|"routes to"| node_login
node_router -->|"routes to"| node_family_dashboard
node_router -->|"routes to"| node_educator_dashboard
node_registration -->|"uses"| node_client_api
node_login -->|"uses"| node_client_api
node_directory -->|"uses"| node_client_api
node_educator_profile -->|"uses"| node_client_api
node_family_dashboard -->|"uses"| node_client_api
node_educator_dashboard -->|"uses"| node_client_api
node_family_dashboard -->|"renders"| node_conversation
node_educator_dashboard -->|"renders"| node_conversation
node_conversation -->|"uses"| node_client_api
node_client_api -->|"HTTP requests"| node_server
node_server -->|"mounts"| node_auth_routes
node_server -->|"mounts"| node_user_routes
node_server -->|"mounts"| node_request_routes
node_auth_routes -->|"protects"| node_auth_guard
node_user_routes -->|"protects"| node_auth_guard
node_request_routes -->|"protects"| node_auth_guard
node_auth_routes -->|"dispatches"| node_auth_logic
node_user_routes -->|"dispatches"| node_user_logic
node_request_routes -->|"dispatches"| node_request_logic
node_request_routes -->|"dispatches"| node_message_logic
node_auth_logic -->|"reads/writes"| node_user_store
node_user_logic -->|"reads/writes"| node_user_store
node_request_logic -->|"looks up"| node_user_store
node_request_logic -->|"reads/writes"| node_request_store
node_message_logic -->|"checks access"| node_request_store
node_message_logic -->|"reads/writes"| node_message_store
node_server -->|"connects"| node_database_connection

click node_router "https://github.com/bhanu-developer5161/linguacare/blob/main/client/src/App.jsx"
click node_home "https://github.com/bhanu-developer5161/linguacare/blob/main/client/src/Home.jsx"
click node_directory "https://github.com/bhanu-developer5161/linguacare/blob/main/client/src/pages/Educators.jsx"
click node_educator_profile "https://github.com/bhanu-developer5161/linguacare/blob/main/client/src/pages/EducatorProfile.jsx"
click node_registration "https://github.com/bhanu-developer5161/linguacare/blob/main/client/src/pages/Register.jsx"
click node_login "https://github.com/bhanu-developer5161/linguacare/blob/main/client/src/pages/Login.jsx"
click node_family_dashboard "https://github.com/bhanu-developer5161/linguacare/blob/main/client/src/pages/FamilyDashboard.jsx"
click node_educator_dashboard "https://github.com/bhanu-developer5161/linguacare/blob/main/client/src/pages/EducatorDashboard.jsx"
click node_conversation "https://github.com/bhanu-developer5161/linguacare/blob/main/client/src/components/Conversation.jsx"
click node_client_api "https://github.com/bhanu-developer5161/linguacare/blob/main/client/src/services/api.js"
click node_server "https://github.com/bhanu-developer5161/linguacare/blob/main/server/server.js"
click node_auth_routes "https://github.com/bhanu-developer5161/linguacare/blob/main/server/routes/authRoutes.js"
click node_user_routes "https://github.com/bhanu-developer5161/linguacare/blob/main/server/routes/userRoutes.js"
click node_request_routes "https://github.com/bhanu-developer5161/linguacare/blob/main/server/routes/requestRoutes.js"
click node_auth_guard "https://github.com/bhanu-developer5161/linguacare/blob/main/server/middleware/authMiddleware.js"
click node_auth_logic "https://github.com/bhanu-developer5161/linguacare/blob/main/server/controllers/authController.js"
click node_user_logic "https://github.com/bhanu-developer5161/linguacare/blob/main/server/controllers/userController.js"
click node_request_logic "https://github.com/bhanu-developer5161/linguacare/blob/main/server/controllers/requestController.js"
click node_message_logic "https://github.com/bhanu-developer5161/linguacare/blob/main/server/controllers/messageController.js"
click node_user_store "https://github.com/bhanu-developer5161/linguacare/blob/main/server/models/User.js"
click node_request_store "https://github.com/bhanu-developer5161/linguacare/blob/main/server/models/InterestRequest.js"
click node_message_store "https://github.com/bhanu-developer5161/linguacare/blob/main/server/models/Message.js"
click node_database_connection "https://github.com/bhanu-developer5161/linguacare/blob/main/server/config/db.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_router,node_home,node_directory,node_educator_profile,node_registration,node_login,node_family_dashboard,node_educator_dashboard,node_conversation,node_client_api toneBlue
class node_server,node_auth_routes,node_user_routes,node_request_routes,node_auth_guard,node_auth_logic toneAmber
class node_user_logic,node_request_logic,node_message_logic toneMint
class node_user_store,node_request_store,node_message_store,node_database_connection toneRose
class node_families,node_educators toneIndigo
```

## Components

### Web client

- [Page routing](https://github.com/bhanu-developer5161/linguacare/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [Landing page](https://github.com/bhanu-developer5161/linguacare/blob/main/client/src/Home.jsx): `client/src/Home.jsx`
- [Educator directory](https://github.com/bhanu-developer5161/linguacare/blob/main/client/src/pages/Educators.jsx): `client/src/pages/Educators.jsx`
- [Educator profile](https://github.com/bhanu-developer5161/linguacare/blob/main/client/src/pages/EducatorProfile.jsx): `client/src/pages/EducatorProfile.jsx`
- [Registration](https://github.com/bhanu-developer5161/linguacare/blob/main/client/src/pages/Register.jsx): `client/src/pages/Register.jsx`
- [Login](https://github.com/bhanu-developer5161/linguacare/blob/main/client/src/pages/Login.jsx): `client/src/pages/Login.jsx`
- [Family dashboard](https://github.com/bhanu-developer5161/linguacare/blob/main/client/src/pages/FamilyDashboard.jsx): `client/src/pages/FamilyDashboard.jsx`
- [Educator dashboard](https://github.com/bhanu-developer5161/linguacare/blob/main/client/src/pages/EducatorDashboard.jsx): `client/src/pages/EducatorDashboard.jsx`
- [Conversation view](https://github.com/bhanu-developer5161/linguacare/blob/main/client/src/components/Conversation.jsx): `client/src/components/Conversation.jsx`
- [API client](https://github.com/bhanu-developer5161/linguacare/blob/main/client/src/services/api.js): `client/src/services/api.js`

### API and access

- [HTTP server](https://github.com/bhanu-developer5161/linguacare/blob/main/server/server.js): `server/server.js`
- [Auth routes](https://github.com/bhanu-developer5161/linguacare/blob/main/server/routes/authRoutes.js): `server/routes/authRoutes.js`
- [User routes](https://github.com/bhanu-developer5161/linguacare/blob/main/server/routes/userRoutes.js): `server/routes/userRoutes.js`
- [Request routes](https://github.com/bhanu-developer5161/linguacare/blob/main/server/routes/requestRoutes.js): `server/routes/requestRoutes.js`
- [JWT guard](https://github.com/bhanu-developer5161/linguacare/blob/main/server/middleware/authMiddleware.js): `server/middleware/authMiddleware.js`
- [Account auth](https://github.com/bhanu-developer5161/linguacare/blob/main/server/controllers/authController.js): `server/controllers/authController.js`

### Matching and communication

- [Profile and directory](https://github.com/bhanu-developer5161/linguacare/blob/main/server/controllers/userController.js): `server/controllers/userController.js`
- [Interest workflow](https://github.com/bhanu-developer5161/linguacare/blob/main/server/controllers/requestController.js): `server/controllers/requestController.js`
- [Messaging](https://github.com/bhanu-developer5161/linguacare/blob/main/server/controllers/messageController.js): `server/controllers/messageController.js`

### Persistent records

- [User records](https://github.com/bhanu-developer5161/linguacare/blob/main/server/models/User.js): `server/models/User.js`
- [Interest requests](https://github.com/bhanu-developer5161/linguacare/blob/main/server/models/InterestRequest.js): `server/models/InterestRequest.js`
- [Messages](https://github.com/bhanu-developer5161/linguacare/blob/main/server/models/Message.js): `server/models/Message.js`
- [Mongo connection](https://github.com/bhanu-developer5161/linguacare/blob/main/server/config/db.js): `server/config/db.js`

### Other components

- **Families**
- **Educators**

## Connections

- Families → Page routing: uses (evidence: `client/src/App.jsx`)
- Educators → Page routing: uses (evidence: `client/src/App.jsx`)
- Page routing → Landing page: routes to (evidence: `client/src/App.jsx`)
- Page routing → Educator directory: routes to (evidence: `client/src/App.jsx`)
- Page routing → Educator profile: routes to (evidence: `client/src/App.jsx`)
- Page routing → Registration: routes to (evidence: `client/src/App.jsx`)
- Page routing → Login: routes to (evidence: `client/src/App.jsx`)
- Page routing → Family dashboard: routes to (evidence: `client/src/App.jsx`)
- Page routing → Educator dashboard: routes to (evidence: `client/src/App.jsx`)
- Registration → API client: uses (evidence: `client/src/pages/Register.jsx`)
- Login → API client: uses (evidence: `client/src/pages/Login.jsx`)
- Educator directory → API client: uses (evidence: `client/src/pages/Educators.jsx`)
- Educator profile → API client: uses (evidence: `client/src/pages/EducatorProfile.jsx`)
- Family dashboard → API client: uses (evidence: `client/src/pages/FamilyDashboard.jsx`)
- Educator dashboard → API client: uses (evidence: `client/src/pages/EducatorDashboard.jsx`)
- Family dashboard → Conversation view: renders (evidence: `client/src/pages/FamilyDashboard.jsx`)
- Educator dashboard → Conversation view: renders (evidence: `client/src/pages/EducatorDashboard.jsx`)
- Conversation view → API client: uses (evidence: `client/src/components/Conversation.jsx`)
- API client → HTTP server: HTTP requests (evidence: `client/src/services/api.js`)
- HTTP server → Auth routes: mounts (evidence: `server/server.js`)
- HTTP server → User routes: mounts (evidence: `server/server.js`)
- HTTP server → Request routes: mounts (evidence: `server/server.js`)
- Auth routes → JWT guard: protects (evidence: `server/routes/authRoutes.js`)
- User routes → JWT guard: protects (evidence: `server/routes/userRoutes.js`)
- Request routes → JWT guard: protects (evidence: `server/routes/requestRoutes.js`)
- Auth routes → Account auth: dispatches (evidence: `server/routes/authRoutes.js`)
- User routes → Profile and directory: dispatches (evidence: `server/routes/userRoutes.js`)
- Request routes → Interest workflow: dispatches (evidence: `server/routes/requestRoutes.js`)
- Request routes → Messaging: dispatches (evidence: `server/routes/requestRoutes.js`)
- Account auth → User records: reads/writes (evidence: `server/controllers/authController.js`)
- Profile and directory → User records: reads/writes (evidence: `server/controllers/userController.js`)
- Interest workflow → User records: looks up (evidence: `server/controllers/requestController.js`)
- Interest workflow → Interest requests: reads/writes (evidence: `server/controllers/requestController.js`)
- Messaging → Interest requests: checks access (evidence: `server/controllers/messageController.js`)
- Messaging → Messages: reads/writes (evidence: `server/controllers/messageController.js`)
- HTTP server → Mongo connection: connects (evidence: `server/server.js`)
