0 Fork 0

Files

T

rootandClaude Fable 5.1 304feea141 chore(deno): migrate toolchain from Node 24 + pnpm to Deno 2.9.7 + TypeScript 7.0.2 (W1.5)

- 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]>

2026-09-27 18:53:06 +08:00

2.2 KiB

Raw Blame History

UHD Media Tool

内部使用、Agent 自动化优先的媒体整理入库平台。需求基线见 media_automation_requirements_architecture_v0.7.md,v0.1 工程任务书见 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。

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。

仓库结构

路径	职责
`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(取代 ADR-001)。

2.2 KiB Raw Blame History

UHD Media Tool

快速启动

仓库结构

2.2 KiB

Raw Blame History