Three-node NATS JetStream cluster on Proxmox LXC

This commit is contained in:
George Lambert 2026-09-11 23:48:02 -04:00
commit f8396325e4
79 changed files with 801 additions and 0 deletions

70
README.md Normal file
View file

@ -0,0 +1,70 @@
# zapier-docs-master
Summaries, NATS contracts, and message flows for every Verae Time × Zapier module.
**Live catalog:** https://zapier.georgelambert.org/
**Move the catalog to another host:** [CATALOG-HOST.md](CATALOG-HOST.md) (relative PDF links; `scripts/rewrite-docs-host.py`)
**Host OS / Node / NATS install:** [verae-bootstrap HOST-DEPS](https://git.georgelambert.org/marchon/verae-bootstrap)
**Overview (start here):** https://git.georgelambert.org/marchon/overview
**Operator console:** http://127.0.0.1:3850/ (Fleet · Trace · Docs)
**Monorepo:** https://git.georgelambert.org/marchon/master-zapier-plan-draft (`main` and `master`)
## Git repos (Forgejo on NS1)
| Repo | URL |
|------|-----|
| master-zapier-plan-draft | https://git.georgelambert.org/marchon/master-zapier-plan-draft |
| zappier-edge | https://git.georgelambert.org/marchon/zappier-edge |
| verae-middleware | https://git.georgelambert.org/marchon/verae-middleware |
| verae-zapier-app | https://git.georgelambert.org/marchon/verae-zapier-app |
| verae-activate | https://git.georgelambert.org/marchon/verae-activate |
| verae-request-splitter | https://git.georgelambert.org/marchon/verae-request-splitter |
| verae-archive-worm | https://git.georgelambert.org/marchon/verae-archive-worm |
| verae-archive-aggregator | https://git.georgelambert.org/marchon/verae-archive-aggregator |
| verae-tree-node | https://git.georgelambert.org/marchon/verae-tree-node |
| verae-zapier-simulator | https://git.georgelambert.org/marchon/verae-zapier-simulator |
| zapier-user-docs | https://git.georgelambert.org/marchon/zapier-user-docs |
| verae-fleet | https://git.georgelambert.org/marchon/verae-fleet |
| **overview** | https://git.georgelambert.org/marchon/overview |
| verae-nats-process | https://git.georgelambert.org/marchon/verae-nats-process |
| **zapier-docs-master** (this repo) | https://git.georgelambert.org/marchon/zapier-docs-master |
| **verae-ops** | https://git.georgelambert.org/marchon/verae-ops |
| verae-staff-iam | https://git.georgelambert.org/marchon/verae-staff-iam |
| verae-keep | https://git.georgelambert.org/marchon/verae-keep |
| verae-bootstrap | https://git.georgelambert.org/marchon/verae-bootstrap |
| verae-uptime | https://git.georgelambert.org/marchon/verae-uptime |
| verae-backup | https://git.georgelambert.org/marchon/verae-backup |
| verae-deploy | https://git.georgelambert.org/marchon/verae-deploy |
| verae-proxmox | https://git.georgelambert.org/marchon/verae-proxmox |
| verae-nats-cluster | https://git.georgelambert.org/marchon/verae-nats-cluster |
Clone (SSH port 2223):
`git clone ssh://git@git.georgelambert.org:2223/marchon/<name>.git`
## Modules
| Module | Summary | NATS in | NATS out |
|--------|---------|---------|----------|
| zappier-edge | Metered HTTPS for Zapier | — | — (HTTPS to middleware) |
| verae-middleware | Job id + wait HTTP | jobs.events | jobs.watch |
| verae-activate | Pushable Zapier app | — | — |
| verae-zapier-app | Full Zapier nouns | — | — |
| request-splitter | Hash vs files | — | archive.put |
| archive-worm | Bloom WORM node | archive.query, archive.put | archive.reply.* (hit only) |
| archive-aggregator | Merge archive replies | archive.reply.* | archive.query |
| tree-node | Merkle leaf proofs | archive.query, archive.put | archive.reply.* (hit only) |
| zapier-simulator | Trace console (in-process) | — | — |
| zapier-user-docs | Signup → lookup guide | — | — |
| verae-fleet | Replica floors + monitor | — | — |
| overview | System map | — | — |
| nats-process | Template worker | example.process.in | example.process.out / reply.* |
| ops | Install / Docker / Proxmox / metal | — | — |
## Documents in this repo
- [MESSAGE-FLOWS.md](MESSAGE-FLOWS.md) — numbered request paths
- [modules-and-nats.md](modules-and-nats.md) — address table
- [archive-nats.md](archive-nats.md) — bloom / multi-receipt design
- [composition.md](composition.md) — HTTPS hops
- `modules/<name>/SUMMARY.md` and `NATS.md`