GetJustly guide / Getting started
GetJustly testing and navigation guide
GetJustly connects people with a legal problem to the help they need: a guided first step, a lawyer, free legal aid or a paralegal who acts on their behalf. Lawyers run their practice on it, the Ministry of Justice watches where complaints pile up, and the platform team keeps money, identity and crisis alerts moving. This guide walks a tester through all five roles, then hands over a checklist.
https://getjustly.afrikabal.orghttps://getjustly.afrikabal.org/auth/personashttps://getjustly.afrikabal.org/emergencySigning in
- Open /auth/personas in Chrome, Edge or Safari.
- The page shows five seats: Client, Advocate, Paralegal, Oversight and Administrator. Each names the person you will be.
- Press the seat you want. You are signed in and land on that role's home.
- To switch role, open the account menu in the sidebar and sign out, then pick another seat.
- Every screen has an emergency link to /emergency: helplines and a Quick Safe Exit button that clears the session.
Good to know
Payments, SMS and WhatsApp run in sandbox mode on this server. No real money or messages leave the system. All testers share one dataset, so a record may already have moved on when you reach it; pick the next one rather than log a defect.
Test accounts by role
| Role | Who this is | Account | Lands on |
|---|---|---|---|
| Client | Jean Baptiste Munyaneza, has a land boundary dispute in Gasabo | jb.munyaneza@yopmail.com | /client |
| Advocate | Me. Amina Uwimana, Uwimana & Partners, family and employment law | a.uwimana@yopmail.com | /lawyer |
| Paralegal | Grace Mukeshimana, community paralegal acting for people who cannot use the app | g.mukeshimana@yopmail.com | /navigator |
| Oversight | Ministry of Justice oversight officer | minijust.oversight@yopmail.com | /government |
| Administrator | GetJustly platform team | justly.admin@yopmail.com | /admin |
What this guide covers
- Key ideas. Complaints, matters, consent and the money hold. Read this once.
- Five role chapters. A menu tour for each role, then walkthroughs with expected results.
- Test cases. Fourteen cases, GJ-01 to GJ-14, with Pass / Fail / Blocked and notes. Results save in your browser and export to a file.
- Reference. Statuses and money terms.
How to use it
Each role starts with a tour of its menu, then numbered walkthroughs. Every walkthrough ends with an Expected result: if the screen does not match it, log a defect. The Test cases section is the checklist to hand a tester. Mark each case Pass, Fail or Blocked, add what you saw, then press Export results in the sidebar to download the run.
GetJustly guide / Getting started
Key ideas before you start
Five ideas explain most of GetJustly.
Complaint, then matter
A client files a complaint (reference like JL-2026-1847). Once a lawyer accepts it, it becomes a matter they work. Statuses run Pending review, Lawyer assigned, In progress, Resolved.
Help before a lawyer
Not everyone needs or can afford a lawyer. /client/first-door asks what the problem is about and points to the right door; /client/legal-aid finds free help; the legal assistant answers general questions and hands hard ones to a person.
Consent is the key
A paralegal or trusted person sees someone's cases only while that person's consent stands. Consent records how it was given (signed form, thumbprint with witness, or spoken with witness) and can be taken back at any time.
Money is held, then released
Retainers and fixed-fee offers are paid up front and held by Justly. The client releases parts as the work is done; released money lands in the lawyer's wallet, which they withdraw to MTN, Airtel or a bank.
A person decides
When the AI is not sure, or someone says they are in danger, it stops and puts the case in a human queue: AI escalations and Crisis support for the platform team.
GetJustly guide / Client
Client: your workspace
Jean Baptiste Munyaneza has five complaints on file, four open. His main one is JL-2026-1847, a land boundary dispute in Gasabo handled by Jean Damascène Niyonzima. The client side is built for someone who may never have met a lawyer.
Your menu, screen by screen
| Menu item | Route | What you do there |
|---|---|---|
| Home | /client | Your matters, your lawyer, what is new. |
| Complaints | /client/complaints | All, Open, Resolved. New complaint. |
| Evidence / Seals | /client/evidence | Files on the case. Seals prove a file has not changed: Seal it, check a file. |
| Incident journal | /client/journal | Dated diary of pain, mood, costs and missed work. New entry. |
| Case readiness | /client/readiness | Score and the document checklist. |
| Hearings / Deadlines | /client/hearings | Court dates; your own dates and how long you have. Add a date. |
| Statements | /client/statements | New statement (sworn) and Sign a document. |
| The other side | /client/other-side | Ask the other party to answer. Send request. |
| Where to start / Free legal help | /client/first-door | Guided first step and legal aid referrals. |
| Letters | /client/letters | Fill a letter from a complaint, read it in Kinyarwanda, English or French. |
| Find a lawyer / Offers / Consultations | /client/find-lawyer | Lawyer directory, fixed-fee offers, Book a consultation. |
| Legal assistant / Health check / Learn | /client/legal-assistant | AI questions, a legal health check, short lessons. |
| Retainers / Billing | /client/retainers | Pay, release or refund held money; your plan. |
| Trusted people / Privacy | /client/trusted | Who can act for you; your consents and Download my data. |
GetJustly guide / Client · walkthrough 1
Follow my complaint
Find a complaint and read where it stands.
Steps
- Open /client/complaints. Header reads
5 complaints filed, 4 open. - Press Open4 to hide the resolved one.
- Open
JL-2026-1847, Land boundary dispute, Gasabo District, Lawyer assigned 15 Jan 2026. - Read the status, the lawyer and the latest activity.
Expected result
Four rows remain under Open. The complaint page shows the lawyer Jean Damascène Niyonzima and the activity history.
GetJustly guide / Client · walkthrough 2
Book a consultation
Book time with a lawyer and pay for it.
Steps
- Open /client/consultations and press Book a consultation.
- Choose a Lawyer (Amina Uwimana, Family, Employment), how you want to meet (In person USD 30, Video USD 30, Chat USD 20).
- Optionally pick a date and time, write one or two lines under What it is about (max 500).
- Press Book and pay and complete the sandbox payment.
Expected result
The booking appears under Upcoming (now 3). The lawyer sees it under /lawyer/consultations. If payment is still running, Check payment refreshes it.
GetJustly guide / Client · walkthrough 3
Keep a journal and a deadline
Record how the matter affects you and never miss a date.
Steps
- Open /client/journal. Tiles: average pain 5.1/10, mood 2.9/5, costs RWF 22,400, 24 work hours missed.
- Press New entry. Set Mood, Pain and How was the day; add a symptom, a cost and missed work. Press Save entry.
- Open /client/deadlines, press Add a date, describe it (
hearing at Gasabo), tick Remind me 7 and 1 days before, press Save date.
Expected result
The journal reads 10 entries and the tiles recompute. The new date shows under Coming up with your reminders.
GetJustly guide / Client · walkthrough 4
Sign a sworn statement and write a letter
Put your account on record and send a formal letter.
Steps
- Open /client/statements and press New statement.
- Write what happened: when, where, who was there. Fill Full name as on your ID. Optionally Add witness.
- Tick the declaration and press Sign statement.
- Open /client/letters, press Write a letter, choose the letter, pick
JL-2026-1847under Fill from a complaint, switch the language.
Expected result
The statement is listed under Sworn statements as signed, with the date. The letter fills with the complaint details and reads correctly in all three languages; Saved1 becomes Saved2 once you keep it.
GetJustly guide / Advocate
Advocate: your workspace
Me. Amina Uwimana runs Uwimana & Partners. She takes cases, runs firm intake, bills through retainers and fixed-fee offers, and is paid through her wallet.
Your menu, screen by screen
| Menu item | Route | What you do there |
|---|---|---|
| Home | /lawyer | Case docket, hearings, clients. |
| Cases | /lawyer/cases | All, Awaiting you, In progress, Resolved, Declined. Accept case / Decline. |
| Calendar / Consultations | /lawyer/calendar | Month, Week, List; consultations booked by clients. |
| Clients / Messages / WhatsApp | /lawyer/clients | Client book; inbox; WhatsApp chats matched to you, anonymous until the client agrees. |
| Readiness / Statements | /lawyer/readiness | Case readiness score and checklist; statements, Mark as filed. |
| Firm / Intake / Vault | /lawyer/firm | Firm profile and seats; enquiries to Assign or Open matter; document vault. |
| Workflows / AI copilot | /lawyer/workflows | Summarise, extract, draft, triage on a matter; research. |
| Analytics / Billing | /lawyer/analytics | Earnings, outcomes; plan, invoices, payout accounts. |
| Retainers / Offers / Wallet | /lawyer/retainers | Ask for money up front; publish set prices; withdraw. |
GetJustly guide / Advocate · walkthrough 1
Accept a new case
Answer a case waiting on you.
Steps
- Open /lawyer/cases and press Awaiting you1.
- Read
JL-2026-2089, Consumer product liability, defective electronics, Emmanuel Nsengimana. - Press Accept case. (Use Decline on a different case to test the other path.)
Expected result
The case moves to In progress, Awaiting you drops to 0, and the client sees the lawyer assigned on their complaint.
GetJustly guide / Advocate · walkthrough 2
Work firm intake
Turn an enquiry into a matter.
Steps
- Open /lawyer/intake. Header reads
3 enquiries waiting. - Read Claudine Mukeshimana's enquiry (Property, family house sold by an uncle).
- Pick a lawyer under Choose a lawyer and press Assign, or press Open matter.
Expected result
The enquiry leaves Open and appears under Opened (now 2). Close moves it to Closed instead.
GetJustly guide / Advocate · walkthrough 3
Ask for a retainer
Get the client to fund work up front.
Steps
- Open /lawyer/retainers and press Request a retainer.
- Choose the Client (Jean Baptiste Munyaneza), say what it is for (
court filing preparation). - Add line items with work, detail and an amount in RWF. Press Send request.
Expected result
The retainer appears under Open as awaiting payment. The client sees a Pay RWF … button under /client/retainers.
GetJustly guide / Advocate · walkthrough 4
Publish an offer and withdraw
Sell a fixed-fee service and get paid out.
Steps
- Open /lawyer/offers and press New offer.
- Fill title, Area (Land, Family, Work, Renting, Business, Money owed), who it is for, what is and is not covered.
- Add up to 4 parts the client releases, each with a price in RWF; set Turnaround between 1 and 180 days. Press Publish offer.
- Open /lawyer/wallet. Available
USD 1,040.00, HeldUSD 200.00. Press Withdraw, enter an amount, pick MTN Mobile Money and a number.
Expected result
The offer shows on /client/offers under its area. The withdrawal appears in Activity as pending and Available drops by the amount. A fifth release part is refused; turnaround 0 or 181 is refused.
GetJustly guide / Paralegal
Paralegal: your workspace
Grace Mukeshimana is a community paralegal. She acts for people who cannot use the app themselves, and only while their consent stands.
Your menu, screen by screen
| Menu item | Route | What you do there |
|---|---|---|
| Home | /navigator | Who needs you this week; coming up; recent activity. |
| People | /navigator/people | Everyone you act for (3). Add a person. |
| Activity log | /navigator/log | What you did: All, Consent, Filings, Visits. |
| Account | /navigator/account | Personal details, your record, close account. |
GetJustly guide / Paralegal · walkthrough 1
Add a person with consent
Start acting for someone.
Steps
- Open /navigator/people and press Add a person.
- Read the consent out in their language. Fill Their name, mobile if any, District, Sector, Language they speak.
- Pick How they gave consent: Signed form, Thumbprint (witness needed) or Said yes out loud (witness needed).
- Set the date and tick what they agreed to: file complaints in their name, follow their cases, speak with their lawyer. Save.
Expected result
People reads 4 people. The Activity log gains a Consent line. Choosing Thumbprint or Said yes out loud without a witness is refused.
GetJustly guide / Paralegal · walkthrough 2
Review my activity
See the record of what you did for people.
Steps
- Open /navigator/log.
- Switch between All7, Consent4, Filings2 and Visits1.
Expected result
Counts on the tabs add up to All. Each line names the person and the date.
GetJustly guide / Oversight
Oversight: your workspace
A Ministry of Justice officer. Sees platform-wide cases, investigations and escalations, where complaints pile up by district, and produces reports. Can flag, escalate and reassign; changes are logged against their name.
Your menu, screen by screen
| Menu item | Route | What you do there |
|---|---|---|
| Home | /government | Recent cases, compliance, escalations due, platform health. |
| Cases / Investigations / Escalations | /government/cases | Dockets. Opening a case shows Overview, Documents, Notes, Activity. |
| Heat map | /government/heatmap | Complaints by district and kind; hotspots; Escalate overdue. |
| Audit log / Compliance | /government/audit | Export Logs, Export Report. |
| Reports | /government/reports | Generate Report, Download. |
| Notifications / Settings | /government/settings | Alerts and preferences. |
GetJustly guide / Oversight · walkthrough 1
Review and reassign a case
Change a case's status and owner.
Steps
- Open /government/cases and open the first case:
JL-2026-1847, Land boundary dispute, Under review, High priority, assigned to Inspector Jean Habimana. - Read Case details and Related cases (
JL-2026-1890, Tenant eviction without due process). - Under Status pick
Flagged. Under Reassign pick Director Claudine Uwase and press Assign.
Expected result
The status and officer change on screen, and Activity gains a line under your name. Note under the status: Changes are logged against your name.
GetJustly guide / Oversight · walkthrough 2
Find the hotspots
See where complaints are overdue.
Steps
- Open /government/heatmap and press Overdue.
- Read Hotspots: 1 Labour in Gasabo 23 overdue, 2 Land in Nyagatare 12, 3 Consumer in Nyarugenge 10.
- Press Escalate overdue (23) on the top hotspot.
Expected result
The overdue complaints move into /government/escalations.
GetJustly guide / Oversight · walkthrough 3
Generate a report
Produce the monthly case status report.
Steps
- Open /government/reports and press Generate Report.
- Press Download.
Expected result
A banner reads Case status report, monthly is ready to download. Tiles show 8 cases monitored, 38% flagged or escalated, 27d average age.
GetJustly guide / Administrator
Administrator: your workspace
The GetJustly platform team: assigns lawyers, approves the bar roll, checks identities, watches payouts, answers crisis alerts and AI escalations.
Your menu, screen by screen
| Menu item | Route | What you do there |
|---|---|---|
| Home | /admin | Latest cases, KYC queue, lawyer bench. |
| Complaints / AI escalations / Assign lawyer | /admin/escalations | Intakes the AI would not answer alone; match complaints with lawyers. |
| Payouts | /admin/payouts | Wallet ledger: Needs a look, All. Check with provider. |
| WhatsApp / Crisis / Feedback | /admin/crisis | Lawyer chats; people who may be in danger; user feedback. |
| Users / Lawyers / Clients / KYC / Firms | /admin/users | Directory, bar roll, identity checks, firms. Suspend, Change role, Approve. |
| Courts / Roles / Permissions / Consents | /admin/courts | Court directory, roles and access, consent records. |
| Audit / System / Ops | /admin/audit | Audit log, service status, CI and email queue. |
| Translations / Deadline rules / Settings | /admin/translations | Review translations; legal time limits; platform settings. |
GetJustly guide / Administrator · walkthrough 1
Answer a crisis alert
Make sure someone in danger is picked up.
Steps
- Open /admin/crisis. Header:
2 alerts waiting for someone to pick up. - Read
CRI-0030, Threat to life, Kenya, detected 47 min ago, confidence 88%, on-call alerted. - Press I'm on it.
Expected result
The alert shows Acknowledged with your name, Waiting drops to 1 and Picked up rises by one.
GetJustly guide / Administrator · walkthrough 2
Take an AI escalation and assign a lawyer
Route intakes the AI stopped on.
Steps
- Open /admin/escalations:
3 intakes the AI would not answer alone. - Open
GJ-AI-02201, Jean Baptiste Munyaneza, Gasabo, 52% sure. Read what the client told the AI and why it stopped. Claim it. - Open /admin/assign-lawyer and press Pending (3). Press Approve on Olivier Bizimana (Labour law, Contracts).
- Back on Available, match a pending complaint to a lawyer.
Expected result
The escalation moves to Claimed. Olivier Bizimana leaves Pending and shows under Available (6). The matched complaint shows the lawyer assigned for the client.
GetJustly guide / Administrator · walkthrough 3
Verify an identity
Clear the KYC queue.
Steps
- Open /admin/kyc:
3 submissions waiting for review. - Open Jean Baptiste Munyaneza, National id, submitted 4 Oct 2026. Compare the document with the profile.
- Verify it, or reject with a reason.
Expected result
Waiting drops to 2 and the submission appears under Verified (or Rejected).
GetJustly guide / Administrator · walkthrough 4
Chase a payout and suspend a user
Handle a stuck payment and a bad account.
Steps
- Open /admin/payouts, press Needs a look. Find Eric Mugabo's top up
GJ-TOP-7K2Q9D, +USD 50.00, Pending. Press Check with provider. - Open /admin/users, find a user and press Suspend. Read:
They are signed out and cannot sign in until you lift it. - Write a reason and press Suspend. Use a test account, not one other testers rely on.
Expected result
The payout status refreshes from the provider. The user moves to Suspended, the audit log records the reason, and they cannot sign in.
GetJustly guide / Test case
Case GJ-01: All five seats sign in
Front door for every tester.
Steps
- Open /auth/personas.
- Enter each seat in turn, note where it lands, sign out.
Pass if
Client → /client, Advocate → /lawyer, Paralegal → /navigator, Oversight → /government, Administrator → /admin. No error pages.
Your result
GetJustly guide / Test case
Case GJ-02: Client cannot open the admin area
Access control.
Steps
- Sign in as Client.
- Type /admin in the address bar.
Pass if
You are kept out of the admin area (redirect or access message). No admin data shows.
Your result
GetJustly guide / Test case
Case GJ-03: Emergency page and Quick Safe Exit
Safety feature for people at risk.
Steps
- Signed in as Client, open /emergency.
- Read the helplines, then press Quick Safe Exit (Scrub Session).
Pass if
Helplines list Police, GBV and Child Abuse, RIB and Isange One Stop Centre. Safe Exit leaves the app and the session is gone (going back does not restore it).
Your result
GetJustly guide / Test case
Case GJ-04: Client files a complaint
Core intake.
Steps
- Open /client/complaints, press New complaint, complete it and submit.
Pass if
All goes from 5 to 6 and the new complaint is listed with a JL- reference and status Pending review.
Your result
GetJustly guide / Test case
Case GJ-05: Client books a paid consultation
Money path.
Steps
- Open /client/consultations, Book a consultation with Amina Uwimana by Video, pay in the sandbox.
Pass if
Upcoming rises by one with the USD 30 price. Signed in as Advocate, the booking shows on /lawyer/consultations.
Your result
GetJustly guide / Test case
Case GJ-06: Journal entry updates the averages
Evidence for the lawyer.
Steps
- Open /client/journal, add an entry with Pain 10 and a cost of RWF 1,000.
Pass if
Entries become 10, average pain rises above 5.1 and costs recorded become RWF 23,400.
Your result
GetJustly guide / Test case
Case GJ-07: Sworn statement needs the declaration
Legal validity.
Steps
- Open /client/statements, New statement, write text and name but do not tick the declaration; try Sign statement.
- Tick it and sign.
Pass if
Unticked, signing is blocked. Ticked, the statement is listed as signed.
Your result
GetJustly guide / Test case
Case GJ-08: Lawyer accepts a case
Client gets a lawyer.
Steps
- Open /lawyer/cases, Awaiting you1, Accept case on the first case.
Pass if
Case shows In progress; Awaiting you is 0.
Your result
GetJustly guide / Test case
Case GJ-09: Retainer request reaches the client
Money path end to end.
Steps
- As Advocate, request a retainer of RWF 50,000 from Jean Baptiste Munyaneza.
- Sign in as Client and open /client/retainers.
Pass if
The client sees the retainer awaiting payment with a Pay RWF 50,000 button.
Your result
GetJustly guide / Test case
Case GJ-10: Offer limits are enforced
Validation.
Steps
- Open /lawyer/offers, New offer, try to add a fifth part, and set turnaround to 181.
Pass if
No fifth part can be added; 181 days is refused with Between 1 and 180.
Your result
GetJustly guide / Test case
Case GJ-11: Withdrawal cannot exceed available
Money integrity.
Steps
- Open /lawyer/wallet, Withdraw, enter USD 5,000.
Pass if
Refused: the field reads Up to 1040.00. A valid amount goes through and shows as pending in Activity.
Your result
GetJustly guide / Test case
Case GJ-12: Paralegal consent needs a witness
Consent integrity.
Steps
- Open /navigator/people, Add a person, choose Thumbprint and save without a witness.
- Add a witness and save.
Pass if
Without a witness it is refused; with one, the person is added and the log gains a Consent line.
Your result
GetJustly guide / Test case
Case GJ-13: Oversight status change is logged
Accountability.
Steps
- Open a case from /government/cases, set status
Flagged, then open Activity.
Pass if
Activity shows the change with your name and time.
Your result
GetJustly guide / Test case
Case GJ-14: Admin picks up a crisis alert
Life-safety queue.
Steps
- Open /admin/crisis, press I'm on it on a waiting alert.
Pass if
Waiting drops by one and the alert shows who picked it up.
Your result
GetJustly guide / Reference
Statuses you will see
Common status words across the app.
| Where | Statuses | Meaning |
|---|---|---|
| Complaint | Pending review, Lawyer assigned, In progress, Resolved | From filing to closing. |
| Lawyer case | Awaiting your answer, In progress, Resolved, Declined | The lawyer's view of the same matter. |
| Oversight case | Under review, Flagged, Escalated, Cleared, Closed | Ministry handling; every change logged. |
| Retainer | Awaiting payment, Funded, Released, Refunded | Money held for work. |
| Payout | Pending, Completed, Failed | Wallet top ups and withdrawals. |
| KYC | Waiting for review, Verified, Rejected | Identity checks. |
| Crisis alert | Waiting, On-call alerted, Escalated, Acknowledged | Life-safety queue. |
GetJustly guide / Reference
Money terms
How money moves in GetJustly.
Held
Paid by the client and kept by Justly until released.
Release
The client lets a part of the held money go to the lawyer when the work is done.
Available
In the lawyer's wallet and can be withdrawn now.
Withdraw
Send available money to MTN Mobile Money, Airtel Money or a bank account.
Refund / Report a problem
The client can ask for unreleased money back or raise a problem on a retainer.