Asset Hub 资产管理插件

• 本仓库用于开发 DooTask 的资产管理插件 Asset Hub，提供资产与耗材的全生命周期管理能力（系统管理、资产管理、耗材管理等）。
• Web 应用基于 Next.js + React + TypeScript + Tailwind CSS + shadcn/ui，位于 web/ 目录。
• 插件适配层基于 DooTask 插件规范，位于 dootask-plugin/ 目录。

开发时的重要规则与约束，已整理在 .cursor/rules/*.mdc 中：

• 00-project-overview.mdc：项目整体说明与关键约束。
• 10-dootask-plugin.mdc：插件适配层职责。
• 20-web.mdc / 21-web-routing.mdc：Web 应用的角色、约束与路由规划。
• 30-feature-plan.mdc：功能需求规划（首页、系统管理、资产管理等）。

开发流程

cd web
pnpm install
pnpm migrate   # 初始化 SQLite 与示例数据
pnpm dev       # http://localhost:3000/apps/asset-hub

质量保障

• pnpm lint：ESLint + TypeScript 检查。
• pnpm test：Vitest 单元测试（主要覆盖仓储层）。
• cd web && pnpm test:e2e：Playwright 端到端测试。
  • 需在 web/.env 中提供 PLAYWRIGHT_DOOTASK_HOST / PLAYWRIGHT_APP_URL / PLAYWRIGHT_USER_ID / PLAYWRIGHT_USER_TOKEN，脚本会自动访问 {host}/single/apps/iframe-test?url=...，在真实 DooTask 宿主 iframe 中执行测试。
  • 该模式完全依赖你提供的线上环境，不会再本地启动 pnpm dev。
• Dockerfile：构建生产镜像 docker build -t asset-hub .。
• .github/workflows/ci.yml：GitHub Actions 自动执行 lint/test/build（可扩展至 Playwright）。

当前里程碑

• 阶段 5 完成：资产 → 操作 → 审批 → 状态联动闭环已上线，并以 Playwright (web/tests/e2e) 自动化回归替换手动清单。
• 阶段 6（筹备中）：Dashboard & 报表指标拆解、聚合 API 规划以及多语言/主题联动优化。

DooTask 插件

• dootask-plugin/config.yml：插件元数据。
• dootask-plugin/version/config.yml：菜单入口，iframe 链接已经附带 theme/lang/user_id/user_token 占位符。
• dootask-plugin/README.md：在 DooTask 侧接入的操作说明。