George Lambert
2d51d7a0dd
Some checks are pending
offline / test (push) Waiting to run
zapier-docs-master now has CATALOG-HOST.md (relative PDFs / rewrite-docs-host.py) and HOST-DEPS.md. verae-bootstrap/scripts/host-deps.sh checks and installs git, Node, native build tools, and nats-server on Debian or Alpine from host-deps.tsv (every Forgejo module). fetch.sh runs it before clone/npm.
37 lines
1.7 KiB
Markdown
37 lines
1.7 KiB
Markdown
# Documentation sync (2026-09-11)
|
|
|
|
Validated against the module list in `packages/` and Forgejo repos.
|
|
|
|
## Current public doors
|
|
|
|
| Door | Bind | Notes |
|
|
|------|------|--------|
|
|
| Customer portal | access-web `:3021/portal/` | Static + `/portal/api` → loopback edge |
|
|
| Customer API | access-api `:3022` | |
|
|
| S2S leaf | access-leaf `:3023` | No billing subjects |
|
|
| Zapier | access-zapier `:3024` | Only Zapier HTTPS |
|
|
| Staff plane | access-staff `:3025` | After IAM |
|
|
| zappier-edge | loopback `:3000` (NS1 all-in-one `:13000`) | Admin, Stripe, not a public portal |
|
|
| Operator console | fleet `:3850` on `0.0.0.0` | Pause/stop honored by keep |
|
|
| Staff IAM | `:3028` | Named users, roles, sessions |
|
|
| Keep | `:3860` + watch `:3861` + `guard.sh` | Restart unless paused/stopped |
|
|
|
|
## New modules since the last catalog pass
|
|
|
|
- `verae-staff-iam`, `verae-staff-session`, `verae-staff-ui`
|
|
- `verae-keep`
|
|
- `verae-bootstrap` (clone + npm per server type; `scripts/host-deps.sh` installs OS/Node/NATS)
|
|
|
|
## Move the catalog to another hostname
|
|
|
|
HTML and PDF catalog links are **path-relative**. Rsync `site/` to a new document root (for example `docs.verae-time.net`) without rewriting files.
|
|
|
|
- Procedure: [CATALOG-HOST.md](https://git.georgelambert.org/marchon/zapier-docs-master/src/branch/main/CATALOG-HOST.md) in **zapier-docs-master**
|
|
- Optional absolute retarget: `python3 scripts/rewrite-docs-host.py --site ./site --from https://zapier.georgelambert.org --to https://docs.verae-time.net`
|
|
- Host packages for a new box: `bash packages/verae-bootstrap/scripts/host-deps.sh --type ns1-all-in-one`
|
|
|
|
## Still blocked (not closable here)
|
|
|
|
- Live `api.veraetime.net` (`MOCK_VERAE=false`)
|
|
- NATS nkeys/mTLS three-node cluster
|
|
- Zapier Platform `push`
|