31 lines
1.8 KiB
Markdown
31 lines
1.8 KiB
Markdown
# dev-overview
|
||
|
||
Developer map of the Verae Time × Zapier **NATS message fabric**: what was designed, what is actually running on NS1, how a Zapier timestamp job reaches `api.veraetime.net` (or the mock) and comes back, and what is still unwired.
|
||
|
||
**Forgejo:** https://git.georgelambert.org/marchon/dev-overview
|
||
**SSH:** `ssh://git@git.georgelambert.org:2223/marchon/dev-overview.git`
|
||
**Catalog:** https://zapier.georgelambert.org/packages/dev-overview/
|
||
**Date:** 2026-09-14
|
||
|
||
Zapier cloud **never** connects to NATS. It talks HTTPS to `https://zap.zapier.georgelambert.org` (access-zapier) then middleware. `api.veraetime.net` is **HTTPS only** — middleware is the NATS client.
|
||
|
||
## Contents
|
||
|
||
| Doc | What |
|
||
|-----|------|
|
||
| [00-sources.md](00-sources.md) | Every other doc that names a NATS address or TCP route |
|
||
| [01-nats-routes.md](01-nats-routes.md) | Transport ports + every `verae.*` address: designed vs running |
|
||
| [02-endpoint-io.md](02-endpoint-io.md) | Per-address: purpose, inbound from, outbound to, how to connect Verae API |
|
||
| [03-zapier-verae-path.md](03-zapier-verae-path.md) | Zapier → middleware → Verae timestamp server → poll → events → Zapier |
|
||
| [04-gaps-and-finish.md](04-gaps-and-finish.md) | Modules not connected; billing/event/aux; ordered finish list |
|
||
| [05-developer-credentials.md](05-developer-credentials.md) | URLs, tokens, lab API keys, staff/IAM, git, env cheat sheet |
|
||
|
||
## Cluster (running)
|
||
|
||
```text
|
||
nats://10.10.10.21:4222,nats://10.10.10.22:4222,nats://10.10.10.23:4222
|
||
```
|
||
|
||
JetStream streams (replicas=3, file): `ZAPIER_JOBS`, `ZAPIER_EVENTS`, `ZAPIER_WEBHOOKS`, `ZAPIER_USAGE`, `VERAE_ARCHIVE`.
|
||
|
||
Public token-gated **client** edge (not cluster routes): `nats://<token>@70.88.205.138:4222`, `wss://nats.zapier.georgelambert.org`. Do not put this in Zapier.
|