Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
28 commits
Select commit Hold shift + click to select a range
6c01ea0
docs: khởi tạo checklist Phase 6 và hoãn phát hành
WindowScary321 Oct 23, 2026
c829b70
feat: bổ sung command đọc Phase 6 và doctor an toàn
WindowScary321 Oct 24, 2026
4a52872
docs: ghi coverage command đọc Phase 6 và phần còn gate
WindowScary321 Oct 24, 2026
4c29b81
feat: đọc rating student v1 và chặn stub v2 trước HTTP
WindowScary321 Oct 24, 2026
d6d0ee6
test: chuẩn hóa màu ANSI khi kiểm lỗi option Phase 6
WindowScary321 Oct 24, 2026
0e0c01c
docs: ghi rating list, CI Phase 6 và lượt login chưa đạt
WindowScary321 Oct 24, 2026
ca09b11
docs: ghi live command đọc Phase 6 v2 HN thành công
WindowScary321 Oct 24, 2026
883a7aa
test: giữ lỗi live v1 và ghi gate nghiệm thu Phase 6
WindowScary321 Oct 24, 2026
c56bd61
feat: chuyển training và nhóm rating vào other
WindowScary321 Oct 24, 2026
873603b
docs: ghi thao tác ghi rating/push/feedback chưa thể xác minh
WindowScary321 Oct 24, 2026
c34d7ed
test: nghiệm thu nhóm đọc mục 1 tại seam CLI
WindowScary321 Oct 24, 2026
c489d95
docs: nghiệm thu nhóm mục 2 và chốt credential v2 bằng bytecode
WindowScary321 Oct 24, 2026
af759eb
docs: xac nhan policy credential v2 bang thi nghiem transport hai chieu
WindowScary321 Oct 24, 2026
f288ccc
feat: mở other feedbacks và GetVersion cho doctor sau khi chốt contract
WindowScary321 Oct 24, 2026
3ef5d2a
docs: phân tích khoảng trống endpoint và ghi nhận mở rộng 24/10
WindowScary321 Oct 24, 2026
f3f2bd6
docs: khép checkpoint nhóm đọc với build artifact và quét session mới
WindowScary321 Oct 25, 2026
8529176
feat: transcript --pretty phan tich HTML bang diem toan khoa
WindowScary321 Oct 25, 2026
c5702d4
docs: ghi nhận mục 4-5 Phase 6 khó thực hiện với tài khoản hiện tại
WindowScary321 Oct 25, 2026
dc04710
docs: nghiệm thu mục 6 phase6 trừ hộp duyệt maintainer
WindowScary321 Oct 25, 2026
32d98e7
fix: làm bền parser và sanitize tên file xuất theo quyết định maintainer
WindowScary321 Oct 25, 2026
acbcce8
docs: ghi nhận nghiệm thu maintainer và đóng finding robustness
WindowScary321 Oct 25, 2026
b2dd9f6
feat: myfap exams --ics xuất lịch thi sang định dạng iCalendar
WindowScary321 Oct 26, 2026
a73c1fa
docs: cập nhật tài liệu cho exams --ics
WindowScary321 Oct 26, 2026
39f8cd9
feat: myfap exams --ics thêm cờ --full ẩn slot UUID mặc định
WindowScary321 Oct 26, 2026
4655dfc
docs: cập nhật tài liệu cho exams --full
WindowScary321 Oct 26, 2026
28dee29
fix: thêm lại phòng thi roomNo vào mặc định của exams --ics
WindowScary321 Oct 26, 2026
bc046f6
docs: cập nhật tài liệu về roomNo trong exams --ics
WindowScary321 Oct 26, 2026
3c59911
docs: đồng bộ tài liệu pre-merge và chốt phạm vi mục 4-5 phase 6
WindowScary321 Oct 26, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 10 additions & 1 deletion CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,13 @@

### API và dữ liệu

- Thêm tùy chọn `--ics` và `--full` cho `myfap exams`: xuất lịch thi ra định dạng iCalendar chuẩn RFC 5545 (giờ Việt Nam, UID/DTSTAMP UTC, CRLF); mặc định xuất ICS đưa đầy đủ các thông tin quan trọng (Môn, Phòng thi `roomNo`, Ngày công bố `dateofPublication`), chỉ ẩn mã slot UUID, ghi chú phụ và điểm danh; cờ `--full` kèm toàn bộ thông tin phụ vào sự kiện lịch; xuất JSON mặc định tiếp tục bảo toàn đầy đủ 100% dữ liệu gốc.
- Thêm `myfap other feedbacks` đọc danh sách feedback student qua `GetStudentFeedbacks`, chỉ có trên proxy API v2; envelope đã kiểm chứng live nhưng item schema chưa có positive (danh sách rỗng trên tài khoản kiểm chứng).
- `transcript --pretty` phân tích HTML bảng điểm toàn khóa thành JSON cấu trúc: mỗi bảng giữ header riêng (bảng chính 10 cột `No`…`Status`, bảng phụ 7 cột) và hàng dữ liệu keyed theo header, chuẩn hoá ` `; không dùng `--pretty` vẫn giữ chuỗi HTML nguyên bản theo contract.
- `doctor --api-version v2 --online` báo thêm `backend_version` qua `GetVersion` POST bootstrap; GET bị proxy từ chối 405 và route v1 đã 404. `myfap version` vẫn chỉ đọc package version offline.
- Thêm [phân tích khoảng trống endpoint](docs/endpoint-gap-analysis.md) đối chiếu 82 route của APK với adapter: CLI phủ toàn bộ operation đọc student (ngoại trừ `GetStudentFeedbackForm` đang gate có chủ đích chờ `feedbackId` thực tế); donor/employee, login thay thế và OTA được ghi rõ out of scope.
- Chuyển training và nhóm rating vào `other`: dùng `myfap other training` và `myfap other rating list`, không giữ command root cũ. Endpoint, policy retry và capability từng version không đổi.

- Giữ API v1 làm mặc định. API v2 chỉ được chọn bằng `--api-version v2` hoặc binding của session; không tự chuyển version khi gặp lỗi.
- Bổ sung adapter v2 cho các lệnh đọc hiện có: kỳ học, lịch học/lịch tuần, điểm, lịch thi, điểm danh, đơn từ, news, thông tin sinh viên/campus, học phí, môn học, thông báo và kiểm tra feedback/profile. Survey tiếp tục dùng dịch vụ và chữ ký riêng.
- Coi ID kỳ học là opaque, chọn kỳ mới nhất theo `startDate` và giữ thứ tự server khi ngày trùng nhau. Query dùng đúng tên trường theo từng operation.
Expand All @@ -28,9 +35,11 @@

- Báo cáo Phase 4 ghi nhận các luồng đọc v2 trên HN, gồm login/refresh và JSON/ICS; đây không phải bằng chứng cho mọi campus, tài khoản hoặc route.
- **V1/APHL:** `news` và `other notification` vẫn trả HTTP 200/body 201 với `data: null`; `other fee` vẫn trả HTTP 404 trong lượt chạy lại ngày 19/10/2026. Request đã được đối chiếu với app, nhưng nguyên nhân chưa được xác định. CLI giữ lỗi, không coi là dữ liệu rỗng, hết phiên hoặc route ngừng hỗ trợ trên mọi campus.
- **Phase 6 v1/APHL, ngày 24/10/2026:** courses và marks summary trả HTTP 404; news search/training trả HTTP 200/body 201, data null. CLI giữ lỗi và không fallback; nguyên nhân chưa rõ. V2/HN đã đọc được các command tương ứng, không thay thế kiểm chứng v1.
- **Fee/survey positive:** theo quyết định ngày 19/10/2026, chờ dữ liệu nghiệp vụ phù hợp và không chặn chuyển sang Phase 5. Schema live có dữ liệu vẫn **chưa kiểm chứng**; fee HTTP/body 200 hoặc survey not-found không đủ để đóng các mục này.
- ICS đã được đọc bằng reader độc lập `icalendar`; chưa xác nhận import vào Google Calendar/Outlook. Reader `ics` hiện có giới hạn recursion với lịch lớn.
- Transcript, balance, ảnh, tìm kiếm news, feedback đầy đủ và thao tác ghi thuộc Phase 6, không nằm trong phạm vi phát hành này.
- Phase 6 đã bổ sung transcript, balance, courses/training, subjects theo kỳ, tìm news, ảnh JSON, marks summary, doctor và (24/10/2026) `other feedbacks` cùng `backend_version` cho doctor online; xem coverage Phase 6 và phân tích khoảng trống endpoint. Rating list student/v1 đã có code/fixture; v2 stub bị chặn. Feedback form/submit và thao tác ghi vẫn còn gate contract/schema, không được coi là đã hỗ trợ.
- **Finding robustness từ review Phase 6 (24/10/2026) — đã sửa theo quyết định maintainer trước khi phát hành:** `rowspan` không phải số nguyên không còn làm parser bảng điểm chi tiết crash (coi như 1); ICS nhận `isOnline` boolean, slot vượt nửa đêm kết thúc sang ngày hôm sau và `slotTime` thiếu dấu gạch báo lỗi rõ ràng; tên file xuất thay ký tự đường dẫn để không thoát thư mục `--output`. Chi tiết tại [TODO](tasks/todo.md).
- Maintainer phải chấp nhận rõ phạm vi hỗ trợ và các lỗi v1 còn mở trước khi tạo tag. CI xanh không thay thế nghiệm thu API thật hoặc quyết định này.

## [0.1.8] - Mốc trước 0.2.0
Expand Down
29 changes: 26 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

## Giới thiệu

Đây là cli tương tác giống hoàn toàn với APP MYFAP trên điện thoại. Bạn có thể xem lịch học, lịch thi, điểm số (sự thất vọng của gia đình), thông tin cá nhân, v.v. 1 cách thuận tiện, không bị gò bó trong giao diện app. <br>
CLI tương tác với các API myFAP để xem lịch học, lịch thi, điểm và thông tin sinh viên. Phạm vi hỗ trợ phụ thuộc API version, campus và capability từng endpoint; CLI chưa thay thế đầy đủ mọi chức năng của app. Xem [mapping command/endpoint](./docs/command-endpoints.md) và [coverage Phase 6](./docs/phase6-coverage.md) để biết phần đã triển khai, đã kiểm thử và còn chưa xác minh. <br>
- Lưu ý: repo này được thực hiện cùng với sự hỗ trợ của AI.

## Tính năng chính
Expand Down Expand Up @@ -48,6 +48,28 @@
myfap schedule
```

## Command mở rộng trên nhánh phát triển

Các command sau đang review trong Phase 6, **chưa phát hành lên PyPI**:

```sh
myfap courses --semester Fall2026 --stdout
myfap other subjects --semester Fall2026 --stdout
myfap other balance --stdout
myfap news --search "lịch thi" --type 1 --stdout
myfap transcript --stdout
myfap transcript --pretty --stdout
myfap other training --semester Fall2026 --stdout
myfap marks --summary --stdout
myfap info photo --stdout
myfap other feedbacks --stdout
myfap other rating list --api-version v1 --stdout
myfap doctor --stdout
myfap doctor --api-version v2 --online --stdout
```

`marks --summary` không nhận kỳ học/courseid/pretty. `transcript --pretty` phân tích HTML bảng điểm toàn khóa thành JSON cấu trúc theo header từng bảng; không có `--pretty` giữ nguyên chuỗi gốc. Photo chỉ xuất JSON, không tự tải hoặc giải mã ảnh. Doctor mặc định không đọc session hoặc gọi mạng; `--online` chỉ probe bootstrap proxy v2 (`GetApiActive` và `backend_version` qua `GetVersion`), không xác nhận tài khoản đã đăng nhập. `other feedbacks` chỉ có trên API v2. `other rating list` chỉ hỗ trợ student/v1; v2 là stub và bị chặn. Khác với các lệnh đọc này, rating submit/push/feedback submit còn có gate riêng và chưa được mở.

## Thông tin thêm
- [Chọn API v1 hoặc v2](https://github.com/WindowScary321/myfap-api-cli/blob/main/docs/api-versions.md): v1 vẫn mặc định; v2 hỗ trợ các command đọc hiện có trong Phase 4.
- [Các ví dụ sử dụng](./docs/Example.md)
Expand Down Expand Up @@ -84,8 +106,9 @@ Nếu khai báo cùng option ở nhiều cấp, giá trị ở lệnh con đư
|-d, --date \<YYYY-MM-DD\>|Chỉ định ngày chính xác, chỉ có ở command ``week-timetable``|
|-sc, --subjectcode <mã môn>|Chọn môn học, chỉ có ở command ``attendance``|
|-cn, --classname <mã lớp>|Chọn lớp học, chỉ có ở command ``attendance``|
|--ics|Convert Sang **ICS**, dễ dàng import lịch học vào Google Calendar hoặc các dịch vụ tương tự, chỉ có ở command ``schedule``)|
|-p, --pretty|Format lại bảng điểm gốc của trường sang dạng json, chỉ có ở command ``marks``)|
|--ics|Convert Sang **ICS**, dễ dàng import lịch vào Google Calendar hoặc các dịch vụ tương tự, áp dụng cho command ``schedule`` (lịch học) và ``exams`` (lịch thi))|
|--full|Kèm toàn bộ thông tin phụ khi xuất ICS ở command ``exams`` (ghi chú, mã slot/UUID, điểm danh...); mặc định xuất các thông tin quan trọng (môn, phòng thi, ngày công bố)|
|-p, --pretty|Format lại bảng điểm gốc của trường sang dạng json, có ở command ``marks`` (chi tiết môn) và ``transcript`` (toàn khóa))|
|--output, -o <thư mục>|Thư mục xuất file thay vì thư mục hiện tại|
|--stdout|In kết quả trực tiếp ra màn hình thay vì lưu file|
|-f, --force|Buộc đăng nhập lại, bỏ qua file ``session.json``, chỉ có ở command ``login``|
Expand Down
Loading
Loading