HELP • RAPIDHOSTELS OS
How to use every module
Click ? Help in any dashboard header → Tour (3-step spotlight) or Docs (this page). Clean, no video.
Visitors / Gate Log
Log every visitor at gate — entry + exit with purpose.
/admin/visitors, /manager/visitors, /tenant/visitors
Manager: Visitors → + Log visitor → select Tenant & Property → Entry time auto → Save (IN)
Visitor leaves → card → Exit → set exitTime → OUT
Tenant: /tenant/visitors → view own logs (read-only)
Leaves / Night-out
Tenant requests night-out or leave (from→to, reason); manager approves.
/tenant/leaves, /manager/leaves, /admin/leaves
Tenant: Leaves → + New Request → NIGHT_OUT/LEAVE + dates + reason → Submit (PENDING)
Manager/Admin: Leaves → card → Approve / Reject (reason)
Tenant can Cancel own PENDING
Handovers — Check-in Kit
Handover checklist per stay: KEYS/BEDDING/LOCKER/CHARGER + photos, HANDED → RETURNED.
/manager/handovers, /admin/handovers
Stays → active stay → Create Handover → stay search → tick items (isProvided/condition) + photos → Handed
View by tenant/property/stay → Mark Returned on checkout
Housekeeping
Recurring cleaning/maintenance tasks DAILY/WEEKLY/MONTHLY/ON_DEMAND.
/manager/housekeeping, /tenant/housekeeping
Manager: Housekeeping → + Create → property→building→floor→room cascade → title/type/frequency/dueDate/assignedTo
Actions: Complete / Cancel / Delete; Tenant: view own property tasks read-only
KYC & Expiry Alerts
Verify tenant ID proof; banner alerts for expiring docs (30d).
/admin/tenants/[id], dashboard banner
Tenants → tenant detail → KYC card → Verify (VERIFIED) / Reject (reason)
Dashboard shows KycExpiryBanner (expiring/expired) → click → Documents
Docs: ID_PROOF cards show Expiring soon / Expired badges
Meals / Mess
Tenant opts in per date+meal (BREAKFAST/LUNCH/DINNER), menu + extraCharge tracked.
/tenant/meals, /manager/meals
Tenant: Meals → pick date → BREAKFAST/LUNCH/DINNER cards → Opt-in/out → menu shown
Manager: Meals → property/date/type filters → edit menu/extraCharge, summary opted/total
Leads Inbox
Marketing /contact submissions → lead pipeline NEW→CONTACTED→CONVERTED/CLOSED.
/contact, /admin/leads
Public: /contact → name/contact/message → creates Lead (NEW)
Admin/Owner: Leads → search/status pills → Contacted/Convert/Close actions + notes
Expenses
Property-wise spend (MAINTENANCE/UTILITY/STAFF/SUPPLIES) with receipt, approve flow.
/owner/expenses, /admin/expenses
Expenses → + Create → property/title/category/amount/date/description → PENDING
Manager/Admin: Approve / Reject → summary
Staff Directory
WARDEN/CLEANER/MAINTENANCE/SECURITY per property, isActive, salary.
/owner/staff, /admin/staff
Staff → + Add → name/mobile/role/property/salary → Create
Deactivate / Delete, filter by role/property/active
Feedback / NPS
Tenant rates 1-5 (CLEANLINESS/FOOD/SERVICE) → manager responses.
/tenant (feedback) /manager/feedback
Tenant: Feedback → rating + category + comment → Submit (NEW)
Manager: Feedback → filter NEW/REVIEWED/ACTIONED → Respond + status → stars shown
Settlements (Checkout)
Final settlement on stay checkout — deposit vs deductions → refund/due.
/admin/settlements, /manager/settlements
Stays → Settle → POST /stays/:id/settle creates FinalSettlement
Settlements → property/status filter → view breakdown → share/print
Documents Upload
Tenant uploads ID/agreement locally (Cloudinary) or URL; manager sees in tenant profile.
/tenant/documents, /tenants/[id]
Tenant: Documents → Upload → file (PDF/JPG/PNG up to 5MB) OR paste URL → title/type/issueDate → Upload
Admin: Tenants → tenant detail → Uploaded Documents grid → View/Download
Tenant Requests
Self-registration at /register (ID proof not required) → admin approves creates User+Tenant.
/register, /admin/requests
Public: /register → common details → Submit → pending
Admin: Requests (PENDING) → View → Accept→Onboard (creates login) / Reject (reason)
ID Card
Tenant detail → ID Card button → modal with QR grid + tenant code.
/admin/tenants/[id]
Tenants → [id] → ID Card → printable (name, property, QR placeholder, code)
Password Reset
Forgot password flow for all roles.
/forgot-password, /reset-password, /login
Login → Forgot password? → email → dev token link → /reset-password?token= → new password → Login
Need more?
Every dashboard has Tour (blue ? button) → 5-7 steps, keyboard arrows, Esc to skip. Help → this page is searchable and linkable: /help#visitors.