85 lines
4 KiB
Markdown
85 lines
4 KiB
Markdown
# Documentation index
|
||
|
||
Read **high-level first**, then **architecture**, then the rest. Live catalog: https://zapier.georgelambert.org/
|
||
|
||
Operator console (loopback): http://127.0.0.1:3850/
|
||
|
||
## 1. High-level (non-technical)
|
||
|
||
| Document | What it is |
|
||
|----------|------------|
|
||
| [README.md](README.md) | Overview (start here) |
|
||
| [01-system.md](01-system.md) | What runs where, in plain language |
|
||
| [02-modules-and-repos.md](02-modules-and-repos.md) | Short names of every independent repo |
|
||
| [zapier-docs-master](https://git.georgelambert.org/marchon/zapier-docs-master) | One-line SUMMARY + NATS per module |
|
||
| [zapier-user-docs](https://git.georgelambert.org/marchon/zapier-user-docs) | Signup → register → lookup |
|
||
|
||
## 2. Architecture
|
||
|
||
| Document | URL |
|
||
|----------|-----|
|
||
| NATS cluster | [03-nats-cluster.md](03-nats-cluster.md) |
|
||
| Uptime | [04-uptime.md](04-uptime.md) |
|
||
| Network failures | [05-network-failures.md](05-network-failures.md) |
|
||
| Address routing | [06-address-routing.md](06-address-routing.md) |
|
||
| External resources | [07-external-resources.md](07-external-resources.md) |
|
||
| Diagrams | [08-diagrams.md](08-diagrams.md) |
|
||
| Catalog home | https://zapier.georgelambert.org/ |
|
||
| Composition | https://zapier.georgelambert.org/docs/02-architecture/composition.html |
|
||
| NATS gateway | https://zapier.georgelambert.org/docs/02-architecture/nats-gateway.html |
|
||
| NATS subjects | https://zapier.georgelambert.org/docs/02-architecture/nats-subjects.html |
|
||
| Archive / bloom | https://zapier.georgelambert.org/docs/02-architecture/archive-nats.html |
|
||
| Module NATS map | https://zapier.georgelambert.org/docs/02-architecture/modules-and-nats.html |
|
||
| Tree nodes | https://zapier.georgelambert.org/docs/02-architecture/tree-nodes.html |
|
||
| Fleet | https://zapier.georgelambert.org/docs/02-architecture/fleet.html |
|
||
|
||
## 3. Remaining documentation
|
||
|
||
| Document | URL |
|
||
|----------|-----|
|
||
| Expansion template | [09-expansion-template.md](09-expansion-template.md) |
|
||
| Operator console | https://git.georgelambert.org/marchon/verae-fleet/src/branch/main/docs/CONSOLE.md |
|
||
| User guide | https://zapier.georgelambert.org/user-docs/README.md |
|
||
| Tree-node lookup (users) | https://zapier.georgelambert.org/packages/zapier-user-docs/09-lookup-tree-nodes.html |
|
||
| Zapier developer setup | https://zapier.georgelambert.org/docs/04-activate/SETUP-ZAPIER-DEVELOPER.html |
|
||
| docs-master | https://zapier.georgelambert.org/docs-master/README.md |
|
||
|
||
## Independent git repositories
|
||
|
||
Prefix: `https://git.georgelambert.org/marchon/`
|
||
|
||
overview · verae-nats-process · master-zapier-plan-draft · zappier-edge · verae-middleware · verae-zapier-app · verae-activate · verae-request-splitter · verae-archive-worm · verae-archive-aggregator · verae-tree-node · verae-fleet · verae-zapier-simulator · zapier-user-docs · zapier-docs-master
|
||
|
||
## Per-module contracts
|
||
|
||
In **zapier-docs-master**: `modules/<package>/SUMMARY.md` and `NATS.md` for every runtime package.
|
||
|
||
## Operator surfaces (not public NATS)
|
||
|
||
| Surface | URL |
|
||
|---------|-----|
|
||
| Operator console (Fleet · Trace · Docs) | http://127.0.0.1:3850/ |
|
||
| Standalone simulator | http://127.0.0.1:3847/ |
|
||
|
||
## A–Z subject index
|
||
|
||
| Term | See |
|
||
|------|-----|
|
||
| aggregator | verae-archive-aggregator; archive.query / reply |
|
||
| bloom miss | silence; 05-network-failures |
|
||
| batch / Merkle | verae-tree-node; user-docs 08–09 |
|
||
| cluster | 03-nats-cluster |
|
||
| fleet / keepFloor | verae-fleet; 04-uptime |
|
||
| hash lookup | verae-zapier-app searches; 07-external-resources |
|
||
| jobs.events / jobs.watch | nats-subjects.html; middleware |
|
||
| includeTree | tree lookup; archive.query kinds=tree |
|
||
| routing | 06-address-routing; verae-nats-process |
|
||
| splitter | verae-request-splitter |
|
||
| SSH hosts | verae-fleet machines.json |
|
||
| Zapier never NATS | 01-system |
|
||
| zappier-edge | metering, portal |
|
||
| operator console | http://127.0.0.1:3850/ ; verae-fleet docs/CONSOLE.md |
|
||
|
||
---
|
||
|
||
Design: **Scott Lindsey**, **George Lambert**, **NATS.IO**, and **Grok-Code** by [Grok.com](https://grok.com).
|