프로젝트 소개

이 저장소는 배포당 단일 학교를 위한 자체 호스팅 학교 관리 플랫폼입니다. Laravel 13, PHP 8.3, MySQL 8, Redis 7로 구축되었으며 Docker Compose 스택(app, nginx, db, redis, MinIO, Horizon, scheduler)을 함께 제공합니다. 관리자 인터페이스는 Laravel Blade와 Bootstrap 5로 서버 렌더링됩니다. 범위 및 모듈: README는 26개 도메인 모듈을 핵심 플랫폼(학교, 학년도/학급/반/과목/시간표, 사용자 및 인증), 학생 생애주기(입학, 진급, 전학, 온라인 입학, 데이터 가져오기), 학사(시험, 성적, GPA/집계표, 증명서, RFID 출석), 재무(수수료 항목, bKash/SSLCommerz/Stripe/PayPal 결제, 수표, 환불, 급여, 보고서), 커뮤니케이션(공지, SMS 일괄 발송, 메시지 스레드), 운영(교직원, 휴가, 도서관, 통학, ID 카드, LMS, 웹사이트 CMS)으로 분류합니다. 현지화 모듈은 RTL 지원과 함께 데이터베이스 기반 번역을 제공합니다. 역할에는 슈퍼 관리자, 관리자, 교사, 회계사, 사서, 접수원, 학생, 학부모가 있으며 관리자, 교직원, 학생/보호자 포털이 별도로 존재합니다. 권한 부여는 웹 UI에 Spatie Laravel Permission을, API에는 abilities를 가진 Laravel Sanctum 토큰을 사용합니다. 아키텍처 참고: 문서화된 10단계 모듈 패턴(마이그레이션, 모델, 리포지토리, 서비스, 옵저버, 요청, 리소스, 컨트롤러/라우트, 테스트, 스타일/문서), Redis가 아닌 캐시 저장소에서도 작동하는 태그 기반 캐싱을 사용하는 리포지토리 패턴, 데이터베이스 트랜잭션으로 감싼 재무 쓰기, school_id로 범위가 지정된 쿼리. README는 206개 이상의 기능 테스트가 있으며 PHPStan이 레벨 5로 실행된다고 명시합니다. 배포: 시드된 데모 자격 증명이 포함된 Docker 빠른 시작과, 데이터베이스 기반 캐시/큐/세션 및 로컬 파일 저장소로 대체되는 공유 cPanel 호스팅 및 VPS 설치를 위한 문서화된 경로를 제공합니다. API 문서는 Scribe로 생성됩니다. 다국가 지원은 로케일, 통화, 시간대, 주말 요일, 국가별 결제 게이트웨이, 여러 채점 템플릿(방글라데시 5.0, 미국 4.0, 영국 9-1, 백분율)을 포함합니다. README는 이 프로젝트를 대부분 AI 코딩 에이전트로 구축한 취미/R&D 작업으로 설명하며, 전문적으로 QA된 제품이 아닌 프로토타이핑 놀이터로 명시적으로 규정합니다. AGPL-3.0에 따라 라이선스되며, 네트워크 사용 조항은 네트워크 서비스로 실행될 때 수정 사항을 공개할 것을 요구합니다.