# hosoo-code/updated-mod architecture

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

- Interactive diagram: https://gitdiagram.com/hosoo-code/updated-mod
- Repository: https://github.com/hosoo-code/updated-mod

## Overview

ARHAT MODERATOR is a Mongolian moderator-profile and identity-verification platform. Users register or sign in, submit a moderator application, then complete a camera-based verification flow; administrators review submissions and publish moderator profiles. The graph also preserves weekly checks, location sharing, private document storage, and admin operations. Source excerpts show several API-to-service calls; other links are documented in the README or marked unverified where implementation wiring was not sampled.

Main entry points: [`src/app/api/apply`](https://github.com/hosoo-code/updated-mod/tree/main/src/app/api/apply) (Application endpoints), [`src/app/api/verifications`](https://github.com/hosoo-code/updated-mod/tree/main/src/app/api/verifications) (Verification endpoints), [`src/lib/repo.ts`](https://github.com/hosoo-code/updated-mod/blob/main/src/lib/repo.ts) (Domain repository), [`src/components/camera/verification-wizard.tsx`](https://github.com/hosoo-code/updated-mod/blob/main/src/components/camera/verification-wizard.tsx) (Verification wizard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["User experience"]
  node_profile["Moderator profiles"]
  node_location["Location sharing<br/>[location-share.tsx]"]
  node_directory["Moderator directory"]
end

subgraph group_verification["Verification and applications"]
  node_apply["Application wizard<br/>[apply-wizard.tsx]"]
  node_verification_wizard["Verification wizard"]
  node_camera["Camera capture<br/>[face-capture.tsx]"]
  node_upload["Client uploads<br/>[client-upload.ts]"]
  node_weekly["Weekly verification<br/>[route.ts]"]
end

subgraph group_services["API and services"]
  node_auth["Authentication<br/>[auth.ts]"]
  node_application_api["Application endpoints"]
  node_verification_api["Verification endpoints"]
  node_location_api["Location endpoints<br/>[route.ts]"]
  node_admin_routes["Admin endpoints"]
  node_security["API security<br/>[security.ts]"]
  node_repository["Domain repository<br/>[repo.ts]"]
  node_supabase[("Supabase database<br/>[server.ts]")]
  node_r2[("Private document storage<br/>[r2.ts]")]
  node_validation["Input validation<br/>[validation.ts]"]
end

subgraph group_operations["Admin and directory"]
  node_admin_review["Admin review<br/>[review-client.tsx]"]
end

node_visitor(("Visitor / user"))
node_admin(("Administrator"))
node_mediapipe["Face detection runtime"]
node_r2_service[("Cloudflare R2")]

node_visitor -.->|"signs in"| node_auth
node_visitor -.->|"submits application"| node_apply
node_apply -.->|"submits data"| node_application_api
node_application_api -->|"checks requests"| node_security
node_application_api -->|"requires user"| node_auth
node_application_api -->|"validates input"| node_validation
node_application_api -->|"persists application"| node_repository
node_application_api -->|"registers images"| node_r2
node_verification_wizard -->|"renders capture"| node_camera
node_verification_wizard -->|"uploads evidence"| node_upload
node_visitor -.->|"starts verification"| node_verification_wizard
node_camera -.->|"detects faces"| node_mediapipe
node_verification_wizard -.->|"submits verification"| node_verification_api
node_verification_api -->|"checks requests"| node_security
node_verification_api -->|"requires user"| node_auth
node_verification_api -->|"validates input"| node_validation
node_verification_api -->|"reads and writes"| node_repository
node_verification_api -.->|"requests document URLs"| node_r2
node_repository -->|"queries database"| node_supabase
node_r2 -.->|"stores objects"| node_r2_service
node_visitor -.->|"starts weekly check"| node_weekly
node_weekly -->|"records check"| node_repository
node_visitor -.->|"shares location"| node_location
node_location -.->|"sends location"| node_location_api
node_location_api -->|"stores location"| node_repository
node_admin -.->|"reviews submissions"| node_admin_review
node_admin_review -.->|"requests decisions"| node_admin_routes
node_admin_routes -.->|"manages records"| node_repository
node_visitor -.->|"browses moderators"| node_directory
node_directory -.->|"opens profiles"| node_profile

click node_auth "https://github.com/hosoo-code/updated-mod/blob/main/src/lib/auth.ts"
click node_profile "https://github.com/hosoo-code/updated-mod/tree/main/src/app/moderators"
click node_apply "https://github.com/hosoo-code/updated-mod/blob/main/src/app/moderator/apply/apply-wizard.tsx"
click node_application_api "https://github.com/hosoo-code/updated-mod/tree/main/src/app/api/apply"
click node_verification_wizard "https://github.com/hosoo-code/updated-mod/blob/main/src/components/camera/verification-wizard.tsx"
click node_camera "https://github.com/hosoo-code/updated-mod/blob/main/src/components/camera/face-capture.tsx"
click node_upload "https://github.com/hosoo-code/updated-mod/blob/main/src/lib/client-upload.ts"
click node_verification_api "https://github.com/hosoo-code/updated-mod/tree/main/src/app/api/verifications"
click node_weekly "https://github.com/hosoo-code/updated-mod/blob/main/src/app/api/weekly/route.ts"
click node_location "https://github.com/hosoo-code/updated-mod/blob/main/src/components/location/location-share.tsx"
click node_location_api "https://github.com/hosoo-code/updated-mod/blob/main/src/app/api/locations/route.ts"
click node_admin_review "https://github.com/hosoo-code/updated-mod/blob/main/src/app/admin/verifications/%5Bid%5D/review-client.tsx"
click node_admin_routes "https://github.com/hosoo-code/updated-mod/tree/main/src/app/api/admin"
click node_directory "https://github.com/hosoo-code/updated-mod/blob/main/src/app/moderators/moderator-directory.tsx"
click node_security "https://github.com/hosoo-code/updated-mod/blob/main/src/lib/security.ts"
click node_repository "https://github.com/hosoo-code/updated-mod/blob/main/src/lib/repo.ts"
click node_supabase "https://github.com/hosoo-code/updated-mod/blob/main/src/lib/supabase/server.ts"
click node_r2 "https://github.com/hosoo-code/updated-mod/blob/main/src/lib/r2.ts"
click node_validation "https://github.com/hosoo-code/updated-mod/blob/main/src/lib/validation.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_profile,node_location,node_directory,node_visitor toneBlue
class node_apply,node_verification_wizard,node_camera,node_upload,node_weekly,node_r2_service toneAmber
class node_auth,node_application_api,node_verification_api,node_location_api,node_admin_routes,node_security,node_repository,node_supabase,node_r2,node_validation toneMint
class node_admin_review toneRose
class node_admin,node_mediapipe toneIndigo
```

## Components

### User experience

- [Moderator profiles](https://github.com/hosoo-code/updated-mod/tree/main/src/app/moderators): `src/app/moderators`
- [Location sharing](https://github.com/hosoo-code/updated-mod/blob/main/src/components/location/location-share.tsx): `src/components/location/location-share.tsx`
- [Moderator directory](https://github.com/hosoo-code/updated-mod/blob/main/src/app/moderators/moderator-directory.tsx): `src/app/moderators/moderator-directory.tsx`

### Verification and applications

- [Application wizard](https://github.com/hosoo-code/updated-mod/blob/main/src/app/moderator/apply/apply-wizard.tsx): `src/app/moderator/apply/apply-wizard.tsx`
- [Verification wizard](https://github.com/hosoo-code/updated-mod/blob/main/src/components/camera/verification-wizard.tsx): `src/components/camera/verification-wizard.tsx`
- [Camera capture](https://github.com/hosoo-code/updated-mod/blob/main/src/components/camera/face-capture.tsx): `src/components/camera/face-capture.tsx`
- [Client uploads](https://github.com/hosoo-code/updated-mod/blob/main/src/lib/client-upload.ts): `src/lib/client-upload.ts`
- [Weekly verification](https://github.com/hosoo-code/updated-mod/blob/main/src/app/api/weekly/route.ts): `src/app/api/weekly/route.ts`

### API and services

- [Authentication](https://github.com/hosoo-code/updated-mod/blob/main/src/lib/auth.ts): `src/lib/auth.ts`
- [Application endpoints](https://github.com/hosoo-code/updated-mod/tree/main/src/app/api/apply): `src/app/api/apply`
- [Verification endpoints](https://github.com/hosoo-code/updated-mod/tree/main/src/app/api/verifications): `src/app/api/verifications`
- [Location endpoints](https://github.com/hosoo-code/updated-mod/blob/main/src/app/api/locations/route.ts): `src/app/api/locations/route.ts`
- [Admin endpoints](https://github.com/hosoo-code/updated-mod/tree/main/src/app/api/admin): `src/app/api/admin`
- [API security](https://github.com/hosoo-code/updated-mod/blob/main/src/lib/security.ts): `src/lib/security.ts`
- [Domain repository](https://github.com/hosoo-code/updated-mod/blob/main/src/lib/repo.ts): `src/lib/repo.ts`
- [Supabase database](https://github.com/hosoo-code/updated-mod/blob/main/src/lib/supabase/server.ts): `src/lib/supabase/server.ts`
- [Private document storage](https://github.com/hosoo-code/updated-mod/blob/main/src/lib/r2.ts): `src/lib/r2.ts`
- [Input validation](https://github.com/hosoo-code/updated-mod/blob/main/src/lib/validation.ts): `src/lib/validation.ts`

### Admin and directory

- [Admin review](https://github.com/hosoo-code/updated-mod/blob/main/src/app/admin/verifications/%5Bid%5D/review-client.tsx): `src/app/admin/verifications/[id]/review-client.tsx`

### Other components

- **Visitor / user**
- **Administrator**
- **Face detection runtime**
- **Cloudflare R2**

## Connections

- Visitor / user → Authentication: signs in (evidence: `README.md`)
- Visitor / user → Application wizard: submits application (evidence: `README.md`)
- Application wizard → Application endpoints: submits data (evidence: `README.md`)
- Application endpoints → API security: checks requests (evidence: `src/app/api/apply/submit/route.ts`)
- Application endpoints → Authentication: requires user (evidence: `src/app/api/apply/submit/route.ts`)
- Application endpoints → Input validation: validates input (evidence: `src/app/api/apply/submit/route.ts`)
- Application endpoints → Domain repository: persists application (evidence: `src/app/api/apply/submit/route.ts`)
- Application endpoints → Private document storage: registers images (evidence: `src/app/api/apply/register-image/route.ts`)
- Verification wizard → Camera capture: renders capture (evidence: `src/components/camera/verification-wizard.tsx`)
- Verification wizard → Client uploads: uploads evidence (evidence: `src/components/camera/verification-wizard.tsx`)
- Visitor / user → Verification wizard: starts verification (evidence: `README.md`)
- Camera capture → Face detection runtime: detects faces (evidence: `README.md`)
- Verification wizard → Verification endpoints: submits verification (evidence: `README.md`)
- Verification endpoints → API security: checks requests (evidence: `src/app/api/verifications/route.ts`)
- Verification endpoints → Authentication: requires user (evidence: `src/app/api/verifications/route.ts`)
- Verification endpoints → Input validation: validates input (evidence: `src/app/api/verifications/route.ts`)
- Verification endpoints → Domain repository: reads and writes (evidence: `src/app/api/verifications/route.ts`)
- Verification endpoints → Private document storage: requests document URLs (evidence: `README.md`)
- Domain repository → Supabase database: queries database (evidence: `src/lib/repo.ts`)
- Private document storage → Cloudflare R2: stores objects (evidence: `README.md`)
- Visitor / user → Weekly verification: starts weekly check (evidence: `README.md`)
- Weekly verification → Domain repository: records check (evidence: `src/app/api/weekly/route.ts`)
- Visitor / user → Location sharing: shares location (evidence: `README.md`)
- Location sharing → Location endpoints: sends location (evidence: `README.md`)
- Location endpoints → Domain repository: stores location (evidence: `src/app/api/locations/route.ts`)
- Administrator → Admin review: reviews submissions (evidence: `README.md`)
- Admin review → Admin endpoints: requests decisions (evidence: `README.md`)
- Admin endpoints → Domain repository: manages records (evidence: `README.md`)
- Visitor / user → Moderator directory: browses moderators (evidence: `README.md`)
- Moderator directory → Moderator profiles: opens profiles (evidence: `README.md`)
