feat: initialize unidesk platform

docs/reference/repo-tree.md

@@ -0,0 +1,66 @@
+- unidesk/ (Repository root: configuration, orchestration, CLI, and documentation)
+  - 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)
+  - package.json / bun.lock (Root Bun tooling for CLI checks)
+  - .gitignore
+  - reference -> docs/reference (Compatibility symlink for older references)
+  - scripts/ (Unified CLI and implementation modules)
+    - cli.ts (Single Bun CLI entry)
+    - tsconfig.json (TypeScript check scope for CLI)
+    - src/ (CLI business logic modules; `cli.ts` remains a thin router)
+      - config.ts (Root config loading and validation)
+      - docker.ts (Docker Compose env generation, start/stop/status/logs)
+      - jobs.ts (Fire-and-Forget job state under `.state/jobs/`)
+      - check.ts (Formal checks)
+      - debug.ts (Real-flow debug helpers)
+      - command.ts (Bounded command execution helpers)
+      - output.ts (JSON output helpers)
+      - e2e.ts (Public API, database, provider, and Playwright frontend E2E checks)
+  - logs/ (Generated service logs; ignored by git)
+  - .state/ (Generated job state and compose env; ignored by git)
+  - docs/
+    - issue/ (Manual test issue records)
+    - reference/ (Long-term reference documents)
+      - arch.md (Distributed work platform architecture)
+      - repo-tree.md (This repository structure reference)
+      - cli.md (CLI command model and async job contract)
+      - config.md (Config and runtime rules)
+      - deployment.md (Docker stack deployment and health criteria)
+      - frontend.md (Frontend layout and design rules)
+      - provider-gateway.md (Provider connection and host SSH maintenance bridge)
+      - observability.md (Logs and status visibility)
+      - e2e.md (Delivery gate, Playwright frontend E2E, and database persistence checks)
+  - src/ (TypeScript component monorepo)
+    - package.json (Component workspace metadata)
+    - bun.lock (Component dependency lockfile)
+    - tsconfig.base.json (Project references for component checks)
+    - tsconfig.check.json (No-emit TypeScript check scope for all components)
+    - components/
+      - shared/ (Shared message types and utilities)
+        - package.json
+        - tsconfig.json
+        - src/index.ts
+      - backend-core/ (UniDesk stateless core service container)
+        - package.json
+        - tsconfig.json
+        - Dockerfile
+        - src/index.ts (REST API, WebSocket provider server, scheduler, database access)
+      - frontend/ (Frontend web application container)
+        - package.json
+        - tsconfig.json
+        - Dockerfile
+        - src/index.ts (Bun static server and runtime config injection)
+        - public/ (HTML/CSS/JS assets for the compact industrial console)
+      - provider-gateway/ (Compute node Provider Gateway container)
+        - package.json
+        - tsconfig.json
+        - Dockerfile
+        - src/index.ts (WebSocket client, heartbeat, Docker adapter)
+        - scripts/host-ssh-shell.sh (Optional maintenance-only SSH bridge)
+      - database/ (PostgreSQL initialization and configuration)
+        - config/postgresql.conf
+        - init/001_unidesk_init.sql
+      - microservices/ (Reserved for future stateless microservices)
+        - example-service/