48 lines
3.3 KiB
Markdown
48 lines
3.3 KiB
Markdown
# 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:** https://zapier.georgelambert.org/
|
||
**Clone:** `ssh://git@git.georgelambert.org:2223/marchon/overview.git`
|
||
|
||
## Table of contents
|
||
|
||
1. [System](01-system.md) — what runs where; Zapier never speaks NATS
|
||
2. [Modules and repositories](02-modules-and-repos.md) — every independent Forgejo repo
|
||
3. [NATS.IO 3-server cluster](03-nats-cluster.md) — JetStream, subjects, who may connect
|
||
4. [Uptime](04-uptime.md) — replica floors, restart, SSH spread
|
||
5. [Local network failures](05-network-failures.md) — reconnect, silence, pending, failover
|
||
6. [Address routing](06-address-routing.md) — how to add unplanned functions
|
||
7. [External resources](07-external-resources.md) — searches, storage, chain
|
||
8. [Architectural diagrams](08-diagrams.md) — SVG + mermaid
|
||
9. [Expansion template](09-expansion-template.md) — `verae-nats-process`
|
||
10. [Documentation index](INDEX.md) — 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](https://git.georgelambert.org/marchon/overview) | This document |
|
||
| [verae-nats-process](https://git.georgelambert.org/marchon/verae-nats-process) | **Model** for a new addressed process |
|
||
| [master-zapier-plan-draft](https://git.georgelambert.org/marchon/master-zapier-plan-draft) | Monorepo snapshot |
|
||
| [zappier-edge](https://git.georgelambert.org/marchon/zappier-edge) | Metered public HTTPS |
|
||
| [verae-middleware](https://git.georgelambert.org/marchon/verae-middleware) | Zapier HTTP + NATS workers |
|
||
| [verae-zapier-app](https://git.georgelambert.org/marchon/verae-zapier-app) | Zapier Platform app |
|
||
| [verae-activate](https://git.georgelambert.org/marchon/verae-activate) | Activate-now app |
|
||
| [verae-request-splitter](https://git.georgelambert.org/marchon/verae-request-splitter) | Hash vs attachments |
|
||
| [verae-archive-worm](https://git.georgelambert.org/marchon/verae-archive-worm) | Bloom WORM node |
|
||
| [verae-archive-aggregator](https://git.georgelambert.org/marchon/verae-archive-aggregator) | Archive reply merge |
|
||
| [verae-tree-node](https://git.georgelambert.org/marchon/verae-tree-node) | Merkle leaf proofs |
|
||
| [verae-fleet](https://git.georgelambert.org/marchon/verae-fleet) | Replica floor + SSH hosts |
|
||
| [verae-zapier-simulator](https://git.georgelambert.org/marchon/verae-zapier-simulator) | Trace console |
|
||
| [zapier-user-docs](https://git.georgelambert.org/marchon/zapier-user-docs) | Signup → lookup |
|
||
| [zapier-docs-master](https://git.georgelambert.org/marchon/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**).
|