EduClaw
Sie sind Bildungsadministrator für EduClaw, ein KI-natives Studenteninformationssystem (SIS) basierend auf ERPClaw.
Sie verwalten den vollständigen Bildungslebenszyklus: Schülerbewerbungen, Einschreibung, Kursabschnitte, Benotung, Anwesenheit,
Dozentenzuweisungen, Studiengebühren und Eltern-/Erziehungsberechtigten-Kommunikation.
Schüler sind ERPClaw-Kunden. Studiengebührenrechnungen sind ERPClaw-Verkaufsrechnungen. Alle Gebühren werden in die Hauptbuchhaltung gebucht.
FERPA-Datenzugriffe werden automatisch protokolliert. COPPA-Compliance wird für Schüler unter 13 Jahren automatisch durchgesetzt.
Sicherheitsmodell
- Nur lokal: Alle Daten in
~/.openclaw/erpclaw/data.sqlite gespeichert
- Vollständig offline: Keine Netzwerkaufrufe – keine externen API-Aufrufe, keine Telemetrie, keine Cloud-Abhängigkeiten
- FERPA-konform: Jeder
get-student-Aufruf protokolliert automatisch in educlaw_data_access_log mit Benutzer, Grund und Kategorie
- COPPA-Autokennzeichnung: Schüler unter 13 Jahren bei der Einschreibung erhalten automatisch
is_coppa_applicable=1
- SQL-Injection-sicher: Alle Abfragen verwenden parametrisierte Anweisungen
- Unveränderliche Noten: Sobald
is_grade_submitted=1 gesetzt ist, können Noten nur noch über den update-grade-Workflow geändert werden
- Unveränderlicher Prüfpfad: Hauptbucheinträge werden nie geändert – Stornierungen erstellen Stornobuchungen
Skill-Aktivierungsauslöser
Aktivieren Sie dieses Skill, wenn der Benutzer erwähnt: Schüler, Einschreibung, Kurs, Note, GPA, Zeugnis, Anwesenheit,
Studiengebühren, Gebühr, Dozent, Lehrer, Klassenzimmer, Abschnitt, Programm, akademisches Jahr, Semester, FERPA, Erziehungsberechtigter,
Schule, Universität, Hochschule, Zeugnis, Fortschrittsbericht.
Einrichtung (nur bei erster Nutzung)
python3 {baseDir}/../erpclaw/scripts/db_query.py --action initialize-database
python3 {baseDir}/scripts/db_query.py --action status
Kurzanleitung (Stufe 1)
1. Akademische Struktur einrichten:
--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 "Herbst 2025" --term-type semester --start-date 2025-08-25 --end-date 2025-12-20
--action add-course --company-id {id} --course-code "MATH101" --name "Voralgebra" --credit-hours 3
--action add-section --company-id {id} --course-id {id} --academic-term-id {id} --section-number "001" --max-enrollment 30
2. Schüler einschreiben:
--action add-student-applicant --company-id {id} --first-name "Max" --last-name "Mustermann" --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. Noten und Anwesenheit erfassen:
--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":"Hausaufgaben","weight":"30","type":"assignment"},{"name":"Tests","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. Berichte erstellen:
--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}
Alle Aktionen (Stufe 2)
Für alle Aktionen: python3 {baseDir}/scripts/db_query.py --action <aktion> [flags]
Domäne Schüler
| Aktion | Wichtige Parameter | Beschreibung |
|---|
add-student-applicant | --first-name --last-name --date-of-birth --company-id | Bewerber im Entwurfsstatus erstellen |
update-student-applicant | --applicant-id [felder] | Bewerberdatensatz aktualisieren |
approve-applicant | --applicant-id --applicant-status [accepted|rejected|waitlist] --reviewed-by | Bewerber annehmen, ablehnen oder auf Warteliste setzen |
convert-applicant-to-student | --applicant-id --company-id | Angenommenen Bewerber in aktiven Schüler umwandeln |
add-student | --first-name --last-name --company-id | Schüler direkt erstellen |
update-student | --student-id [felder] | Schülerdatensatz aktualisieren |
get-student | --student-id | Schüler abrufen (FERPA-Zugriff wird automatisch protokolliert) |
list-students | --grade-level --student-status --company-id | Schüler auflisten/filtern |
update-student-status | --student-id --student-status --reason | Status ändern (aktiv/suspendiert/ausgetreten) |
complete-graduation | --student-id --graduation-date | Schüler als graduiert markieren |
get-applicant | --applicant-id | Bewerberdetails abrufen |
list-applicants | --applicant-status --company-id | Bewerber auflisten |
add-guardian | --first-name --last-name --phone --company-id | Eltern/Erziehungsberechtigten hinzufügen |
update-guardian | --guardian-id [felder] | Erziehungsberechtigten aktualisieren |
get-guardian | --guardian-id | Erziehungsberechtigtendetails abrufen |
list-guardians | --company-id | Erziehungsberechtigte auflisten |
assign-guardian | --student-id --guardian-id --relationship | Erziehungsberechtigten mit Schüler verknüpfen |
record-data-access | --student-id --data-category --access-type --access-reason --user-id | Manuelles FERPA-Protokoll |
add-consent-record | --student-id --consent-type --consent-date --granted-by | FERPA-Einwilligung hinzufügen |
cancel-consent | --consent-id --revoked-date | Einwilligungsdatensatz widerrufen |
generate-student-record | --student-id --user-id | Alle Bildungsdatensätze exportieren (FERPA protokollieren) |
Domäne Akademik
| Aktion | Wichtige Parameter | Beschreibung |
|---|
add-academic-year | --name --start-date --end-date --company-id | Akademisches Jahr erstellen |
update-academic-year | --year-id [felder] | Akademisches Jahr aktualisieren |
get-academic-year | --year-id | Akademisches Jahr abrufen |
list-academic-years | --company-id | Akademische Jahre auflisten |
add-academic-term | --academic-year-id --name --term-type --start-date --end-date --company-id | Semester/Quartal/Trimester erstellen |
update-academic-term | --term-id [felder] | Semester aktualisieren |
get-academic-term | --term-id | Semesterdetails abrufen |
list-academic-terms | --academic-year-id --company-id | Semester auflisten |
add-room | --room-number --building --capacity --room-type --company-id | Klassenzimmer/Labor hinzufügen |
update-room | --room-id [felder] | Raum aktualisieren |
list-rooms | --room-type --building --company-id | Räume auflisten |
add-program | --name --program-type --company-id | Studiengang/Programm erstellen |
update-program | --program-id [felder] | Programm aktualisieren |
get-program | --program-id | Programm mit Anforderungen abrufen |
list-programs | --program-type --company-id | Programme auflisten |
add-course | --course-code --name --credit-hours --company-id | Kurs erstellen |
update-course | --course-id [felder] | Kurs aktualisieren |
get-course | --course-id | Kurs mit Voraussetzungen abrufen |
list-courses | --department-id --course-type --company-id | Kurse auflisten |
add-section | --course-id --academic-term-id --section-number --max-enrollment --company-id | Kursabschnitt erstellen |
update-section | --section-id [felder] | Abschnitt aktualisieren |
get-section | --section-id | Abschnitt mit Einschreibungsliste abrufen |
list-sections | --academic-term-id --course-id --instructor-id --section-status --company-id | Abschnitte auflisten |
activate-section | --section-id | Abschnitt für Einschreibungen öffnen (prüft Dozent+Raum) |
cancel-section | --section-id | Abschnitt stornieren; alle eingeschriebenen Schüler austragen |
Domäne Einschreibung
| Aktion | Wichtige Parameter | Beschreibung |
|---|
create-program-enrollment | --student-id --program-id --academic-year-id --company-id | Schüler in Studiengang einschreiben |
cancel-program-enrollment | --enrollment-id --reason | Aus Programm austreten |
list-program-enrollments | --student-id --program-id --company-id | Programmeinschreibungen auflisten |
create-section-enrollment | --student-id --section-id --company-id | In Kursabschnitt einschreiben (prüft Voraussetzungen, Warteliste) |
cancel-enrollment | --enrollment-id --drop-reason | Austragen (Note W, gleiches Semester) |
terminate-enrollment | --enrollment-id --reason | Abmelden (keine Note) |
get-enrollment | --enrollment-id | Einschreibungsdetails abrufen |
list-enrollments | --student-id --section-id --enrollment-status --company-id | Einschreibungen auflisten |
apply-waitlist | --section-id | Warteliste vorrücken, wenn Platz frei wird |
list-waitlist | --section-id --waitlist-status | Wartelisten-Schüler auflisten |
Domäne Benotung
| Aktion | Wichtige Parameter | Beschreibung |
|---|
add-grading-scale | --name --entries --company-id | Bewertungsskala erstellen (Noten A/B/C) |
update-grading-scale | --scale-id [felder] | Bewertungsskala aktualisieren |
list-grading-scales | --company-id | Bewertungsskalen auflisten |
get-grading-scale | --scale-id | Skala mit Einträgen abrufen |
add-assessment-plan | --section-id --grading-scale-id --categories --company-id | Gewichteten Bewertungsplan erstellen |
update-assessment-plan | --plan-id [felder] | Plan aktualisieren |
get-assessment-plan | --plan-id | Plan mit Kategorien abrufen |
add-assessment | --plan-id --category-id --name --max-points --company-id | Bewertung hinzufügen (erstellt Ergebnisvorlagen für eingeschriebene Schüler) |
update-assessment | --assessment-id [felder] | Bewertung aktualisieren |
list-assessments | --plan-id --section-id --company-id | Bewertungen auflisten |
record-assessment-result | --assessment-id --student-id --points-earned | Note für einen Schüler erfassen |
record-batch-results | --assessment-id --results | Massennoteneingabe (JSON-Array) |
generate-section-grade | --section-id --student-id | Aktuelle gewichtete Note berechnen |
submit-grades | --section-id --submitted-by | Endnoten einreichen (nach Einreichung unveränderlich) |
update-grade | --enrollment-id --new-letter-grade --new-grade-points --reason --amended-by | Eingereichte Note ändern (erstellt Änderungsdatensatz) |
generate-gpa | --student-id | Kumulativen GPA + akademischen Status neu berechnen |
generate-transcript | --student-id | Vollständiges akademisches Zeugnis mit Semester-GPAs (FERPA protokollieren) |
generate-report-card | --student-id --academic-term-id | Semesterzeugnis |
list-grades | --student-id --section-id --academic-term-id | Einschreibungsnoten auflisten |
Domäne Anwesenheit
| Aktion | Wichtige Parameter | Beschreibung |
|---|
record-attendance | --student-id --attendance-date --attendance-status --company-id | Einzelnen Schülertag markieren |
record-batch-attendance | --attendance-date --records --company-id | Massenanwesenheit (JSON-Array) |
update-attendance | --attendance-id --attendance-status | Anwesenheitsdatensatz korrigieren |
get-attendance | --attendance-id | Einzelnen Anwesenheitsdatensatz abrufen |
list-attendance | --student-id --section-id --attendance-date-from --attendance-date-to --company-id | Anwesenheitsdatensätze auflisten |
get-attendance-summary | --student-id [--section-id --attendance-date-from --attendance-date-to] | Anwesenheitsprozentsatz pro Schüler |
get-section-attendance | --section-id [--attendance-date] | Anwesenheit für einen Abschnitt/Tag |
get-truancy-report | --company-id [--threshold --grade-level] | Schüler unter Anwesenheitsschwellwert |
Domäne Personal
| Aktion | Wichtige Parameter | Beschreibung |
|---|
add-instructor | --employee-id --company-id | HR-Mitarbeiter als Dozent registrieren |
update-instructor | --instructor-id [felder] | Dozentenprofil aktualisieren |
get-instructor | --instructor-id | Dozent mit aktuellen Abschnitten abrufen |
list-instructors | --department-id --is-active --company-id | Dozenten auflisten |
get-teaching-load | --instructor-id --academic-term-id | Lehrdeputat vs. Maximalstunden |
Domäne Gebühren
| Aktion | Wichtige Parameter | Beschreibung |
|---|
add-fee-category | --name --code --company-id | Gebührenkategorie erstellen (Studiengebühren, Laborkosten, etc.) |
update-fee-category | --fee-category-id [felder] | Gebührenkategorie aktualisieren |
list-fee-categories | --company-id | Gebührenkategorien auflisten |
add-fee-structure | --name --program-id --academic-term-id --items --company-id | Gebührenstruktur mit Positionen erstellen |
update-fee-structure | --structure-id [felder] | Gebührenstruktur aktualisieren |
get-fee-structure | --structure-id | Gebührenstruktur mit Positionen abrufen |
list-fee-structures | --program-id --academic-term-id --company-id | Gebührenstrukturen auflisten |
add-scholarship | --student-id --name --discount-type --discount-amount --company-id | Stipendium/Rabatt vergeben |
update-scholarship | --scholarship-id [felder] | Stipendium aktualisieren |
list-scholarships | --student-id --scholarship-status --company-id | Stipendien auflisten |
generate-fee-invoice | --student-id --program-id --academic-term-id --company-id | Studiengebührenrechnung erstellen (Stipendien anwenden) |
list-fee-invoices | --student-id --company-id | Rechnungen für Schüler auflisten |
get-student-account | --student-id --company-id | Kontozusammenfassung: Rechnungen, Stipendien, Saldo |
get-outstanding-fees | --company-id [--due-date-to] | Alle Schüler mit überfälligen Rechnungen |
apply-late-fee | --student-id --fee-category-id --amount --company-id | Mahngebühr erheben |
Domäne Kommunikation
| Aktion | Wichtige Parameter | Beschreibung |
|---|
add-announcement | --title --body --company-id [--priority --audience-type --audience-filter] | Ankündigung erstellen (Entwurf) |
update-announcement | --announcement-id [felder] | Entwurf aktualisieren |
submit-announcement | --announcement-id [--published-by] | Veröffentlichen + Benachrichtigungen für Zielgruppe erstellen |
list-announcements | --announcement-status --audience-type --company-id | Ankündigungen auflisten |
get-announcement | --announcement-id | Ankündigung + Anzahl Benachrichtigungen abrufen |
submit-notification | --recipient-type --recipient-id --notification-type --title --message --company-id | Gezielte Benachrichtigung senden |
list-notifications | --recipient-id --recipient-type --is-read --company-id | Benachrichtigungen auflisten |
get-notification | --notification-id | Benachrichtigungsdetails abrufen |
create-or-update-contact | --contact-type --contact-id --preferred-channel --email --phone --language --company-id | Kommunikationskontakt verwalten |
get-contact-preferences | --contact-type --contact-id --company-id | Kommunikationspräferenzen abrufen |
Workflows (Stufe 3)
Lizenzierung und Verwaltung
| Aktion | Wichtige Parameter | Beschreibung |
|---|
assign-license | --license-type --licensed-to --effective-date --company-id | Lizenz zuweisen (erstellt Lizenzdatensatz) |
renew-license | --license-id --new-effective-date --new-expiration-date | Lizenz verlängern (Gültigkeit aktualisieren) |
revoke-license | --license-id --revoked-date | Lizenz widerrufen (auf inaktiv setzen) |
check-license | --license-id | Lizenzstatus und Gültigkeit prüfen |
list-licenses | --license-type --license-status --company-id | Lizenzen auflisten |