marchon/master-zapier-plan-draft
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 1
master-zapier-plan-draft/packages/overview/README.md
George Lambert a32c91475c
Some checks are pending
offline / test (push) Waiting to run
Details
Add overview repo and verae-nats-process expansion template 
High-level system map with diagrams, TOC, and a docs index. Template
worker shows how to add a new verae.* address for search, storage, or
unplanned functions without teaching Zapier NATS.
2026-09-11 13:50:37 -04:00

3.3 KiB
Raw Blame History

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 — what runs where; Zapier never speaks NATS
  2. Modules and repositories — every independent Forgejo repo
  3. NATS.IO 3-server cluster — JetStream, subjects, who may connect
  4. Uptime — replica floors, restart, SSH spread
  5. Local network failures — reconnect, silence, pending, failover
  6. Address routing — how to add unplanned functions
  7. External resources — searches, storage, chain
  8. Architectural diagrams — SVG + mermaid
  9. Expansion template — verae-nats-process
  10. Documentation index — pointer into all other docs

One-screen picture

System context

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-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).