helooselassie/ghana-student-system

Ghanaian Student Information System in Django # Ghanaian Student Information System This project is a Django-based web application for managing students, programs, subjects, and marks in Ghanaian Junior High School (JHS) and Senior High School (SHS) institutions. ## Features - Register and manage students with personal details. - Define and assign Ghanaian JHS and SHS programs. - List and categorize core and elective subjects for each educational level. - Record and track student marks by subject. - Admin interface for easy data management. ## Models Overview - **Program**: Represents JHS/SHS programs such as General Science, Business, etc. - **Subject**: Core and Elective subjects with codes and levels (JHS/SHS). - **Student**: Student profiles, linked to their subjects. - **Mark**: Records marks for students per subject. ## Ghanaian Programs & Subjects - **Programs**: JHS, General Science, General Arts, Business, Technical, Visual Arts, Home Economics, Agriculture. - **Core Subjects**: English Language, Mathematics, Integrated Science, Social Studies (for both JHS and SHS). - **Electives**: Physics, Chemistry, Literature, Geography, Economics, Accounting, Technical Drawing, Visual Arts, etc. ## Setup Instructions 1. **Clone the repository** ```bash git clone github.com cd yourrepo ``` 2. **Install dependencies** ```bash pip install -r requirements.txt ``` 3. **Apply migrations** ```bash python manage.py makemigrations python manage.py migrate ``` 4. **Create superuser** ```bash python manage.py createsuperuser ``` 5. **Run the development server** ```bash python manage.py runserver ``` 6. **Access the admin panel** Visit 127.0.0.1 and log in. ## Usage - Use the admin panel to add programs, subjects, students, and marks. - Assign subjects to students and programs as needed. ## Contributing Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.