marchon/master-zapier-plan-draft
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 1
Verae Time x Zapier monorepo plan draft
30 commits 2 branches 0 tags 93 MiB
Find a file
George Lambert cb07f5b321
Some checks are pending
offline / test (push) Waiting to run
Details
Restyle staff and console UIs; add UI-Docs walkthrough and review PDF. 
Match CS/sales/accounting/access-staff to the portal indigo system with
dollar amounts, skip links, and empty states. Fleet replica actions move
into overflow menus, roles become chips, Docs become cards, and the
header copy reflects the 0.0.0.0 bind. Simulator uses the same shell
(orange only for faults). Portal API keys are masked; admin customers
edit in a drawer. Catalog uses system-ui. New UI-Docs repo holds
screenshots, usage notes, and UI-REVIEW.pdf.
2026-09-11 18:01:33 -04:00
.github/workflows Keep-going: tree shares, health flags, CI, compose, timestamp Zapier action 2026-09-09 03:02:08 -04:00
docs Clean prepaid SoT, identity mailbox, public access planes, leaf policy, fleet spawn 2026-09-11 17:15:16 -04:00
harness Keep-going: tree shares, health flags, CI, compose, timestamp Zapier action 2026-09-09 03:02:08 -04:00
packages Restyle staff and console UIs; add UI-Docs walkthrough and review PDF. 2026-09-11 18:01:33 -04:00
research Milestone 0: import zappier billing, Verae middleware, and Zapier research 2026-09-09 02:37:36 -04:00
scripts Restyle staff and console UIs; add UI-Docs walkthrough and review PDF. 2026-09-11 18:01:33 -04:00
vendor Milestone 0: import zappier billing, Verae middleware, and Zapier research 2026-09-09 02:37:36 -04:00
.gitignore Publish docs site for zapier.georgelambert.org and archive-NATS design 2026-09-11 12:23:23 -04:00
package.json Document every repo in Sphinx, catalog PDFs, and verae-ops 2026-09-11 14:36:17 -04:00
README.MD Fix catalog PDF links; add bring-online guide; feature zappier billing 2026-09-11 14:59:13 -04:00
restart.sh Milestone 0: import zappier billing, Verae middleware, and Zapier research 2026-09-09 02:37:36 -04:00
TODO.md Milestone 3: NATS wait (gate 9), hash lookup, zappier timestamp, NS1 tunnel 2026-09-09 02:54:02 -04:00

README.MD

Verae Time × Zapier

Workspace that composes two existing systems and the official Zapier Platform SDK:

  1. packages/zappier — custom pricing, API keys, customer portal, admin, Stripe, invoices.
  2. packages/verae-zapier-middleware — timestamp adapter to api.veraetime.net (or MOCK_VERAE) plus NATS workers.
  3. packages/verae-zapier — Zapier Platform CLI app.
  4. vendor/zapier-platform — upstream CLI/core/schema/examples (reference).
  5. research/zapier — vendor research, scrapes, cloned Zapier repos, playbooks (research/README.md).

They are imported, not yet wired. Public Zapier traffic should eventually hit zappier (x-api-key), which meters the call and proxies to the Verae middleware. See docs/02-architecture/composition.md.

Original brief (features a–m): docs/00-sources/workspace-brief.md.
Where each tree came from: docs/00-sources/provenance.md.

Tomorrow morning: docs/04-activate/SETUP-ZAPIER-DEVELOPER.md — create a Zapier developer account and push Add Numbers.

Quick start

# Billing platform (portal :3000, admin, /docs)
cd packages/zappier && npm install && npm test && npm run dev

# Verae middleware (HTTP :3100, optional NATS)
cd packages/verae-zapier-middleware && npm install
cd ../.. && npm run gate:0

Gates (npm run gate:N) continue the middleware plan in TODO.md. Phases 0–8, 10, 11 already passed in the source tree; 9 and 12+ are still open. Path prefixes now use packages/.

Bring online: https://zapier.georgelambert.org/packages/verae-ops/GETTING-STARTED.pdf
Live catalog (PDF default): https://zapier.georgelambert.org/ · Markdown indexes
Billing / users (zappier-edge): https://zapier.georgelambert.org/packages/zappier/docs/USER-MANUAL.pdf
Sphinx: https://zapier.georgelambert.org/sphinx/ · LaTeX PDF

Documentation map

Doc Contents
docs/01-product/features-a-m.md Requested Zapier surface vs owners
docs/01-product/api-gap-analysis.md Live Verae OpenAPI vs a–m
docs/01-product/billing-and-keys.md Keys, rate card, invoices
docs/02-architecture/overview.md Adapter internals (imported)
docs/03-zapier/operations.md Platform nouns
research/README.md Imported Zapier vendor research
docs/04-activate/SETUP-ZAPIER-DEVELOPER.md Morning: Zapier developer account + push Add Numbers
docs/modules/README.md Per-module API sheets (params, callees, returns)
docs/models/README.md Data models
docs/sphinx/_build/html/index.html Sphinx HTML (rebuild: npm run docs:sphinx)

Environment (middleware)

Variable Default Purpose
PORT 3100 Middleware HTTP
VERAE_API_BASE_URL http://localhost:8080 Upstream Verae
MOCK_VERAE false Local mock of Verae HTTP
NATS_ENABLED false JetStream workers vs in-process poller

Zappier uses PORT (3000), ZAPPIER_DB, ADMIN_KEY, STRIPE_SECRET_KEY — see packages/zappier/README.md.