このプロジェクトについて
このリポジトリは、デプロイメントごとに単一の学校向けの自己ホスト型学校管理プラットフォームです。Laravel 13、PHP 8.3、MySQL 8、Redis 7で構築され、Docker Composeスタック(app、nginx、db、redis、MinIO、Horizon、scheduler)が同梱されています。管理インターフェースは、Laravel BladeとBootstrap 5でサーバーレンダリングされます。
範囲とモジュール:READMEには、コアプラットフォーム(学校、学年度/クラス/セクション/科目/ルーチン、ユーザーと認証)、学生ライフサイクル(入学、進級、転校、オンライン入学、データインポート)、学術(試験、成績、GPA/成績表、証明書、RFIDによる出席)、財務(授業料項目、bKash/SSLCommerz/Stripe/PayPalによる支払い、小切手、返金、給与、レポート)、コミュニケーション(お知らせ、SMS一括送信、メッセージスレッド)、運用(スタッフ、休暇、図書館、交通、IDカード、LMS、ウェブサイトCMS)にグループ化された26のドメインモジュールが説明されています。ローカリゼーションモジュールは、RTLサポート付きのデータベースバックアップ翻訳を提供します。
役割には、スーパー管理者、管理者、教師、会計担当者、図書館司書、受付、学生、保護者が含まれ、管理、スタッフ、学生/保護者ポータルが別々にあります。認可には、Web UI用のSpatie Laravel Permissionと、API用のアビリティを持つ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でライセンスされており、そのネットワーク使用条項では、ネットワークサービスとして実行する場合に変更を公開する必要があります。
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.