学校管理システム (Sistema-Escolar)

Data
学校管理システム (Sistema-Escolar)

学校管理システム (Sistema-Escolar)

PythonとMySQLで実装されたシンプルな学校管理システム。生徒（alunos）、コース（cursos）、履修（matrículas）に対するCRUD操作を備え、データベース接続情報は.envで管理。学習や小規模運用向けのCLI/スクリプト型アプリケーションとして、データ永続化・参照・更新・削除の基本機能を整理しています。

https://github.com/rafaelemidiolopes/Sistema-Escolar

概要

Sistema-Escolarは、Pythonで書かれた学籍管理（学校管理）用の小規模システムです。MySQLをデータ永続化層に用い、生徒（alunos）、コース（cursos）、および履修・登録（matrículas）に対する登録、更新、一覧表示、削除といった基本的なCRUD操作を提供します。データベース接続情報は.envファイルを用いて環境変数で管理する設計になっており、ローカル開発や学習目的でDB操作の流れを学ぶのに適しています。コマンドラインベースの操作想定で、テーブル間の関連（履修の有無による絞り込みなど）を扱える点も特徴です。

GitHub

リポジトリの統計情報

  • スター数: 2
  • フォーク数: 0
  • ウォッチャー数: 2
  • コミット数: 4
  • ファイル数: 10
  • メインの言語: Python

主な特徴

  • PythonでのCRUD実装（生徒・コース・履修管理）
  • MySQLを用いた永続化、接続設定は.envで管理
  • 履修状況（登録済み／未登録）を区別して一覧可能
  • 学習用途・小規模運用に向いたシンプルな構成

技術的なポイント

本プロジェクトは「明示的な層分離」と「環境変数による設定管理」を重視した設計になっています。database.pyにデータベース接続ロジックを集中させることで、接続情報の一元管理（ホスト、ユーザー、パスワード、データベース名など）を実現し、.envを読み込むことでソースコード中に機密情報を直書きしない安全なアプローチを取っています。CRUD操作は各ドメイン（生徒、コース、履修）ごとにモジュール化されており、cursos.py等のファイルに該当エンティティ向けのSQL実行や入出力処理が実装されています。

データ操作はおそらくプレーンなSQLを用いた直接実行（接続->カーソル->実行->コミット/フェッチ）スタイルで、SQLの理解を深める教育的価値があります。履修関連の処理では複数テーブルの結合や参照整合性（外部キー）を意識したクエリが使われている想定で、登録済み／未登録の生徒を抽出するロジックなど、実務でよくある要件を満たします。エラーハンドリングや入力検証は最小限に留まっている可能性が高く、堅牢性や拡張性を高める余地があります。

拡張観点としては、SQLインジェクション対策のためのパラメータ化クエリ、接続プールの導入、トランザクション制御の明示化、ORM（SQLAlchemyなど）やマイグレーションツール（Alembic）導入によるスキーマ管理、自動テスト（ユニットテスト・統合テスト）、およびDockerを用いた開発環境のコンテナ化が有効です。これらを適用することで、学習用サンプルから実運用向けの基盤へ段階的に移行できます。

プロジェクトの構成

主要なファイルとディレクトリ：

  • .gitignore: file
  • LICENSE: file
  • README.md: file
  • cursos.py: file
  • database.py: file

…他 5 ファイル

上記のうちの役割（推定）：

  • database.py
    • MySQLへの接続処理を集約。環境変数(.env)から接続情報を読み込み、接続オブジェクトやカーソル生成を行う関数やユーティリティが含まれる想定です。接続・クローズ・コミット処理の責務を担います。
  • cursos.py
    • コース（cursos）に関するCRUD関数群を実装。コースの追加、一覧表示、更新、削除などを行うスクリプト/モジュールです。
  • README.md
    • セットアップ手順、機能一覧、使い方の説明（例：環境変数の設定、データベース初期化方法、実行例）を記載。ローカルでの実行手順や依存パッケージの情報があるはずです。
  • .gitignore / LICENSE
    • 開発の基本ファイル。不要な一時ファイルや環境固有ファイルを無視する設定と、プロジェクトのライセンス表記。

他のファイル群（残り5ファイル）は、alunos（生徒）やmatriculas（履修）関連のモジュール、メインの起動スクリプト、依存関係ファイル（requirements.txt等）や.envのサンプルなどが含まれている可能性があります。総ファイル数は10で、シンプルな構成です。

まとめ

学習や小規模運用向けに読みやすく、環境変数管理など最低限のベストプラクティスも備えた良質なサンプルです。