rootandClaude Fable 5.1
304feea141
- root deno.json workspace (nodeModulesDir auto), npm versions registered once in imports, deno.lock; remove pnpm-lock/pnpm-workspace/root package.json; members keep minimal package.json (name/type/exports) - tasks: dev, typecheck (tsc 7.0.2 per member + deno check), lint/fmt (biome, useImportExtensions), test (vitest via deno), check:tokens, build (web + deno compile), ci, db:migrate/reset, gen:types - tsconfig base moved to config/ (no root tsconfig.json); deno types -> types/deno.d.ts; web drops baseUrl - server: Deno.serve entry with graceful shutdown, --role migrate|preflight|probe, WEB_ROOT static SPA hosting; drop @hono/node-server, tsx, esbuild build.mjs - logger: redact child() bindings and serialize err by message/stack; sync stdout destination; tests - relative imports get explicit extensions (sites/mp-sync paths left for follow-up) - crash-recovery tests spawn `deno run -A`; tasks tests use unique per-file schemas - single-container Dockerfile + entrypoint (migrate -> preflight -> api+worker watchdog), docker-compose.yml - docs: README, runbook, ADR-001 superseded, plan §1 validation row Co-Authored-By: Claude Fable 5.1 <[email protected]>
44 lines
2.2 KiB
Markdown
44 lines
2.2 KiB
Markdown
# UHD Media Tool
|
|
|
|
内部使用、Agent 自动化优先的媒体整理入库平台。需求基线见 [media_automation_requirements_architecture_v0.7.md](media_automation_requirements_architecture_v0.7.md),v0.1 工程任务书见 [docs/plan/00-first-version-plan.md](docs/plan/00-first-version-plan.md)。
|
|
|
|
## 快速启动
|
|
|
|
需要 Deno 2.9.7(锁定版本:`curl -fsSL https://deno.land/install.sh | sh -s v2.9.7`)和 Docker。不需要 Node.js / pnpm。
|
|
|
|
```sh
|
|
cp .env.example .env
|
|
deno task db:up # postgres:16-alpine,端口 55433
|
|
deno install # 按 deno.lock 安装依赖到 node_modules
|
|
deno task db:migrate
|
|
deno task dev # API http://localhost:4380 控制台 http://localhost:5180
|
|
```
|
|
|
|
提交前:`deno task ci`(typecheck:tsc 7.0.2 + deno check → biome → vitest → check:tokens → web 构建 + server 编译)。
|
|
|
|
生产/试运行:`docker compose up -d --build`(单容器 app + postgres,见 [docs/runbook/dev.md](docs/runbook/dev.md#docker-单容器部署))。
|
|
|
|
更多见 [docs/runbook/dev.md](docs/runbook/dev.md)。
|
|
|
|
## 仓库结构
|
|
|
|
| 路径 | 职责 |
|
|
|---|---|
|
|
| `apps/web` | React Router 7 SPA 控制台,沿用 uhd_web 设计系统 |
|
|
| `apps/server` | Hono API(`/api/v1`)+ SSE + worker 入口 |
|
|
| `packages/contracts` | zod schema:API/事件/能力的唯一定义 |
|
|
| `packages/db` | Kysely 客户端、表类型与迁移 |
|
|
| `packages/domain` | 纯业务逻辑,无 IO |
|
|
| `packages/adapters` | qB / RSS / 站点 / TMDB / Emby / 文件系统适配 |
|
|
| `packages/tasks` | 持久任务与 outbox |
|
|
| `packages/agent` | Pi 接入与能力注册桥接 |
|
|
| `packages/testkit` | mock 服务与测试夹具 |
|
|
| `docs/adr` | 架构决策记录 |
|
|
| `docs/design` | 设计系统规范 |
|
|
| `docs/runbook` | 运行手册 |
|
|
| `config/` | tsc 7 用的 tsconfig 基座(根目录不放 tsconfig.json,否则 `deno check` 丢 Deno 全局) |
|
|
| `docker/` | 容器入口脚本 |
|
|
| `spikes/` | 独立兼容性验证(不属于 workspace) |
|
|
|
|
技术选型:Deno 2.9.7(锁定)+ TypeScript 7.0.2 strict,deno.json workspace(`nodeModulesDir: auto`,npm 依赖版本统一登记在根 `deno.json` 的 `imports`,`deno.lock` 锁定)。前端 Vite 7 + React Router 7 由 Deno 执行。决策见 [ADR-004](docs/adr/ADR-004-deno-runtime.md)(取代 ADR-001)。
|