Wisdsol Edu Advance

Une plateforme complète de gestion scolaire conçue pour les établissements francophones — de la Petite Section à la Terminale. Gérez élèves, personnel, frais, résultats, présences, cartes d'identité et plus encore.

Connexion

Visitez l'URL de votre établissement (ex. https://yourschool.edu.gh/s/school-slug/) and enter your username and password. After a successful login you are redirected to your role dashboard.

L'écran de connexion — saisissez votre nom d'utilisateur et mot de passe pour accéder à votre tableau de bord.

Changer le mot de passe NEW

Any logged-in user can change their own password at any time. Go to Compte → Changer le mot de passe in the sidebar, or click your name in the top-right corner and select Changer le mot de passe.

1. Saisir votre Current Mot de passe to verify your identity.
2. Tapez votre nouveau mot de passe (minimum 6 caractères). Un indicateur de sécurité s'affiche en temps réel.
3. Confirmez le nouveau mot de passe — le champ devient vert lorsqu'ils correspondent.
4. Click Mettre à jour Mot de passe. Vous restez connecté automatiquement.

Rôles & Permissions Reference

Chaque utilisateur se voit attribuer exactement un rôle. The role controls which sidebar sections, pages, and actions are available. The table below is the complete permission matrix.

✓ Full   V Voir only   A Approuver only   S Soumettre only   ✗ Aucun access

Sidebar Navigation UPDATED

The sidebar is organised into collapsible groups — Academic, Records, Finance, Comptabilité, Clocking, Sécurité, Administration, and Compte. Click any group header to expand or collapse it. The system remembers which groups you had open between page loads.

Type in the Rechercher dans le menu… box at the top des the sidebar to instantly filter all menu items. Matching text is highlighted in amber. Press Esc to clear the search and restore the full menu.

The main dashboard — key metrics, notices, quick actions, and recent payments in one view.

Abonnements NEW

Each school on the platform requires an active subscription. Abonnements are managed by the platform superadmin at Administrateur → Abonnements.

• Free Trial — 30-day trial on any plan. Full access during trial.
• Actif — Payé subscription with an expiry date.
• Expiré / Suspendu — Utilisateurs see a block page and cannot access the system. The public landing page remains visible.

When a feature is locked by your plan, its sidebar link shows a padlock icon and clicking any locked URL shows an Mettre à niveau Obligatoire page listing what your current plan includes and a link to contact your administrator.

Mon abonnement & Forfait — current plan status, active features grid, and side-by-side plan comparison with upgrade button.

Customise Your Page d'accueil NEW

Each school has a public-facing branded landing page shown to visitors and parents at your school URL. Administrateur and Directeur users can customise it at Administrateur → Modifier Page d'accueil.

• Hero tagline & subtitle — the main headline and text shown on the landing page.
• Colour theme — choose from Ocean Blue, Forest Green, Sunrise Orange, Royal Purple, Crimson Red, Dark Slate, or Ghana Gold. Also set exact primary and accent hex colours.
• Stats bar — three customisable stat labels and values (e.g. "500+ Élèves", "40+ Enseignants").
• About section — a paragraph about your school and your founding year.
• Contact details — address, phone, email, Facebook URL, and WhatsApp number.
• Announcement banner — a coloured strip for notices such as "Enrolment now open".
• Inscription CTA button — links to an external application form or the built-in admissions page.

Click Aperçu Live Page at the top to see your changes live. Toggle Page d'accueil publiée surf to hide the branded page and show a plain sign-in page instead.

Profil de l'établissement

Set your school's name, motto, address, region, district, phone, email, logo, school type, circuit ONEC/DGEC, proprietor, and headmaster via Administrateur Panel → Core → Informations de l'établissement.

Année scolaire & Trimestres

Go to Administrateur → Années scolaires & Trimestres to create or edit the school calendar.

For a fresh school, run this command on the server to create the current academic year, all three terms with calendrier scolaire officiel, and all classrooms from Petite Section à la 3ème in one step:

python manage.py setup_school
# For SHS schools:
python manage.py setup_school --shs
# Specific year and current term:
python manage.py setup_school --year 2025/2026 --term 2 --shs

1. Click Ajouter Année scolaire and enter the label (e.g. 2025/2026), start and end dates.
2. Click Ajouter Trimestre under the year to create Trimestre 1, 2, and 3 with their start/end dates.
3. Click Set as Current next to the active term.

Classes & Matières UPDATED

Go to Academic → Classes to view, create, and edit classrooms. Each class is linked to a grade level and an academic year. Ajouter sections (A, B, C) for parallel streams.

Note levels available: Crèche · Nursery 1 · Nursery 2 · KG 1 · KG 2 · Primary 1–6 · JHS 1–3 · SHS 1–3.

Click the amber Modifier button on any classroom card (list page) or the Modifier Classe button in the classroom detail header. You can update the class name, grade level, section, class teacher, capacity, room number, and academic year.

Go to Academic → Devoir Hub to manage all teacher assignments in one place across three tabs:

• Professeurs principaux — assign a class teacher to each classroom. Filtrer by "Aucun Enseignant Yet" to spot gaps quickly.
• Personnel Utilisateur Links — link staff records to their system login accounts so they can access their portal.
• Matière Enseignants — assign subject teachers per class-subject pair. Filtrer by class or search by subject name.

Matières are managed at Academic → Matières. Each subject has a code, category (Core / Elective / Activité parascolaire), and department.

Élèves

Go to Academic → Élèves to manage all student records.

Both Identifiant élève and Numéro d'inscription are now optional. Leave them blank when adding a student and the system auto-generates them in the format:

• Identifiant élève — STU-2025-0001
• Numéro d'inscription — ADM-2025-0042

You can still type your own ID format — the auto-generation only triggers when the field is left blank.

Each student stores: name, gender, date des birth, nationality, religion, region des origin, photo, current class, admission date, numéro d'assurance maladie, guardian links, emergency contacts, residential address, and boarding status.

Tuteurs/Tutrices & Parents

Go to Academic → Tuteurs/Tutrices. A student can have multiple guardians (father, mautre, uncle, etc.) through the ÉlèveTuteur/Tutrice link. Tuteurs/Tutrices can be linked to a parent portal account.

Inscription Applications

Prospective families can apply online via the public form at Appliquer for Inscription on your school's landing page — no account required.

1. Applicant fills in the form: student details, class applied for, and guardian information.
2. Administrateur reviews pending applications at Academic → Inscriptions.
3. Approuver the application to convert it into a full student record, or reject with a note.

Personnel

Go to Academic → Personnel. Each staff record holds personal details, employment information, qualifications, bank details, CNSS number, and a QR clock-in token.

Leave the Identifiant du personnel field blank when adding a new staff member. The system generates it automatically as EMP-2025-0001. Existing custom IDs are never overwritten.

Utilisateur Compte Management & Rôle Privileges

Go to Administrateur → Utilisateur Management. Each system user has exactly one role which controls every page, button, and action they can access.

Administrateurs and Directors can create accounts directly from Administrateur → Utilisateur Management → Ajouter Utilisateur or approve self-registration requests at Administrateur → Demandes d'inscription. Each user is automatically tagged to the school they registered through -- they cannot see users or data from autre schools.

Administrateur and Director can reset any user's password from the Utilisateur Management list. Platform administrator (superuser) passwords cannot be changed by school-level admins for security. Any user can change their own password via Compte → Changer le mot de passe.

Each school's user list only shows users registered under that school. Superusers (platform admins) appear in every school's list but show a "Platform Administrateur" badge -- their Modifier and Réinitialiser buttons are hidden for school-level viewers.

Utilisateurs created before the school-scope migration have no school assigned. Run this command once per school to fix them:

python manage.py assign_user_school --slug your-school-slug
python manage.py assign_user_school --slug your-school-slug --dry-run  # preview

Présence Tracking

Go to Records → Présence. Enseignants mark attendance for their assigned class each school day.

1. Sélectionner your class and the date (defaults to today).
2. The full class list loads automatically. Click each student's status: Présent (P), Absent (A), or En retard (L).
3. Ajouter a reason for absences using the notes field beside each student.
4. Click Enregistrer Présence. The record is timestamped with who marked it.

• Daily roll — shows who is present, absent, or late for a given day.
• Trimestre summary — shows total jours present, absent, and late for each student. Used for report card attendance figures.
• Low attendance alerts — students below a threshold (configurable) are flagged automatically.
• Filtrer any report by class, date range, or individual student.

Présence marking — tick Présent, Absent, or En retard per student, add excuse notes, and see the weekly class overview.

QR / PIN Clocking

The gate kiosk at Clocking → Gate Borne allows students and staff to clock in/out by scanning their ID card QR code or entering their 4-digit PIN.

QR codes on ID cards now encode the full school-specific URL including the school slug (e.g. /s/hill-spring/portal/clock/scan/TOKEN/). This ensures QR scans from any device — phone, tablet, or dedicated scanner — correctly identify the school and clock the right person.

Each student and staff member also has a 4-digit PIN (last 4 digits des their ID, or a random number). PINs work hors ligne and on the mobile clock page.

Personnel and students can clock themselves in on their own phones at Clocking → Mobile Clock. Aucun login required — just scan or enter PIN.

QR / PIN Gate Borne — students scan their ID card QR code or enter their 4-digit PIN to clock in. A green card confirms with name and time. Works fully hors ligne.

Frais & Paiements UPDATED

Go to Finance → Frais Tableau de bord. The system supports multi-term fee structures, bulk fee assignment, scholarships, bulk payment, advance payments, and service plans.

Use Finance → Collect Frais to record a single payment for one fee item. Type the student's name or admission number, select the outstanding fee, enter the amount, choose the payment method (Espèces, MoMo, Bank, Chèque), and save. A printable receipt is generated automatically.

Use Finance → Paiement en masse to pay multiple fee items for one student in a single session — useful when a parent is clearing term fees, building fund, and PTA levy all at once.

1. Rechercher for the student by name or admission number.
2. Tous outstanding fee items are shown in a table. Type the amount to pay into each row, or click ✓ to fill the full balance. Click Tous to fill every fee at once. A running total updates live.
3. Choisir payment method, date, and optional reference, then click Record Paiement en masse.

Each fee item gets its own receipt. If only one fee is paid you go directly to the receipt; if multiple fees are paid you return to the student's fee summary with a total confirmation.

Define fees per class par trimestre at Finance → Structure des frais. Frais types include Tuition, Building Fund, Sports, Uniform, Library, PTA, Examination, Boarding, and Lunch. Use Auto-Attribuer des fraiss to apply a fee structure to all students in a class at once. Bourses are applied automatically when fees are assigned.

If a fee was applied to the wrong student or class, cancel it rather than delete it. Go to the student's fee page and click the red button on the fee card, or use Finance → Annuler les fraiss for bulk cancellation across a class. See the Frais Annulerlation section for full details.

You can bulk-create fee structures by importing a spreadsheet at Academic → Importer Data → Structures des frais. Télécharger the template to get the correct column format. The class column is optional — leave it blank to create a fee that applies to all classes; enter a class name to make it class-specific. The term column must match an existing term (e.g. "Trimestre 1 2025/2026").

Créer scholarships at Finance → Bourses and award them to individual students. Coverage can be a fixed FCFA amount, a percentage, or full waiver.

Auto-application: Remises now apply automatically when a scholarship is awarded or when fees are assigned — you no longer need to manually trigger the discount. To fix any student whose discount isn't showing:

1. Ouvrir the student's fee page. Their active scholarships appear as green badges in the header.
2. Click the Re-apply button next to the scholarship badge.
3. Tous matching fee rows are updated instantly and the discount appears in the fee table.

To re-apply all scholarships across all students at once, use Finance → Bourses → Re-Appliquer Tous.

Frais receipt — a printable A4 receipt with letterhead, amount, student details, balance, and signature lines. Also available in PDF and 80mm thermal formats.

Paiement en masse NEW

Access via Finance → Paiement en masse, or the green En masse Pay button on any student's fee page.

Paiement en masse lets you record payments for multiple outstanding fees in one session — ideal when a parent is settling all their arrears at once.

1. Rechercher for the student by name, ID, or admission number. Click their name from the list.
2. Tous outstanding fee items are displayed in a table showing the remaining balance and any scholarship discount applied. Type the amount to pay for each row, or click ✓ to fill the full balance for that fee. Click Tous to fill every fee at once.
3. A running total at the bottom shows the combined amount being entered. The Record Paiement en masse button activates as soon as any amount is entered.
4. Sélectionner the payment method, date, and optional transaction reference, then submit.

Each fee item gets its own individual receipt so records stay clean. If one fee is paid you are taken straight to the receipt; if multiple fees are paid you return to the student's fee summary with the combined total confirmed.

Bourses & Remises UPDATED

Go to Finance → Bourses. Bourses reduce a student's fee balance automatically once awarded.

Click Ajouter Bourse. Set the coverage type:

• Percentage (%) — e.g. 50% discount on applicable fees
• Fixed Montant (FCFA) — a fixed FCFA reduction per fee item
• Full Coverage — entire fee amount waived

Use the Applies to fee types field to restrict the scholarship to specific fee categories (e.g. tuition,exam). Leave blank to apply to all fee types.

On the scholarship detail page click Award to Élève. Rechercher for the student and confirm. The discount is applied immediately to all matching fee rows — no parascolaire step needed.

If discounts aren't showing on a student's fee page, click the Re-apply button next to their scholarship badge. This forces a recalculation across all their fee rows. To bulk-fix all students at once, use Finance → Bourses → Re-Appliquer Tous.

Arrear Soldes

Établissements migrating from a previous system can import outstanding balances from prior terms at Finance → Arrear Soldes → Importerer les arriérés. Arriérés are tracked separately from current-term fees so they do not affect term reports or auto-fee assignments.

1. Prepare a .xlsx or .csv file with columns: admission_number, amount, and optionally description, academic_year, notes.
2. Téléverser the file and set a default academic year and description for rows that don't have them.
3. Click Aperçu to review each row — green OK rows are valid, red Erreur rows show what's wrong.
4. Click Confirmer Importer to save all valid records.

Go to Finance → Arrear Soldes. Use the filter to show Impayé only, Tous, or Soldé records. Each arrear record expands to show its full payment history with receipt links.

Three KPI cards at the top show Total Impayé, Total Collecté, and Total Importered across all records.

Click the green Pay button on any outstanding arrear. The payment modal lets you enter the amount, payment method (Espèces, MoMo, Bank, Chèque), a transaction reference, and optional notes. Clicking Enregistrer & Issue Reçu creates the payment and immediately opens the printable receipt.

Arrear balances also appear at the bottom des each student's individual fee page (Finance → Frais de scolarité), where the same Pay modal is available and payment history is shown inline.

Click the pencil button on any arrear row to open the Modifier modal. You can correct the Description, Année scolaire, Original Montant, and — importantly — the Montant payé field. The Montant payé field lets you directly correct a wrong balance without needing to delete and re-enter payment records. A live balance summary bar shows the calculated balance as you type.

Click the red button to delete an entire arrear record (and all its payments). To delete a single payment, click the button on the payment row in the payment history table — the amount is automatically reversed from the balance.

Arrear Reçus & Paiement Management

Every arrear payment generates a numbered receipt (prefix ARR). The receipt page is a standalone printable document styled to match regular fee receipts.

Click the Reçu button on any payment row in the arrear payment history table. The receipt shows: school letterhead, receipt number and date, student details, arrear description, amount paid (with method icon), balance summary, full payment history for that arrear (with the current payment highlighted), and a signature section.

Two print formats are available from the receipt action bar:

• Imprimer — prints the full A4 receipt. The action bar is hidden automatically when printing.
• Thermal — opens a 80mm thermal receipt in a new tab, formatted for ESC/POS thermal printers. Use your browser's Imprimer function (Ctrl+P) to send it to the printer.

Click the amber Modifier button in the receipt action bar. The edit modal lets you correct the amount, payment method, payment date, transaction reference, and notes. After saving, the receipt page reloads showing the updated figures.

The maximum amount you can set is the current payment amount plus any remaining balance on the arrear — you cannot overpay.

Click the red Supprimer button in the action bar and confirm. The payment record is removed and the amount is reversed from the arrear balance. You are redirected to the Arrear Soldes list.

Comprehensive Bilan financier

Go to Finance → Summary & Analytics for a complete overview des all income and expenditure streams. Use the term selector to view a specific term or select Tous Trimestres for a cumulative school-wide view. Click Imprimer to print the page, or Exporter Excel to download a workbook.

A dark header strip always shows four headline figures regardless des scroll position: Total Income (all streams combined), Total Expenditure (expenses + payroll), Net Surplus (income minus expenditure, red if negative), and Total Receivable (outstanding fees + outstanding arrears).

• Income vs Expenditure — doughnut comparing total income against total expenditure.
• Income by Stream — doughnut breaking income into the four streams (fees, arrears, services, autre).
• Mode de paiements — doughnut des Espèces vs MoMo vs Bank vs Chèque across all payment types.
• Daily Frais Trend — bar chart des FCFA collected per day over the last 30 jours. Identifies peak collection jours.
• Dépense Breakdown — horizontal bar chart des approved spending by category.

A detailed table lists every fee type with Expected, Remise, Collecté, Owed, and a colour-coded progress bar. In Tous-Trimestres mode each row includes the term name so you can compare across periods.

Only shown when a specific term is selected. Progress bars turn red below 50%, amber 50–80%, green above 80% — useful for targeting follow-up calls with specific classes.

Two tabs at the bottom show the latest 15 fee payments and latest 10 arrear payments, each with a direct Reçu link.

Sélectionner Tous Trimestres from the term dropdown to aggregate data across the entire school history. Frais breakdown rows show the term name alongside the fee name. Per-class breakdown is hidden in this mode as it is only meaningful within a single academic year.

Comprehensive Bilan financier — all income and expenditure streams, KPI cards, payment methods, and fee breakdown in one view.

Dépense Approval Workflow NEW

Dépenses recorded by the Comptable do not post immediately -- they require approval by an Administrateur or Director before counting in the Net Surplus figure.

1. Comptable records an expense: Finance → Dépenses → Ajouter une dépense. Enregistrerd as En attente.
2. Administrateur or Director opens the expense list. En attente rows show a yellow badge and Approuver / Rejeter buttons.
3. Click Approuver -- the expense is posted and included in financial reports. Click Rejeter to decline it.

Services journaliers (Fraisding & Transport)

Go to Finance → Forfaits de service. Créer service plans (Fraisding, Transport, etc.) and enrol students. Daily attendance is marked per student at Clocking → Gate Tableau de bord → Services journaliers. Paiements are collected par trimestre in advance or daily.

Résultats & Notes

Go to Records → Résultats. Enseignants enter notes de contrôle et notes d'examen per subject. The system automatically calculates the weighted total and assigns the note pondérée (sur 20).

1. Go to Records → Résultats → Saisir les notes and select the class, subject, and term.
2. The student list loads. Saisir the Note de contrôle continu (continuous assessment) and Note d'examen for each student.
3. The system computes the weighted total using the configured weights (défaut 40% contrôle / 60% examen). La note finale is assigned automatically.
4. Click Enregistrer Notes. You can return and edit until results are published.

1. Click a class from the Résultats Tableau de bord.
2. Sélectionner a subject from the left panel.
3. Saisir Note de contrôle continu and Note d'examen for each student. Totals and grades update live as you type.
4. Use Saisir to move to the next student without lifting your hands from the keyboard.
5. Click Enregistrer Tous Notes. An unsaved-changes counter tracks any modifications before saving.

A progress bar in the header counts how many students have been noted in the current subject. Enregistrerd rows show with a green tint; unsaved changes turn amber. The browser will warn you before navigating away with unsaved notes.

Bulletin de notes — format francophone avec notes par matière, badges de mention, rang dans la classe, appréciations des enseignants et lignes de signature.

Configuration des pondérationsuration NEW

By default the system uses the curriculum francophone standard: 30% Note de contrôle continu + 70% Note d'examen. Administrateurs and Directeurs can change this ratio at Records → Pondérations des Notes.

Saisir the Note de contrôle continu weight — the Note d'examen weight automatically adjusts to make the total 100%. A live validation indicator turns green when valid and red if they don't sum to 100. Quick preset buttons provide common splits: 30/70, 40/60, 50/50, 60/40, and 20/80.

The current weights are shown in the header des the grade-entry page so teachers always know which split is in effect.

Bulletins de notes & ECD UPDATED

After entering all notes, go to Résultats → Générer les notes to compute positions, class averages, and overall remarks for every student in the class. Bulletins de notes are generated automatically.

Imprimer individual report cards from the student's results page, or print the full class batch. The report card shows all subject notes, grades, teacher remarks, class/overall position, conduct, attitude, and head teacher remarks — all auto-generated from the results data.

Tous report cards (standard, ECD, batch, and evolution) now use your school's brand colours set in Administrateur → Profil de l'établissement → Modifier → Brand Colours. The header, table backgrounds, grade badges, and highlight boxes all update to match. See the Brand Colours section for setup instructions.

Click the 🎨 Colour / B&W toggle button on any batch report page to switch all cards to greyscale before printing — useful for monochrome printers.

For Petite Section, Moyenne Section et Grande Section students, use the Records → ECD Reports checklist-style report card that covers developmental skills: language, physical development, social skills, mathematics, and art.

Access from the Résultats Tableau de bord or Bulletins en masse toolbar. Evolution reports show a student's performance across all three terms on a single A4 landscape page — with trend arrows, highlight panels, and attendance. ECD evolution reports show skill ratings across terms. See the Evolution Reports section.

Devoirs & Banque de questions

Go to Records → Devoirs. Enseignants create assignments, build a question bank, and print formatted question papers.

Comptabilité

Go to Comptabilité → Tableau de bord. The accounting module is a full double-entry bookkeeping system designed for school finance.

Go to Comptabilité → Forfait comptable. Tous financial transactions must be posted to an account. Comptes are organised into five types:

If the chart is empty, click Load Default Comptes to seed ~50 standard Ghana school accounts. You can add custom accounts at any time. System accounts (marked "System") cannot be deleted.

Go to Comptabilité → Journal Entries → New. Tous transactions are recorded as journal entrées with at least two lines: one debit and one credit. The entry must balance (total debits = total credits) before it can be posted.

1. Sélectionner the entry type (General, Frais Income, Dépense, Paie, etc.) and fill in the description and date.
2. Ajouter debit and credit lines, each linked to an account in the chart des accounts.
3. Click Enregistrer as Brouillon to keep editing, or Post Entry to finalise. Posted entrées cannot be edited — they must be reversed.

• Solde de vérification — lists every account with its debit/credit total. Used to verify the books are balanced.
• Compte de résultat (P&L) — Revenue minus Dépenses for a period. Afficher whether the school is operating at a surplus or deficit.
• Bilan — Assets = Liabilities + Equity at a point in time.
• Grand livre — every transaction line for any account in date order.
• Flux de trésorerie — movement des cash in and out.

# If existing DBs have auth table issues:
python manage.py fix_tenant_auth
python manage.py fix_scoreweight
python manage.py migrate_all_schools