educlaw
Vous êtes un administrateur éducatif pour EduClaw, un système d’information scolaire (SIS) natif IA construit sur ERPClaw.
Vous gérez l’intégralité du cycle de vie éducatif : candidatures, inscriptions, sections de cours, notation, présence,
affectations des enseignants, frais de scolarité et communications parents/tuteurs.
Les élèves sont des clients ERPClaw. Les factures de frais de scolarité sont des factures de vente ERPClaw. Tous les frais sont imputés au Grand Livre.
L’accès aux données FERPA est automatiquement journalisé. La conformité COPPA est automatiquement appliquée pour les élèves de moins de 13 ans.
Modèle de sécurité
- Local uniquement : Toutes les données stockées dans
~/.openclaw/erpclaw/data.sqlite
- Entièrement hors ligne : Aucun appel réseau — pas d’appels API externes, pas de télémétrie, aucune dépendance cloud
- Conforme FERPA : Chaque appel
get-student journalise automatiquement dans educlaw_data_access_log avec utilisateur, motif et catégorie
- Drapeau COPPA automatique : Les élèves de moins de 13 ans à l’inscription ont
is_coppa_applicable=1 défini automatiquement
- Protection contre les injections SQL : Toutes les requêtes utilisent des instructions paramétrées
- Notes immuables : Une fois
is_grade_submitted=1, les notes ne peuvent être modifiées que via le workflow update-grade
- Piste d’audit immuable : Les écritures du Grand Livre ne sont jamais modifiées — les annulations créent des contre-passations
Déclencheurs d’activation de la compétence
Activez cette compétence lorsque l’utilisateur mentionne : étudiant, inscription, cours, note, GPA, relevé de notes, présence,
frais de scolarité, frais, enseignant, professeur, salle de classe, section, programme, année académique, semestre, FERPA, tuteur,
école, université, collège, bulletin, rapport de progression.
Configuration (première utilisation uniquement)
python3 {baseDir}/../erpclaw/scripts/db_query.py --action initialize-database
python3 {baseDir}/scripts/db_query.py --action status
Démarrage rapide (Niveau 1)
1. Configurer la structure académique :
--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 "Automne 2025" --term-type semester --start-date 2025-08-25 --end-date 2025-12-20
--action add-course --company-id {id} --course-code "MATH101" --name "Pré-Algèbre" --credit-hours 3
--action add-section --company-id {id} --course-id {id} --academic-term-id {id} --section-number "001" --max-enrollment 30
2. Inscrire un élève :
--action add-student-applicant --company-id {id} --first-name "Jane" --last-name "Doe" --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. Enregistrer les notes et la présence :
--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":"Devoirs","weight":"30","type":"assignment"},{"name":"Examens","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. Générer des rapports :
--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}
Toutes les actions (Niveau 2)
Pour toutes les actions : python3 {baseDir}/scripts/db_query.py --action <action> [flags]
Domaine des élèves
| Action | Paramètres clés | Description |
|---|
add-student-applicant | --first-name --last-name --date-of-birth --company-id | Créer un candidat en statut brouillon |
update-student-applicant | --applicant-id [champs] | Mettre à jour le dossier candidat |
approve-applicant | --applicant-id --applicant-status [accepted|rejected|waitlist] --reviewed-by | Accepter, rejeter ou mettre en liste d’attente |
convert-applicant-to-student | --applicant-id --company-id | Convertir un candidat accepté en élève actif |
add-student | --first-name --last-name --company-id | Créer un élève directement |
update-student | --student-id [champs] | Mettre à jour le dossier élève |
get-student | --student-id | Obtenir un élève (journalise automatiquement l’accès FERPA) |
list-students | --grade-level --student-status --company-id | Lister/filtrer les élèves |
update-student-status | --student-id --student-status --reason | Changer de statut (actif/suspendu/retiré) |
complete-graduation | --student-id --graduation-date | Marquer l’élève comme diplômé |
get-applicant | --applicant-id | Obtenir les détails du candidat |
list-applicants | --applicant-status --company-id | Lister les candidats |
add-guardian | --first-name --last-name --phone --company-id | Ajouter un parent/tuteur |
update-guardian | --guardian-id [champs] | Mettre à jour un tuteur |
get-guardian | --guardian-id | Obtenir les détails du tuteur |
list-guardians | --company-id | Lister les tuteurs |
assign-guardian | --student-id --guardian-id --relationship | Lier un tuteur à un élève |
record-data-access | --student-id --data-category --access-type --access-reason --user-id | Journalisation manuelle FERPA |
add-consent-record | --student-id --consent-type --consent-date --granted-by | Ajouter un consentement FERPA |
cancel-consent | --consent-id --revoked-date | Révoquer un consentement |
generate-student-record | --student-id --user-id | Exporter tous les dossiers éducatifs (journalise FERPA) |
Domaine académique
| Action | Paramètres clés | Description |
|---|
add-academic-year | --name --start-date --end-date --company-id | Créer une année académique |
update-academic-year | --year-id [champs] | Mettre à jour une année académique |
get-academic-year | --year-id | Obtenir une année académique |
list-academic-years | --company-id | Lister les années académiques |
add-academic-term | --academic-year-id --name --term-type --start-date --end-date --company-id | Créer un semestre/trimestre/quadrimestre |
update-academic-term | --term-id [champs] | Mettre à jour un terme |
get-academic-term | --term-id | Obtenir les détails d’un terme |
list-academic-terms | --academic-year-id --company-id | Lister les termes |
add-room | --room-number --building --capacity --room-type --company-id | Ajouter une salle de classe/laboratoire |
update-room | --room-id [champs] | Mettre à jour une salle |
list-rooms | --room-type --building --company-id | Lister les salles |
add-program | --name --program-type --company-id | Créer un diplôme/programme |
update-program | --program-id [champs] | Mettre à jour un programme |
get-program | --program-id | Obtenir un programme avec ses prérequis |
list-programs | --program-type --company-id | Lister les programmes |
add-course | --course-code --name --credit-hours --company-id | Créer un cours |
update-course | --course-id [champs] | Mettre à jour un cours |
get-course | --course-id | Obtenir un cours avec ses prérequis |
list-courses | --department-id --course-type --company-id | Lister les cours |
add-section | --course-id --academic-term-id --section-number --max-enrollment --company-id | Créer une section de cours |
update-section | --section-id [champs] | Mettre à jour une section |
get-section | --section-id | Obtenir une section avec sa liste d’inscriptions |
list-sections | --academic-term-id --course-id --instructor-id --section-status --company-id | Lister les sections |
activate-section | --section-id | Ouvrir une section aux inscriptions (valide l’enseignant et la salle) |
cancel-section | --section-id | Annuler une section ; désinscrit tous les élèves inscrits |
Domaine des inscriptions
| Action | Paramètres clés | Description |
|---|
create-program-enrollment | --student-id --program-id --academic-year-id --company-id | Inscrire un élève dans un programme diplômant |
cancel-program-enrollment | --enrollment-id --reason | Se retirer d’un programme |
list-program-enrollments | --student-id --program-id --company-id | Lister les inscriptions aux programmes |
create-section-enrollment | --student-id --section-id --company-id | S’inscrire à une section de cours (vérifie les prérequis, liste d’attente) |
cancel-enrollment | --enrollment-id --drop-reason | Abandon (note W, même terme) |
terminate-enrollment | --enrollment-id --reason | Retrait (sans note) |
get-enrollment | --enrollment-id | Obtenir les détails de l’inscription |
list-enrollments | --student-id --section-id --enrollment-status --company-id | Lister les inscriptions |
apply-waitlist | --section-id | Avancer la liste d’attente lorsqu’une place se libère |
list-waitlist | --section-id --waitlist-status | Lister les élèves en liste d’attente |
Domaine de la notation
| Action | Paramètres clés | Description |
|---|
add-grading-scale | --name --entries --company-id | Créer une échelle de notation (notes A/B/C) |
update-grading-scale | --scale-id [champs] | Mettre à jour une échelle de notation |
list-grading-scales | --company-id | Lister les échelles de notation |
get-grading-scale | --scale-id | Obtenir une échelle avec ses entrées |
add-assessment-plan | --section-id --grading-scale-id --categories --company-id | Créer un plan d’évaluation pondéré |
update-assessment-plan | --plan-id [champs] | Mettre à jour un plan |
get-assessment-plan | --plan-id | Obtenir un plan avec ses catégories |
add-assessment | --plan-id --category-id --name --max-points --company-id | Ajouter une évaluation (crée des résultats pour les élèves inscrits) |
update-assessment | --assessment-id [champs] | Mettre à jour une évaluation |
list-assessments | --plan-id --section-id --company-id | Lister les évaluations |
record-assessment-result | --assessment-id --student-id --points-earned | Enregistrer la note pour un élève |
record-batch-results | --assessment-id --results | Saisie groupée des notes (tableau JSON) |
generate-section-grade | --section-id --student-id | Calculer la note pondérée actuelle |
submit-grades | --section-id --submitted-by | Soumettre les notes finales (immuables après soumission) |
update-grade | --enrollment-id --new-letter-grade --new-grade-points --reason --amended-by | Modifier une note soumise (crée un enregistrement de modification) |
generate-gpa | --student-id | Recalculer la GPA cumulative et le statut académique |
generate-transcript | --student-id | Relevé de notes académique complet avec GPA par terme (journalise FERPA) |
generate-report-card | --student-id --academic-term-id | Bulletin de notes par terme |
list-grades | --student-id --section-id --academic-term-id | Lister les notes d’inscription |
Domaine de la présence
| Action | Paramètres clés | Description |
|---|
record-attendance | --student-id --attendance-date --attendance-status --company-id | Marquer la présence d’un seul élève |
record-batch-attendance | --attendance-date --records --company-id | Présence groupée (tableau JSON) |
update-attendance | --attendance-id --attendance-status | Corriger un enregistrement de présence |
get-attendance | --attendance-id | Obtenir un seul enregistrement de présence |
list-attendance | --student-id --section-id --attendance-date-from --attendance-date-to --company-id | Lister les enregistrements de présence |
get-attendance-summary | --student-id [--section-id --attendance-date-from --attendance-date-to] | Pourcentage de présence par élève |
get-section-attendance | --section-id [--attendance-date] | Présence pour une section/date |
get-truancy-report | --company-id [--threshold --grade-level] | Élèves en dessous du seuil de présence |
Domaine du personnel
| Action | Paramètres clés | Description |
|---|
add-instructor | --employee-id --company-id | Enregistrer un employé RH comme enseignant |
update-instructor | --instructor-id [champs] | Mettre à jour le profil de l’enseignant |
get-instructor | --instructor-id | Obtenir un enseignant avec ses sections actuelles |
list-instructors | --department-id --is-active --company-id | Lister les enseignants |
get-teaching-load | --instructor-id --academic-term-id | Charge d’enseignement vs heures maximales |
Domaine des frais
| Action | Paramètres clés | Description |
|---|
add-fee-category | --name --code --company-id | Créer une catégorie de frais (scolarité, frais de labo, etc.) |
update-fee-category | --fee-category-id [champs] | Mettre à jour une catégorie de frais |
list-fee-categories | --company-id | Lister les catégories de frais |
add-fee-structure | --name --program-id --academic-term-id --items --company-id | Créer une structure de frais avec lignes |
update-fee-structure | --structure-id [champs] | Mettre à jour une structure de frais |
get-fee-structure | --structure-id | Obtenir une structure de frais avec ses éléments |
list-fee-structures | --program-id --academic-term-id --company-id | Lister les structures de frais |
add-scholarship | --student-id --name --discount-type --discount-amount --company-id | Attribuer une bourse/réduction |
update-scholarship | --scholarship-id [champs] | Mettre à jour une bourse |
list-scholarships | --student-id --scholarship-status --company-id | Lister les bourses |
generate-fee-invoice | --student-id --program-id --academic-term-id --company-id | Générer une facture de frais de scolarité (applique les bourses) |
list-fee-invoices | --student-id --company-id | Lister les factures pour un élève |
get-student-account | --student-id --company-id | Résumé du compte : factures, bourses, solde |
get-outstanding-fees | --company-id [--due-date-to] | Tous les élèves avec factures en souffrance |
apply-late-fee | --student-id --fee-category-id --amount --company-id | Appliquer des frais de retard |
Domaine des communications
| Action | Paramètres clés | Description |
|---|
add-announcement | --title --body --company-id [--priority --audience-type --audience-filter] | Créer une annonce (brouillon) |
update-announcement | --announcement-id [champs] | Mettre à jour une annonce brouillon |
submit-announcement | --announcement-id [--published-by] | Publier + créer des notifications pour le public |
list-announcements | --announcement-status --audience-type --company-id | Lister les annonces |
get-announcement | --announcement-id | Obtenir une annonce + nombre de notifications |
submit-notification | --recipient-type --recipient-id --notification-type --title --message --company-id | Envoyer une notification ciblée |
list-notifications | --recipient-id --recipient-type --is-read --company-id | Lister les notifications |
mark-notification-read | --notification-id | Marquer une notification comme lue |
get-communication-preference | --recipient-id --recipient-type --company-id | Obtenir les préférences de communication |
update-communication-preference | --preference-id --preferred-channel --opt-in | Mettre à jour les préférences de communication |
add-communication-template | --name --template-type --subject --body --company-id | Créer un modèle de communication |
update-communication-template | --template-id [champs] | Mettre à jour un modèle |
list-communication-templates | --template-type --company-id | Lister les modèles de communication |
add-parent-conference | --student-id --guardian-id --conference-date --notes --company-id | Planifier une conférence parents-profs |
update-parent-conference | --conference-id [champs] | Mettre à jour une conférence |
list-parent-conferences | --student-id --guardian-id --conference-date-from --conference-date-to --company-id | Lister les conférences |