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
Student: find and inspect a lodge
Core feature · mobile + webA 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
| ID | Screen | States specific to it |
|---|---|---|
| S-01 | Welcome | First launch only |
| S-02 | Select institution (search list) | No match; campus not covered; slow network |
| S-03 | Choose campus area; change campus later | Institution with one campus |
| S-04 | Request my campus | Already requested |
| S-05 | Student home: campus in header, search, room-type shortcuts, featured verified lodges, marketplace highlights | No featured lodges yet |
| S-06 | Search and filters sheet: price, distance, room type, facilities | Filters that return 0 |
| S-07 | Results list | No results; stale listings hidden |
| S-08 | Map view with distance to campus | Location off; pins clustered |
| S-09 | Listing detail: gallery, rent and fees, facilities, freshness, agent card | One photo; no video; removed listing; agent suspended |
| S-10 | Cost breakdown Part B | Refundable vs non-refundable caution fee |
| S-11 | Compare listings Part B | Only 1 saved |
| S-12 | Saved lodges | Empty; saved listing no longer available; offline copy |
| S-13 | Chat with agent | Bank-number warning Part B; agent slow to reply |
| S-14 | Request inspection: pick date and time | No slots; agent must confirm |
| S-15 | Inspection confirmation with safety notice | Pending agent confirmation; rescheduled by agent |
| S-16 | Upcoming inspections | Empty; cancelled |
| S-17 | Report a listing: reason, details, confirmation | Already reported |
| S-18 | My reports and their status | Under review; resolved; no action taken |
| S-19 | Pay in LodgePlug, then confirm move-in Part B | Held; disputed; released |
| S-20 | Write a verified review Part B | Not eligible yet |
Agent: get verified and manage leads
Mobile + web dashboardAn 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
| ID | Screen | States specific to it |
|---|---|---|
| A-01 | Agent sign-up | Already has a student account (role switch) |
| A-02 | Verification overview: 4 steps with progress | Partly done; step sent back |
| A-03 | Step 1: identity (ID document and selfie) | Blurry photo; ID expired |
| A-04 | Step 2: contact (phone and email codes) | Code expired |
| A-05 | Step 3: business or agency details | Independent agent, no agency |
| A-06 | Step 4: property ownership or authorisation | Several properties; document unreadable |
| A-07 | Review and submit, with consent | Missing step |
| A-08 | Verification status: submitted, under review, approved, rejected with reason | All four |
| A-09 | Public agent profile: badge, last checked, listing portfolio | Under review; re-check due; suspended |
| A-10 | Agent dashboard: listings, new leads, upcoming inspections, subscription | New agent, all empty; subscription lapsed |
| A-11 | Add or edit listing (photos, video, rent, fees, facilities) | Draft; upload failed; awaiting admin review |
| A-12 | My listings: mark unavailable, confirm availability, remove | Stale (needs confirming); removed by admin |
| A-13 | Leads list | Empty; unread |
| A-14 | Lead detail and chat | Student cancelled |
| A-15 | Inspection request: accept or reschedule | Clash with another booking |
| A-16 | Subscription plans and renewal | Renewal reminder; expired; bought on web only Part B |
| A-17 | Suspended: reason and how to appeal | Appeal submitted |
Marketplace buyer: get what you need to settle in
Students · mobile + webA 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
| ID | Screen | States specific to it |
|---|---|---|
| B-01 | Marketplace home: categories, deals, move-in bundles bundles: Part B | Few vendors on this campus |
| B-02 | Category and search results with price sort | No results |
| B-03 | Product detail | Out of stock; second-hand condition; service, not a product |
| B-04 | Seller shop profile | New seller, no reviews; student seller |
| B-05 | Chat with seller | Bank-number warning Part B |
| B-06 | Cart | Empty; items from several sellers; price changed |
| B-07 | Checkout: delivery or pickup, address on campus | Seller doesn't deliver to this area |
| B-08 | Payment and receipt | Payment failed; pending bank confirmation |
| B-09 | Order tracking | Processing; dispatched; delayed; cancelled by seller |
| B-10 | Confirm delivery or open a dispute Part B | Dispute open; resolved |
| B-11 | Order history | Empty |
Marketplace seller: run a campus shop
Vendors · mobile + web dashboardA 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
| ID | Screen | States specific to it |
|---|---|---|
| V-01 | Seller sign-up: vendor or student seller student: Part B | Student hits the lower limit |
| V-02 | Shop details and campuses served | Campus not covered |
| V-03 | Identity and payout account | Account name doesn't match ID |
| V-04 | Shop review status | Under review; rejected with reason |
| V-05 | Shop dashboard: new orders, sales, low stock | New shop, all empty; suspended |
| V-06 | Add or edit product (photos, price, stock, condition) | Draft; removed by admin |
| V-07 | Orders to fulfil | Empty; overdue |
| V-08 | Order detail: accept, decline, dispatch | Buyer cancelled; dispute open |
| V-09 | Earnings and withdrawals | Held vs available; withdrawal failed |
| V-10 | Shop profile (public and edit) | Long shop name; no logo |
Admin: keep the platform safe
LodgePlug staff · desktop webStaff 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
| ID | Screen | States specific to it |
|---|---|---|
| D-01 | Overview: users, enquiries, inspections, listings, orders, revenue, by campus | New campus with no data |
| D-02 | Agent applications queue | Empty; overdue past target time |
| D-03 | Application detail: each check, its evidence, approve or reject with reason | Evidence unreadable; duplicate ID found |
| D-04 | Listing review queue and detail | Photos reused from another listing |
| D-05 | Vendor review queue and detail | Student seller over limit |
| D-06 | Reports and complaints queue | Urgent (money involved); several reports on one agent |
| D-07 | Report detail with actions: warn, suspend, remove | Appeal received |
| D-08 | Subscriptions and renewals | Expiring this week |
| D-09 | Marketplace activity and disputes | Dispute past deadline |
| D-10 | User management | One person, several roles |
| D-11 | Campus management: add campus, areas, coverage requests | Requested by many students |