# iamparody/peerpal-app architecture

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

- Interactive diagram: https://gitdiagram.com/iamparody/peerpal-app
- Repository: https://github.com/iamparody/peerpal-app

## Overview

PeerPal is a mental-wellness and peer-support product with a member app, operational admin console, therapist portal, and API backend. The member journey includes account/onboarding, mood and self-guided support, peer and group interactions, and therapist sessions; the backend also provides AI support, safety controls, and scheduled operations. The excerpts show app routing, selected peer and AI internals, API mounting, and job startup. Other capabilities are represented from the file tree; links to their unsampled implementations are omitted where invocation evidence is unavailable.

Main entry points: [`src/frontend/src/App.jsx`](https://github.com/iamparody/peerpal-app/blob/main/src/frontend/src/App.jsx) (Member app), [`src/backend/app.js`](https://github.com/iamparody/peerpal-app/blob/main/src/backend/app.js) (API application), [`src/backend/routes/peer.js`](https://github.com/iamparody/peerpal-app/blob/main/src/backend/routes/peer.js) (Peer API), [`src/backend/server.js`](https://github.com/iamparody/peerpal-app/blob/main/src/backend/server.js) (Server & scheduler)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_member["Member experience"]
  node_member_app["Member app<br/>[App.jsx]"]
  node_identity_onboard["Identity &amp; onboarding"]
  node_wellbeing["Wellbeing tools"]
end

subgraph group_care["Care workflows"]
  node_peer_ui["Peer support UI"]
  node_groups_ui["Groups UI"]
  node_therapy_ui["Therapy UI"]
  node_training_ui["Skills training"]
end

subgraph group_backend["Backend services"]
  node_api_app["API application<br/>[app.js]"]
  node_member_routes["Member API routes"]
  node_admin_routes["Admin API<br/>[admin.js]"]
  node_peer_routes["Peer API<br/>[peer.js]"]
  node_therapy_routes["Therapy API<br/>[therapy.js]"]
  node_ai_pipeline["AI support pipeline<br/>[pipeline.js]"]
  node_ai_persistence["AI persistence"]
  node_policy["Permission policy<br/>[policyEngine.js]"]
end

subgraph group_operations["Operations consoles"]
  node_admin["Admin console<br/>[App.jsx]"]
  node_therapist_portal["Therapist portal<br/>[App.jsx]"]
end

subgraph group_runtime["Runtime infrastructure"]
  node_database[("Application database<br/>[index.js]")]
  node_server["Server &amp; scheduler<br/>[server.js]"]
  node_signaling["Call signaling<br/>[signaling.js]"]
  node_jobs["Background jobs"]
end

node_member(("Member"))

node_member -->|"uses"| node_member_app
node_member_app -->|"routes to"| node_identity_onboard
node_member_app -->|"routes to"| node_wellbeing
node_member_app -->|"routes to"| node_peer_ui
node_member_app -->|"routes to"| node_training_ui
node_member_app -.->|"routes to"| node_groups_ui
node_member_app -.->|"routes to"| node_therapy_ui
node_admin -.->|"calls API"| node_admin_routes
node_therapist_portal -.->|"calls API"| node_therapy_routes
node_api_app -->|"mounts routes"| node_member_routes
node_api_app -->|"mounts route"| node_admin_routes
node_api_app -->|"mounts route"| node_peer_routes
node_api_app -->|"mounts route"| node_therapy_routes
node_peer_routes -->|"queries"| node_database
node_peer_routes -->|"uses signaling"| node_signaling
node_peer_routes -->|"checks policy"| node_policy
node_ai_pipeline -.->|"persists through"| node_ai_persistence
node_ai_persistence -->|"queries"| node_database
node_ai_persistence -->|"uses generator"| node_ai_pipeline
node_policy -->|"queries"| node_database
node_server -->|"serves"| node_api_app
node_server -->|"starts"| node_signaling
node_server -->|"schedules"| node_jobs

click node_member_app "https://github.com/iamparody/peerpal-app/blob/main/src/frontend/src/App.jsx"
click node_identity_onboard "https://github.com/iamparody/peerpal-app/tree/main/src/frontend/src/screens/onboarding"
click node_wellbeing "https://github.com/iamparody/peerpal-app/tree/main/src/frontend/src/screens"
click node_peer_ui "https://github.com/iamparody/peerpal-app/tree/main/src/frontend/src/screens/peer"
click node_groups_ui "https://github.com/iamparody/peerpal-app/blob/main/src/frontend/src/screens/GroupChatScreen.jsx"
click node_therapy_ui "https://github.com/iamparody/peerpal-app/tree/main/src/frontend/src/screens/therapist"
click node_training_ui "https://github.com/iamparody/peerpal-app/tree/main/src/frontend/src/screens/training"
click node_admin "https://github.com/iamparody/peerpal-app/blob/main/src/admin/src/App.jsx"
click node_therapist_portal "https://github.com/iamparody/peerpal-app/blob/main/src/therapist/src/App.jsx"
click node_api_app "https://github.com/iamparody/peerpal-app/blob/main/src/backend/app.js"
click node_member_routes "https://github.com/iamparody/peerpal-app/tree/main/src/backend/routes"
click node_admin_routes "https://github.com/iamparody/peerpal-app/blob/main/src/backend/routes/admin.js"
click node_peer_routes "https://github.com/iamparody/peerpal-app/blob/main/src/backend/routes/peer.js"
click node_therapy_routes "https://github.com/iamparody/peerpal-app/blob/main/src/backend/routes/therapy.js"
click node_ai_pipeline "https://github.com/iamparody/peerpal-app/blob/main/src/backend/ai/pipeline.js"
click node_ai_persistence "https://github.com/iamparody/peerpal-app/blob/main/src/backend/ai/pipelinePersistence.js"
click node_policy "https://github.com/iamparody/peerpal-app/blob/main/src/backend/services/policyEngine.js"
click node_database "https://github.com/iamparody/peerpal-app/blob/main/src/backend/db/index.js"
click node_server "https://github.com/iamparody/peerpal-app/blob/main/src/backend/server.js"
click node_signaling "https://github.com/iamparody/peerpal-app/blob/main/src/backend/ws/signaling.js"
click node_jobs "https://github.com/iamparody/peerpal-app/tree/main/src/backend/jobs"

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_member_app,node_identity_onboard,node_wellbeing toneBlue
class node_peer_ui,node_groups_ui,node_therapy_ui,node_training_ui toneAmber
class node_api_app,node_member_routes,node_admin_routes,node_peer_routes,node_therapy_routes,node_ai_pipeline,node_ai_persistence,node_policy toneMint
class node_admin,node_therapist_portal toneRose
class node_database,node_server,node_signaling,node_jobs,node_member toneIndigo
```

## Components

### Member experience

- [Member app](https://github.com/iamparody/peerpal-app/blob/main/src/frontend/src/App.jsx): `src/frontend/src/App.jsx`
- [Identity & onboarding](https://github.com/iamparody/peerpal-app/tree/main/src/frontend/src/screens/onboarding): `src/frontend/src/screens/onboarding`
- [Wellbeing tools](https://github.com/iamparody/peerpal-app/tree/main/src/frontend/src/screens): `src/frontend/src/screens`

### Care workflows

- [Peer support UI](https://github.com/iamparody/peerpal-app/tree/main/src/frontend/src/screens/peer): `src/frontend/src/screens/peer`
- [Groups UI](https://github.com/iamparody/peerpal-app/blob/main/src/frontend/src/screens/GroupChatScreen.jsx): `src/frontend/src/screens/GroupChatScreen.jsx`
- [Therapy UI](https://github.com/iamparody/peerpal-app/tree/main/src/frontend/src/screens/therapist): `src/frontend/src/screens/therapist`
- [Skills training](https://github.com/iamparody/peerpal-app/tree/main/src/frontend/src/screens/training): `src/frontend/src/screens/training`

### Backend services

- [API application](https://github.com/iamparody/peerpal-app/blob/main/src/backend/app.js): `src/backend/app.js`
- [Member API routes](https://github.com/iamparody/peerpal-app/tree/main/src/backend/routes): `src/backend/routes`
- [Admin API](https://github.com/iamparody/peerpal-app/blob/main/src/backend/routes/admin.js): `src/backend/routes/admin.js`
- [Peer API](https://github.com/iamparody/peerpal-app/blob/main/src/backend/routes/peer.js): `src/backend/routes/peer.js`
- [Therapy API](https://github.com/iamparody/peerpal-app/blob/main/src/backend/routes/therapy.js): `src/backend/routes/therapy.js`
- [AI support pipeline](https://github.com/iamparody/peerpal-app/blob/main/src/backend/ai/pipeline.js): `src/backend/ai/pipeline.js`
- [AI persistence](https://github.com/iamparody/peerpal-app/blob/main/src/backend/ai/pipelinePersistence.js): `src/backend/ai/pipelinePersistence.js`
- [Permission policy](https://github.com/iamparody/peerpal-app/blob/main/src/backend/services/policyEngine.js): `src/backend/services/policyEngine.js`

### Operations consoles

- [Admin console](https://github.com/iamparody/peerpal-app/blob/main/src/admin/src/App.jsx): `src/admin/src/App.jsx`
- [Therapist portal](https://github.com/iamparody/peerpal-app/blob/main/src/therapist/src/App.jsx): `src/therapist/src/App.jsx`

### Runtime infrastructure

- [Application database](https://github.com/iamparody/peerpal-app/blob/main/src/backend/db/index.js): `src/backend/db/index.js`
- [Server & scheduler](https://github.com/iamparody/peerpal-app/blob/main/src/backend/server.js): `src/backend/server.js`
- [Call signaling](https://github.com/iamparody/peerpal-app/blob/main/src/backend/ws/signaling.js): `src/backend/ws/signaling.js`
- [Background jobs](https://github.com/iamparody/peerpal-app/tree/main/src/backend/jobs): `src/backend/jobs`

### Other components

- **Member**

## Connections

- Member → Member app: uses
- Member app → Identity & onboarding: routes to (evidence: `src/frontend/src/App.jsx`)
- Member app → Wellbeing tools: routes to (evidence: `src/frontend/src/App.jsx`)
- Member app → Peer support UI: routes to (evidence: `src/frontend/src/App.jsx`)
- Member app → Skills training: routes to (evidence: `src/frontend/src/App.jsx`)
- Member app → Groups UI: routes to (evidence: `src/frontend/src/App.jsx`)
- Member app → Therapy UI: routes to
- Admin console → Admin API: calls API
- Therapist portal → Therapy API: calls API
- API application → Member API routes: mounts routes (evidence: `src/backend/app.js`)
- API application → Admin API: mounts route (evidence: `src/backend/app.js`)
- API application → Peer API: mounts route (evidence: `src/backend/app.js`)
- API application → Therapy API: mounts route (evidence: `src/backend/app.js`)
- Peer API → Application database: queries (evidence: `src/backend/routes/peer.js`)
- Peer API → Call signaling: uses signaling (evidence: `src/backend/routes/peer.js`)
- Peer API → Permission policy: checks policy (evidence: `src/backend/routes/peer.js`)
- AI support pipeline → AI persistence: persists through
- AI persistence → Application database: queries (evidence: `src/backend/ai/pipelinePersistence.js`)
- AI persistence → AI support pipeline: uses generator (evidence: `src/backend/ai/pipelinePersistence.js`)
- Permission policy → Application database: queries (evidence: `src/backend/services/policyEngine.js`)
- Server & scheduler → API application: serves (evidence: `src/backend/server.js`)
- Server & scheduler → Call signaling: starts (evidence: `src/backend/server.js`)
- Server & scheduler → Background jobs: schedules (evidence: `src/backend/server.js`)
