LegacyBlinkin-2-Hetzner Docs
Use this folder to track the preservation and migration work.
Suggested first documents:
legacy-source-map.md: where Picasso FE, Zweistein, and Studio API live and what each owns.migration-parity-matrix.md: old behavior, new implementation target, gap, and verification status.hetzner-deployment-plan.md: deployment shape, services, storage, backups, and rollout steps.
Current PRD suite:
prds/README.md: PRD map and source boundaries.prds/00-master-platform-prd.md: whole-platform preservation PRD.prds/01-auth-tenancy-prd.md: auth, tenant, users, permissions, external users.prds/02-flow-board-companion-prd.md: flows, boards, companions, publishing, forms.prds/03-editor-runtime-prd.md: Picasso editor and Houston runtime.prds/04-chat-agents-controls-prd.md: chat, agents, dynamic controls/widgets.prds/05-ai-tools-ingestion-prd.md: AI tools, research, ingestion, RAG/query engine.prds/06-billing-quotas-prd.md: subscriptions, plans, quota, usage, wallet.prds/07-integrations-media-webhooks-prd.md: integrations, uploads, media, webhooks, statistics.prds/08-admin-analytics-hetzner-prd.md: admin navigation, analytics, deployment, operations.
Current user-story suite:
user-stories/README.md: user-story backlog map and rules.user-stories/platform-user-story-backlog.md: complete platform backlog with epics, story IDs, acceptance criteria, and PRD links.
Current user manual suite:
manuals/README.md: manual map and writing rules.manuals/01-getting-started.md: first login, workspace basics, navigation.manuals/02-create-agent.md: create, configure, test, and publish an agent.manuals/03-create-and-publish-app.md: create an app/companion, build steps, publish, share, embed.manuals/04-knowledge-spaces.md: add files, websites, and knowledge sources.manuals/05-team-and-access.md: invite users, manage roles, external users, protected access.manuals/06-integrations-webhooks.md: connect integrations and send webhooks.manuals/07-billing-usage-admin.md: plans, billing portal, usage, quotas, and admin checks.manuals/08-studio-visual-flow-agentic-miniapp.md: build a visual flow in Studio and attach an Agentic App.manuals/09-agent-team-with-apps.md: use an App to coordinate a team of Agents.
Current audits:
audits/2026-05-05-prd-user-story-completion-audit.md: completion audit for PRD and user-story platform coverage.audits/2026-05-05-hetzner-port-completion-audit.md: completion audit for the local rebuild and Hetzner port objective, including current blockers and required evidence.
Current porting notes:
porting/2026-05-05-local-rebuild-foundation.md: first local rebuild foundation for the imported Picasso, Zweistein, and Studio API codebases.porting/2026-05-05-local-runtime-assembly.md: local runtime assembly map with service order, env templates, artifact status, health status, and current rebuild gaps.porting/2026-05-05-local-non-python-runtime-smoke.md: repeatable coordinated local smoke proving Studio API, Zweistein Server/Admin/Widget, and Picasso Houston/Editor/Widget run together with HTTP 200 throughnpm run legacy:runtime:smoke:non-python.porting/2026-05-05-database-readiness-gate.md: database readiness gate for Studio API migrations and Zweistein synchronized-schema evidence.porting/2026-05-05-studio-api-local-runtime.md: first verified Studio API local runtime slice with install, build, migrations, and health check.porting/2026-05-05-zweistein-server-local-runtime.md: verified Zweistein server local runtime slice with install, build, health check, Swagger, Redis, and database schema evidence.porting/2026-05-05-zweistein-admin-local-runtime.md: verified Zweistein admin local runtime slice with install, Vite build, dev server, and backend proxy evidence.porting/2026-05-05-zweistein-embedding-widget-local-runtime.md: verified Zweistein embedding widget slice with install, build, artifact, and dev-server evidence.porting/2026-05-05-picasso-fe-local-build-runtime.md: verified Picasso FE monorepo slice with Houston, Picasso Editor, and widget install/build/dev evidence.porting/2026-05-05-zweistein-python-services-local-probe.md: Python Query Engine and Ingestion Worker probe with Poetry checks, env templates, secret cleanup, partial macOS install evidence, Linux/amd64 Torch probe, and remaining Docker-build blocker.porting/2026-05-05-hetzner-staging-compose.md: first Hetzner staging Compose package with safe source sync, host preflight, runtime env templates, service ports, static widget services, optional Caddy reverse proxy/TLS, validation commands, build order, health gates, and known server-side blockers.porting/2026-05-05-hetzner-source-sync.md: guarded source sync helper for dry-run and confirmed rsync push to the Hetzner host.porting/2026-05-05-hetzner-bootstrap.md: server bootstrap gate for base tools, Docker readiness, and deployment-user checks.porting/2026-05-05-hetzner-runtime-config.md: safe runtime config initializer for ignored Hetzner.envfiles and Caddyfile.porting/2026-05-05-hetzner-stack-runbook.md: guarded server-side Compose run sequence for config, build, startup, service inspection, and proxy startup.porting/2026-05-05-hetzner-milestone-runbook.md: guarded milestone runner that groups readiness, Python, build, database, stack, proxy, and evidence steps.porting/2026-05-05-port-completion-gate.md: read-only final completion gate that maps the full port objective to concrete source, artifact, config, milestone, product-flow, and backup/restore evidence.porting/2026-05-05-hetzner-python-gate.md: server-side Python gate for the Query Engine and Ingestion Worker build/import/runtime blocker.porting/2026-05-05-hetzner-backup-restore.md: first backup and restore runbook for Postgres, MinIO, Caddy volumes, and runtime config.porting/2026-05-05-hetzner-staging-evidence.md: server-side evidence collection workflow for Hetzner staging milestones.