Buyootna QA Docs
User stories and test scenarios for QA engineers testing the Buyootna platform — the mobile app, every web portal, and the API. Each story is grounded in features that actually exist in the codebase today, including known stubs and placeholders that should be tracked as gaps rather than re-filed as new bugs.
10 sections · 65 user stories
Mobile — Shared
Cross-role mobile features (apps/mobile) that apply regardless of which identity is active — guest gating, chat, search, listings, identity switching, payments, layout, and the App Store demo account. Includes the confirmed reason Company/Office roles are currently unreachable.
9 user stories
Mobile — Individual
The (individual) route group and (auth) individual-auth/forgot-password screens — the only account type currently reachable in the mobile app (Company/Office are gated, see Mobile — Shared). Covers login, signup, Google/Apple sign-in, OTP, password recovery, the identity switcher, and favorites.
16 user stories
Mobile — Company
The (company) route group (company-home, company-more, company-chats, company-requests). IMPORTANT: this entire route group is currently gated behind ComingSoonGate — see mobile-company-office-gate in Mobile — Shared. None of the stories below are reachable by real users right now; they're a readiness checklist for when COMPANY_OFFICE_LOCKED flips off, grounded in what's actually built in the code today.
5 user stories
Mobile — Office
The (office) route group (office-home, office-more, office-chats, office-properties). IMPORTANT: this entire route group is currently gated behind ComingSoonGate — see mobile-company-office-gate in Mobile — Shared. None of the stories below are reachable by real users right now; they're a readiness checklist for when COMPANY_OFFICE_LOCKED flips off, grounded in what's actually built in the code today.
5 user stories
Web Admin
Next.js system administrator dashboard (apps/web/admin, port 3005). Covers the dashboard, user management, Plans & Pricing, Subscriptions & Billing, and several intentionally-unbuilt placeholder sections (Notifications, Content, Roles, Settings, Logs).
9 user stories
Web Companies
Next.js corporate portal (apps/web/companies, port 3002). Currently an auth-only shell: a splash page plus login/signup/forgot-password, all reusing the shared @buyootna/ui forms. No company dashboard exists yet.
4 user stories
Web Offices
Next.js real-estate office/agency portal (apps/web/offices, port 3003). Mirrors web-companies exactly today: a splash page plus login/signup/forgot-password on shared @buyootna/ui forms. No office dashboard exists yet.
3 user stories
Web Management
Next.js property management portal (apps/web/management, port 3004). Same auth-only shell pattern as web-companies/web-offices, but with a likely-unfinished detail: SignupForm's defaultRole is currently "INDIVIDUAL", not a management-specific role.
3 user stories
Web Landing
Next.js marketing site (apps/web/landing, port 3001): the public splash plus login/signup/forgot-password, the front door most real users and search engines will actually hit.
3 user stories
API
NestJS backend (apps/api/src/features + core): auth/identities, properties/search/map/favorites, chat, notifications, plans/payments/invoices, reviews, and core Twilio/S3/Prisma services. These stories focus on cross-cutting correctness that a UI-only pass would miss.
8 user stories