# sanjay082039-source/japanese-website architecture

> Architecture diagram of the GitHub repository sanjay082039-source/japanese-website, 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/sanjay082039-source/japanese-website
- Repository: https://github.com/sanjay082039-source/japanese-website

## Overview

This is a Japanese-language LMS for JLPT N1–N5, serving students and administrators/teachers. Students authenticate, access curriculum and schedules, complete assignments and exams, and track attendance; instructors administer those activities and review student performance. The graph keeps curriculum, assessment, attendance, and AI tutoring as distinct product stages, with authentication and persistence as shared internal layers. Major README capabilities are represented, but many page-to-API links are not shown in the sampled evidence and are therefore omitted.

Main entry points: [`src/lib/prisma.ts`](https://github.com/sanjay082039-source/japanese-website/blob/main/src/lib/prisma.ts) (Prisma Database), [`src/app`](https://github.com/sanjay082039-source/japanese-website/tree/main/src/app) (Role Portals), [`src/app/admin`](https://github.com/sanjay082039-source/japanese-website/tree/main/src/app/admin) (Admin Controls), [`src/app/api/auth/login/route.ts`](https://github.com/sanjay082039-source/japanese-website/blob/main/src/app/api/auth/login/route.ts) (Login API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Portal Access"]
  node_portal["Role Portals"]
  node_authapi["Login API<br/>[route.ts]"]
end

subgraph group_learning["Learning Content"]
  node_curriculum["JLPT Curriculum<br/>[route.ts]"]
  node_materials["Study Materials<br/>[route.ts]"]
  node_tutor["Sensei Chat<br/>[route.ts]"]
  node_chatwidget["Chat Widget<br/>[ChatbotWidget.tsx]"]
  node_homework["Daily Homework<br/>[route.ts]"]
  node_questionbank["Question Bank"]
end

subgraph group_assessment["Assessment"]
  node_assignments["Assignments &amp; Grading<br/>[route.ts]"]
  node_examadmin["Exam Management<br/>[route.ts]"]
  node_exams["Exam Delivery<br/>[route.ts]"]
  node_proctor["Exam Proctoring"]
  node_violations["Violation Logging<br/>[route.ts]"]
end

subgraph group_operations["Course Operations"]
  node_attendance[("Attendance Records<br/>[route.ts]")]
  node_liveattendance["Live Attendance<br/>[route.ts]"]
  node_biometrics["Biometric Enrollment<br/>[route.ts]"]
  node_timetable["Timetable<br/>[route.ts]"]
  node_admin["Admin Controls"]
  node_dossier["Student Dossier<br/>[route.ts]"]
  node_shortlist["Student Shortlist<br/>[route.ts]"]
end

subgraph group_platform["Shared Services"]
  node_auth["Session &amp; Roles<br/>[auth.ts]"]
  node_ai["Gemini Client<br/>[gemini.ts]"]
  node_db[("Prisma Database<br/>[prisma.ts]")]
  node_device["Device Sessions<br/>[device.ts]"]
end

node_people(("Students &amp; Staff"))

node_people -->|"use portal"| node_portal
node_portal -.->|"sign in"| node_authapi
node_authapi -->|"creates session"| node_auth
node_authapi -->|"checks users"| node_db
node_authapi -->|"checks device"| node_device
node_auth -->|"validates sessions"| node_db
node_portal -.->|"access curriculum"| node_curriculum
node_curriculum -->|"reads chapters"| node_db
node_curriculum -.->|"returns resources"| node_materials
node_chatwidget -.->|"sends questions"| node_tutor
node_tutor -->|"requests responses"| node_ai
node_tutor -->|"retrieves course data"| node_db
node_portal -.->|"requests homework"| node_homework
node_homework -->|"uses questions"| node_questionbank
node_homework -->|"generates content"| node_ai
node_homework -->|"reads progress"| node_db
node_portal -.->|"submits work"| node_assignments
node_assignments -->|"checks access"| node_auth
node_assignments -->|"stores submissions"| node_db
node_admin -.->|"manages exams"| node_examadmin
node_examadmin -->|"generates questions"| node_ai
node_portal -.->|"takes exams"| node_exams
node_exams -.->|"runs monitoring"| node_proctor
node_proctor -->|"posts violations"| node_violations
node_violations -->|"records violations"| node_db
node_admin -.->|"runs live sessions"| node_liveattendance
node_liveattendance -->|"records presence"| node_attendance
node_liveattendance -->|"manages sessions"| node_db
node_portal -.->|"views attendance"| node_attendance
node_attendance -->|"reads and writes"| node_db
node_biometrics -->|"stores credentials"| node_db
node_liveattendance -.->|"verifies identity"| node_biometrics
node_portal -.->|"views schedule"| node_timetable
node_timetable -->|"reads schedule"| node_db
node_admin -.->|"reviews students"| node_dossier
node_dossier -->|"reads records"| node_db
node_admin -.->|"reviews eligibility"| node_shortlist
node_shortlist -->|"reads performance"| node_db

click node_portal "https://github.com/sanjay082039-source/japanese-website/tree/main/src/app"
click node_authapi "https://github.com/sanjay082039-source/japanese-website/blob/main/src/app/api/auth/login/route.ts"
click node_auth "https://github.com/sanjay082039-source/japanese-website/blob/main/src/lib/auth.ts"
click node_curriculum "https://github.com/sanjay082039-source/japanese-website/blob/main/src/app/api/chapters/route.ts"
click node_materials "https://github.com/sanjay082039-source/japanese-website/blob/main/src/app/api/chapters/route.ts"
click node_tutor "https://github.com/sanjay082039-source/japanese-website/blob/main/src/app/api/chat/route.ts"
click node_chatwidget "https://github.com/sanjay082039-source/japanese-website/blob/main/src/components/chatbot/ChatbotWidget.tsx"
click node_ai "https://github.com/sanjay082039-source/japanese-website/blob/main/src/lib/gemini.ts"
click node_homework "https://github.com/sanjay082039-source/japanese-website/blob/main/src/app/api/student/daily-homework/route.ts"
click node_questionbank "https://github.com/sanjay082039-source/japanese-website/blob/main/src/lib/homeworkQuestionBank.ts"
click node_assignments "https://github.com/sanjay082039-source/japanese-website/blob/main/src/app/api/assignments/route.ts"
click node_examadmin "https://github.com/sanjay082039-source/japanese-website/blob/main/src/app/api/admin/exams/ai-generate/route.ts"
click node_exams "https://github.com/sanjay082039-source/japanese-website/blob/main/src/app/api/exams/%5Bid%5D/attempt/route.ts"
click node_proctor "https://github.com/sanjay082039-source/japanese-website/blob/main/src/hooks/useProctoringEngine.ts"
click node_violations "https://github.com/sanjay082039-source/japanese-website/blob/main/src/app/api/exams/log-violation/route.ts"
click node_attendance "https://github.com/sanjay082039-source/japanese-website/blob/main/src/app/api/attendance/route.ts"
click node_liveattendance "https://github.com/sanjay082039-source/japanese-website/blob/main/src/app/api/attendance/live-session/route.ts"
click node_biometrics "https://github.com/sanjay082039-source/japanese-website/blob/main/src/app/api/biometrics/route.ts"
click node_timetable "https://github.com/sanjay082039-source/japanese-website/blob/main/src/app/api/timetable/route.ts"
click node_admin "https://github.com/sanjay082039-source/japanese-website/tree/main/src/app/admin"
click node_dossier "https://github.com/sanjay082039-source/japanese-website/blob/main/src/app/api/admin/dossier/route.ts"
click node_shortlist "https://github.com/sanjay082039-source/japanese-website/blob/main/src/app/api/admin/shortlist/route.ts"
click node_db "https://github.com/sanjay082039-source/japanese-website/blob/main/src/lib/prisma.ts"
click node_device "https://github.com/sanjay082039-source/japanese-website/blob/main/src/lib/device.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_portal,node_authapi toneBlue
class node_curriculum,node_materials,node_tutor,node_chatwidget,node_homework,node_questionbank toneAmber
class node_assignments,node_examadmin,node_exams,node_proctor,node_violations toneMint
class node_attendance,node_liveattendance,node_biometrics,node_timetable,node_admin,node_dossier,node_shortlist toneRose
class node_auth,node_ai,node_db,node_device,node_people toneIndigo
```

## Components

### Portal Access

- [Role Portals](https://github.com/sanjay082039-source/japanese-website/tree/main/src/app): `src/app`
- [Login API](https://github.com/sanjay082039-source/japanese-website/blob/main/src/app/api/auth/login/route.ts): `src/app/api/auth/login/route.ts`

### Learning Content

- [JLPT Curriculum](https://github.com/sanjay082039-source/japanese-website/blob/main/src/app/api/chapters/route.ts): `src/app/api/chapters/route.ts`
- [Study Materials](https://github.com/sanjay082039-source/japanese-website/blob/main/src/app/api/chapters/route.ts): `src/app/api/chapters/route.ts`
- [Sensei Chat](https://github.com/sanjay082039-source/japanese-website/blob/main/src/app/api/chat/route.ts): `src/app/api/chat/route.ts`
- [Chat Widget](https://github.com/sanjay082039-source/japanese-website/blob/main/src/components/chatbot/ChatbotWidget.tsx): `src/components/chatbot/ChatbotWidget.tsx`
- [Daily Homework](https://github.com/sanjay082039-source/japanese-website/blob/main/src/app/api/student/daily-homework/route.ts): `src/app/api/student/daily-homework/route.ts`
- [Question Bank](https://github.com/sanjay082039-source/japanese-website/blob/main/src/lib/homeworkQuestionBank.ts): `src/lib/homeworkQuestionBank.ts`

### Assessment

- [Assignments & Grading](https://github.com/sanjay082039-source/japanese-website/blob/main/src/app/api/assignments/route.ts): `src/app/api/assignments/route.ts`
- [Exam Management](https://github.com/sanjay082039-source/japanese-website/blob/main/src/app/api/admin/exams/ai-generate/route.ts): `src/app/api/admin/exams/ai-generate/route.ts`
- [Exam Delivery](https://github.com/sanjay082039-source/japanese-website/blob/main/src/app/api/exams/%5Bid%5D/attempt/route.ts): `src/app/api/exams/[id]/attempt/route.ts`
- [Exam Proctoring](https://github.com/sanjay082039-source/japanese-website/blob/main/src/hooks/useProctoringEngine.ts): `src/hooks/useProctoringEngine.ts`
- [Violation Logging](https://github.com/sanjay082039-source/japanese-website/blob/main/src/app/api/exams/log-violation/route.ts): `src/app/api/exams/log-violation/route.ts`

### Course Operations

- [Attendance Records](https://github.com/sanjay082039-source/japanese-website/blob/main/src/app/api/attendance/route.ts): `src/app/api/attendance/route.ts`
- [Live Attendance](https://github.com/sanjay082039-source/japanese-website/blob/main/src/app/api/attendance/live-session/route.ts): `src/app/api/attendance/live-session/route.ts`
- [Biometric Enrollment](https://github.com/sanjay082039-source/japanese-website/blob/main/src/app/api/biometrics/route.ts): `src/app/api/biometrics/route.ts`
- [Timetable](https://github.com/sanjay082039-source/japanese-website/blob/main/src/app/api/timetable/route.ts): `src/app/api/timetable/route.ts`
- [Admin Controls](https://github.com/sanjay082039-source/japanese-website/tree/main/src/app/admin): `src/app/admin`
- [Student Dossier](https://github.com/sanjay082039-source/japanese-website/blob/main/src/app/api/admin/dossier/route.ts): `src/app/api/admin/dossier/route.ts`
- [Student Shortlist](https://github.com/sanjay082039-source/japanese-website/blob/main/src/app/api/admin/shortlist/route.ts): `src/app/api/admin/shortlist/route.ts`

### Shared Services

- [Session & Roles](https://github.com/sanjay082039-source/japanese-website/blob/main/src/lib/auth.ts): `src/lib/auth.ts`
- [Gemini Client](https://github.com/sanjay082039-source/japanese-website/blob/main/src/lib/gemini.ts): `src/lib/gemini.ts`
- [Prisma Database](https://github.com/sanjay082039-source/japanese-website/blob/main/src/lib/prisma.ts): `src/lib/prisma.ts`
- [Device Sessions](https://github.com/sanjay082039-source/japanese-website/blob/main/src/lib/device.ts): `src/lib/device.ts`

### Other components

- **Students & Staff**

## Connections

- Students & Staff → Role Portals: use portal
- Role Portals → Login API: sign in
- Login API → Session & Roles: creates session (evidence: `src/app/api/auth/login/route.ts`)
- Login API → Prisma Database: checks users (evidence: `src/app/api/auth/login/route.ts`)
- Login API → Device Sessions: checks device (evidence: `src/app/api/auth/login/route.ts`)
- Session & Roles → Prisma Database: validates sessions (evidence: `src/lib/auth.ts`)
- Role Portals → JLPT Curriculum: access curriculum
- JLPT Curriculum → Prisma Database: reads chapters (evidence: `src/app/api/chapters/route.ts`)
- JLPT Curriculum → Study Materials: returns resources (evidence: `src/app/api/chapters/route.ts`)
- Chat Widget → Sensei Chat: sends questions
- Sensei Chat → Gemini Client: requests responses (evidence: `src/app/api/chat/route.ts`)
- Sensei Chat → Prisma Database: retrieves course data (evidence: `src/app/api/chat/route.ts`)
- Role Portals → Daily Homework: requests homework
- Daily Homework → Question Bank: uses questions (evidence: `src/app/api/student/daily-homework/route.ts`)
- Daily Homework → Gemini Client: generates content (evidence: `src/app/api/student/daily-homework/route.ts`)
- Daily Homework → Prisma Database: reads progress (evidence: `src/app/api/student/daily-homework/route.ts`)
- Role Portals → Assignments & Grading: submits work
- Assignments & Grading → Session & Roles: checks access (evidence: `src/app/api/assignments/route.ts`)
- Assignments & Grading → Prisma Database: stores submissions (evidence: `src/app/api/assignments/route.ts`)
- Admin Controls → Exam Management: manages exams
- Exam Management → Gemini Client: generates questions
- Role Portals → Exam Delivery: takes exams
- Exam Delivery → Exam Proctoring: runs monitoring
- Exam Proctoring → Violation Logging: posts violations (evidence: `src/hooks/useProctoringEngine.ts`)
- Violation Logging → Prisma Database: records violations (evidence: `src/app/api/exams/log-violation/route.ts`)
- Admin Controls → Live Attendance: runs live sessions
- Live Attendance → Attendance Records: records presence (evidence: `src/app/api/attendance/live-session/route.ts`)
- Live Attendance → Prisma Database: manages sessions (evidence: `src/app/api/attendance/live-session/route.ts`)
- Role Portals → Attendance Records: views attendance
- Attendance Records → Prisma Database: reads and writes (evidence: `src/app/api/attendance/route.ts`)
- Biometric Enrollment → Prisma Database: stores credentials (evidence: `src/app/api/biometrics/route.ts`)
- Live Attendance → Biometric Enrollment: verifies identity
- Role Portals → Timetable: views schedule
- Timetable → Prisma Database: reads schedule (evidence: `src/app/api/timetable/route.ts`)
- Admin Controls → Student Dossier: reviews students
- Student Dossier → Prisma Database: reads records (evidence: `src/app/api/admin/dossier/route.ts`)
- Admin Controls → Student Shortlist: reviews eligibility
- Student Shortlist → Prisma Database: reads performance (evidence: `src/app/api/admin/shortlist/route.ts`)
