feat: add D601 dev backend path

2026-05-18 10:31:43 +00:00
parent 11b94f3a95
commit 37504a28e8
56 changed files with 10489 additions and 311 deletions
@@ -2,7 +2,7 @@
  - AGENTS.md (Top-level agent index and `scripts/cli.ts` usage guide)
  - TEST.md (Manual CLI test plan following cli-spec expectations)
  - config.json (Single source of truth for ports, tokens, runtime, paths, and provider identity)
-  - docker-compose.yml (Main server orchestration for database, backend-core, frontend, provider-gateway, and managed main-server user services such as Todo Note)
+  - docker-compose.yml (Main server orchestration for database, backend-core, frontend, dev-frontend-proxy, provider-gateway, and managed main-server user services such as Todo Note)
  - package.json / bun.lock (Root Bun tooling for CLI checks)
  - .gitignore
  - reference -> docs/reference (Compatibility symlink for older references)
@@ -17,7 +17,7 @@
      - debug.ts (Real-flow debug helpers)
      - command.ts (Bounded command execution helpers)
      - output.ts (JSON output helpers)
-      - e2e.ts (Public frontend/provider ingress, internal core/database, and Playwright frontend E2E checks)
+      - e2e.ts (Public production frontend/dev frontend/provider ingress, internal core/database, and Playwright frontend E2E checks)
      - ci.ts (D601 k3s Tekton CI install/status/manual-run/dev-namespace-e2e/logs helpers; CI only, no CD)
  - logs/ (Generated service logs; ignored by git)
  - .state/ (Generated job state and compose env; ignored by git)
@@ -34,7 +34,8 @@
      - observability.md (Logs and status visibility)
      - e2e.md (Delivery gate, Playwright frontend E2E, and database persistence checks)
      - ci.md (D601 k3s Tekton CI, read-only production database performance gate, master deploy.json dev namespace e2e harness, and trigger boundary)
-  - src/ (TypeScript component monorepo)
+      - dev-environment.md (D601 persistent dev environment, public dev frontend proxy, deploy dev scope, and Rust build boundary)
+  - src/ (Component monorepo)
    - package.json (Component workspace metadata)
    - bun.lock (Component dependency lockfile)
    - tsconfig.base.json (Project references for component checks)
@@ -45,24 +46,28 @@
        - tsconfig.json
        - src/index.ts
      - backend-core/ (UniDesk stateless core service container)
+        - Cargo.toml / Cargo.lock (Rust backend-core crate and pinned dependency graph)
        - package.json
-        - tsconfig.json
        - Dockerfile
-        - src/index.ts (Server setup, HTTP/WebSocket routing, startup orchestration)
-        - src/types.ts (All interfaces and type aliases)
-        - src/config.ts (Environment variable reading and config validation)
-        - src/context.ts (Shared mutable state container: db client, config ref, dbReady flag)
-        - src/logger.ts (Structured logger factory)
-        - src/http.ts (HTTP/JSON utilities, ISO formatting, nested value extraction)
-        - src/db.ts (Database init, schema creation, all CRUD queries)
-        - src/performance.ts (Request/operation performance sampling and database size reporting)
-        - src/provider-registry.ts (Provider WebSocket lifecycle: register, heartbeat, status, disconnect)
-        - src/task-dispatcher.ts (Task creation, dispatch to providers, wait-for-result)
-        - src/ssh-bridge.ts (SSH session bridging over provider WebSocket)
-        - src/egress-tcp.ts (Egress TCP proxy for provider outbound connections)
-        - src/scheduler.ts (Scheduled task system: cron-like recurring tasks)
-        - src/microservice-proxy.ts (Microservice routing, HTTP proxy, health aggregation)
-        - src/overview.ts (Overview endpoint, node/task/service summary, load test)
+        - src/main.rs (Server setup, HTTP/WebSocket routing, startup orchestration)
+        - src/cli.rs (Container-local helpers for JSON fetch and SSH broker)
+        - src/types.rs (Runtime config, provider, task, microservice and performance data structures)
+        - src/config.rs (Environment variable reading, config validation and dev identity)
+        - src/state.rs (Shared application state, database pool, logger and in-memory task/provider indexes)
+        - src/logger.rs (Structured JSONL logger with hourly rotation and retention pruning)
+        - src/http.rs (HTTP routing, JSON utilities, health payload and API handlers)
+        - src/db.rs (Database init, schema creation and CRUD queries)
+        - src/performance.rs (Request/operation performance sampling and database size reporting)
+        - src/provider_registry.rs (Provider WebSocket lifecycle: register, heartbeat, status, disconnect)
+        - src/task_dispatcher.rs (Task creation, dispatch to providers, wait-for-result)
+        - src/ssh_bridge.rs (SSH session bridging over provider WebSocket)
+        - src/egress_tcp.rs (Egress TCP proxy for provider outbound connections)
+        - src/scheduler.rs (Scheduled task system: cron-like recurring tasks)
+        - src/microservice_proxy.rs (Microservice routing, HTTP proxy, health aggregation)
+        - src/overview.rs (Overview endpoint, node/task/service summary, load test)
+      - dev-frontend-proxy/ (Main-server nginx proxy exposing D601 `frontend-dev` on the dev public port)
+        - Dockerfile
+        - nginx.conf
      - frontend/ (Frontend web application container)
        - package.json
        - tsconfig.json