George Lambert
e401635fd6
Add missing package READMEs, expand Sphinx to all runtime modules, publish a LaTeX/PDF README book, and add verae-ops for Docker, Proxmox, VMs, dedicated hardware, and service linking. Catalog defaults to public PDF links for each module README and samples.
6.4 KiB
Verae Time × Zapier — system overview
High-level description of the whole system: what it is, which independent git repositories implement it, how it stays up, how it behaves when the local network fails, and how it talks to the central Verae NATS.IO 3-server cluster. New work is added by new address routing, not by teaching Zapier about NATS.
This repo: https://git.georgelambert.org/marchon/overview
Live catalog (PDF by default): https://zapier.georgelambert.org/ · Markdown indexes
Clone: ssh://git@git.georgelambert.org:2223/marchon/overview.git
Table of contents
- System — what runs where; Zapier never speaks NATS
- Modules and repositories — every independent Forgejo repo
- NATS.IO 3-server cluster — JetStream, subjects, who may connect
- Uptime — replica floors, restart, SSH spread
- Local network failures — reconnect, silence, pending, failover
- Address routing — how to add unplanned functions
- External resources — searches, storage, chain
- Architectural diagrams — SVG + mermaid
- Expansion template —
verae-nats-process - Documentation index — pointer into all other docs
One-screen picture
Zapier → HTTPS zappier-edge → HTTPS verae-middleware → NATS cluster → workers, WORM archives, tree nodes. Chain HTTPS is api.veraetime.net (or MOCK). Fleet keeps minimum copies, including tree nodes.
Independent repositories (Forgejo)
| Repo | Role |
|---|---|
| overview | This document |
| verae-ops | Docker, Proxmox, VMs, dedicated hardware |
| verae-nats-process | Model for a new addressed process |
| master-zapier-plan-draft | Monorepo snapshot |
| zappier-edge | Metered public HTTPS |
| verae-middleware | Zapier HTTP + NATS workers |
| verae-zapier-app | Zapier Platform app |
| verae-activate | Activate-now app |
| verae-request-splitter | Hash vs attachments |
| verae-archive-worm | Bloom WORM node |
| verae-archive-aggregator | Archive reply merge |
| verae-tree-node | Merkle leaf proofs |
| verae-fleet | Replica floor + SSH hosts |
| verae-zapier-simulator | Trace console |
| zapier-user-docs | Signup → lookup |
| zapier-docs-master | Per-module SUMMARY + NATS |
Clone any of them: git clone ssh://git@git.georgelambert.org:2223/marchon/<name>.git (SSH port 2223).
Operator console (loopback)
Fleet, message Trace, and Docs share one shell at http://127.0.0.1:3850/ (verae-fleet). Not public. See CONSOLE.pdf.
Where to read next
Start at the top. Architecture is second. Everything else is reference.
1. High-level (non-technical)
| Document | What it is |
|---|---|
| This overview | Whole system in one place |
| Modules and repositories | Short names of every independent repo |
| zapier-docs-master | One-line SUMMARY + NATS per module |
| zapier-user-docs | Signup → register a hash → lookup |
2. Architecture
| Document | What it is |
|---|---|
| NATS 3-server cluster | Who may connect; private URLs |
| Uptime | Replica floors, restart, SSH hosts |
| Local network failures | Reconnect, bloom silence, failover |
| Address routing | Unplanned functions as new subjects |
| External resources | Chain, WORM, tree-node search |
| Diagrams | SVG + mermaid |
| Fleet | Operator replica control |
| Module NATS map | Address table |
| Archive / bloom | Multipart and multi-receipt |
| Tree nodes | Bulk Merkle leaves |
| Composition | zappier + middleware HTTPS |
3. Remaining documentation
| Document | What it is |
|---|---|
| Documentation index | A–Z and catalog URLs |
| Expansion template / verae-nats-process | Copy this to add an address |
| Operator console | Screenshots of Fleet / Trace / Docs |
| Simulator | Standalone trace (also inside the console) |
| Zapier developer setup | CLI / login / push |
| Live catalog | https://zapier.georgelambert.org/ (PDF) · Markdown indexes |
Credits
Design: Scott Lindsey, George Lambert, NATS.IO, and Grok-Code by Grok.com.