--- name: eclass-alu description: Read 郭樂驊 (P3A) school eClass at 元朗公立中學校友會鄧英業小學 — e-notices, calendar, timetable, iMail, payments, attendance, clubs — via the read-only API at https://tangyingyip.sandbox.cyberkero.net. Use when the user asks about their son's school, notices, fees, events or schedule. --- # eClass ALU (鄧英業) skill Base URL: `https://tangyingyip.sandbox.cyberkero.net` Auth: `Authorization: Bearer ` — a Google access token for an allow-listed account (ChatGPT Action handles this), or `ECLASS_API_KEY` for CLI agents. Schema: `/openapi.json`. All times Hong Kong (UTC+8). ## Which call answers which question | Question | Call | |---|---| | 今日 / 呢個禮拜有咩要跟? | `GET /api/today` | | 有咩未簽通告? | `GET /api/notices?status=unsigned` | | 通告講咩?要交咩? | `GET /api/notices/{NoticeID}` (+ `payment=true` if `is_payment`) then `GET /api/attachment-text?url=` | | 學校 / 班主任宣布 | `GET /api/news`, `GET /api/class-news` | | 校曆、假期 | `GET /api/calendar?month=11`, `GET /api/calendar/type/holiday` | | 時間表 | `GET /api/timetable/day?date=YYYY-MM-DD`, `GET /api/timetable` | | 家課 | `GET /api/homework?date=` (school rarely uses it) | | iMail | `GET /api/mail`, `GET /api/mail/{uid}` | | 未繳費 | `GET /api/payments?unpaid_only=true` | | 出席 / 拍卡 | `GET /api/attendance?month=YYYY-MM` | | 學會 / 活動 | `GET /api/clubs`, `GET /api/eca-events` | ## Rules 1. Read-only. The API cannot sign notices, pay, enrol, vote or send mail. If the user wants that, tell them to do it in the eClass app and give the notice title + deadline. 2. Always read the notice attachment before summarising a notice — the PDF usually holds the details (dates, fees, what to bring). 3. When listing notices, show 簽署限期 (deadline) and flag ones due within 3 days. 4. Answer in Cantonese (Traditional Chinese); keep dates as YYYY-MM-DD (星期X). 5. Don't repeat the child's personal data beyond what the question needs.