George Lambert
1b199ca4d4
Some checks are pending
offline / test (push) Waiting to run
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).
35 lines
3.1 KiB
Markdown
35 lines
3.1 KiB
Markdown
# 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](https://git.georgelambert.org/marchon/zapier-docs-master).
|