V12.1 · SYSTEM MAP

Cấu trúc chức năng của Tuition Studio

Đây là bản đồ logic để phát triển app mà không làm mất chức năng khi lên version mới.

Hướng dẫn dùng

1. Cấu trúc cấp cao

Organization→Owner/Admin→Academic Manager→Teacher→Group/Class→Course/Curriculum→Session→Student

2. Identity & Permission

Organization MembershipOwner / Manager / Teacher
Server/RLS
Group MembershipTeacher ↔ Group, Student ↔ Group
Scope
Email InvitePending → Verified login → Active
Enrollment
Substitute PermissionSession-level + hết hạn
Temporary

3. Curriculum Engine

Language→Level→Course→Version→Module→Unit→Lesson→Activity / Resource
English=CEFR · Japanese=JLPT · Chinese=HSK · Korean=TOPIK. Cohort phải pin một curriculum version.

4. Teaching Operations

Group ManagementTạo nhóm, roster, invite
Teacher
Schedule EngineTeacher/group/resource overlap + buffer
Hard Guard
AbsenceTeacher request → Manager
Workflow
SubstituteActual teacher thay đổi, Primary giữ nguyên
Session
HandoverLesson plan + roster + shareable notes
Package

5. Learning Engine

Lesson→Assignment/Test→Submission→Grading→Feedback→Progress
Assignment types
Test · Speaking · File · Writing
Completion rules
View · Submit · Score threshold · Teacher mark

6. Student Interaction

Smart TodayViệc ưu tiên từ nhiều lớp
Action Layer
NotebookVocabulary · Grammar · Note
User scoped
Class FeedAnnouncement + comment
Group scoped
Direct ChatConversation Teacher ↔ Student
Conversation

7. Course Lifecycle

Active→Ended / Read-only→90-day Renewal→Archived
Gia hạn = enrollment mới. Khóa cũ, tài nguyên, điểm, submission và feedback không bị xóa.

8. Web ↔ Desktop Data Architecture

Web / Desktop UI→Data Service + Outbox→Auth / Permission / Conflict Check→Cloud PostgreSQL + Storage→Realtime / Delta Sync
Desktop
SQLite cache + file cache.
Web
IndexedDB/cache nhẹ.
Cloud
Source of truth duy nhất.

9. Multi‑Edition

Single Core→English Edition日本語 Edition中文 Edition한국어 EditionEnterprise

Mỗi Edition thay locale/framework/offline defaults nhưng account, organization, groups và progress vẫn dùng chung cloud.

10. Regression Gate bắt buộc

Student
Login · Classes · Calendar · Test · Speaking · File · Writing · Results · Notebook · Feed · Chat · Archive
Teacher
Groups · Invite · Roster · Schedule · Absence · Assignment · Grading · Feed · Chat · Lifecycle
Operations
Conflict · Substitute · Curriculum · Sync · Edition · Link/package check