REPORT CARD SYSTEM — Nursery, Primary & Secondary (multi-branch)
================================================================

INSTALL (cPanel)
1. cPanel → MySQL® Databases: create a database and a user, add the user to the database with ALL PRIVILEGES.
2. File Manager: upload report-card.zip into public_html (or a sub-folder such as public_html/results) and Extract.
3. Open https://your-domain/ (or /results/) in a browser. The installer opens. Enter the database details,
   school name and your super-admin username and password. Tick "demo data" to try it with sample classes and marks.
4. Log in. (To start over: delete config.php and empty the database.)
Requirements: PHP 8.0+ with PDO MySQL and GD (standard on cPanel).

WHO USES WHAT
- Staff login (/login.php): super admin (all branches), branch admins, teachers.
- Student / parent portal (/portal/login.php): students use admission no. + password; parents use phone + password
  and see all their children.
- Result checker (/check.php): admission no. + term + result PIN — or, with PINs turned off in Settings, + surname.

SET-UP ORDER (admin)
1. Branches (super admin) → School sections: logo, banner, heading, grade scale, template, observation ratings.
2. Sessions & terms: current term, term dates, "next term begins".
3. Grade scales (A1–F9, A–F, your own, with grade points) · Report card templates (colour, watermark, 3 signatures, footer).
4. Classes (+ class teacher) → Subjects (scholastic / co-scholastic) → Class subjects & teachers.
5. Exams & assessments per term: e.g. CA (Test 1 /20, Test 2 /20, weight 40) + Terminal Exam (Objective /30, Theory /70, weight 60).
   Unit tests, monthly tests, half-yearly, finals: add as many as you need. "Copy exams from another term" reuses a set-up.
6. Observation parameters (Affective domain, Psychomotor skills…).
7. Students: add, or import CSV (Admission no, Surname, First name, Other name, Gender, DOB, Parent name, Parent phone).
   "Login slips" creates and prints passwords. "Move to class" promotes at the end of the session.

EACH TERM
- Teachers: Marks entry (type AB for absent). Class teachers: co-scholastic grades, observations, attendance, remarks.
- Admin: Print report cards → Single exam / Term (all exams) / Session (all terms), one student or whole class.
- Publish: tick "Published" on an exam or term so students, parents and the checker can see it. Published exams lock
  marks for teachers.
- Reports: broadsheet, subject analysis & grade distribution, top students, missing marks (all exportable to CSV).

PRINTING TIP: in the browser's print window choose A4, margins Default, and turn ON "Background graphics".
