Admin panel — operator guide & review console
Read a feature, click the link, see it live, note what's wrong/missing.
This is the review surface for the admin app: every page linked, what it should
do, and a status column you annotate as you go.
- Live links point at / (prod). For local dev,
swap the host for
http://localhost:3001.
- Login:
admin@mauza.fi (dev password mauza2024; prod set separately).
- Review status (edit these as you review):
✅ done & correct · 🟡 partial · 📝 todo (planned) · ❌ missing · ❓ to check
- Add findings in the Notes / gaps column. When you flag something, we
update both this doc (the intent) and the code (the implementation).
Source of truth for code locations: docs/workflows.md (terse inventory).
This doc is the human-facing, clickable companion.
Dashboard & monitoring
| Feature |
Live page |
What it should do |
Status |
Notes / gaps |
| Dashboard / metrics |
/ |
Platform KPIs: total + today orders, revenue, commission, active restaurants/carriers, customer count. |
❓ |
(time-series / per-entity breakdown not built) |
| Live view |
/ |
Active orders + online carriers snapshot (on dashboard, WS-fed). |
❓ |
|
Orders
| Feature |
Live page |
What it should do |
Status |
Notes / gaps |
| Order list |
/orders |
All orders, filter by status, live status updates via WS (no refresh). Click a row → detail. |
❓ |
|
| Order detail |
/orders → click a row |
Full order: items, money breakdown, event timeline, customer/restaurant/carrier. |
❓ |
|
| Force-cancel |
(in order detail) |
Admin override cancel from any non-terminal state; frees the carrier. |
❓ |
|
| Reassign carrier |
(in order detail) |
Manually assign/swap the carrier (ready_for_pickup → carrier_at_restaurant stages). |
❓ |
|
| Refund |
(in order detail) |
Full/partial refund + reason. Audit-only today — no Stripe money movement. |
🟡 |
Stripe wiring is post-beta |
Restaurants
| Feature |
Live page |
What it should do |
Status |
Notes / gaps |
| Restaurant list |
/restaurants |
List with status filter; approve / suspend; click → detail. |
❓ |
|
| Restaurant detail / edit |
/restaurants → click a row |
Edit name, address, commission rate, cuisine, prep time, delivery radius, coords. |
❓ |
|
| Create restaurant |
/restaurants/new |
Admin creates a restaurant under a company (PRH prefill). |
❓ |
|
| Menu import |
/restaurants → detail → import |
LLM-assisted menu import (URL / image / text → parse → review → import). |
❓ |
|
Onboarding (restaurant applications)
| Feature |
Live page |
What it should do |
Status |
Notes / gaps |
| Application list |
/onboarding |
All applications, filter by status, "awaiting review" count, section progress. |
✅ |
built 2026-06-11 |
| Application review |
/onboarding → click a row |
Per-section data + documents; verify / reject (with reason); final approve → creates the restaurant. |
✅ |
built 2026-06-11 |
Carriers
| Feature |
Live page |
What it should do |
Status |
Notes / gaps |
| Carrier list |
/carriers |
List with status/online filters; Approve / Suspend buttons. |
✅ |
approve/suspend built 2026-06-11 |
| Carrier map |
/carriers → Map tab |
Live fleet on a map, dots colored by online status, updates via WS. |
❓ |
|
Platform config & data
| Feature |
Live page |
What it should do |
Status |
Notes / gaps |
| VAT rates |
/vat-rates |
View active VAT rates per category/country/validity. Read-only — no edit UI. |
🟡 |
no create/edit; seed data only |
| Data sources |
/data-sources |
Load/refresh the Finnish address DB (DVV); shows version/size/last update. |
❓ |
|
| Platform settings |
(no page) |
Key/value platform config. API exists (GET/PUT /admin/settings), no UI. |
❌ |
build a settings page |
Tools (not in main nav)
| Feature |
Where |
What it should do |
Status |
Notes / gaps |
| PRH company search |
inside restaurant create / onboarding |
Search Finnish PRH open data by name / Y-tunnus for prefill. |
❓ |
|
| Simulation control |
separate app: web-simulation (not in admin) |
Start/stop/tick the marketplace simulation; visual map. |
❓ |
lives in apps/web-simulation, port 3003 |
How to use this for review
- Click a feature's link → it opens the live page (log in once).
- Check it does what the "What it should do" column says.
- Set the Status emoji and write findings in Notes / gaps.
- Tell me what you flagged — we update this doc (intent) and the code/tests
to match. Missing features become 📝 todo rows here first, then get built.
Known-missing right now (start here): Platform settings UI (❌), VAT rate
editing (🟡), dashboard time-series (📝). The rest are ❓ pending your eyes.