Guides & Help
Knowledge Base
Role-based operating guides for Ateminium. Register, get the school ready, run a term, upload results, set fee policy, run bursar billing, and keep academic records secure. Same topics as the video tutorials, in writing.
For school administrators
School Registration
Before You Start
- School name, location, and an admin email you can access
- South Sudan phone number for the school administrator
01.Open Registration
Go to Register Your School and complete the three steps: school info, admin account, and details.
02.Submit and Wait for Review
Ateminium reviews registrations, typically within one working day. Until approval, the school admin cannot sign in.
03.Sign In After Approval
When approved, you receive email confirmation. Sign in on the Staff tab with the admin email and password you chose at registration.
04.Continue with Setup
Next, follow Get the School Ready (or open the in-app Setup Guide at
/admin/guide).
Common Failures
- Still Pending: you cannot sign in until Ateminium approves the school. Wait for the confirmation email or contact support with your school name.
- Wrong Tab: school admins and teachers use the Staff tab (email + password), not the Student tab.
Prefer video? Watch School Registration
For school administrators
Get the School Ready
Before You Start
- School registration approved and admin signed in
- Decided academic year label and which classes you offer
Use the In-App Setup Guide
Signed-in admins can follow the live checklist at /admin/guide (Get the School Ready / Run a Term). This page is the public written version of the same flow.
01.Configure the Class Catalog
In Settings → Class Catalog, add every class your school uses (or start with Senior 1-4). Students can only pick these exact classes at signup. Save before sharing your School ID.
02.Create and Activate a Term
Under Academics → Terms, create Term 1 for the academic year. If it is the only term, it is marked Active automatically. Create Term 2 or Term 3 only after you lock the previous term in that year. Teachers upload only for the Active unlocked term.
03.Set Passing Marks (Optional)
In Settings → Passing Marks, set the minimum pass percentage per class when ready. If you skip this, promotions use the default 50% pass mark.
04.Review Optional Subjects (Optional)
Confirm Arts and Science optional subjects for Senior 3 in Settings → Optional Subjects. Students pick optionals after login when applicable.
05.Add Teachers and Assignments
Create teacher accounts and assign class-subject pairs in Teachers. Teachers need assignments before they can upload results.
06.Share Registration ID and Enroll Students
From Students, share your School ID (SCH-ID) / Registration ID so students can self-register. You can also create students on the roster when needed.
Common Failures
- Students Cannot Pick a Class: save the Class Catalog in Settings before sharing SCH-ID.
- Teachers Cannot Upload: create an Active unlocked term and assign class-subject pairs first.
Prefer video? Watch Get the School Ready
For school administrators
Set Up Teachers
Before You Start
- Active (or soon-active) term planned
- List of teachers and the subjects they teach
01.Create Teacher Accounts
Only school admins create teachers. Open Teachers, enter name, email, South Sudan phone, and gender. Each teacher gets a temporary password for first sign-in.
02.Assign Class-Subject Pairs
Assign the exact classes and subjects each teacher teaches. Each class-subject pair belongs to one teacher for the academic year. Upload access follows those assignments only.
03.Hand Over First-Login Details
Share the teacher's email and temporary password securely. They must sign in on the Staff tab and change the password before the teacher dashboard opens.
Common Failures
- Class-Subject Already Taken: each pair can only be assigned to one teacher for the academic year.
- Teacher Stuck at Password Change: they must finish forced password change before the dashboard opens. See Teacher First Login below.
Prefer video? Watch Get the School Ready
For school administrators
Run a Term
Before You Start
- Teachers assigned and students enrolled for the classes in play
- One Active unlocked term for uploads
Locking Is Permanent
Teachers upload only for the Active term. Locking freezes further upload changes and requires your administrator password. Release transcripts in a separate step after lock.
01.Set the Active Term
In Academics → Terms, mark the term teachers should upload into as Active. Only one Active unlocked term accepts Excel uploads.
02.Teachers Upload Scores
Teachers download pre-filled Excel templates for their assigned class-subject pairs, enter marks 0-100, and upload. Students can view those marks on their dashboard immediately after a successful upload.
03.Monitor Class Results
Use Upload Status and Class Results to catch missing subjects before you lock.
04.Lock the Term When Marks Are Final
Locking is permanent and requires your administrator password. Teachers can no longer change uploads for that term. Pass/fail is processed; the final term promotes passed students; Senior 4 Term 2 drives internal graduation.
05.Release Transcripts
After lock, release transcripts so students can download official PDF transcripts from their dashboard (subject to clearance).
06.Manage Transcript Clearance
From Students → By Class, block or allow transcript downloads per student or class when holds apply (for example fees or other school policies). Clearance is separate from finance auto-blocks.
07.Create the Next Term (When Needed)
After you lock the current term, create the next term for that academic year under Academics → Terms. You cannot add Term 2 or Term 3 while the previous term is still open. Set the new term Active before teachers upload into it.
Common Failures
- Students See Marks but Not PDFs: viewing marks needs only a successful upload; official PDFs need lock + release + no clearance block.
- Incomplete Subjects: check Upload Status / Class Results before locking.
Prefer video? Watch Run a Term
For school administrators
School Fees
Before You Start
- School approved and at least one academic term created
- Classes and enrolled students ready (class names must match fee schedule cohorts)
- Agreement on currency (SSP, USD, or Dual) before posting money
Fees ≠ Academic Blocks
Finance clearance on a statement is not the same as transcript clearance. If you need to hold a transcript PDF, use Students → By Class clearance controls deliberately.
01.Unlock School Fees
Open Finances → School Fees and confirm with the administrator password. Fees Overview stays available without that unlock; sensitive fee work does not.
02.Set Currency Mode
In Currency, choose SSP, USD, or Dual before posting fee activity. Changing mode after catalog, schedules, or payments exist is restricted.
03.Build the Fee Catalog
Under Catalog, define reusable fee items (name, code, compulsory/optional, term/year amounts).
04.Publish a Term Schedule
In Schedule, assign catalog items to fee cohorts (class level × day/boarding) for a term, save a draft, then publish. Day-to-day billing and payment posting run from the bursar workspace.
05.Create Bursar Accounts
Under Bursars, create each bursar with name, email, phone, and gender. Copy the temporary password from the dialog and share it securely. Bursars sign in on the Staff tab (email + password) and must change the password on first login. Deactivate accounts when staff leave.
06.Grant Scholarships (Policy)
Use Scholarships to grant percent or amount relief on selected fee items for a term, year, or until revoked. Bursars cannot invent scholarship policy; they only see the effect on bills and payments.
07.Use Reports for Oversight
Admins use Reports for collections and year summaries. Students see a read-only statement under My Fees.
Common Failures
- Cannot Change Currency: mode is locked after fee activity exists. Set it first.
- Students See “No Fees Yet”: publish a schedule for their class/term and ask the bursar to generate bills for that cohort.
- Bursar Cannot Bill: confirm currency is set, the term schedule is published, and the bursar account is active.
For bursars
Bursar Workspace
Before You Start
- Email and temporary password from your school admin (Staff tab)
- Admin has set currency and published a fee schedule for the term
- Students enrolled in the classes you will bill
Admin Sets Policy. Bursar Runs Billing.
If currency, catalog, or schedules are missing, stop and ask the school admin. Do not invent fee items or scholarship rules in the bursar workspace. See School Fees for the admin setup path.
01.Sign In and Open the Workspace
Sign in on the Staff tab with the email and temporary password from your school admin, then change your password when prompted. Your home is Fees Overview (
/bursar). Open School Fees for day-to-day work.02.Unlock School Fees
School Fees asks for your bursar password again before residency, bills, payments, openings, unpaid fees, and reports. Fees Overview does not need that second unlock. Currency mode is set by the admin. If it is missing, ask them to finish policy setup first.
03.Set Student Residency
On the Residency tab, search or filter students and mark each as day or boarding for the term. Wrong residency produces wrong bill amounts after generate.
04.Generate Bills
On Bills, select a term that already has a published schedule. Generate bills for a class or filtered roster. Confirm net amounts, installments, and clearance status. Follow on-screen messages if a student is already billed so you do not create duplicate charges. After residency or schedule changes, use Rebuild for unpaid bills instead of generating again.
05.Record Opening Balances When Needed
Use Openings for carry-in arrears or credit when a continuing student starts the term with a prior balance. Confirm the listing before posting new payments.
06.Review Scholarships
On Scholarships, view active grants and beneficiaries for the term or year. Bursars cannot create or revoke scholarship policy here. Ask the school admin if a grant is missing or needs to change.
07.Post Payments and Receipts
On Payments, select the student bill, enter cash or bank amounts, and post. Note the receipt number and download the PDF when parents or students need proof. Apply available credit when the UI offers it. If you posted the wrong amount, void the payment and re-post the correct one. There is no parent refund flow in Ateminium.
08.Track Unpaid Fees and Run Reports
Unpaid Fees shows class arrears for the term (export CSV when you need a list). Reports covers collections, year summary, and credit views for the academic year. Unpaid fees never automatically block login, promotion, or transcripts.
Common Failures
- Wrong Bill Amounts: check residency (day vs boarding) and that the published schedule matches the student’s fee cohort.
- Cannot Generate Bills: the term needs a published schedule and a school currency mode. Ask the admin if either is incomplete.
- Payment Mistake: void the receipt and re-post. There is no parent refund button in Ateminium.
- Used Student Tab: bursars sign in on Staff with email, not STD-ID.
For school administrators
Trial & Go-Live
01.Keep the Pilot Small
For the 30-day free trial, involve about 3-5 teachers and 50-60 students. Not the whole school.
02.Use a Pilot Term and Sample Marks
Create a clearly labelled trial term, onboard the pilot cohort, and upload made-up marks (0-100) so you can test view, lock, release, and transcripts without waiting for real exams.
03.Decide at the End of the Month
If you continue, convert on the same school account. Prefer a clean production start (wipe trial academic data) unless you intentionally keep the pilot roster. If you stop, Ateminium can expire and remove the tenant after a short retention window. Ask support rather than deleting rows by hand.
Success Looks Like
One admin can open a term, a few teachers upload sample marks, pilot students see results, and you can walk lock → release → transcript download (and fees if you are evaluating that too) within 30 days.
For teachers
First Login
Before You Start
- Email and temporary password from your school admin
01.Receive Your Invite Details
Your school admin creates your account and shares your email plus a temporary password. Teachers cannot self-register.
02.Sign In on the Staff Tab
Open Login, choose the Staff tab, and sign in with email and the temporary password.
03.Change Your Password
Ateminium forces a password change before the teacher dashboard. After that, you only see class-subject pairs assigned to you.
Common Failures
- No Assignments: ask your admin to assign class-subject pairs before you try to upload.
- Used Student Tab: teachers sign in on Staff with email, not STD-ID.
Prefer video? Watch First Login
For teachers
Upload Results
Before You Start
- Forced password change completed
- At least one class-subject assignment
- School has an Active unlocked term
01.Confirm the Active Term
Uploads only work for the school’s Active unlocked term. If upload is unavailable, ask your admin to set the correct Active term.
02.Download the Template
Choose your assigned class and subject, then download the Excel template. Student names and Student IDs are already filled.
03.Enter Scores 0-100
Fill marks for each student. The system validates values on upload.
04.Upload and Review the Summary
Submit the file and read the validation summary. Once accepted, students can already see those marks on their dashboard. After the admin locks the term, you cannot change that term’s uploads.
Common Failures
- Validation Errors: keep marks between 0 and 100 and do not rename template columns or student ID cells.
- Term Locked: you cannot re-upload for a locked term. Contact your admin about process; locked uploads are not reopened.
Prefer video? Watch Upload Results
For students
Student Registration
School ID Required
Without a valid SCH-ID from your school admin, you cannot register. This blocks unauthorized accounts and protects school data.
01.Get Your School ID
Ask your school administrator for the unique School ID (SCH-ID). You cannot create a student account without it.
02.Open Student Signup
Visit Student Registration and verify your School ID to confirm you are joining the right school.
03.Create Your Account
Enter your name, select your class from the school’s catalog, set a password, and submit. Double-check your class before finishing.
04.Save Your Student ID
Ateminium issues a unique Student ID (STD-ID). Keep it safe. You sign in on the Student tab with STD-ID and password (not email).
Common Failures
- Invalid School ID: re-check the SCH-ID with your school office; the school must be approved and the class catalog saved.
- Forgot STD-ID: ask your school admin to look it up on the roster. Login uses Student ID, not email.
Prefer video? Watch Student Registration
For students
Results and Transcripts
Before You Start
- You can sign in with your STD-ID and password
01.View Marks After Upload
When a teacher successfully uploads results for your class and subject, those marks appear on your student dashboard right away. No term lock is required just to view marks.
02.Wait for Official Transcripts
Official transcript PDFs are available only after your school admin locks the term and releases transcripts.
03.Check Clearance If Download Fails
If the term is released but you still cannot download, your school may have a transcript clearance hold on your account or class. Contact your school office, not Ateminium support, for clearance.
Common Failures
- Empty Results: your teachers may not have uploaded that subject yet, or you are in the wrong class. Confirm with the school.
- Transcript Blocked: clearance hold or transcripts not released. Ask the school office.
Prefer video? Watch Results and Transcripts
For students
My Fees
01.Open My Fees
After sign-in, open My Fees to see billed amounts, adjustments, payments, credit, and dues for terms your school has published.
02.Read the Statement
The statement is read-only. Receipts and payment history appear when your school has recorded payments against your account.
03.Remember Academics Stay Separate
Unpaid fees do not automatically block login, promotion, or transcripts. Your school may still apply a manual transcript clearance hold when policy requires it.
Common Failures
- No Bills Yet: your school may not have published a fee schedule for your class/term.
- Payment Questions: Ateminium shows what the school recorded; bring payment disputes to the school bursar or office.
For everyone
How Your Data Stays Protected
01.Multi-Tenant Isolation
Each school’s data is isolated. Your records stay separate from every other institution on the platform.
02.Role-Based Access
Permissions limit what each person can see. Students cannot view other students’ results; teachers stay within their assignments.
03.Transport and Session Security
Sign-in uses an HttpOnly session cookie (about 2 hours). API access is scoped by school. Production deployments use managed database backups and persistent upload storage.
04.Result Integrity
Term locking, controlled transcript release, clearance holds, and audit trails keep academic records accountable after they are finalized.
Related: Security attestation (download) · Privacy Policy · Terms of Service · Cookie Policy
Still Need a Hand?
If a step does not match what you see in the product, contact support and include your school name, role, and the guide section you were following. Prefer video? Open the Video Tutorials.
Contact Support