overview/10-docs-sync.md

39 lines
1.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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)
- `verae-uptime`, `verae-backup`, `verae-deploy`, `verae-proxmox` (LXC 510 on NS1 `vmbr1`)
- `verae-nats-cluster` (LXC 511513 JetStream on `vmbr1`)
## 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`