# danchik-312/helpthechildren architecture

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

- Interactive diagram: https://gitdiagram.com/danchik-312/helpthechildren
- Repository: https://github.com/danchik-312/helpthechildren

## Overview

This repository implements a public-facing organizational website, an authenticated content-management console, and an API that serves published content and accepts administrative changes. The public workflow routes visitors to content pages, whose repository fetches and shapes API data; editors use the console to manage content, media, site settings, and publication features. The graph includes major documented capabilities, but several relationships are omitted or shown as unverified because their implementations were not sampled.

Main entry points: [`admin/src/api/apiClient.js`](https://github.com/danchik-312/helpthechildren/blob/main/admin/src/api/apiClient.js) (Admin API client), [`server/src/routes/public.routes.js`](https://github.com/danchik-312/helpthechildren/blob/main/server/src/routes/public.routes.js) (Public API routes), [`server/src/routes/admin.routes.js`](https://github.com/danchik-312/helpthechildren/blob/main/server/src/routes/admin.routes.js) (Admin API routes), [`client/src/App.js`](https://github.com/danchik-312/helpthechildren/blob/main/client/src/App.js) (Public routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_public["Public website"]
  node_public_app["Public routes<br/>[App.js]"]
  node_public_pages["Content pages"]
  node_repository["Content repository"]
end

subgraph group_admin["Admin console"]
  node_admin_app["Admin routes<br/>[App.js]"]
  node_admin_auth["Session and access<br/>[AuthContext.js]"]
  node_api_client["Admin API client<br/>[apiClient.js]"]
  node_content_editors["Content editors<br/>[ContentFormPage.js]"]
  node_media_editor["Media editor<br/>[MediaPage.js]"]
  node_site_editors["Site settings"]
  node_admin_operations["Admin operations<br/>[AdminUsersPage.js]"]
end

subgraph group_api["API and domain services"]
  node_public_routes["Public API routes<br/>[public.routes.js]"]
  node_content_domain["Content domain<br/>[content.service.js]"]
  node_auth_domain["Authentication<br/>[auth.service.js]"]
  node_site_domain["Site and hero settings"]
  node_admin_routes["Admin API routes<br/>[admin.routes.js]"]
  node_database[("Application database<br/>[prisma.js]")]
end

subgraph group_media["Media management"]
  node_media_routes["Media API routes<br/>[media.routes.js]"]
  node_media_domain["Media service<br/>[media.service.js]"]
  node_media_storage["Media storage"]
end

node_visitor(("Visitor"))
node_editor(("Administrator"))

node_visitor -->|"opens site"| node_public_app
node_public_app -->|"routes to"| node_public_pages
node_public_pages -.->|"loads content"| node_repository
node_repository -->|"requests public data"| node_public_routes
node_public_routes -->|"routes content"| node_content_domain
node_public_routes -->|"queries homepage and search"| node_database
node_editor -->|"opens console"| node_admin_app
node_admin_app -->|"guards routes"| node_admin_auth
node_admin_auth -->|"uses API"| node_api_client
node_content_editors -.->|"sends edits"| node_api_client
node_media_editor -.->|"manages media"| node_api_client
node_site_editors -.->|"updates settings"| node_api_client
node_admin_operations -->|"manages users"| node_api_client
node_api_client -.->|"calls admin API"| node_admin_routes
node_admin_routes -.->|"dispatches auth"| node_auth_domain
node_admin_routes -.->|"dispatches content"| node_content_domain
node_admin_routes -.->|"mounts media routes"| node_media_routes
node_media_routes -->|"dispatches media actions"| node_media_domain
node_public_routes -->|"mounts site and hero routes"| node_site_domain
node_media_domain -.->|"stores files"| node_media_storage

click node_public_app "https://github.com/danchik-312/helpthechildren/blob/main/client/src/App.js"
click node_public_pages "https://github.com/danchik-312/helpthechildren/tree/main/client/src/pages"
click node_repository "https://github.com/danchik-312/helpthechildren/blob/main/client/src/services/contentRepository.js"
click node_admin_app "https://github.com/danchik-312/helpthechildren/blob/main/admin/src/App.js"
click node_admin_auth "https://github.com/danchik-312/helpthechildren/blob/main/admin/src/auth/AuthContext.js"
click node_api_client "https://github.com/danchik-312/helpthechildren/blob/main/admin/src/api/apiClient.js"
click node_content_editors "https://github.com/danchik-312/helpthechildren/blob/main/admin/src/pages/ContentFormPage.js"
click node_media_editor "https://github.com/danchik-312/helpthechildren/blob/main/admin/src/pages/MediaPage.js"
click node_site_editors "https://github.com/danchik-312/helpthechildren/blob/main/admin/src/pages/OrganizationPage.js"
click node_admin_operations "https://github.com/danchik-312/helpthechildren/blob/main/admin/src/pages/AdminUsersPage.js"
click node_public_routes "https://github.com/danchik-312/helpthechildren/blob/main/server/src/routes/public.routes.js"
click node_content_domain "https://github.com/danchik-312/helpthechildren/blob/main/server/src/modules/content/content.service.js"
click node_auth_domain "https://github.com/danchik-312/helpthechildren/blob/main/server/src/modules/auth/auth.service.js"
click node_site_domain "https://github.com/danchik-312/helpthechildren/tree/main/server/src/modules/site"
click node_admin_routes "https://github.com/danchik-312/helpthechildren/blob/main/server/src/routes/admin.routes.js"
click node_media_routes "https://github.com/danchik-312/helpthechildren/blob/main/server/src/modules/media/media.routes.js"
click node_media_domain "https://github.com/danchik-312/helpthechildren/blob/main/server/src/modules/media/media.service.js"
click node_media_storage "https://github.com/danchik-312/helpthechildren/blob/main/server/src/storage/local-media-storage.js"
click node_database "https://github.com/danchik-312/helpthechildren/blob/main/server/src/db/prisma.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_public_app,node_public_pages,node_repository toneBlue
class node_admin_app,node_admin_auth,node_api_client,node_content_editors,node_media_editor,node_site_editors,node_admin_operations toneAmber
class node_public_routes,node_content_domain,node_auth_domain,node_site_domain,node_admin_routes,node_database toneMint
class node_media_routes,node_media_domain,node_media_storage toneRose
class node_visitor,node_editor toneIndigo
```

## Components

### Public website

- [Public routes](https://github.com/danchik-312/helpthechildren/blob/main/client/src/App.js): `client/src/App.js`
- [Content pages](https://github.com/danchik-312/helpthechildren/tree/main/client/src/pages): `client/src/pages`
- [Content repository](https://github.com/danchik-312/helpthechildren/blob/main/client/src/services/contentRepository.js): `client/src/services/contentRepository.js`

### Admin console

- [Admin routes](https://github.com/danchik-312/helpthechildren/blob/main/admin/src/App.js): `admin/src/App.js`
- [Session and access](https://github.com/danchik-312/helpthechildren/blob/main/admin/src/auth/AuthContext.js): `admin/src/auth/AuthContext.js`
- [Admin API client](https://github.com/danchik-312/helpthechildren/blob/main/admin/src/api/apiClient.js): `admin/src/api/apiClient.js`
- [Content editors](https://github.com/danchik-312/helpthechildren/blob/main/admin/src/pages/ContentFormPage.js): `admin/src/pages/ContentFormPage.js`
- [Media editor](https://github.com/danchik-312/helpthechildren/blob/main/admin/src/pages/MediaPage.js): `admin/src/pages/MediaPage.js`
- [Site settings](https://github.com/danchik-312/helpthechildren/blob/main/admin/src/pages/OrganizationPage.js): `admin/src/pages/OrganizationPage.js`
- [Admin operations](https://github.com/danchik-312/helpthechildren/blob/main/admin/src/pages/AdminUsersPage.js): `admin/src/pages/AdminUsersPage.js`

### API and domain services

- [Public API routes](https://github.com/danchik-312/helpthechildren/blob/main/server/src/routes/public.routes.js): `server/src/routes/public.routes.js`
- [Content domain](https://github.com/danchik-312/helpthechildren/blob/main/server/src/modules/content/content.service.js): `server/src/modules/content/content.service.js`
- [Authentication](https://github.com/danchik-312/helpthechildren/blob/main/server/src/modules/auth/auth.service.js): `server/src/modules/auth/auth.service.js`
- [Site and hero settings](https://github.com/danchik-312/helpthechildren/tree/main/server/src/modules/site): `server/src/modules/site`
- [Admin API routes](https://github.com/danchik-312/helpthechildren/blob/main/server/src/routes/admin.routes.js): `server/src/routes/admin.routes.js`
- [Application database](https://github.com/danchik-312/helpthechildren/blob/main/server/src/db/prisma.js): `server/src/db/prisma.js`

### Media management

- [Media API routes](https://github.com/danchik-312/helpthechildren/blob/main/server/src/modules/media/media.routes.js): `server/src/modules/media/media.routes.js`
- [Media service](https://github.com/danchik-312/helpthechildren/blob/main/server/src/modules/media/media.service.js): `server/src/modules/media/media.service.js`
- [Media storage](https://github.com/danchik-312/helpthechildren/blob/main/server/src/storage/local-media-storage.js): `server/src/storage/local-media-storage.js`

### Other components

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

## Connections

- Visitor → Public routes: opens site (evidence: `client/src/App.js`)
- Public routes → Content pages: routes to (evidence: `client/src/App.js`)
- Content pages → Content repository: loads content
- Content repository → Public API routes: requests public data (evidence: `client/src/services/contentRepository.js`)
- Public API routes → Content domain: routes content (evidence: `server/src/routes/public.routes.js`)
- Public API routes → Application database: queries homepage and search (evidence: `server/src/routes/public.routes.js`)
- Administrator → Admin routes: opens console (evidence: `admin/src/App.js`)
- Admin routes → Session and access: guards routes (evidence: `admin/src/App.js`)
- Session and access → Admin API client: uses API (evidence: `admin/src/auth/AuthContext.js`)
- Content editors → Admin API client: sends edits
- Media editor → Admin API client: manages media
- Site settings → Admin API client: updates settings
- Admin operations → Admin API client: manages users (evidence: `admin/src/pages/AdminUsersPage.js`)
- Admin API client → Admin API routes: calls admin API
- Admin API routes → Authentication: dispatches auth
- Admin API routes → Content domain: dispatches content
- Admin API routes → Media API routes: mounts media routes
- Media API routes → Media service: dispatches media actions (evidence: `server/src/modules/media/media.routes.js`)
- Public API routes → Site and hero settings: mounts site and hero routes (evidence: `server/src/routes/public.routes.js`)
- Media service → Media storage: stores files
