education_center.list_students
read按 search、school、gender、status、record_state 分頁查詢學生。
建議先讀取
無
治理與審批
只讀,不建立 action request。
安全說明
列表要 bounded pagination,不可一次 dump 全部學生資料。
以 EducationCenter 真實 MCP manifest 及 CMS workflow 文件整理,覆蓋學生、課程、班別、報名、出席、補堂、發票、付款證明、收款記錄、教學資源、通告、學生事件及請假審批流程。
education_center.list_students
read按 search、school、gender、status、record_state 分頁查詢學生。
建議先讀取
無
治理與審批
只讀,不建立 action request。
安全說明
列表要 bounded pagination,不可一次 dump 全部學生資料。
education_center.get_student
read讀取學生 profile、overview、events、已派發資源與通告。
建議先讀取
education_center.list_students
治理與審批
只讀,不建立 action request。
安全說明
後續 student-centric assign/event write 應以此狀態為準。
education_center.list_courses
read列出課程供班別、報名及 invoice flow 使用。
建議先讀取
無
治理與審批
只讀,不建立 action request。
安全說明
保留 record_state 概念,避免 archived 課程被誤用。
education_center.list_classes
read列出班別,可按 course_id、active_only、record_state 篩選。
建議先讀取
education_center.list_courses
治理與審批
只讀,不建立 action request。
安全說明
報名、attendance、invoice 前先確認班別仍 active 及容量合理。
education_center.list_enrollments
read按 student、class、course 查詢報名紀錄。
建議先讀取
education_center.get_student 或 education_center.list_classes
治理與審批
只讀,不建立 action request。
安全說明
invoice 和 default lessons 應以真實 enrollment 狀態為基礎。
education_center.get_attendance_sheet
read按日期、班別、導師及 unmarked filter 讀取 attendance sheet。
建議先讀取
education_center.list_classes
治理與審批
只讀,不建立 action request。
安全說明
attendance write 必須用讀取到的 lesson identifier。
education_center.list_invoices
read查詢 cashier / student detail invoice summary rows。
建議先讀取
education_center.get_student 或 filters
治理與審批
只讀,不建立 action request。
安全說明
列表只作 summary;要 lessons/payments 明細需 get_invoice。
education_center.get_invoice
read讀取單一 invoice、student、lessons、payments、draft payload。
建議先讀取
education_center.list_invoices
治理與審批
只讀,不建立 action request。
安全說明
update_invoice 或 payment write 前必須先讀取當前 invoice。
education_center.preview_invoice_default_lessons
read由 backend preview invoice default lessons,集中 charge_type 規則。
建議先讀取
education_center.list_enrollments + education_center.list_classes
治理與審批
只讀 preview,不建立 action request。
安全說明
create/update invoice 必須提交 explicit lessons[];不要讓 write 自行重算。
education_center.list_invoice_reminders
read讀取基於 remaining lessons 的 invoice reminders。
建議先讀取
education_center.list_invoices
治理與審批
只讀,不建立 action request。
安全說明
reminder 建議要核對 invoice 狀態及剩餘堂數。
education_center.list_payment_proofs
read按 search、status 查詢付款證明。
建議先讀取
education_center.list_invoices
治理與審批
只讀,不建立 action request。
安全說明
review 前要 get_payment_proof 檢查 invoice/student/payment detail。
education_center.get_payment_proof
read讀取單一付款證明、invoice、student、review 及 applied payment detail。
建議先讀取
education_center.list_payment_proofs
治理與審批
只讀,不建立 action request。
安全說明
apply/reject 前必須確認未重複套用、金額與 invoice 一致。
education_center.list_payment_records
read查詢收款記錄 summary 及 invoice payment status aggregates。
建議先讀取
education_center.list_invoices
治理與審批
只讀,不建立 action request。
安全說明
payment-records 是獨立 domain,不應只當 invoice 附件。
education_center.list_resources
read查詢 learning resources。
建議先讀取
無
治理與審批
只讀,不建立 action request。
安全說明
派發前應 get_resource 查看 assignments。
education_center.get_resource
read讀取單一 learning resource 及 current assignments。
建議先讀取
education_center.list_resources
治理與審批
只讀,不建立 action request。
安全說明
assign/unassign 必須用此狀態避免重複或錯派。
education_center.list_notices
read查詢 notices。
建議先讀取
無
治理與審批
只讀,不建立 action request。
安全說明
通告派發前應讀 get_notice 及目標學生範圍。
education_center.get_notice
read讀取單一 notice 及 assignments。
建議先讀取
education_center.list_notices
治理與審批
只讀,不建立 action request。
安全說明
更新或派發前確認 audience、attachments、read receipts 影響。
education_center.list_student_events
read列出指定學生事件。
建議先讀取
education_center.get_student
治理與審批
只讀,不建立 action request。
安全說明
event write 要保持 student-centric,唔好跨學生誤寫。
education_center.list_leave_requests
read列出請假申請,支援 review workflow。
建議先讀取
education_center.get_attendance_sheet 或 filters
治理與審批
只讀,不建立 action request。
安全說明
請假會影響 attendance / makeup,審批前要讀 detail。
education_center.get_leave_request
read讀取單一請假申請、linked lesson 及 review context。
建議先讀取
education_center.list_leave_requests
治理與審批
只讀,不建立 action request。
安全說明
approve makeup 前確認補堂日期與時間,避免同 reschedule 衝突。
education_center.update_attendance
write更新單一 lesson attendance action。
建議先讀取
education_center.get_attendance_sheet
治理與審批
受治理寫入;可能 executed 或 pending_approval。
安全說明
只用 canonical attendance action;不要直接改 lesson row。
education_center.bulk_update_attendance
write批量更新多個 lessons 的 attendance action。
建議先讀取
education_center.get_attendance_sheet
治理與審批
受治理寫入;可能 executed 或 pending_approval。
安全說明
lesson identifiers 必須來自同一次受控讀取;避免跨 scope 混入。
education_center.reschedule_lesson
write調堂,只更新 makeup_date、makeup_start_time、makeup_end_time。
建議先讀取
education_center.get_attendance_sheet
治理與審批
受治理寫入;可能 executed 或 pending_approval。
安全說明
不可同時改班別、導師、課室或原堂時間。
education_center.create_student_event
write在 student-centric flow 建立一筆 student event。
建議先讀取
education_center.get_student
治理與審批
受治理寫入;可能 executed 或 pending_approval。
安全說明
備註欄位用 event_remark,因 remark 是 MCP governance 欄位。
education_center.update_student_event
write更新一筆 student event。
建議先讀取
education_center.list_student_events
治理與審批
受治理寫入;可能 executed 或 pending_approval。
安全說明
event_id 必須屬於該 student;備註欄位用 event_remark。
education_center.delete_student_event
write刪除一筆 student event。
建議先讀取
education_center.list_student_events
治理與審批
受治理寫入;可能 executed 或 pending_approval。
安全說明
刪除前確認 event_id 與學生一致。
education_center.apply_payment_proof
write批核並套用一筆付款證明,建立或對應 payment。
建議先讀取
education_center.get_payment_proof
治理與審批
高風險 review write,應保留 approval/audit metadata。
安全說明
確認金額、invoice、student、未重複套用後先執行。
education_center.reject_payment_proof
write拒絕一筆付款證明,不建立 payment。
建議先讀取
education_center.get_payment_proof
治理與審批
高風險 review write,應保留 approval/audit metadata。
安全說明
拒絕原因應清楚,避免家長 follow-up 無上下文。
education_center.approve_leave_request_no_makeup
write批准請假但不安排補堂。
建議先讀取
education_center.get_leave_request
治理與審批
高風險 review write,影響 attendance。
安全說明
確認 no-makeup 是業務決策,不應由 agent 默認選擇。
education_center.approve_leave_request_makeup
write批准請假並安排補堂日期。
建議先讀取
education_center.get_leave_request
治理與審批
高風險 review write,影響 attendance / makeup。
安全說明
補堂欄位要同現有 makeup/reschedule contract 一致。
education_center.reject_leave_request
write拒絕請假申請。
建議先讀取
education_center.get_leave_request
治理與審批
高風險 review write,應保留 approval/audit metadata。
安全說明
拒絕前確認 linked lesson 及原因,避免錯誤通知家長。
education_center.create_student
write用 canonical setup student flow 建立學生。
建議先讀取
education_center.list_students
治理與審批
受治理寫入;可能 executed 或 pending_approval。
安全說明
建立前先搜尋避免重複學生/家長資料。
education_center.update_student
write用 canonical setup student flow 更新學生。
建議先讀取
education_center.get_student
治理與審批
受治理寫入;可能 executed 或 pending_approval。
安全說明
更新前確認 student_id 及 record_state,避免改 archived record。
education_center.create_enrollment
write用 setup enrollment flow 建立報名。
建議先讀取
education_center.get_student + education_center.list_classes
治理與審批
受治理寫入;可能 executed 或 pending_approval。
安全說明
建立前檢查班別容量、重複報名及收費設定。
education_center.create_invoice
write用 canonical invoice flow 建立 invoice;is_draft 控制草稿狀態。
建議先讀取
education_center.preview_invoice_default_lessons
治理與審批
受治理寫入;cashier write 應保留 audit metadata。
安全說明
lessons[] 必填且 explicit;不要使用隱式 default。
education_center.update_invoice
write用 canonical invoice flow 更新 invoice;lessons[] 仍需 explicit。
建議先讀取
education_center.get_invoice + education_center.preview_invoice_default_lessons
治理與審批
受治理寫入;cashier write 應保留 audit metadata。
安全說明
更新前比較現有 payments/draft 狀態,避免覆蓋付款資料。
education_center.add_invoice_payment
write為 existing invoice append payment,是日常收款 canonical path。
建議先讀取
education_center.get_invoice
治理與審批
受治理寫入;cashier payment write。
安全說明
新增收款前核對 outstanding amount 及 payment method。
education_center.replace_invoice_payments
write整批覆蓋 invoice payment list,用於行政修正。
建議先讀取
education_center.get_invoice
治理與審批
高風險覆蓋式 cashier write。
安全說明
非日常收款 path;只在明確需要 full overwrite 時使用。
education_center.upsert_resource_item
write建立或更新 learning_resource / notice,支援 body、source、attachments。
建議先讀取
education_center.get_resource 或 education_center.get_notice
治理與審批
受治理寫入;可能 executed 或 pending_approval。
安全說明
type 必須正確;resource_id 存在代表更新,省略代表建立。
education_center.delete_resource_item
write用 shared resource backend flow archive learning_resource 或 notice。
建議先讀取
education_center.get_resource 或 education_center.get_notice
治理與審批
受治理寫入;delete/archive 類操作應保留 audit。
安全說明
刪除前確認 assignments、attachments、read receipts 影響。
education_center.assign_resource
write用 shared assignment flow 派發 learning_resource 或 notice;支援 is_all_students。
建議先讀取
education_center.get_resource / get_notice + education_center.list_students
治理與審批
受治理寫入;bulk all-students 屬高影響操作。
安全說明
type、target student 或 is_all_students 必須明確,不可同時含糊。
education_center.unassign_resource
write用 shared assignment flow 取消學生特定 resource/notice assignment。
建議先讀取
education_center.get_resource 或 education_center.get_notice
治理與審批
受治理寫入;可能 executed 或 pending_approval。
安全說明
assignment 必須來自讀取結果;不要自行猜 assignment id。