← LodgePlug hub

LodgePlug User Flows
LodgePlug logo

LodgePlug user flows

Phase 0 · Deliverable 1 of the Project Description v2.0 · 26 Oct 2026

Each portal has one flow: the path a person takes from opening the app to finishing the job they came to do. Under each flow is the list of screens it needs. That list becomes the checklist for the wireframes in Phase 1.

Screen IDs (S-01, A-04 and so on) are fixed from here on, so we can name a screen in feedback without describing it.

Every screen also needs its states: empty, loading, error, offline, success, plus pending or restricted where they apply. The "States" column lists only the ones specific to that screen.

Legend

A screen or step
A decision or branch
Trust moment: a safety warning, badge check or protected payment
From Part B: optional until the LodgePlug team approves it
Job done

Student: find and inspect a lodge

Core feature · mobile + web

A fresher picks their campus, finds a lodge they can afford, checks that the agent is verified, and books an inspection without paying anything first.

flowchart TD
  A([Open app]) --> B[Welcome]
  B --> C[Select institution]
  C --> D{Campus covered?}
  D -- No --> E[Request my campus]
  E --> E2([We'll notify you])
  D -- Yes --> F[Choose campus area]
  F --> G[Student home]
  G --> H[Search and filters]
  G --> SV[Saved lodges]
  H --> I{List or map?}
  I -- List --> J[Results list]
  I -- Map --> K[Map with distance to campus]
  J --> L[Listing detail]
  K --> L
  SV --> L
  L --> M[Agent badge and profile]
  L --> CB[Cost breakdown]
  L --> CMP[Compare up to 3]
  L --> R[Report listing]
  R --> R2([Report status])
  L --> N[Chat with agent]
  N --> NW[Bank-details warning]
  L --> O[Request inspection: date and time]
  O --> P[Before-inspection safety notice]
  P --> Q[Inspection booked: agent number revealed]
  Q --> S[Upcoming inspections]
  S --> T{Took the room?}
  T -- No --> H
  T -- Yes --> U[Pay in LodgePlug, money held]
  U --> V[Confirm move-in, money released]
  V --> W[Leave a verified review]
  W --> X([Moved in])
  classDef trust fill:#ffe431,stroke:#033a1d,color:#033a1d
  classDef opt stroke-dasharray:5 4
  classDef done fill:#033a1d,stroke:#033a1d,color:#ffffff
  class M,NW,P,U trust
  class CB,CMP,NW,U,V,W opt
  class X,E2,R2 done
  
IDScreenStates specific to it
S-01WelcomeFirst launch only
S-02Select institution (search list)No match; campus not covered; slow network
S-03Choose campus area; change campus laterInstitution with one campus
S-04Request my campusAlready requested
S-05Student home: campus in header, search, room-type shortcuts, featured verified lodges, marketplace highlightsNo featured lodges yet
S-06Search and filters sheet: price, distance, room type, facilitiesFilters that return 0
S-07Results listNo results; stale listings hidden
S-08Map view with distance to campusLocation off; pins clustered
S-09Listing detail: gallery, rent and fees, facilities, freshness, agent cardOne photo; no video; removed listing; agent suspended
S-10Cost breakdown Part BRefundable vs non-refundable caution fee
S-11Compare listings Part BOnly 1 saved
S-12Saved lodgesEmpty; saved listing no longer available; offline copy
S-13Chat with agentBank-number warning Part B; agent slow to reply
S-14Request inspection: pick date and timeNo slots; agent must confirm
S-15Inspection confirmation with safety noticePending agent confirmation; rescheduled by agent
S-16Upcoming inspectionsEmpty; cancelled
S-17Report a listing: reason, details, confirmationAlready reported
S-18My reports and their statusUnder review; resolved; no action taken
S-19Pay in LodgePlug, then confirm move-in Part BHeld; disputed; released
S-20Write a verified review Part BNot eligible yet

Agent: get verified and manage leads

Mobile + web dashboard

An agent registers, passes verification step by step, lists properties, and turns student enquiries into inspections. Verification is checked again over time, so the flow loops.

flowchart TD
  A([Sign up as agent]) --> B[Verification overview with progress]
  B --> C[Step 1: Identity]
  C --> D[Step 2: Contact]
  D --> E[Step 3: Business or agency details]
  E --> F[Step 4: Property authorisation]
  F --> G[Review and submit]
  B -. save and continue later .-> B
  G --> H[Submitted]
  H --> I[Under review]
  I --> J{Decision}
  J -- Rejected --> K[Rejected with reason]
  K --> B
  J -- Approved --> L[Verified badge awarded]
  L --> M[Agent dashboard]
  M --> N[Add or edit listing]
  N --> N2[Mark unavailable or remove]
  M --> O[Leads list]
  O --> P[Lead detail and chat]
  P --> Q{Inspection request}
  Q -- Accept --> R[Inspection booked]
  Q -- Reschedule --> R
  R --> R2([Inspection done])
  M --> S[Subscription status]
  S --> T[Renew on web]
  M --> U{Re-check due?}
  U -- Yes --> V[Re-verification due]
  V --> B
  U -- Failed or reported --> W[Suspended: reason and appeal]
  classDef trust fill:#ffe431,stroke:#033a1d,color:#033a1d
  classDef opt stroke-dasharray:5 4
  classDef done fill:#033a1d,stroke:#033a1d,color:#ffffff
  class L,V,W trust
  class T opt
  class R2 done
  
IDScreenStates specific to it
A-01Agent sign-upAlready has a student account (role switch)
A-02Verification overview: 4 steps with progressPartly done; step sent back
A-03Step 1: identity (ID document and selfie)Blurry photo; ID expired
A-04Step 2: contact (phone and email codes)Code expired
A-05Step 3: business or agency detailsIndependent agent, no agency
A-06Step 4: property ownership or authorisationSeveral properties; document unreadable
A-07Review and submit, with consentMissing step
A-08Verification status: submitted, under review, approved, rejected with reasonAll four
A-09Public agent profile: badge, last checked, listing portfolioUnder review; re-check due; suspended
A-10Agent dashboard: listings, new leads, upcoming inspections, subscriptionNew agent, all empty; subscription lapsed
A-11Add or edit listing (photos, video, rent, fees, facilities)Draft; upload failed; awaiting admin review
A-12My listings: mark unavailable, confirm availability, removeStale (needs confirming); removed by admin
A-13Leads listEmpty; unread
A-14Lead detail and chatStudent cancelled
A-15Inspection request: accept or rescheduleClash with another booking
A-16Subscription plans and renewalRenewal reminder; expired; bought on web only Part B
A-17Suspended: reason and how to appealAppeal submitted

Marketplace buyer: get what you need to settle in

Students · mobile + web

A student browses items from vendors serving their campus, compares prices, asks the seller a question, then orders and pays inside the app.

flowchart TD
  A([Marketplace tab]) --> B[Marketplace home: categories and move-in bundles]
  B --> C[Category or search results]
  C --> D[Product detail]
  D --> E[Seller shop profile]
  D --> F[Chat with seller]
  F --> FW[Bank-details warning]
  D --> G[Add to cart]
  G --> H[Cart]
  H --> I[Checkout: delivery or pickup]
  I --> J[Pay in LodgePlug, money held]
  J --> K[Order tracking]
  K --> L{Received as described?}
  L -- Yes --> M[Confirm delivery, money released]
  M --> N[Verified purchase review]
  N --> O([Done])
  L -- No --> P[Open a dispute]
  D --> R[Report product or seller]
  B --> Q[Order history]
  classDef trust fill:#ffe431,stroke:#033a1d,color:#033a1d
  classDef opt stroke-dasharray:5 4
  classDef done fill:#033a1d,stroke:#033a1d,color:#ffffff
  class FW,J,P trust
  class FW,M,N,P opt
  class O done
  
IDScreenStates specific to it
B-01Marketplace home: categories, deals, move-in bundles bundles: Part BFew vendors on this campus
B-02Category and search results with price sortNo results
B-03Product detailOut of stock; second-hand condition; service, not a product
B-04Seller shop profileNew seller, no reviews; student seller
B-05Chat with sellerBank-number warning Part B
B-06CartEmpty; items from several sellers; price changed
B-07Checkout: delivery or pickup, address on campusSeller doesn't deliver to this area
B-08Payment and receiptPayment failed; pending bank confirmation
B-09Order trackingProcessing; dispatched; delayed; cancelled by seller
B-10Confirm delivery or open a dispute Part BDispute open; resolved
B-11Order historyEmpty

Marketplace seller: run a campus shop

Vendors · mobile + web dashboard

A vendor, or a student reselling used items, sets up a shop, lists products, fulfils orders and withdraws earnings.

flowchart TD
  A([Sign up as seller]) --> B{Vendor or student seller?}
  B -- Vendor --> C[Shop details and campuses served]
  B -- Student --> C2[Lighter sign-up, lower limits]
  C --> D[Identity and payout account]
  C2 --> D
  D --> E[Shop under review]
  E --> F{Approved?}
  F -- No --> G[Rejected with reason]
  G --> C
  F -- Yes --> H[Shop dashboard]
  H --> I[Add or edit product]
  H --> J[Orders to fulfil]
  J --> K[Order detail: accept or decline]
  K --> L[Mark dispatched or ready for pickup]
  L --> M{Buyer confirms?}
  M -- Yes --> N[Money released to earnings]
  M -- Dispute --> P[Respond to dispute]
  N --> O[Withdraw to bank]
  O --> Q([Paid out])
  H --> R[Shop profile]
  classDef trust fill:#ffe431,stroke:#033a1d,color:#033a1d
  classDef opt stroke-dasharray:5 4
  classDef done fill:#033a1d,stroke:#033a1d,color:#ffffff
  class E,P trust
  class C2,P opt
  class Q done
  
IDScreenStates specific to it
V-01Seller sign-up: vendor or student seller student: Part BStudent hits the lower limit
V-02Shop details and campuses servedCampus not covered
V-03Identity and payout accountAccount name doesn't match ID
V-04Shop review statusUnder review; rejected with reason
V-05Shop dashboard: new orders, sales, low stockNew shop, all empty; suspended
V-06Add or edit product (photos, price, stock, condition)Draft; removed by admin
V-07Orders to fulfilEmpty; overdue
V-08Order detail: accept, decline, dispatchBuyer cancelled; dispute open
V-09Earnings and withdrawalsHeld vs available; withdrawal failed
V-10Shop profile (public and edit)Long shop name; no logo

Admin: keep the platform safe

LodgePlug staff · desktop web

Staff verify agents against evidence, review listings and vendors, act on reports, and watch how each campus is performing.

flowchart TD
  A([Sign in]) --> B[Overview by campus]
  B --> C[Agent applications queue]
  C --> D[Application detail: each check and its evidence]
  D --> E{Decision}
  E -- Approve --> F[Badge awarded, agent notified]
  E -- Reject --> G[Reason sent to agent]
  E -- Need more --> G2[Request more evidence]
  B --> H[Listing review queue]
  B --> I[Vendor review queue]
  H --> H2{OK?}
  H2 -- Yes --> H3[Publish]
  H2 -- No --> H4[Reject with reason]
  B --> J[Reports and complaints queue]
  J --> K[Report detail]
  K --> L{Action}
  L --> L1[Warn]
  L --> L2[Suspend]
  L --> L3[Remove listing or product]
  L --> L4[No action]
  L1 --> M([Reporter told the outcome])
  L2 --> M
  L3 --> M
  L4 --> M
  B --> N[Subscriptions and renewals]
  B --> O[Marketplace activity and disputes]
  B --> P[Users and campuses]
  classDef trust fill:#ffe431,stroke:#033a1d,color:#033a1d
  classDef opt stroke-dasharray:5 4
  classDef done fill:#033a1d,stroke:#033a1d,color:#ffffff
  class D,K trust
  class M,F done
  
IDScreenStates specific to it
D-01Overview: users, enquiries, inspections, listings, orders, revenue, by campusNew campus with no data
D-02Agent applications queueEmpty; overdue past target time
D-03Application detail: each check, its evidence, approve or reject with reasonEvidence unreadable; duplicate ID found
D-04Listing review queue and detailPhotos reused from another listing
D-05Vendor review queue and detailStudent seller over limit
D-06Reports and complaints queueUrgent (money involved); several reports on one agent
D-07Report detail with actions: warn, suspend, removeAppeal received
D-08Subscriptions and renewalsExpiring this week
D-09Marketplace activity and disputesDispute past deadline
D-10User managementOne person, several roles
D-11Campus management: add campus, areas, coverage requestsRequested by many students

Account and shared screens

Every portal

Sign-in, role switching and the privacy screens that the app stores and Nigerian data law require.

flowchart TD
  A([Sign in or sign up]) --> B[Phone or email code]
  B --> C[Profile]
  C --> D[Role switcher: student, agent, seller]
  D --> D2[Mode banner shows current role]
  C --> E[Notifications]
  C --> F[Settings: data saver, language]
  C --> G[Privacy centre]
  G --> G1[Download my data]
  G --> G2[Delete account]
  G2 --> G3[Confirm and reason]
  G3 --> G4([Account deleted])
  C --> H[Help and safety tips]
  classDef trust fill:#ffe431,stroke:#033a1d,color:#033a1d
  classDef opt stroke-dasharray:5 4
  classDef done fill:#033a1d,stroke:#033a1d,color:#ffffff
  class D,D2,F,G,G1 opt
  class G4 done
  
IDScreenStates specific to it
X-01Sign in and sign up (phone or email, one-time code)Code expired; too many attempts
X-02ProfileNo photo; long name
X-03Role switcher and mode banner Part BRole not verified yet
X-04NotificationsEmpty
X-05Settings, including data saver Part BOffline
X-06Privacy centre: consent, download my data Part BDownload preparing
X-07Delete account in app, plus a web page for itOpen orders or held money block deletion
X-08Help and safety tips

Totals: 77 screens across 6 areas: 20 student, 17 agent, 11 buyer, 10 seller, 11 admin, 8 shared. 13 of them include Part B items that the LodgePlug team still needs to approve. Layouts will leave room for those either way.