Files

T

Connor Yoh f6f484f184 Procurement: render the real Enterprise Agreement + capture a signature

Replaces the placeholder agreement stub with the full Stirling Enterprise
Agreement (MSA + Order Form + DPA, one signature), served from a new
versioned legal-document registry, and captures a real signature record.

Versioned legal registry (backend-owned)
- app/saas/.../resources/legal/manifest.json + legal/<id>/<version>/*.md for
  the agreement (MSA + DPA), EULA, SLA exhibit and subprocessors, cleaned of
  internal counsel markers. Publishing a new version = drop a markdown file +
  bump the manifest; no code change.
- LegalDocumentRegistry loads the manifest and fills {{token}} slots.

Agreement rendering + signing
- AgreementAssembler builds MSA + a generated Order Form (Part B, from the
  quote) + DPA, filling every token; provider signatory is Matt Joseph, CEO.
- GET /procurement/agreement/document serves the filled markdown; the portal
  renders it (react-markdown) with a scroll-to-sign gate and typed legal
  name / signatory / title / authority.
- POST /procurement/agreement/sign records an immutable signature pinned to
  the document id + version + a SHA-256 content hash + the variable snapshot,
  then the flow accepts the quote as before.

Signed PDF
- AgreementPdfRenderer dogfoods Stirling's own Markdown->HTML->PDF path
  (commonmark + common FileToPdf/WeasyPrint); resilient — the signature is
  recorded even if the render runtime is unavailable, and the PDF is served
  from GET /procurement/agreement/signature/pdf when stored.

Storage: procurement_agreement_signature (V38 + Supabase twin). Read-only
pricing accessors added for the Order Form (effective rate/PDF, term
discount %); no billing behaviour change. Pricing reconciliation (25 MB
data-processing model) is intentionally out of scope. Legal text is DRAFT,
attorney-review-required — surfaced with a draft badge.

2026-07-13 15:14:59 +01:00

.claude/agents

playwright (#6025 )

2026-04-27 11:35:50 +01:00

.storybook

Portal empty states: add CTAs and hide stat boxes (#6952 )

2026-07-10 08:54:05 +00:00

editor

Procurement: render the real Enterprise Agreement + capture a signature

2026-07-13 15:14:59 +01:00

scripts

Consolidate buttons and related components (#6787 )

2026-07-07 16:06:56 +00:00

shared/components

Consolidate buttons and related components (#6787 )

2026-07-07 16:06:56 +00:00

.gitignore

Portal procurement: real pricing/trial/quote spine + linked-gated checkout (vertical slice) (#6861 )

2026-07-07 12:02:02 +00:00

.prettierignore

Restructure Portal code to be inside Editor (#6857 )

2026-07-03 13:20:02 +00:00

.prettierrc

Prettier 2: Electric Boogaloo (#6113 )

2026-04-17 09:50:16 +00:00

eslint.config.mjs

Portal: realign home hero to the simplified marketing card (#6956 )

2026-07-10 13:20:18 +00:00

package-lock.json

build(deps): bump form-data from 4.0.5 to 4.0.6 in /frontend (#6676 )

2026-07-11 12:55:08 +01:00

package.json

Convert to consistently use JS modules (#6854 )

2026-07-07 11:11:24 +00:00

README.md

Restructure/frontend editor (#6404 )

2026-05-22 13:40:34 +01:00

README.md

Frontend

All frontend commands are run from the repository root using Task:

task frontend:dev — start Vite dev server (localhost:5173)
task frontend:build — production build
task frontend:test — run tests
task frontend:test:watch — run tests in watch mode
task frontend:lint — run ESLint + cycle detection
task frontend:typecheck — run TypeScript type checking
task frontend:check — run typecheck + lint + test
task frontend:install — install npm dependencies

For desktop app development, see the Tauri section below.

Layout

frontend/ is a workspace containing one or more apps. Today it holds the PDF editor under frontend/editor/; new apps (the developer portal, etc.) will sit alongside it as siblings. Shared tooling — package.json, node_modules, .storybook/, ESLint, Prettier — lives at frontend/ so every app installs once and lints with the same config.

Environment Variables

The editor's environment variables live in committed .env files at frontend/editor/:

.env — used by all builds (core, proprietary, and as the base for desktop/SaaS)
.env.desktop — additional vars loaded in desktop (Tauri) mode
.env.saas — additional vars loaded in SaaS mode

These files contain non-secret defaults and are checked into Git, so most dev work needs no further setup.

To override values locally (API keys, machine-specific settings), create an uncommitted sibling editor/.env.local / editor/.env.desktop.local / editor/.env.saas.local. Vite automatically layers these on top of the committed files.

Docker Setup

For Docker deployments and configuration, see the Docker README.

Tauri

All desktop tasks are available via Task. From the root of the repo:

Dev

task desktop:dev

This ensures the JLink runtime and backend JAR exist (skipping if already built), then starts Tauri in dev mode.

Build

task desktop:build

This does a full clean rebuild of the backend JAR and JLink runtime, then builds the Tauri app for production.

Platform-specific dev builds are also available:

task desktop:build:dev           # No bundling
task desktop:build:dev:mac       # macOS .app bundle
task desktop:build:dev:windows   # Windows NSIS installer
task desktop:build:dev:linux     # Linux AppImage

JLink Tasks

You can also run JLink steps individually:

task desktop:jlink          # Build JAR + create JLink runtime
task desktop:jlink:jar      # Build backend JAR only
task desktop:jlink:runtime  # Create JLink custom JRE only
task desktop:jlink:clean    # Remove JLink artifacts

Clean

task desktop:clean

Removes all desktop build artifacts including JLink runtime, bundled JARs, Cargo build, and dist/build directories.