User Stories (Prime Order Portal)
Business stories for Prime Order Portal. Plain language for customers, sales, and operations.
1. Check availability at my address
As a prospective customer
I want guided address entry with autocomplete (city → ZIP → street → house number)
So that I can quickly see whether service is available at my home.
Done when: address resolves cleanly; result shows available / pre-orderable / in planning / not available, differentiated by product class (FTTH, VDSL, HFC, radio, …).
2. Know when fiber will arrive
As a customer in a rollout area
I want to see the expected build timeframe for my address
So that I know when fiber (or another technology) will be available for me.
Done when: the result can show an expected timeframe and a configurable message (e.g. “FTTH available by Q2/2026”).
3. Register for later rollout (waitlist)
As a customer without availability yet
I want to add myself to a waitlist
So that I am notified and counted when the area is built.
Done when: a negative result offers waitlist sign-up; the entry is stored and can be exported.
4. See alternatives when my first choice is unavailable
As a customer
I want to be shown alternative products on a negative result
So that I still find an option that works at my address.
Done when: alternatives appear automatically when the requested product class is not available.
5. Configure status messages and campaigns
As sales / marketing
I want configurable status texts and area campaigns
So that each Ausbaugebiet shows the right message and promotion.
Done when: status texts and marketing banners can be set per area without code changes.
6. Check many addresses via API
As a B2B partner or housing-industry customer
I want to run multi-address availability queries through an API
So that I can assess whole portfolios at once.
Done when: the API accepts batches and returns per-address status; waitlists can be exported via API.
7. Order and get provisioned automatically
As a customer
I want to configure and order online with digital signature and payment
So that my contract is created and service provisioned without manual steps.
Done when: approved orders create a contract and trigger provisioning via OS Provisioning.
8. Verify my e-mail with double opt-in
As a prospective customer
I want an optional double opt-in (DOI) e-mail step
So that my e-mail address is confirmed before the order completes.
Done when: when DOI is enabled, pricing / checkout continues only after the customer confirms the verification link.
9. Complete the order on any device
As a customer
I want a responsive funnel with clear mandatory fields (name, birth date, address, e-mail, phone)
So that I can order on phone, tablet, or desktop without friction.
Done when: the funnel validates required fields and renders cleanly on mobile and desktop.
10. Monitor orders and CRM handover
As an order-operations admin
I want an order error dashboard and a view of CRM transfer status
So that I can see error counts, the latest failures, and whether every order reached CRM.
Done when: the dashboard lists recent errors with counts and flags orders not yet transferred to CRM.
11. Sell with sales-assisted roles
As sales
I want role-based access for sales-assisted orders
So that agents can place and manage orders within their permissions.
Done when: sales roles can drive the funnel on behalf of a customer within their access scope.
12. Grow with forecasts and new carriers
As a product owner
I want the availability layer to extend with forecasts and external address carriers
So that planned-area info and sources like the envia TEL Address-API can be added over time.
Done when: the availability orchestration layer can add a new address source or forecast feed without changing the shop UI.