marchon/master-zapier-plan-draft
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 1
master-zapier-plan-draft/packages/verae-ops/01-dependencies.md
George Lambert cb07f5b321
Some checks are pending
offline / test (push) Waiting to run
Details
Restyle staff and console UIs; add UI-Docs walkthrough and review PDF. 
Match CS/sales/accounting/access-staff to the portal indigo system with
dollar amounts, skip links, and empty states. Fleet replica actions move
into overflow menus, roles become chips, Docs become cards, and the
header copy reflects the 0.0.0.0 bind. Simulator uses the same shell
(orange only for faults). Portal API keys are masked; admin customers
edit in a drawer. Catalog uses system-ui. New UI-Docs repo holds
screenshots, usage notes, and UI-REVIEW.pdf.
2026-09-11 18:01:33 -04:00

3 KiB
Raw Blame History

1. Dependencies and data flow

Humans / Zapier cloud
        │ HTTPS  x-api-key
        ▼
 zappier-edge :3000     (meter, portal, admin, Stripe)
        │ HTTPS internal
        ▼
 middleware-http :3100  (/zapier/v1)
        │
        ├── HTTPS → api.veraetime.net   (or MOCK_VERAE)
        └── NATS  → private cluster
                      jobs.watch / jobs.events
                      webhooks.deliver
                      archive.put / query / reply.*
                            │
              archive-worm × N     tree-node × N
              archive-aggregator   job-poller
                                   webhook-deliver

Repositories (clone all that you run)

Prefix ssh://git@git.georgelambert.org:2223/marchon/<name>.git (SSH 2223).

You need Repo Catalog README
Billing HTTPS zappier-edge https://zapier.georgelambert.org/packages/zappier/README.pdf
Zapier adapter verae-middleware https://zapier.georgelambert.org/packages/verae-zapier-middleware/README.pdf
Zapier app (cloud) verae-zapier-app https://zapier.georgelambert.org/packages/verae-zapier/README.pdf
WORM nodes verae-archive-worm https://zapier.georgelambert.org/packages/verae-archive-worm/README.pdf
Merkle leaves verae-tree-node https://zapier.georgelambert.org/packages/verae-tree-node/README.pdf
Archive merge verae-archive-aggregator https://zapier.georgelambert.org/packages/verae-archive-aggregator/README.pdf
Splitter verae-request-splitter https://zapier.georgelambert.org/packages/verae-request-splitter/README.pdf
Replica floors verae-fleet https://zapier.georgelambert.org/packages/verae-fleet/README.pdf
This install guide verae-ops https://zapier.georgelambert.org/packages/verae-ops/README.pdf

Optional: verae-activate (tiny pushable app), verae-zapier-simulator (trace), overview, zapier-docs-master, zapier-user-docs, verae-nats-process.

Runtime dependencies

Service Needs
zappier-edge Node 20+, SQLite path or volume, PORT, optional Stripe keys
middleware Node 22+, NATS_URL or NATS_ENABLED=false, chain URL or MOCK_VERAE
NATS JetStream, no public bind
worm / tree-node Node, NATS_URL, local state dir
fleet Node, machines.json (SSH paths), HTTP :3850 on 0.0.0.0
Zapier cloud app MIDDLEWARE_BASE_URL = public HTTPS of zappier-edge (or middleware if you skip metering in lab)

Ports (lab defaults)

Port Bind Process
3000 public or docker publish zappier-edge
3100 public or docker publish middleware
4222 private only NATS client
6222 private only NATS cluster
8222 private / localhost NATS monitor
3847 0.0.0.0 simulator
3850 0.0.0.0 operator console

Chain: https://api.veraetime.net (prod) or MOCK_VERAE=true (lab).