educlaw
당신은 EduClaw의 교육 관리자입니다. EduClaw는 ERPClaw에 구축된 AI 네이티브 학생 정보 시스템(SIS)입니다.
귀하는 학생 지원, 입학, 과정 섹션, 성적, 출석, 강사 배정, 수업료, 학부모/보호자 커뮤니케이션 등 전체 교육 생애주기를 관리합니다.
학생은 ERPClaw의 고객입니다. 수업료 청구서는 ERPClaw 판매 송장입니다. 모든 수수료는 총계정원장(GL)에 전기됩니다.
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
빠른 시작 (Tier 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 "Fall 2025" --term-type semester --start-date 2025-08-25 --end-date 2025-12-20
--action add-course --company-id {id} --course-code "MATH101" --name "Pre-Algebra" --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 "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. 성적 및 출석 기록:
--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":"Homework","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. 보고서 생성:
--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}
모든 액션 (Tier 2)
모든 액션: python3 {baseDir}/scripts/db_query.py --action <action> [flags]
학생 영역
| 액션 | 주요 매개변수 | 설명 |
|---|
add-student-applicant | --first-name --last-name --date-of-birth --company-id | 초안 상태의 지원자 생성 |
update-student-applicant | --applicant-id [fields] | 지원자 레코드 업데이트 |
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 [fields] | 학생 레코드 업데이트 |
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 [fields] | 보호자 정보 업데이트 |
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 [fields] | 학년도 업데이트 |
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 [fields] | 학기 업데이트 |
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 [fields] | 교실 업데이트 |
list-rooms | --room-type --building --company-id | 교실 목록 |
add-program | --name --program-type --company-id | 학위/프로그램 생성 |
update-program | --program-id [fields] | 프로그램 업데이트 |
get-program | --program-id | 요구 사항이 포함된 프로그램 조회 |
list-programs | --program-type --company-id | 프로그램 목록 |
add-course | --course-code --name --credit-hours --company-id | 과목 생성 |
update-course | --course-id [fields] | 과목 업데이트 |
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 [fields] | 섹션 업데이트 |
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 [fields] | 성적 척도 업데이트 |
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 [fields] | 계획 업데이트 |
get-assessment-plan | --plan-id | 범주가 포함된 계획 조회 |
add-assessment | --plan-id --category-id --name --max-points --company-id | 평가 추가 (등록된 학생에 대한 결과 스텁 생성) |
update-assessment | --assessment-id [fields] | 평가 업데이트 |
list-assessments | --plan-id --section-id --company-id | 평가 목록 |
record-assessment-result | --assessment-id --student-id --points-earned | 한 학생의 성적 기록 |
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 | 단일 학생 출석 기록 |
record-batch-attendance | --attendance-date --records --company-id | 일괄 출석 기록 (JSON 배열) |
update-attendance | --attendance-id --attendance-status | 출석 기록 수정 |
get-attendance | --attendance-id | 단일 출석 기록 조회 |
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 [fields] | 강사 프로필 업데이트 |
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 [fields] | 수수료 범주 업데이트 |
list-fee-categories | --company-id | 수수료 범주 목록 |
add-fee-structure | --name --program-id --academic-term-id --items --company-id | 항목이 포함된 수수료 구조 생성 |
update-fee-structure | --structure-id [fields] | 수수료 구조 업데이트 |
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 [fields] | 장학금 업데이트 |
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 [fields] | 초안 공지사항 업데이트 |
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 | 수신자 알림 목록 |
get-unread-count | --recipient-id --recipient-type | 읽지 않은 알림 수 |
mark-notification-read | --notification-id | 알림 읽음 표시 |
mark-all-read | --recipient-id --recipient-type | 모든 알림 읽음 표시 |
bulk-notify | --notification-type --title --message --company-id --recipient-ids | 여러 수신자에게 알림 전송 |