# protonmind03/internet_updated architecture

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

- Interactive diagram: https://gitdiagram.com/protonmind03/internet_updated
- Repository: https://github.com/protonmind03/internet_updated

## Overview

This repository implements an OJT (on-the-job training) portal for students, supervisors, and coordinators, with a React PWA and a Node backend. A representative workflow is a student recording attendance, with photo/liveness checks and offline queuing, then syncing through the API to backend persistence. The portals also support supervisor task and record review, coordinator administration and analytics, documents, complaints, evaluations, and notifications. The graph captures major documented capabilities; backend route details are largely unsampled, so uncertain client-to-server links are dashed.

Main entry points: [`backend/src/server.ts`](https://github.com/protonmind03/internet_updated/blob/main/backend/src/server.ts) (HTTP API), [`my-pwa/src/App.tsx`](https://github.com/protonmind03/internet_updated/blob/main/my-pwa/src/App.tsx) (Portal router), [`my-pwa/src/pages/student/useAttendance.ts`](https://github.com/protonmind03/internet_updated/blob/main/my-pwa/src/pages/student/useAttendance.ts) (Attendance capture), [`backend/src/routes/extensions.ts`](https://github.com/protonmind03/internet_updated/blob/main/backend/src/routes/extensions.ts) (Extended routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["PWA and access"]
  node_app["Portal router<br/>[App.tsx]"]
  node_session["Session and auth<br/>[session.ts]"]
  node_api["API client<br/>[api.ts]"]
  node_offline[("Offline storage<br/>[offlineStore.ts]")]
  node_queue["Offline queue<br/>[offlineQueue.ts]"]
  node_notifyui["Notification UI"]
end

subgraph group_student["Student workflows"]
  node_student_attendance["Attendance capture<br/>[useAttendance.ts]"]
  node_student_pages["Student portal"]
end

subgraph group_supervisor["Supervisor workflows"]
  node_supervisor_work["Supervisor work"]
  node_supervisor_tasks["Task review<br/>[tasks.tsx]"]
end

subgraph group_backend["Backend services"]
  node_coordinator["Coordinator portal"]
  node_server["HTTP API<br/>[server.ts]"]
  node_extensions["Extended routes<br/>[extensions.ts]"]
  node_database[("PostgreSQL")]
  node_files["Private files"]
  node_notifications["Notification services"]
  node_insights["Insights and digests<br/>[insights.ts]"]
  node_privacy["Privacy controls<br/>[privacy.ts]"]
  node_audit["Audit trail<br/>[audit.ts]"]
end

node_users(("Portal users"))

node_users -->|"opens portal"| node_app
node_app -->|"routes to"| node_student_pages
node_app -->|"mounts"| node_notifyui
node_student_pages -.->|"uses"| node_student_attendance
node_student_attendance -->|"requests attendance"| node_api
node_student_attendance -->|"reads cached data"| node_offline
node_student_attendance -->|"queues steps"| node_queue
node_queue -->|"syncs requests"| node_api
node_queue -->|"reads and writes"| node_offline
node_app -.->|"routes to"| node_supervisor_work
node_supervisor_tasks -->|"uses work data"| node_supervisor_work
node_supervisor_work -->|"requests records"| node_api
node_app -->|"routes to"| node_coordinator
node_api -.->|"sends HTTP requests"| node_server
node_server -->|"queries"| node_database
node_server -->|"stores and deletes"| node_files
node_server -->|"routes through"| node_extensions
node_server -->|"uses preferences"| node_notifications
node_server -->|"uses insights"| node_insights
node_server -->|"uses privacy controls"| node_privacy
node_server -->|"uses audit service"| node_audit
node_extensions -->|"uses privacy controls"| node_privacy
node_extensions -->|"uses preferences"| node_notifications
node_extensions -->|"uses insights"| node_insights

click node_app "https://github.com/protonmind03/internet_updated/blob/main/my-pwa/src/App.tsx"
click node_session "https://github.com/protonmind03/internet_updated/blob/main/my-pwa/src/lib/session.ts"
click node_api "https://github.com/protonmind03/internet_updated/blob/main/my-pwa/src/lib/api.ts"
click node_offline "https://github.com/protonmind03/internet_updated/blob/main/my-pwa/src/lib/offlineStore.ts"
click node_queue "https://github.com/protonmind03/internet_updated/blob/main/my-pwa/src/lib/offlineQueue.ts"
click node_notifyui "https://github.com/protonmind03/internet_updated/blob/main/my-pwa/src/components/RealtimeNotificationBridge.tsx"
click node_student_attendance "https://github.com/protonmind03/internet_updated/blob/main/my-pwa/src/pages/student/useAttendance.ts"
click node_student_pages "https://github.com/protonmind03/internet_updated/tree/main/my-pwa/src/pages/student"
click node_supervisor_work "https://github.com/protonmind03/internet_updated/blob/main/my-pwa/src/pages/supervisor/useSupervisorWork.ts"
click node_supervisor_tasks "https://github.com/protonmind03/internet_updated/blob/main/my-pwa/src/pages/supervisor/tasks.tsx"
click node_coordinator "https://github.com/protonmind03/internet_updated/tree/main/my-pwa/src/pages/coordinator"
click node_server "https://github.com/protonmind03/internet_updated/blob/main/backend/src/server.ts"
click node_extensions "https://github.com/protonmind03/internet_updated/blob/main/backend/src/routes/extensions.ts"
click node_files "https://github.com/protonmind03/internet_updated/blob/main/backend/src/services/privateFileStore.ts"
click node_notifications "https://github.com/protonmind03/internet_updated/blob/main/backend/src/services/notificationPreferences.ts"
click node_insights "https://github.com/protonmind03/internet_updated/blob/main/backend/src/services/insights.ts"
click node_privacy "https://github.com/protonmind03/internet_updated/blob/main/backend/src/services/privacy.ts"
click node_audit "https://github.com/protonmind03/internet_updated/blob/main/backend/src/services/audit.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_app,node_session,node_api,node_offline,node_queue,node_notifyui,node_users toneBlue
class node_student_attendance,node_student_pages toneAmber
class node_supervisor_work,node_supervisor_tasks toneMint
class node_coordinator,node_server,node_extensions,node_database,node_files,node_notifications,node_insights,node_privacy,node_audit toneRose
```

## Components

### PWA and access

- [Portal router](https://github.com/protonmind03/internet_updated/blob/main/my-pwa/src/App.tsx): `my-pwa/src/App.tsx`
- [Session and auth](https://github.com/protonmind03/internet_updated/blob/main/my-pwa/src/lib/session.ts): `my-pwa/src/lib/session.ts`
- [API client](https://github.com/protonmind03/internet_updated/blob/main/my-pwa/src/lib/api.ts): `my-pwa/src/lib/api.ts`
- [Offline storage](https://github.com/protonmind03/internet_updated/blob/main/my-pwa/src/lib/offlineStore.ts): `my-pwa/src/lib/offlineStore.ts`
- [Offline queue](https://github.com/protonmind03/internet_updated/blob/main/my-pwa/src/lib/offlineQueue.ts): `my-pwa/src/lib/offlineQueue.ts`
- [Notification UI](https://github.com/protonmind03/internet_updated/blob/main/my-pwa/src/components/RealtimeNotificationBridge.tsx): `my-pwa/src/components/RealtimeNotificationBridge.tsx`

### Student workflows

- [Attendance capture](https://github.com/protonmind03/internet_updated/blob/main/my-pwa/src/pages/student/useAttendance.ts): `my-pwa/src/pages/student/useAttendance.ts`
- [Student portal](https://github.com/protonmind03/internet_updated/tree/main/my-pwa/src/pages/student): `my-pwa/src/pages/student`

### Supervisor workflows

- [Supervisor work](https://github.com/protonmind03/internet_updated/blob/main/my-pwa/src/pages/supervisor/useSupervisorWork.ts): `my-pwa/src/pages/supervisor/useSupervisorWork.ts`
- [Task review](https://github.com/protonmind03/internet_updated/blob/main/my-pwa/src/pages/supervisor/tasks.tsx): `my-pwa/src/pages/supervisor/tasks.tsx`

### Backend services

- [Coordinator portal](https://github.com/protonmind03/internet_updated/tree/main/my-pwa/src/pages/coordinator): `my-pwa/src/pages/coordinator`
- [HTTP API](https://github.com/protonmind03/internet_updated/blob/main/backend/src/server.ts): `backend/src/server.ts`
- [Extended routes](https://github.com/protonmind03/internet_updated/blob/main/backend/src/routes/extensions.ts): `backend/src/routes/extensions.ts`
- **PostgreSQL**
- [Private files](https://github.com/protonmind03/internet_updated/blob/main/backend/src/services/privateFileStore.ts): `backend/src/services/privateFileStore.ts`
- [Notification services](https://github.com/protonmind03/internet_updated/blob/main/backend/src/services/notificationPreferences.ts): `backend/src/services/notificationPreferences.ts`
- [Insights and digests](https://github.com/protonmind03/internet_updated/blob/main/backend/src/services/insights.ts): `backend/src/services/insights.ts`
- [Privacy controls](https://github.com/protonmind03/internet_updated/blob/main/backend/src/services/privacy.ts): `backend/src/services/privacy.ts`
- [Audit trail](https://github.com/protonmind03/internet_updated/blob/main/backend/src/services/audit.ts): `backend/src/services/audit.ts`

### Other components

- **Portal users**

## Connections

- Portal users → Portal router: opens portal
- Portal router → Student portal: routes to (evidence: `my-pwa/src/App.tsx`)
- Portal router → Notification UI: mounts (evidence: `my-pwa/src/App.tsx`)
- Student portal → Attendance capture: uses
- Attendance capture → API client: requests attendance (evidence: `my-pwa/src/pages/student/useAttendance.ts`)
- Attendance capture → Offline storage: reads cached data (evidence: `my-pwa/src/pages/student/useAttendance.ts`)
- Attendance capture → Offline queue: queues steps (evidence: `my-pwa/src/pages/student/useAttendance.ts`)
- Offline queue → API client: syncs requests (evidence: `my-pwa/src/lib/offlineQueue.ts`)
- Offline queue → Offline storage: reads and writes (evidence: `my-pwa/src/lib/offlineQueue.ts`)
- Portal router → Supervisor work: routes to
- Task review → Supervisor work: uses work data (evidence: `my-pwa/src/pages/supervisor/tasks.tsx`)
- Supervisor work → API client: requests records (evidence: `my-pwa/src/pages/supervisor/useSupervisorWork.ts`)
- Portal router → Coordinator portal: routes to (evidence: `my-pwa/src/App.tsx`)
- API client → HTTP API: sends HTTP requests
- HTTP API → PostgreSQL: queries (evidence: `backend/src/server.ts`)
- HTTP API → Private files: stores and deletes (evidence: `backend/src/server.ts`)
- HTTP API → Extended routes: routes through (evidence: `backend/src/server.ts`)
- HTTP API → Notification services: uses preferences (evidence: `backend/src/server.ts`)
- HTTP API → Insights and digests: uses insights (evidence: `backend/src/server.ts`)
- HTTP API → Privacy controls: uses privacy controls (evidence: `backend/src/server.ts`)
- HTTP API → Audit trail: uses audit service (evidence: `backend/src/server.ts`)
- Extended routes → Privacy controls: uses privacy controls (evidence: `backend/src/routes/extensions.ts`)
- Extended routes → Notification services: uses preferences (evidence: `backend/src/routes/extensions.ts`)
- Extended routes → Insights and digests: uses insights (evidence: `backend/src/routes/extensions.ts`)
