master-zapier-plan-draft/packages/ui-docs/WALKTHROUGH.md
George Lambert d31c4317af
Some checks are pending
offline / test (push) Waiting to run
Add live HTTPS door cards and screenshots to the catalog.
Homepage bottom of zapier.georgelambert.org lists each public
service with a description, screenshot, and link. UI-REVIEW.pdf
and the walkthrough document those doors.
2026-09-11 20:15:53 -04:00

4.9 KiB

UI walkthrough (operator, staff, customers)

Captured 2026-09-11. Browser console: no application errors on the product UIs (favicon data-URI). Design tokens: --accent #4f46e5, --bg #f4f5fb, 12px radius, indigo header.

1. Operator console — Fleet

Open http://127.0.0.1:3850/.

Fleet

  1. Header kicker reads operator LAN · binds 0.0.0.0:3850. NATS stays private.
  2. Add machine: pick roles as chips (tree-node, archive-worm, …), then Add machine.
  3. Machine cards show role pills and enable/disable.
  4. Services: Health is operational/degraded. Power is a status (on / paused / off), not a toggle.
  5. Click on a replica or on Power for pause / resume / restart / start / stop.

Overflow

2. Trace

Click Trace.

Trace

  1. Pick an action (default Create Timestamp and Wait).
  2. Orange Faults box is inject-only.
  3. Run step. Hops wrap; module names are not clipped.

Trace run

3. Docs

Click Docs. Cards match Fleet. High-level first.

Docs

4. Standalone simulator

Open http://127.0.0.1:3847/. Same indigo shell. Orange only on Inject faults.

Simulator

Run step or a scenario (Register, Batch Merkle, …).

Simulator run

5. Customer service

Open http://127.0.0.1:3011/.

  1. Customer id → Review account. Prepaid is dollars.
  2. Amount (USD)Apply credit. Table lists $5.00, reason, agent name, when.

CS review

CS credit

6. Sales

http://127.0.0.1:3012/Review account or Show quote (named fields, not a JSON dump).

Sales

7. Accounting

http://127.0.0.1:3013/ — review plus QuickBooks IIF / CSV.

Accounting

8. Staff access plane

http://127.0.0.1:3025/ — same review/credit UI after verae.access.authz.check.

Staff

9. Admin

http://127.0.0.1:3000/admin/

Username Password
admin admin-dev-key
demo $$$Adm1n###

Login

Rate card

Customers is a read-only list. Edit opens a drawer (email, type, multiplier, billing).

Customers

Drawer

Invoices empty state until you Generate a period.

Invoices

10. Customer portal

http://127.0.0.1:3021/portal/ — public customer door (access-web). Loopback edge still has /portal on :3000. Create an account or sign in.

Portal login

Dashboard: API key is masked. Reveal, Copy (full key to clipboard), Regenerate.

Dashboard

No invoices

Statement

API & pricing notes that /docs is stock Swagger.

API

11. Swagger (not a customer surface)

http://127.0.0.1:3000/docs — vendor Swagger UI for integrators.

Swagger

12. Catalog

https://zapier.georgelambert.org/ — system-ui on the indigo header (not Georgia).

Catalog

13. Live HTTPS doors (NS1)

Public names on NS1.GEORGELAMBERT.ORG with Let's Encrypt. Caddy file: packages/verae-ops/caddy/zapier-services.georgelambert.org.caddy. NATS, keep, and archive workers stay on loopback.

Door URL
Customer portal https://portal.zapier.georgelambert.org/portal/
Customer API https://api.zapier.georgelambert.org/
S2S leaf https://leaf.zapier.georgelambert.org/
Zapier plane https://zap.zapier.georgelambert.org/
Staff plane https://staff.zapier.georgelambert.org/
Staff IAM https://iam.zapier.georgelambert.org/
Staff session https://login.zapier.georgelambert.org/
Customer service https://cs.zapier.georgelambert.org/
Sales https://sales.zapier.georgelambert.org/
Accounting https://acct.zapier.georgelambert.org/
Middleware https://mw.zapier.georgelambert.org/
Operator console https://fleet.zapier.georgelambert.org/
This catalog https://zapier.georgelambert.org/
Forgejo https://git.georgelambert.org/

Staff HTML redirects to IAM login (https://iam.zapier.georgelambert.org/login?next=…).

Portal live

IAM live

Fleet live

Zapier plane live

CS live

Catalog live