Student Absence & Academic Accommodation System (SAAS)

One problem, three artefacts: a runnable prototype, an enterprise design package, and the Individual Ideation assignment that motivated them.

一個問題，三份產出：可執行的原型、企業級設計提案包，以及促成這一切的個人創意作業。

Prototype version ｜原型版本：v0.2.0（2026-09-29）· MIT · CI passing

v0.2.0 hardens the prototype: CSRF protection on every form, attachment access control (medical certificates were readable by any logged-in user), overlapping-leave validation, password management, pagination, and a 49-check smoke suite in CI.

Folder	What it is	說明
`leave-system/`	Flask + SQLite prototype (v0.2.0) — student leave, two-level approval (advisor → faculty), CSRF protection, attachment access control, 49-check smoke suite. Runs at `http://127.0.0.1:5055`	可執行原型：學生請假、兩級審批、CSRF 防護、附件權限
`saas/`	Enterprise design package for HKUST(GZ): PRD, architecture & API, data & security, UI design, roadmap & cost, plus full PostgreSQL DDL	企業級設計提案包（6 頁中英對照）＋完整資料庫 DDL
`assignment/`	Individual Ideation assignment (≈1,030 words) + 10-slide deck + 3 figures	個人創意作業：Word 正文、簡報、流程圖

Quick start ｜快速開始

# 原型系統
cd leave-system
python app.py            # http://127.0.0.1:5055
python smoke_test.py     # 49 項全鏈路冒煙測試

# 設計提案包（靜態站）
cd saas
python -m http.server 5066 --bind 127.0.0.1

Demo accounts (password Pass@123): student 2024001, advisor T001, faculty F001, admin admin.

Before deploying: set LEAVE_SECRET (see leave-system/README.md).

Changelog ｜更新日誌

See CHANGELOG.md — v0.2.0 adds CSRF protection, attachment access control, overlapping-leave validation, password management, pagination, and a 49-check smoke suite.

完整變更記錄見 CHANGELOG.md。

Absence workflow ｜請假流程

≤ 3 days → instructor approval only
> 3 days, or an official-activity absence → advisor → faculty review
Official activity roster → auto-verified, instructors notified only
Absence > 7 days → programme office → registry → instructors

Author

Johnny, Jeng-lin Li · HKUST(GZ)

License

Code and documentation are released under the MIT License — see LICENSE. You may use, modify and redistribute freely, including commercially, provided the copyright notice is retained.

程式碼與文件皆採 MIT License，可自由使用、修改、再散布（含商業用途），只需保留著作權聲明。

On assignment/: the Individual Ideation essay is published as a worked example for reference and citation. It must not be submitted as another student's own assessment. If you cite it, please attribute: Li, J. (2026). SAAS: A Student Absence and Academic Accommodation System (Individual Ideation assignment), HKUST(GZ).

assignment/ 內的作業全文僅供參考與引用，不得作為他人作業提交。引用請註明出處。

Jeng-linLi/student-absence-system