master-zapier-plan-draft/packages/overview/02-modules-and-repos.md
George Lambert 1b199ca4d4
Some checks are pending
offline / test (push) Waiting to run
Separate Zapier, web, API, and leaf access planes with NATS authz
Zapier is one ingress. Direct web, customer API, and S2S leaf nodes are their own services. Every hop to an internal subject must pass verae.access.authz.check (default deny by plane).
2026-09-11 16:05:05 -04:00

3.1 KiB

2. Modules and independent repositories

Each runtime piece is its own git repo on Forgejo (git.georgelambert.org, SSH port 2223). The monorepo master-zapier-plan-draft is a snapshot of the workspace; do not treat it as the only clone path.

Independent repo Package / path What it does
overview packages/overview This high-level map
verae-nats-process packages/verae-nats-process Template for a new addressed NATS process
master-zapier-plan-draft workspace root Combined snapshot (main and master)
zappier-edge packages/zappier Metered HTTPS, portal, admin, Stripe; proxies Verae calls to middleware
verae-access-authz packages/verae-access-authz NATS authorization step (authz.check)
verae-access-web packages/verae-access-web Direct customer web plane
verae-access-api packages/verae-access-api Direct customer API plane (not Zapier)
verae-access-leaf packages/verae-access-leaf Server-to-server NATS leaf plane
verae-access-zapier packages/verae-access-zapier Zapier Platform plane only
zappier-account-balance packages/zappier-account-balance NATS source of truth for prepaid balances
zappier-customer-service packages/zappier-customer-service CS goodwill credits onto prepaid balances
zappier-sales-pricing packages/zappier-sales-pricing Sales per-customer tier / multiplier
zappier-accounting-export packages/zappier-accounting-export QuickBooks IIF + accounting CSV
verae-middleware packages/verae-zapier-middleware /zapier/v1, job wait, NATS publishers/workers
verae-zapier-app packages/verae-zapier Full Zapier nouns (timestamp, wait, batch, hash + tree lookup)
verae-activate packages/verae-activate Activate-now (Add Numbers, Echo, SHA256, mock timestamp)
verae-request-splitter packages/verae-request-splitter Chain hash vs archive.put
verae-archive-worm packages/verae-archive-worm Bloom WORM node
verae-archive-aggregator packages/verae-archive-aggregator Merge archive replies
verae-tree-node packages/verae-tree-node Merkle leaf proofs (bulk summaries)
verae-fleet packages/verae-fleet Catalog, min copies, pause/restart, SSH hosts, operator console
verae-zapier-simulator packages/verae-zapier-simulator Trace console before zapier-platform push
zapier-user-docs packages/zapier-user-docs Customer signup → register → lookup
zapier-docs-master packages/docs-master Per-module SUMMARY.md + NATS.md
verae-ops packages/verae-ops Docker, Proxmox, VMs, dedicated hardware, linking services

Libraries that are not separate Forgejo apps today: verae-chain-client (inside middleware), job-poller and webhook-deliver (middleware workers, fleet-spawned).

Per-module NATS contracts: zapier-docs-master.