Skip to content

Legaciti Dev Docs

Deploy Workers

Recommended deployment and verification flow for production.

Deploy All Services (Recommended)

Deploys all workers in dependency order, then the dashboard, public site, and docs:

pnpm deploy:all

Manual Deploy (Fallback)

pnpm deploy:worker-log-processor
pnpm deploy:worker-rate-limiter
pnpm deploy:worker-notification
pnpm deploy:worker-ingestion-process
pnpm deploy:worker-ingestion-orchestrator
pnpm deploy:worker-consumer-api
pnpm deploy:dashboard
pnpm deploy:marketing
pnpm deploy:docs

Stuck Job Triage (Dashboard API)

List stuck jobs older than five minutes:

curl -H "CF-Access-Client-Id: $CF_ACCESS_CLIENT_ID" \
  -H "CF-Access-Client-Secret: $CF_ACCESS_CLIENT_SECRET" \
  "https://dash.legaciti.org/api/ingest/stuck?threshold_seconds=300&limit=50"

Force-fail one active stuck job:

curl -X POST \
  -H "CF-Access-Client-Id: $CF_ACCESS_CLIENT_ID" \
  -H "CF-Access-Client-Secret: $CF_ACCESS_CLIENT_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"orcid_id":"0000-0002-8685-5194","error_message":"manual unblock"}' \
  "https://dash.legaciti.org/api/ingest/stuck/<job_id>/force-fail"

Docs Architecture Runbooks Dashboard

Start Here

Legaciti Dev Docs Documentation Index Documentation Placement Guide New Contributors

Architecture

Repo Map Code Placement Guide Package Categories Dependency Rules Dashboard App Structure Worker Structure Known Architecture Gaps 07 — Feature Source of Truth 08 — Feature Module Internals 09 — TanStack Query Patterns 10 — Domain Packages 11) Cloudflare Runtime Boundary Generated Artifacts Policy 13 — Naming Conventions 14 — Barrel Files and Public Boundaries Architecture Checks in CI 16 — Contributing With The Architecture 17 — Feature Package Audit

Runbooks

GlitchTip Monitoring Setup Integrations API Rollout Runbook Slow DB Query Runbook Workspace Modules Rollout Runbook

Operational References

Worker Deploy Order Workspace API Key Management Publication & ORCID Resync Single-ORCID Resync Resync Unverified Works

Migrated Internal Docs

ADR E1: Localized Search Strategy ADR — Installation-Centric Integrations Model Authentication Operations CLI Deploy Workers Integrations Ownership, Migration, and Rollback Locale Key Checks Locale-Search Rollout Runbook Operations Runbook Partner Write API Performance And Localization Roadmap (2 to 100 Languages) Performance And Localization Implementation Backlog

Root Docs Archive

Fallow Prompt Documentation Placement Guide Documentation Index