# isabellanoy/mental-health architecture

> Architecture diagram of the GitHub repository isabellanoy/mental-health, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/isabellanoy/mental-health
- Repository: https://github.com/isabellanoy/mental-health

## Overview

Apoyo psicológico primario is a public mental-health support site with a separate volunteer application and an admin console. Visitors submit a guided support form or volunteer application; administrators authenticate to review and manage submissions, volunteers, accounts, allies, and roulette images. The NestJS API persists records in Supabase Postgres and uses Supabase Storage for uploaded media. The README documents the product workflows and endpoints; source excerpts and the index support selected implementation links, while unsampled frontend and API wiring is not inferred beyond those documented capabilities.

Main entry points: [`frontend/src/admin/api/adminClient.ts`](https://github.com/isabellanoy/mental-health/blob/main/frontend/src/admin/api/adminClient.ts) (Admin API client), [`frontend/src/App.tsx`](https://github.com/isabellanoy/mental-health/blob/main/frontend/src/App.tsx) (Public routes), [`backend/src/admin/auth/admin.guard.ts`](https://github.com/isabellanoy/mental-health/blob/main/backend/src/admin/auth/admin.guard.ts) (Session guard), [`backend/src/prisma/prisma.service.ts`](https://github.com/isabellanoy/mental-health/blob/main/backend/src/prisma/prisma.service.ts) (Postgres access)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_public["Public experience"]
  node_public_app["Public routes<br/>[App.tsx]"]
  node_support_form["Support form<br/>[Form.tsx]"]
  node_volunteer_form["Volunteer form<br/>[Volunteer.tsx]"]
  node_public_content["Public content<br/>[Home.tsx]"]
  node_roulette_view["Roulette view<br/>[Roulette.tsx]"]
  node_frontend_api["API client<br/>[api.ts]"]
end

subgraph group_api["API workflows"]
  node_submission_api["Submission API"]
  node_submission_service["Submission workflow"]
  node_volunteer_api["Volunteer API"]
  node_volunteer_service["Volunteer workflow"]
  node_allies_service["Allies workflow<br/>[allies.service.ts]"]
  node_roulette_service["Roulette workflow"]
end

subgraph group_admin["Admin operations"]
  node_admin_console["Admin console<br/>[AdminApp.tsx]"]
  node_admin_client["Admin API client<br/>[adminClient.ts]"]
  node_admin_auth["Admin authentication<br/>[auth.service.ts]"]
  node_admin_guard["Session guard<br/>[admin.guard.ts]"]
  node_admin_management["Account management<br/>[admins.service.ts]"]
  node_submission_admin["Submission management"]
  node_volunteer_admin["Volunteer management"]
  node_allies_admin["Ally management"]
  node_roulette_admin["Roulette management"]
end

subgraph group_data["Persistence and media"]
  node_prisma[("Postgres access<br/>[prisma.service.ts]")]
  node_supabase_storage[("Supabase Storage")]
end

node_visitor(("Visitor"))
node_admin_actor(("Administrator"))

node_visitor -->|"opens"| node_public_app
node_public_app -->|"routes to"| node_support_form
node_public_app -->|"routes to"| node_volunteer_form
node_public_app -->|"routes to"| node_roulette_view
node_public_app -->|"routes to"| node_public_content
node_support_form -.->|"submits through"| node_frontend_api
node_volunteer_form -->|"submits through"| node_frontend_api
node_frontend_api -->|"posts submission"| node_submission_api
node_frontend_api -->|"posts application"| node_volunteer_api
node_submission_api -->|"delegates to"| node_submission_service
node_volunteer_api -->|"delegates to"| node_volunteer_service
node_submission_service -->|"reads and writes"| node_prisma
node_volunteer_service -->|"reads and writes"| node_prisma
node_admin_actor -->|"uses"| node_admin_console
node_admin_console -.->|"calls"| node_admin_client
node_admin_client -->|"logs in"| node_admin_auth
node_admin_client -->|"manages submissions"| node_submission_admin
node_admin_client -->|"manages volunteers"| node_volunteer_admin
node_admin_client -->|"manages accounts"| node_admin_management
node_admin_client -->|"manages allies"| node_allies_admin
node_admin_client -->|"manages images"| node_roulette_admin
node_submission_admin -->|"guards routes"| node_admin_guard
node_volunteer_admin -->|"guards routes"| node_admin_guard
node_allies_admin -->|"guards routes"| node_admin_guard
node_roulette_admin -->|"guards routes"| node_admin_guard
node_admin_guard -->|"checks active account"| node_admin_management
node_submission_admin -->|"delegates to"| node_submission_service
node_volunteer_admin -->|"delegates to"| node_volunteer_service
node_allies_admin -->|"delegates to"| node_allies_service
node_roulette_admin -->|"delegates to"| node_roulette_service
node_admin_management -->|"reads and writes"| node_prisma
node_allies_service -->|"reads and writes"| node_prisma
node_roulette_service -->|"reads and writes"| node_prisma
node_allies_service -->|"stores logos"| node_supabase_storage
node_roulette_service -->|"stores images"| node_supabase_storage

click node_public_app "https://github.com/isabellanoy/mental-health/blob/main/frontend/src/App.tsx"
click node_support_form "https://github.com/isabellanoy/mental-health/blob/main/frontend/src/pages/Form.tsx"
click node_volunteer_form "https://github.com/isabellanoy/mental-health/blob/main/frontend/src/pages/Volunteer.tsx"
click node_public_content "https://github.com/isabellanoy/mental-health/blob/main/frontend/src/pages/Home.tsx"
click node_roulette_view "https://github.com/isabellanoy/mental-health/blob/main/frontend/src/pages/Roulette.tsx"
click node_frontend_api "https://github.com/isabellanoy/mental-health/blob/main/frontend/src/services/api.ts"
click node_submission_api "https://github.com/isabellanoy/mental-health/blob/main/backend/src/submissions/submissions.controller.ts"
click node_submission_service "https://github.com/isabellanoy/mental-health/blob/main/backend/src/submissions/submissions.service.ts"
click node_volunteer_api "https://github.com/isabellanoy/mental-health/blob/main/backend/src/volunteers/volunteers.controller.ts"
click node_volunteer_service "https://github.com/isabellanoy/mental-health/blob/main/backend/src/volunteers/volunteers.service.ts"
click node_admin_console "https://github.com/isabellanoy/mental-health/blob/main/frontend/src/admin/AdminApp.tsx"
click node_admin_client "https://github.com/isabellanoy/mental-health/blob/main/frontend/src/admin/api/adminClient.ts"
click node_admin_auth "https://github.com/isabellanoy/mental-health/blob/main/backend/src/admin/auth/auth.service.ts"
click node_admin_guard "https://github.com/isabellanoy/mental-health/blob/main/backend/src/admin/auth/admin.guard.ts"
click node_admin_management "https://github.com/isabellanoy/mental-health/blob/main/backend/src/admin/admins/admins.service.ts"
click node_submission_admin "https://github.com/isabellanoy/mental-health/blob/main/backend/src/submissions/admin-submissions.controller.ts"
click node_volunteer_admin "https://github.com/isabellanoy/mental-health/blob/main/backend/src/volunteers/admin-volunteers.controller.ts"
click node_allies_admin "https://github.com/isabellanoy/mental-health/blob/main/backend/src/allies/admin-allies.controller.ts"
click node_roulette_admin "https://github.com/isabellanoy/mental-health/blob/main/backend/src/roulette/admin-roulette.controller.ts"
click node_allies_service "https://github.com/isabellanoy/mental-health/blob/main/backend/src/allies/allies.service.ts"
click node_roulette_service "https://github.com/isabellanoy/mental-health/blob/main/backend/src/roulette/roulette.service.ts"
click node_prisma "https://github.com/isabellanoy/mental-health/blob/main/backend/src/prisma/prisma.service.ts"

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_public_app,node_support_form,node_volunteer_form,node_public_content,node_roulette_view,node_frontend_api toneBlue
class node_submission_api,node_submission_service,node_volunteer_api,node_volunteer_service,node_allies_service,node_roulette_service toneAmber
class node_admin_console,node_admin_client,node_admin_auth,node_admin_guard,node_admin_management,node_submission_admin,node_volunteer_admin,node_allies_admin,node_roulette_admin toneMint
class node_prisma,node_supabase_storage toneRose
class node_visitor,node_admin_actor toneIndigo
```

## Components

### Public experience

- [Public routes](https://github.com/isabellanoy/mental-health/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Support form](https://github.com/isabellanoy/mental-health/blob/main/frontend/src/pages/Form.tsx): `frontend/src/pages/Form.tsx`
- [Volunteer form](https://github.com/isabellanoy/mental-health/blob/main/frontend/src/pages/Volunteer.tsx): `frontend/src/pages/Volunteer.tsx`
- [Public content](https://github.com/isabellanoy/mental-health/blob/main/frontend/src/pages/Home.tsx): `frontend/src/pages/Home.tsx`
- [Roulette view](https://github.com/isabellanoy/mental-health/blob/main/frontend/src/pages/Roulette.tsx): `frontend/src/pages/Roulette.tsx`
- [API client](https://github.com/isabellanoy/mental-health/blob/main/frontend/src/services/api.ts): `frontend/src/services/api.ts`

### API workflows

- [Submission API](https://github.com/isabellanoy/mental-health/blob/main/backend/src/submissions/submissions.controller.ts): `backend/src/submissions/submissions.controller.ts`
- [Submission workflow](https://github.com/isabellanoy/mental-health/blob/main/backend/src/submissions/submissions.service.ts): `backend/src/submissions/submissions.service.ts`
- [Volunteer API](https://github.com/isabellanoy/mental-health/blob/main/backend/src/volunteers/volunteers.controller.ts): `backend/src/volunteers/volunteers.controller.ts`
- [Volunteer workflow](https://github.com/isabellanoy/mental-health/blob/main/backend/src/volunteers/volunteers.service.ts): `backend/src/volunteers/volunteers.service.ts`
- [Allies workflow](https://github.com/isabellanoy/mental-health/blob/main/backend/src/allies/allies.service.ts): `backend/src/allies/allies.service.ts`
- [Roulette workflow](https://github.com/isabellanoy/mental-health/blob/main/backend/src/roulette/roulette.service.ts): `backend/src/roulette/roulette.service.ts`

### Admin operations

- [Admin console](https://github.com/isabellanoy/mental-health/blob/main/frontend/src/admin/AdminApp.tsx): `frontend/src/admin/AdminApp.tsx`
- [Admin API client](https://github.com/isabellanoy/mental-health/blob/main/frontend/src/admin/api/adminClient.ts): `frontend/src/admin/api/adminClient.ts`
- [Admin authentication](https://github.com/isabellanoy/mental-health/blob/main/backend/src/admin/auth/auth.service.ts): `backend/src/admin/auth/auth.service.ts`
- [Session guard](https://github.com/isabellanoy/mental-health/blob/main/backend/src/admin/auth/admin.guard.ts): `backend/src/admin/auth/admin.guard.ts`
- [Account management](https://github.com/isabellanoy/mental-health/blob/main/backend/src/admin/admins/admins.service.ts): `backend/src/admin/admins/admins.service.ts`
- [Submission management](https://github.com/isabellanoy/mental-health/blob/main/backend/src/submissions/admin-submissions.controller.ts): `backend/src/submissions/admin-submissions.controller.ts`
- [Volunteer management](https://github.com/isabellanoy/mental-health/blob/main/backend/src/volunteers/admin-volunteers.controller.ts): `backend/src/volunteers/admin-volunteers.controller.ts`
- [Ally management](https://github.com/isabellanoy/mental-health/blob/main/backend/src/allies/admin-allies.controller.ts): `backend/src/allies/admin-allies.controller.ts`
- [Roulette management](https://github.com/isabellanoy/mental-health/blob/main/backend/src/roulette/admin-roulette.controller.ts): `backend/src/roulette/admin-roulette.controller.ts`

### Persistence and media

- [Postgres access](https://github.com/isabellanoy/mental-health/blob/main/backend/src/prisma/prisma.service.ts): `backend/src/prisma/prisma.service.ts`
- **Supabase Storage**

### Other components

- **Visitor**
- **Administrator**

## Connections

- Visitor → Public routes: opens (evidence: `frontend/src/App.tsx`)
- Public routes → Support form: routes to (evidence: `frontend/src/App.tsx`)
- Public routes → Volunteer form: routes to (evidence: `frontend/src/App.tsx`)
- Public routes → Roulette view: routes to (evidence: `frontend/src/App.tsx`)
- Public routes → Public content: routes to (evidence: `frontend/src/App.tsx`)
- Support form → API client: submits through
- Volunteer form → API client: submits through (evidence: `frontend/src/pages/Volunteer.tsx`)
- API client → Submission API: posts submission
- API client → Volunteer API: posts application
- Submission API → Submission workflow: delegates to (evidence: `backend/src/submissions/submissions.controller.ts`)
- Volunteer API → Volunteer workflow: delegates to (evidence: `backend/src/volunteers/volunteers.controller.ts`)
- Submission workflow → Postgres access: reads and writes (evidence: `backend/src/submissions/submissions.service.ts`)
- Volunteer workflow → Postgres access: reads and writes (evidence: `backend/src/volunteers/volunteers.service.ts`)
- Administrator → Admin console: uses
- Admin console → Admin API client: calls
- Admin API client → Admin authentication: logs in
- Admin API client → Submission management: manages submissions
- Admin API client → Volunteer management: manages volunteers
- Admin API client → Account management: manages accounts
- Admin API client → Ally management: manages allies
- Admin API client → Roulette management: manages images
- Submission management → Session guard: guards routes (evidence: `backend/src/submissions/admin-submissions.controller.ts`)
- Volunteer management → Session guard: guards routes (evidence: `backend/src/volunteers/admin-volunteers.controller.ts`)
- Ally management → Session guard: guards routes (evidence: `backend/src/allies/admin-allies.controller.ts`)
- Roulette management → Session guard: guards routes (evidence: `backend/src/roulette/admin-roulette.controller.ts`)
- Session guard → Account management: checks active account (evidence: `backend/src/admin/auth/admin.guard.ts`)
- Submission management → Submission workflow: delegates to (evidence: `backend/src/submissions/admin-submissions.controller.ts`)
- Volunteer management → Volunteer workflow: delegates to (evidence: `backend/src/volunteers/admin-volunteers.controller.ts`)
- Ally management → Allies workflow: delegates to (evidence: `backend/src/allies/admin-allies.controller.ts`)
- Roulette management → Roulette workflow: delegates to (evidence: `backend/src/roulette/admin-roulette.controller.ts`)
- Account management → Postgres access: reads and writes (evidence: `backend/src/admin/admins/admins.service.ts`)
- Allies workflow → Postgres access: reads and writes (evidence: `backend/src/allies/allies.service.ts`)
- Roulette workflow → Postgres access: reads and writes (evidence: `backend/src/roulette/roulette.service.ts`)
- Allies workflow → Supabase Storage: stores logos (evidence: `backend/src/allies/allies.service.ts`)
- Roulette workflow → Supabase Storage: stores images (evidence: `backend/src/roulette/roulette.service.ts`)
