Demo suite 2026

The demo suite creates synthetic but realistic Vietnam 2026 data through the live API. It does not insert directly into PostgreSQL, so auth, tenancy, RBAC, billing, invoice, payment, export, tenant portal, and maintenance code paths are exercised exactly like a landlord would use them.

Research assumptions

Rents model three common segments: HCMC inner-city rooms, Hanoi serviced studios, and Binh Duong worker/logistics rooms.
Utility prices are rounded landlord billing rates for demo validation, not a legal resale-price claim.
Renter names, phone numbers, identity numbers, bank accounts, addresses, and emails are demo-only synthetic data.
Source references used for ranges and naming patterns: EVN average electricity-price adjustment, EVN tenant-room electricity billing context, SAWACO clean-water customer-service context, Vietnam rental listings, and Vietnam government 2026 wage-floor update.

Seed locally

Start the backend first:

cp .env.example .env
make docker-up
cargo run --bin anhome-backend

In another terminal:

make demo-seed

Optional overrides:

ANHOME_API_BASE_URL=http://127.0.0.1:8080/api/v1 \
ANHOME_DEMO_RUN_ID=demo-2026-a \
ANHOME_DEMO_PERIOD=2026-05 \
ANHOME_DEMO_USERNAME=demo_chu_tro_2026_a \
node scripts/seed-demo-suite.mjs

The script writes a validation artifact to output/demo-suite-<run_id>.json. Each run appends a new demo snapshot under the same organization. Use a fresh database or override ANHOME_DEMO_USERNAME when you want isolated dashboard totals.

Seed public listing search data

Issue #30 adds a dedicated public renter-search testing corpus. This mode uses the same live API path as the regular demo seed and creates only synthetic data: testing owners, testing properties, testing rooms, public listing overlays, and visibility controls. Preview the deterministic data shape without writing anything:

node scripts/seed-demo-suite.mjs --public-listings-plan

Seed a local/dev/staging API:

ANHOME_API_BASE_URL=http://127.0.0.1:8080/api/v1 \
ANHOME_DEMO_RUN_ID=public-search-qa-a \
ANHOME_DEMO_OUTPUT=output/public-listing-seed-public-search-qa-a.json \
ANHOME_ALLOW_PUBLIC_LISTING_SEED=yes \
ANHOME_PUBLIC_LISTING_SEED_PASSWORD='replace-with-a-temporary-qa-password' \
make public-listing-seed

Safe target environments: local, dev, staging, and disposable QA databases. The command fails closed unless ANHOME_ALLOW_PUBLIC_LISTING_SEED=yes and a temporary QA password are provided, and it refuses production-like API URLs. Use a fresh ANHOME_DEMO_RUN_ID for every corpus snapshot; fixed run-id reruns fail before writes when the previous public corpus is still visible. The corpus creates:

3 synthetic active owner organizations.
46 public published vacant listings total.
23 public published vacant listings in Cần Thơ (province_code=92).
23 public published vacant listings in Ho Chi Minh City (province_code=79).
4 represented wards in Cần Thơ and 4 represented wards in Ho Chi Minh City.
A valid Cần Thơ empty-state ward (ward_code=31299, Xã Phong Điền) with zero seeded public rooms.
Unpublished, occupied, maintenance, and hidden controls that must not appear on public renter APIs.

Validate after seeding:

curl -s "$ANHOME_API_BASE_URL/public/listings?province_code=92" | jq '.data.listings | length'
curl -s "$ANHOME_API_BASE_URL/public/listings?province_code=79" | jq '.data.listings | length'
curl -s "$ANHOME_API_BASE_URL/public/listings?q=$ANHOME_DEMO_RUN_ID&province_code=92" | jq '.data.listings | length'
curl -s "$ANHOME_API_BASE_URL/public/listings?q=$ANHOME_DEMO_RUN_ID&province_code=79" | jq '.data.listings | length'
curl -s "$ANHOME_API_BASE_URL/public/listing-filter-options?province_code=92" | jq '.data.wards[] | select(.code=="31299")'

Demo account

Username: demo_chu_tro_2026
Email: demo.chutro.2026@example.com
Password: AnHomeDemo2026!
Organization: AnHome Demo Việt Nam 2026

Get a token:

TOKEN=$(curl -s -X POST http://127.0.0.1:8080/api/v1/auth/login \
  -H 'content-type: application/json' \
  -d '{"username_or_email":"demo_chu_tro_2026","password":"AnHomeDemo2026!"}' \
  | jq -r '.data.access_token')

Validation endpoints

curl -s -H "authorization: Bearer $TOKEN" \
  'http://127.0.0.1:8080/api/v1/me' | jq

curl -s -H "authorization: Bearer $TOKEN" \
  'http://127.0.0.1:8080/api/v1/properties' | jq

curl -s -H "authorization: Bearer $TOKEN" \
  'http://127.0.0.1:8080/api/v1/dashboard/summary?period=2026-05' | jq

curl -s -H "authorization: Bearer $TOKEN" \
  'http://127.0.0.1:8080/api/v1/reports/revenue?period=2026-05' | jq

curl -s -H "authorization: Bearer $TOKEN" \
  'http://127.0.0.1:8080/api/v1/reports/receivables?period=2026-05' | jq

curl -s -H "authorization: Bearer $TOKEN" \
  'http://127.0.0.1:8080/api/v1/reports/occupancy' | jq

curl -s -H "authorization: Bearer $TOKEN" \
  'http://127.0.0.1:8080/api/v1/exports/invoices.csv?period=2026-05'

curl -s -H "authorization: Bearer $TOKEN" \
  'http://127.0.0.1:8080/api/v1/exports/payments.csv?period=2026-05'

The output JSON includes a tenant_link.public_token when at least one issued invoice exists. Validate the public tenant portal with:

curl -s "http://127.0.0.1:8080/api/v1/tenant-portal/invoices/<public_token>" | jq

Seed coverage

Each run creates:

3 properties across HCMC, Hanoi, and Binh Duong.
15 rooms with occupied, vacant, and maintenance states.
12 renters and active leases.
Billing settings, default recurring fees, payment accounts, meter readings for two 2026 periods.
Draft, issued, paid, partially paid, overdue, and reconciled invoices.
Manual cash/bank payments and one manual reconciliation match.
Admin and public tenant maintenance tickets.
Dashboard, reports, and CSV export validation previews.

​Research assumptions

​Seed locally

​Seed public listing search data

​Demo account

​Validation endpoints