# 03 — Modules / Subsystems

There are two sources, and they do not split the system the same way:

| Source | Date | Granularity | Status |
|---|---|---|---|
| **BA draw.io source** (`TNSU_EDU 191069.drawio` in the repo root, received 2026-10-30; rendered in [ba-drawio.md](ba-drawio.md)) | 2026-10-30 | 7 pages: module overview, university and school sub-modules (23 modules, ~80 functions), organisation structure, curriculum list, 2 process flows | **Primary.** Collected by the BA from the client, so it is the closest thing to requirements we have. Replaces the earlier image `assets/ba-module-structure.png`; the module lists in both are identical |
| Proposal §4.1 / §6.1 (TNSU-01…12) | 27-10-2026 | 12 subsystems, functional/channel split | Secondary. A sales-level view that includes channels and cross-cutting services the BA chart does not list |

**Rule:** for "what functions exist", use the BA structure. For channels (apps, portal), finance, e-document, AI and integration, the proposal is the only source, and those areas are still open (see §C below and [11-open-questions-and-known-issues.md](11-open-questions-and-known-issues.md)).

> **See also [12-use-cases.md](12-use-cases.md).** The team's use cases use a third, more detailed taxonomy (35 modules such as ADM, REG, FIN, SCH = scholarships, ATH, SAFE), with a mapping to the codes below. For behaviour (who does what, in which order), the use cases are the primary source.

## A. BA module structure (primary)

The draw.io file has two module pages, **Sub Module-วิทยาลัย** and **Sub Module-โรงเรียน**, plus an overview page **module** whose root is "ระบบการจัดการบริหารการศึกษา" and shows only the 8 university modules. (The earlier image combined both branches under "ระบบบริหารข้อมูลภาพรวมทุกหน่วยงานภายใต้ TNSU".) The two branches:

- **UNI**: ระบบบริหารการศึกษาระดับมหาวิทยาลัย (university level, 17 campuses), 8 modules
- **SS**: ระบบบริหารโรงเรียนกีฬาและนักเรียนประจำ (sports and boarding schools, 13 schools), 15 modules

> The codes `UNI-xx` and `SS-xx` (and sub-codes like `UNI-04.6`) are **our convention** for referencing these modules in docs, tickets and code. They are not on the BA chart. The chart numbers each branch from 1.
>
> In the source file, UNI 1–6 are **green** (`#d5e8d4`) while UNI 7–8 and all SS modules are **pink** (`#f8cecc`). The file has no legend, so the meaning is still **[unknown]** (e.g. agreed vs. draft, or phase). Ask the BA.

### UNI — University level

| Code | Module | Functions |
|---|---|---|
| **UNI-01** | ระบบงานควบคุม (control / system settings) | 1.1 จัดการค่าธรรมเนียมการศึกษา: fee types, fee rates (Fee Rate) · 1.2 ปีการศึกษา/ภาคเรียน (academic years and semesters) · 1.3 User Permission |
| **UNI-02** | การรับเข้าเป็นนักศึกษา (admission) | 2.1 รับสมัครนักศึกษา (applications) · 2.2 รับเข้าและยืนยันสิทธิ์ (admit and confirm) |
| **UNI-03** | งานทะเบียน (registrar) | 3.1 จัดการข้อมูลนักศึกษา (student records) · 3.2 จัดการสถานะนักศึกษา (student status) · 3.3 คำร้องนักศึกษา (student requests) |
| **UNI-04** | งานวิชาการและหลักสูตร (academics and curriculum) | 4.1 ข้อมูลพื้นฐาน: education levels, faculties, majors · 4.2 จัดการหลักสูตร (curricula) · 4.3 จัดการโครงสร้างหลักสูตร (curriculum structure) · 4.4 จัดการรายวิชา (courses) · 4.5 จัดกลุ่มรายวิชาในหลักสูตร (course groups) · 4.6 จัดการวิชาบังคับก่อน (prerequisites) · 4.7 จัดทำแผนการเรียน (study plans) · 4.8 จัดการเปิดรายวิชา (course offerings) · 4.9 จัดการอาจารย์ผู้สอน (instructors) |
| **UNI-05** | การลงทะเบียนเรียน (course registration) | 5.1 จัดการรอบ/ช่วงเวลาลงทะเบียน (registration rounds and windows) · 5.2 จัดการเปิดรายวิชาลงทะเบียน (open sections) · 5.3 จัดตารางเรียนและตารางสอบ (class and exam timetables) · 5.4 ลงทะเบียนเรียน (register) · 5.5 เพิ่ม/ถอน/เปลี่ยนกลุ่มเรียน (add, drop, change section) · 5.6 จัดการอนุมัติการลงทะเบียน (registration approval) |
| **UNI-06** | การวัดและประเมินผลการศึกษา (assessment and grading) | 6.1 ตั้งค่าการประเมินผล: assessment types, result formats, grading schemes · 6.2 กำหนดเกณฑ์การประเมินรายวิชา (per-course assessment criteria) · 6.3 กำหนดเกณฑ์ตัดเกรดรายวิชา (per-course grade cut-offs) · 6.4 บันทึกและประมวลผลคะแนน (score entry and processing) · 6.5 ตรวจสอบและอนุมัติผลการเรียน (review and approve grades) · 6.6 ประกาศผลการเรียนและคำนวณ GPA/GPAX (publish grades, GPA/GPAX) · 6.7 จัดการคำร้องแก้ไขผลการเรียน (grade-correction requests) · 6.8 ตรวจสอบสำเร็จการศึกษา (graduation audit) |
| **UNI-07** | การวัดและประเมินผลอาจารย์ผู้สอน (instructor evaluation) | 7.1 จัดการแบบประเมินอาจารย์ (evaluation forms) · 7.2 กำหนดรอบการประเมิน (evaluation rounds) · 7.3 กำหนดรายวิชาที่ประเมิน (courses to evaluate) · 7.4 ประเมินอาจารย์ผู้สอนและประมวลผล (run the evaluation and process results) |
| **UNI-08** | ระบบด้านการจัดการศิษย์เก่า (alumni) | 8.1 จัดการข้อมูลศิษย์เก่า (alumni records) · 8.2 ลงทะเบียนและปรับปรุงข้อมูลศิษย์เก่า (alumni self-registration and updates) · 8.3 สำรวจและติดตามข้อมูลศิษย์เก่า (alumni surveys and tracking) |

### SS — Sports schools and boarding students

| Code | Module | Functions |
|---|---|---|
| **SS-01** | ระบบรับสมัครและคัดเลือกนักเรียน (admission and selection) | 1.1 จัดการรอบรับสมัครและเกณฑ์การคัดเลือก (rounds and selection criteria) · 1.2 รับสมัครและตรวจสอบใบสมัคร (receive and verify applications) · 1.3 จัดการสอบและบันทึกผลการคัดเลือก (selection exams and results; for a sports school this probably includes sports-skill tests [inferred]) · 1.4 ประกาศผลและรายงานตัวนักเรียน (announce results, student reporting-in / มอบตัว) |
| **SS-02** | ระบบทะเบียนและประวัตินักเรียน (student registry) | 2.1 จัดการทะเบียนและประวัตินักเรียน (records and history) · 2.2 จัดการข้อมูลผู้ปกครอง (parents/guardians) · 2.3 จัดการสถานภาพและการย้ายสถานศึกษา (status, transfers) · 2.4 จัดการเลื่อนชั้นและสำเร็จการศึกษา (grade promotion, graduation) |
| **SS-03** | ระบบบริหารหลักสูตรและการเรียนการสอน (curriculum and teaching) | 3.1 จัดการหลักสูตรและรายวิชา (curriculum and subjects) · 3.2 จัดการชั้นเรียนและครูผู้สอน (classes/homerooms and teachers) · 3.3 จัดการตารางเรียนและตารางสอบ (timetables) · 3.4 จัดการแผนการสอน (lesson plans) |
| **SS-04** | ระบบวัดผลและประเมินผลการเรียน (assessment) | 4.1 กำหนดเกณฑ์และรายการประเมิน (criteria and assessment items) · 4.2 บันทึกคะแนนและประมวลผลการเรียน (scores and results) · 4.3 ตรวจสอบและอนุมัติผลการเรียน (approve) · 4.4 จัดทำเอกสารและรายงานผลการเรียน (transcripts and report cards; probably the ปพ. forms [inferred]) |
| **SS-05** | ระบบบริหารจัดการหอพักนักเรียน (dormitory) | 5.1 จัดการอาคาร ห้องพัก และเตียง (buildings, rooms, **beds**) · 5.2 จัดสรรและย้ายห้องพักนักเรียน (allocate and move) · 5.3 จัดการครูเวรและตรวจหอพัก (duty-teacher roster, dorm inspections) · 5.4 ติดตามสถานะการเข้าพักและแจ้งซ่อม (occupancy status, **maintenance requests**) |
| **SS-06** | ระบบเช็กชื่อและติดตามนักเรียน (roll call and tracking) | 6.1 ตั้งค่ารอบและประเภทการเช็กชื่อ (roll-call rounds and types, e.g. class, dorm, training, meals [inferred]) · 6.2 บันทึกการเช็กชื่อนักเรียน (record roll call) · 6.3 ติดตามการขาด ลา มาสาย และนักเรียนไม่พบตัว (absent, on leave, late, **student not found / missing**) |
| **SS-07** | ระบบการลาและการขออนุญาตออกนอกโรงเรียน (leave and off-campus permission) | 7.1 ยื่นคำร้องขอลาและออกนอกโรงเรียน (submit) · 7.2 พิจารณาและอนุมัติคำร้อง (approve) · 7.3 บันทึกการออกและกลับเข้าโรงเรียน (exit and return log) · 7.4 ติดตามสถานะและประวัติการลา (status and history) |
| **SS-08** | ระบบโภชนาการและอาหารนักเรียน (nutrition and meals) | 8.1 จัดการเมนูและแผนอาหาร (menus and meal plans) · 8.2 จัดการข้อมูลโภชนาการและข้อจำกัดด้านอาหาร (nutrition data, dietary restrictions and allergies) · 8.3 บันทึกการรับประทานอาหาร (meal attendance log) · 8.4\* จัดการวัตถุดิบและต้นทุนอาหาร (ingredients and food cost) |
| **SS-09** | ระบบสุขภาพและสวัสดิการนักเรียน (health and welfare) | 9.1 จัดการข้อมูลสุขภาพนักเรียน (health records) · 9.2 บันทึกการเจ็บป่วยและการรักษา (illness and treatment) · 9.3 ติดตามการบาดเจ็บและการฟื้นฟู (sports injuries and rehabilitation) · 9.4 จัดการสวัสดิการและเหตุฉุกเฉิน (welfare and emergencies) |
| **SS-10** | ระบบบริหารการฝึกซ้อมกีฬา (training) | 10.1 จัดการชนิดกีฬา ทีม และผู้ฝึกสอน (sports, teams, coaches) · 10.2 จัดการแผนและตารางฝึกซ้อม (training plans and schedule) · 10.3 บันทึกและติดตามผลการฝึกซ้อม (training results) |
| **SS-11** | ระบบบริหารการแข่งขันและผลงานนักกีฬา (competitions and achievements) | 11.1 จัดการรายการแข่งขันและผู้เข้าร่วม (events and entrants) · 11.2 จัดการเดินทางและเอกสารการแข่งขัน (travel and competition documents) · 11.3 บันทึกผลการแข่งขันและรางวัล (results and awards) · 11.4 ติดตามประวัติและผลงานนักกีฬา (athlete track record) |
| **SS-12** | ระบบประเมินสมรรถภาพและพัฒนาศักยภาพนักกีฬา (fitness testing and athlete development) | 12.1 จัดการเกณฑ์และรอบการทดสอบ (test criteria and rounds) · 12.2 บันทึกผลทดสอบสมรรถภาพและทักษะกีฬา (fitness and skill test results) · 12.3 ติดตามพัฒนาการและแผนพัฒนานักกีฬา (progress and development plans) |
| **SS-13** | ระบบกิจการนักเรียนและระเบียบวินัย (student affairs and discipline) | 13.1 จัดการพฤติกรรมและระเบียบวินัย (behaviour and discipline, probably conduct points [inferred]) · 13.2 จัดการกิจกรรมและการเข้าร่วม (activities and participation) · 13.3 บันทึกการให้คำปรึกษาและติดตามนักเรียน (counselling records and follow-up) |
| **SS-14** | ระบบสื่อสารและบริการผู้ปกครอง (parent communication and services) | 14.1 ข้อมูลนักเรียนในความดูแล (children under care) · 14.2 ติดตามผลการเรียนและการเข้าเรียน (grades and attendance) · 14.3 ยืนยันคำร้องและติดตามการลา (**parent confirms requests**, tracks leave) · 14.4\* ข่าวสารและการแจ้งเตือน (news and notifications) |
| **SS-15** | ระบบรายงานและสารสนเทศสำหรับผู้บริหาร (executive reporting) | 15.1 Dashboard ภาพรวมส่วนกลางและรายโรงเรียน (overview across central office and per school) · 15.2 รายงานด้านการศึกษาและนักเรียน (education and students) · 15.3 รายงานด้านหอพักและกิจการนักเรียน (dorms and student affairs) · 15.4\* รายงานด้านกีฬาและสมรรถภาพนักกีฬา (sports and fitness) |

\* On the chart these are numbered 8.3, 14.3 and 15.3 a second time (duplicate numbers). We renumbered them to .4 here.

### Observations about the BA structure

- **Asymmetry between the branches.** Sports, dorm, health, nutrition, roll call, leave and discipline exist **only under SS**. Fees, instructor evaluation and alumni exist **only under UNI**. The proposal implies both levels share athletes, dorm, finance and the executive dashboard. Whether this asymmetry is intended is **[unknown]**.
- **Shared concepts implemented twice.** Admission, registry, curriculum, timetable and assessment appear in both branches with different depth (UNI has prerequisites, study plans, registration rounds and GPAX; SS has homerooms, lesson plans and promotion). Design implication [inferred]: shared core entities (person, org unit, academic year/term, course, timetable, assessment) with level-specific rules, rather than two separate systems.
- **System-level settings live inside UNI-01** (fees, academic year, user permissions). They probably need to be central for both branches [inferred].
- **Requests** appear as UNI-03.3 (student requests), UNI-06.7 (grade correction), SS-07 (leave/exit) and SS-14.3 (parent confirmation). A generic request/approval engine fits [inferred].

## A2. Organisation structure (BA draw.io page "โครงสร้างหน่วยงานของระบบ")

```mermaid
flowchart TD
  U[มหาวิทยาลัยการกีฬาแห่งชาติ] --> C[วิทยาเขต 1…17]
  U --> S[โรงเรียน 1…13]
  C --> F[คณะ]
  F --> M[สาขา]
  M --> P[หลักสูตร]
  S --> G[ระดับชั้น]
  G --> T[ชนิดกีฬา]
```

- **University branch:** campus → faculty → major (สาขา) → curriculum (หลักสูตร). Faculties hang **under each campus**.
- **Sports-school branch:** school → grade level (ระดับชั้น) → **sport type (ชนิดกีฬา)**. Sport type sits under the grade level, so a school's students are organised by grade and then by sport.
- This is the org-unit tree for data scoping and permissions (see [13-role-matrix.md](13-role-matrix.md)).

## A3. Curriculum list (BA draw.io page "หลักสูตร")

The real programmes, grouped by degree and faculty. Three faculties offer programmes.

| Degree | Faculty | Programme |
|---|---|---|
| ปริญญาตรี | คณะวิทยาศาสตร์การกีฬาและสุขภาพ | วท.บ. สาขาวิชาวิทยาศาสตร์การกีฬาและการออกกำลังกาย (ปรับปรุง พ.ศ. 2568) |
| ปริญญาตรี | คณะศิลปศาสตร์ | ศศ.บ. สาขาวิชาการจัดการการกีฬา (ปรับปรุง พ.ศ. 2568) |
| ปริญญาตรี | คณะศิลปศาสตร์ | ศศ.บ. สาขาวิชาการท่องเที่ยวและนันทนาการ (ปรับปรุง พ.ศ. 2568) |
| ปริญญาตรี | คณะศึกษาศาสตร์ | ศษ.บ. สาขาวิชาพลศึกษา (4 ปี) (ปรับปรุง พ.ศ. 2568) |
| ปริญญาตรี | คณะศึกษาศาสตร์ | ศษ.บ. สาขาวิชาพลศึกษาและสุขศึกษา (4 ปี) (ปรับปรุง พ.ศ. 2568) |
| ปริญญาโท | คณะศิลปศาสตร์ | บธ.ม. สาขาวิชาการจัดการการกีฬา การท่องเที่ยวและนันทนาการ |
| ปริญญาโท | คณะศึกษาศาสตร์ | ศษ.ม. สาขาวิชาพลศึกษาและกีฬา (M.Ed. Physical Education and Sports) |
| ปริญญาเอก | คณะศิลปศาสตร์ | บธ.ด. สาขาวิชาการจัดการการกีฬา การท่องเที่ยวและนันทนาการ (D.B.A. Tourism and Recreation Management) |
| ปริญญาเอก | คณะศึกษาศาสตร์ | ปร.ด. สาขาวิชาพลศึกษาและกีฬา (Ph.D. Physical Education and Sports) |

- 9 programmes in total: 5 bachelor's, 2 master's, 2 doctoral. The diagram lists the English and Thai names of the same graduate programme as two lines; they are paired here [inferred].
- **Graduate programmes exist**, so the use-case module GRAD (ป.โท/ป.เอก) is real scope.
- The faculties in the proposal's mockups (บริหารธุรกิจ, สหเวชศาสตร์) were sample data and are not in this list.
- Not stated: which campuses offer which programmes, and whether some programmes are also offered with a different curriculum year.

## A4. BA process flows

The draw.io file has two flows; they are written out in [05-workflows.md](05-workflows.md) (§15 and §16) and rendered in [ba-drawio.md](ba-drawio.md).

## B. Mapping: proposal subsystems ↔ BA modules

| Proposal code | Subsystem | BA modules | Coverage in BA |
|---|---|---|---|
| TNSU-01 | University Education Management | UNI-02, 03, 04, 05, 06, 08 | ✅ detailed |
| TNSU-02 | Sports School Management | SS-01, 02, 03, 04, 06, 07, 13 | ✅ detailed |
| TNSU-03 | Sports & Athlete Management | SS-10, 11, 12 | ⚠️ school only. University athletes are missing |
| TNSU-04 | Boarding & Student Welfare | SS-05, 08, 09 | ⚠️ school only |
| TNSU-05 | Financial & Scholarship Management | UNI-01.1 (fee types and rates only) | ❌ no payments, receipts, reconciliation, กยศ. or scholarships. Nothing for schools |
| TNSU-06 | Student Mobile Application | — | ❌ channel; not in BA chart |
| TNSU-07 | Parent Mobile Application | SS-14 (functions) | ⚠️ functions for school parents only |
| TNSU-08 | Student Web Portal | — | ❌ channel; not in BA chart |
| TNSU-09 | Staff Backoffice & e-Document | Implicit (all backoffice functions) | ❌ no e-document, e-signature or DGA |
| TNSU-10 | Executive Dashboard & AI | SS-15 | ⚠️ school reporting only; no university dashboard; no AI analytics or bot |
| TNSU-11 | Central Administration | UNI-01 (academic year, permissions) | ⚠️ thin: no org-unit master data, audit log or central user management |
| TNSU-12 | Integration Services | — | ❌ not in BA chart |
| (none) | Instructor evaluation | UNI-07 | ➕ new in BA |
| (none) | Roll call / missing-student tracking | SS-06 | ➕ new in BA |
| (none) | Discipline and counselling | SS-13 | ➕ more specific than proposal |
| (none) | Food cost and ingredients | SS-08.4 | ➕ new in BA |
| (none) | Dorm maintenance requests and duty teachers | SS-05.3, 05.4 | ➕ new in BA |

Proposal §6.1 (delivery-scope list) → proposal codes: 1→TNSU-10, 2→TNSU-11, 3→admission in TNSU-01/02, 4→rest of TNSU-01/02, 5→TNSU-03, 6→TNSU-04, 7→TNSU-05, 8→TNSU-06/07/08, 9 and 10→TNSU-09, 11→notifications and AI bot, 12→TNSU-12 plus security.

## C. Open scope gaps (to confirm with BA and client)

1. Finance at both levels: payment gateway, receipts, กยศ., scholarships. These are in the proposal but missing from the BA chart.
2. e-Document, e-Signature and DGA.
3. AI analytics and AI bot.
4. Student mobile app and student web portal, and which BA functions they expose.
5. University-level executive dashboard (SS-15 covers schools only, but the mockups show a university-wide dashboard).
6. Athletes, dorms and health for university students.
7. ~~Integration with legacy E-Education~~: not needed. There is no legacy system (confirmed 2026-10-30).
8. Central administration: org units (17 + 13), audit log, cross-unit roles.
9. Meaning of the green/pink colours on the chart.