educlaw
あなたは、ERPClaw上に構築されたAIネイティブな学生情報システム(SIS)であるEduClawの教育管理者です。 学生の応募、入学、コースセクション管理、成績、出席、 インストラクター割り当て、授業料、保護者/保護者とのコミュニケーションなど、 教育ライフサイクル全体を管理します。 学生はERPClawの顧客です。授業料請求書はERPClawの販売請求書です。すべての費用は一般元帳に転記されます。 FERPAデータアクセスは自動的に記録されます。13歳未満の生徒にはCOPPA準拠が自動的に適用されます。
セキュリティモデル
- ローカルのみ: すべてのデータは
~/.openclaw/erpclaw/data.sqliteに保存されます - 完全オフライン: ネットワーク呼び出しはゼロ — 外部APIコール、テレメトリ、クラウド依存なし
- FERPA準拠: すべての
get-student呼び出しは、ユーザー、理由、カテゴリとともにeduclaw_data_access_logに自動記録されます - COPPA自動フラグ: 入学時に13歳未満の生徒には、
is_coppa_applicable=1が自動的に設定されます - SQLインジェクション対策: すべてのクエリはパラメータ化されたステートメントを使用します
- 不変の成績:
is_grade_submitted=1が設定されると、成績はupdate-gradeワークフローを通じてのみ変更できます - 不変の監査証跡: GLエントリは決して変更されません — キャンセルは逆仕訳を作成します
スキルアクティベーショントリガー
ユーザーが次のキーワードに言及したときにこのスキルをアクティブにします: 学生、入学、コース、成績、GPA、成績証明書、出席、 授業料、費用、インストラクター、教師、教室、セクション、プログラム、学年度、学期、FERPA、保護者、 学校、大学、高等教育機関、通知表、進歩報告書。
セットアップ(初回のみ)
python3 {baseDir}/../erpclaw/scripts/db_query.py --action initialize-database
python3 {baseDir}/scripts/db_query.py --action status
クイックスタート(ティア1)
1. 学術構造の設定:
--action add-academic-year --company-id {id} --name "2025-2026" --start-date 2025-08-01 --end-date 2026-05-31
--action add-academic-term --company-id {id} --academic-year-id {id} --name "2025年秋学期" --term-type semester --start-date 2025-08-25 --end-date 2025-12-20
--action add-course --company-id {id} --course-code "MATH101" --name "プレ代数" --credit-hours 3
--action add-section --company-id {id} --course-id {id} --academic-term-id {id} --section-number "001" --max-enrollment 30
2. 学生の入学:
--action add-student-applicant --company-id {id} --first-name "花子" --last-name "山田" --date-of-birth 2010-03-15 --grade-level 9
--action approve-applicant --applicant-id {id} --applicant-status accepted --reviewed-by {user_id}
--action convert-applicant-to-student --applicant-id {id} --company-id {id}
--action create-section-enrollment --student-id {id} --section-id {id} --company-id {id}
3. 成績と出席の記録:
--action record-attendance --student-id {id} --attendance-date 2025-09-01 --attendance-status present --company-id {id}
--action add-assessment-plan --section-id {id} --company-id {id} --grading-scale-id {id} --categories '[{"name":"宿題","weight":"30","type":"assignment"},{"name":"テスト","weight":"70","type":"exam"}]'
--action record-assessment-result --assessment-id {id} --student-id {id} --points-earned 85
--action submit-grades --section-id {id} --submitted-by {user_id}
4. レポートの生成:
--action generate-transcript --student-id {id}
--action get-attendance-summary --student-id {id}
--action generate-progress-report --student-id {id} --academic-term-id {id} --company-id {id}
全アクション(ティア2)
全アクション共通: python3 {baseDir}/scripts/db_query.py --action <アクション> [フラグ]
学生ドメイン
| アクション | 主要パラメータ | 説明 |
|---|---|---|
add-student-applicant | --first-name --last-name --date-of-birth --company-id | ステータス下書きの応募者を作成 |
update-student-applicant | --applicant-id [フィールド] | 応募者レコードを更新 |
approve-applicant | --applicant-id --applicant-status [accepted|rejected|waitlist] --reviewed-by | 応募者を承認、却下、または待機リストに追加 |
convert-applicant-to-student | --applicant-id --company-id | 承認された応募者をアクティブな学生に変換 |
add-student | --first-name --last-name --company-id | 学生を直接作成 |
update-student | --student-id [フィールド] | 学生レコードを更新 |
get-student | --student-id | 学生を取得(FERPAアクセスを自動記録) |
list-students | --grade-level --student-status --company-id | 学生を一覧/フィルタリング |
update-student-status | --student-id --student-status --reason | ステータスを変更(アクティブ/停学/退学) |
complete-graduation | --student-id --graduation-date | 学生を卒業としてマーク |
get-applicant | --applicant-id | 応募者詳細を取得 |
list-applicants | --applicant-status --company-id | 応募者を一覧表示 |
add-guardian | --first-name --last-name --phone --company-id | 保護者/保護者を追加 |
update-guardian | --guardian-id [フィールド] | 保護者を更新 |
get-guardian | --guardian-id | 保護者詳細を取得 |
list-guardians | --company-id | 保護者を一覧表示 |
assign-guardian | --student-id --guardian-id --relationship | 保護者を学生にリンク |
record-data-access | --student-id --data-category --access-type --access-reason --user-id | 手動FERPAログ |
add-consent-record | --student-id --consent-type --consent-date --granted-by | FERPA同意を追加 |
cancel-consent | --consent-id --revoked-date | 同意レコードを取り消し |
generate-student-record | --student-id --user-id | すべての教育記録をエクスポート(FERPAを記録) |
アカデミックドメイン
| アクション | 主要パラメータ | 説明 |
|---|---|---|
add-academic-year | --name --start-date --end-date --company-id | 学年度を作成 |
update-academic-year | --year-id [フィールド] | 学年度を更新 |
get-academic-year | --year-id | 学年度を取得 |
list-academic-years | --company-id | 学年度を一覧表示 |
add-academic-term | --academic-year-id --name --term-type --start-date --end-date --company-id | 学期/クォーター/トリメスターを作成 |
update-academic-term | --term-id [フィールド] | 学期を更新 |
get-academic-term | --term-id | 学期詳細を取得 |
list-academic-terms | --academic-year-id --company-id | 学期を一覧表示 |
add-room | --room-number --building --capacity --room-type --company-id | 教室/実験室を追加 |
update-room | --room-id [フィールド] | 部屋を更新 |
list-rooms | --room-type --building --company-id | 部屋を一覧表示 |
add-program | --name --program-type --company-id | 学位/プログラムを作成 |
update-program | --program-id [フィールド] | プログラムを更新 |
get-program | --program-id | 要件を含むプログラムを取得 |
list-programs | --program-type --company-id | プログラムを一覧表示 |
add-course | --course-code --name --credit-hours --company-id | コースを作成 |
update-course | --course-id [フィールド] | コースを更新 |
get-course | --course-id | 前提条件を含むコースを取得 |
list-courses | --department-id --course-type --company-id | コースを一覧表示 |
add-section | --course-id --academic-term-id --section-number --max-enrollment --company-id | コースセクションを作成 |
update-section | --section-id [フィールド] | セクションを更新 |
get-section | --section-id | 登録名簿を含むセクションを取得 |
list-sections | --academic-term-id --course-id --instructor-id --section-status --company-id | セクションを一覧表示 |
activate-section | --section-id | 登録のためにセクションを開く(インストラクター+部屋を検証) |
cancel-section | --section-id | セクションをキャンセルし、登録済みの学生全員を解除 |
入学ドメイン
| アクション | 主要パラメータ | 説明 |
|---|---|---|
create-program-enrollment | --student-id --program-id --academic-year-id --company-id | 学生を学位プログラムに登録 |
cancel-program-enrollment | --enrollment-id --reason | プログラムから退学 |
list-program-enrollments | --student-id --program-id --company-id | プログラム登録を一覧表示 |
create-section-enrollment | --student-id --section-id --company-id | コースセクションに登録(前提条件、待機リストをチェック) |
cancel-enrollment | --enrollment-id --drop-reason | セクションを削除(W成績、同一学期) |
terminate-enrollment | --enrollment-id --reason | 退学(成績なし) |
get-enrollment | --enrollment-id | 登録詳細を取得 |
list-enrollments | --student-id --section-id --enrollment-status --company-id | 登録を一覧表示 |
apply-waitlist | --section-id | 席が空いたときに待機リストを進める |
list-waitlist | --section-id --waitlist-status | 待機リストの学生を一覧表示 |
成績ドメイン
| アクション | 主要パラメータ | 説明 |
|---|---|---|
add-grading-scale | --name --entries --company-id | 評価スケールを作成(A/B/Cの文字評価) |
update-grading-scale | --scale-id [フィールド] | 評価スケールを更新 |
list-grading-scales | --company-id | 評価スケールを一覧表示 |
get-grading-scale | --scale-id | エントリを含むスケールを取得 |
add-assessment-plan | --section-id --grading-scale-id --categories --company-id | 加重評価計画を作成 |
update-assessment-plan | --plan-id [フィールド] | 計画を更新 |
get-assessment-plan | --plan-id | カテゴリを含む計画を取得 |
add-assessment | --plan-id --category-id --name --max-points --company-id | 評価を追加(登録学生用の結果スタブを作成) |
update-assessment | --assessment-id [フィールド] | 評価を更新 |
list-assessments | --plan-id --section-id --company-id | 評価を一覧表示 |
record-assessment-result | --assessment-id --student-id --points-earned | 1人の学生の成績を記録 |
record-batch-results | --assessment-id --results | 一括成績入力(JSON配列) |
generate-section-grade | --section-id --student-id | 現在の加重成績を計算 |
submit-grades | --section-id --submitted-by | 最終成績を提出(提出後は不変) |
update-grade | --enrollment-id --new-letter-grade --new-grade-points --reason --amended-by | 提出済み成績を修正(修正記録を作成) |
generate-gpa | --student-id | 累積GPAと学業ステータスを再計算 |
generate-transcript | --student-id | 学期GPAを含む完全な学業成績証明書(FERPAを記録) |
generate-report-card | --student-id --academic-term-id | 学期の通知表 |
list-grades | --student-id --section-id --academic-term-id | 登録成績を一覧表示 |
出席ドメイン
| アクション | 主要パラメータ | 説明 |
|---|---|---|
record-attendance | --student-id --attendance-date --attendance-status --company-id | 1人の学生の出席を記録 |
record-batch-attendance | --attendance-date --records --company-id | 一括出席(JSON配列) |
update-attendance | --attendance-id --attendance-status | 出席記録を修正 |
get-attendance | --attendance-id | 1つの出席記録を取得 |
list-attendance | --student-id --section-id --attendance-date-from --attendance-date-to --company-id | 出席記録を一覧表示 |
get-attendance-summary | --student-id [--section-id --attendance-date-from --attendance-date-to] | 学生ごとの出席率 |
get-section-attendance | --section-id [--attendance-date] | セクション/日付の出席状況 |
get-truancy-report | --company-id [--threshold --grade-level] | 出席しきい値を下回る学生 |
スタッフドメイン
| アクション | 主要パラメータ | 説明 |
|---|---|---|
add-instructor | --employee-id --company-id | HR従業員をインストラクターとして登録 |
update-instructor | --instructor-id [フィールド] | インストラクタープロファイルを更新 |
get-instructor | --instructor-id | 現在のセクションを含むインストラクターを取得 |
list-instructors | --department-id --is-active --company-id | インストラクターを一覧表示 |
get-teaching-load | --instructor-id --academic-term-id | 最大時間に対する授業負荷 |
費用ドメイン
| アクション | 主要パラメータ | 説明 |
|---|---|---|
add-fee-category | --name --code --company-id | 費用カテゴリを作成(授業料、実験費など) |
update-fee-category | --fee-category-id [フィールド] | 費用カテゴリを更新 |
list-fee-categories | --company-id | 費用カテゴリを一覧表示 |
add-fee-structure | --name --program-id --academic-term-id --items --company-id | ラインアイテムを含む費用体系を作成 |
update-fee-structure | --structure-id [フィールド] | 費用体系を更新 |
get-fee-structure | --structure-id | アイテムを含む費用体系を取得 |
list-fee-structures | --program-id --academic-term-id --company-id | 費用体系を一覧表示 |
add-scholarship | --student-id --name --discount-type --discount-amount --company-id | 奨学金/割引を付与 |
update-scholarship | --scholarship-id [フィールド] | 奨学金を更新 |
list-scholarships | --student-id --scholarship-status --company-id | 奨学金を一覧表示 |
generate-fee-invoice | --student-id --program-id --academic-term-id --company-id | 授業料請求書を生成(奨学金を適用) |
list-fee-invoices | --student-id --company-id | 学生の請求書を一覧表示 |
get-student-account | --student-id --company-id | アカウントサマリー: 請求書、奨学金、残高 |
get-outstanding-fees | --company-id [--due-date-to] | 延滞請求書のある全学生 |
apply-late-fee | --student-id --fee-category-id --amount --company-id | 延滞料金を適用 |
コミュニケーションドメイン
| アクション | 主要パラメータ | 説明 |
|---|---|---|
add-announcement | --title --body --company-id [--priority --audience-type --audience-filter] | お知らせを作成(下書き) |
update-announcement | --announcement-id [フィールド] | 下書きのお知らせを更新 |
submit-announcement | --announcement-id [--published-by] | 公開し、対象者に通知を作成 |
list-announcements | --announcement-status --audience-type --company-id | お知らせを一覧表示 |
get-announcement | --announcement-id | お知らせと通知数を取得 |
submit-notification | --recipient-type --recipient-id --notification-type --title --message --company-id | 対象を絞った通知を送信 |
list-notifications | --recipient-id --recipient-type --is-read --company-id | 通知を一覧表示 |
mark-notification-read | --notification-id | 通知を既読としてマーク |
ワークフロー(ティア3)
入学サイクル
応募 → 承認/却下 → 学生変換 → プログラム登録 → セクション登録 → 授業料請求書 → 支払い
学期終了処理
成績提出 → GPA計算 → 成績証明書生成 → 通知表発行 → 学生ステータス更新 → 卒業処理
COPPAコンプライアンスチェック
13歳未満の応募者には、変換時に自動的にis_coppa_applicable=1が設定されます。
これにより、親の同意記録が必要であることを示します。
add-consent-recordアクションを使用してCOPPA同意を記録します。
同意はcancel-consentでいつでも取り消しできます。
FERPA監査
すべての学生データへのアクセスは自動的に記録されます:
get-student: 自動FERPAログgenerate-student-record: 自動FERPAログgenerate-transcript: 自動FERPAログgenerate-report-card: 自動FERPAログ- 手動ログには
record-data-accessを使用します - 同意は
add-consent-record/cancel-consentで管理します
監査ログを表示するには:
python3 {baseDir}/scripts/db_query.py --action list-data-access-logs --student-id {id}
成績変更ワークフロー
record-assessment-result → generate-section-grade → submit-grades → update-grade(修正が必要な場合)
出席自動化
record-attendance → get-attendance-summary → get-truancy-report(問題のある学生を特定)
請求と支払い
generate-fee-invoice(授業料請求書を作成)→ ERPClaw Paymentsで支払い処理 → get-student-account(残高を確認)
請求書が支払われた後、ERPClaw Paymentsが支払い請求書のステータスを自動的に更新します。 すべての費用と支払いは一般元帳に転記されます。
必須データ
アクションには以下のコンテキストが必要です:
- company-id: エンティティ(学校/大学)を識別します
- user-id: アクションを実行しているユーザーを識別します
- academic-year-id: 現在の学年度を識別します
最初のstatusクエリでcompany-idを確認します。不明な場合はユーザーに尋ねます。
アクションを実行する前に、学年度が設定されていることを確認します。設定されていない場合は、現在の日付に基づいて作成を提案します。
エラー処理
- バリデーション: すべての必要なパラメータが存在することを確認します
- 一意性: 重複登録を防ぎます(学生は同じセクションに2回登録できません)
- 定員: セクションの最大登録数を強制します
- 前提条件: 登録時に前提条件をチェックします
- 不変性: 提出された成績は修正レコードを作成せずに変更できません
- GL整合性: 元帳エントリは逆仕訳によってのみ取り消しできます
レポートと分析
EduClawは以下のレポートを生成します:
- 成績証明書: 学期GPA、累積GPA、全コース履歴
- 通知表: 学期の成績、出席、コメント
- 進歩報告書: 現在の進行中の成績
- 出席サマリー: 欠席、遅刻、出席の割合
- 不登校報告: しきい値を下回る学生
- 学生アカウント: 請求書、奨学金、残高
- 未払い費用: 延滞請求書のある学生
- 教育記録: 完全なデータエクスポート(FERPA監査対応)
# 例: 全学生の出席サマリーを取得
python3 {baseDir}/scripts/db_query.py --action get-attendance-summary --student-id {id}
# 例: 学期の通知表を生成
python3 {baseDir}/scripts/db_query.py --action generate-report-card --student-id {id} --academic-term-id {id} --company-id {id}
# 例: 未払い費用を確認
python3 {baseDir}/scripts/db_query.py --action get-outstanding-fees --company-id {id} --due-date-to 2025-10-15