feat: 完成v1.3.0架构对齐与Web端根路径托管全量开发

- 重构架构：抽离AddCloudSyncServer到扩展类，补全中间层文档对齐
- 修复根路径404与鉴权跳转：新增中间件处理浏览器请求302跳转
- 实现种子数据初始化：添加默认管理员账号自动创建逻辑
- 优化前端代理与构建：新增Vite代理配置与自动构建Target
- 补全测试与文档：新增集成测试，更新开发与部署文档

docs/project/研发工单-v1.3.0/00-工单总览.md

@@ -40,6 +40,16 @@ Hua.Todo v1.3.0 版本聚焦于三个核心能力的升级：
 
 当前版本暂无串行工单依赖。
 
+### 2.4 补充工单（架构对齐，2026-08-08 新增）
+
+> 按 [04-研发工单全流程规范.md](../../../.trae/rules/全局/04-研发工单全流程规范.md) §2.3「新增工单约束」：已有条目不可改写，本章节为本次**新增**。触发原因：本次 307 修复后重写 [01-项目架构.md](../../../.trae/rules/项目/01-项目架构.md) §3/§5，对照代码发现 2 处架构缺口（文档遗漏 HttpApi.AspNetCore 层、Web 端根路径无前端托管）。
+
+| 工单编号 | 标题 | 负责人 | 状态 | 并行性 |
+|---|---|---|---|---|
+| 05 | 架构文档与代码实际路径对齐 | - | 待开始 | 与 03/06 并行 |
+| 06 | Web 端根路径托管前端 | - | 待开始 | 与 03/05 并行（建议 05 缺口 D 先落，再推 06 Program.cs 集成） |
+| 07 - 数据库初始化默认管理员 | 待实现 | 待验证 | Host 服务端 DB Migrate 后自动创建默认管理员账号；仅 Host 模式；配置驱动 + 幂等 + 强制首登改密；作为 06.1 Bootstrap 的自动前置项。详见 [10-数据库初始化默认管理员.md](10-数据库初始化默认管理员.md) |
+
 ---
 
 ## 三、各子工单摘要
@@ -123,6 +133,33 @@ Hua.Todo v1.3.0 版本聚焦于三个核心能力的升级：
 - 本地附件可通过系统关联程序打开
 - 附件数量（20个）和大小（50MB）限制生效
 
+### 3.5 工单 05 - 架构文档与代码实际路径对齐
+
+**目标**：修正 01-项目架构.md §1/§2/§5 共 5 处与实际代码结构不一致的描述，使规则文档成为代码的单一事实来源。
+
+**核心需求**：
+- **文档侧**：§1 项目清单补 `Hua.Todo.HttpApi.AspNetCore` 条目；§2 ASCII 依赖图加该中间层；§5 路径修正 Mcp 描述
+- **代码侧**：`CloudSyncServerService.cs` 抽离 `AddCloudSyncServer()` 到新文件 `CloudSyncServiceCollectionExtensions.cs`；新建 `CloudSyncEndpointExtensions.cs` 还原 `MapCloudSyncProxySettings()`
+- **回归**：Host 编译 + 161 个既有测试全部通过
+
+**不包含**：业务逻辑变更、公共 API 签名修改、v1.2.0 工单 10（DataSeeder）
+
+**验收标准**：详细 5 条 Given-When-Then 见 [05-架构文档与代码实际路径对齐.md](./05-架构文档与代码实际路径对齐.md) §五。
+
+### 3.6 工单 06 - Web 端根路径托管前端
+
+**目标**：补齐模式 B（Hua.Todo.Host Web 端）的前端静态页托管链路，使 `dotnet publish Hua.Todo.Host` 产出一个「页面 + API + Admin 占位」完整可部署的服务。
+
+**核心需求**：
+- Host `Program.cs`：`UseDefaultFiles` + `UseStaticFiles` + `MapFallbackToFile("index.html")`（支持 SPA 路由）
+- Host `csproj`：新增 `BuildHuaTodoWebWebRoot` Target（`npm install`/`npm run build`/`copy dist → wwwroot`，Inputs/Outputs 支持增量构建）
+- 文档：`docs/manual/08-构建与开发指南.md` 追加模式 B 开发双开步骤 + 生产发布步骤
+- 测试：`WebRootStaticFileTests.cs` 验证根路径 `/` 与 SPA fallback 不覆盖 `/api/*`
+
+**不包含**：Admin 管理后台前端实现（v1.2.0 工单 06.1）、嵌入式模式前端托管（`EmbeddedWebServerService` 各自管理）
+
+**验收标准**：详细 6 条 Given-When-Then 见 [06-Web端根路径托管前端.md](./06-Web端根路径托管前端.md) §四。
+
 ---
 
 ## 四、待验证表
@@ -149,6 +186,14 @@ Hua.Todo v1.3.0 版本聚焦于三个核心能力的升级：
 | 04 | 附件数量/大小限制 | 待验证 | 20 个 / 50MB |
 | 04 | 待办项删除时附件级联清理 | 待验证 | - |
 | 04 | 跨平台编辑安全（移动端不覆盖描述/附件） | 待验证 | 桌面设值 → 移动端改标题 → 桌面验证不丢失 |
+| 05 | 规则文档 §1/§2 补 HttpApi.AspNetCore 条目与依赖图 | 待验证 | Glob 到项目 + 规则描述一致 |
+| 05 | §5 扩展点 AddCloudSyncServer / MapCloudSyncProxySettings / Mcp 3 个路径修复 | 待验证 | 规则路径 = Grep 实际路径；Host 编译 0 错误 |
+| 05 | 既有 AddCloudSyncServer 回归测试 | 待验证 | `CloudSyncEndpointRegistrationTests` 5 个用例全部通过 |
+| 06 | Host `/` 返回 Hua.Todo.Web index.html（200 + div#app） | 待验证 | `WebRootStaticFileTests.Root_Get_ReturnsIndexHtml` 通过 |
+| 06 | SPA 路由 `/settings` fallback 到 index.html | 待验证 | 不 404；不覆盖 `/api/*` 动态 API |
+| 06 | `dotnet publish Hua.Todo.Host` 产出包含前端静态资源 | 待验证 | publish/wwwroot/index.html 存在 + 资源齐全 |
+| 06 | 增量构建前端未变时跳过 npm build | 待验证 | MSBuild Inputs/Outputs 检测 Skipping target 提示 |
+| 06 | 模式 B 开发双开文档可执行性 | 待验证 | 从零 clone → 文档 step by step 跑通页面 + API |
 
 ---
 
@@ -172,6 +217,9 @@ Hua.Todo v1.3.0 版本聚焦于三个核心能力的升级：
 | 附件存储策略 | 附件存储在应用数据目录 `Attachments/` 子目录；外部链接不复制文件仅存 URL；单文件 50MB / 每待办项 20 个上限 |
 | 外部程序启动 | 通过 `IPlatformAttachmentOpener` 接口实现平台差异：Windows 用 `Process.Start`，Linux 用 `xdg-open` |
 | 工单 04 与 03 共享文件 | `TaskEntity.cs`、`TodoDbContext.cs`、`task.ts`、`TaskEditDialog.vue` 为共享文件，工单 03 先写入，04 后续追加 |
+| **架构文档 ↔ 代码一致性强制策略** | 后续凡改 01-项目架构.md 任何一节，改后必须立即对 §1/§2/§5 所有提到的文件路径做一次 Glob/Grep 校验；不一致 → 先开对齐工单，不直接碰业务代码（本次 05 工单即为策略首次落地案例） |
+| **Host 中间件顺序固定模板** | Swagger → UseDefaultFiles/UseStaticFiles → CORS → Authentication → Authorization → UseDynamicApi → MapMcpServer → MapFallbackToFile → Run（顺序错误直接判作编译/验收失败） |
+| **MSBuild 前端构建 Target 命名与增量** | Host 前端构建 Target 固定名 `BuildHuaTodoWebWebRoot`；必须显式写 `Inputs="$(HuaTodoWebSrc);$(HuaTodoWebPkgJson)" Outputs="$(WebRoot)/index.html"` 支持增量；Node/npm 不存在时只 Warning 不阻塞 API 层 build |
 
 ---
 
@@ -185,6 +233,9 @@ Hua.Todo v1.3.0 版本聚焦于三个核心能力的升级：
 | LLM API（AI 拆分） | 待确认 | Host 端调用 |
 | 浏览器 MediaRecorder API | 已就绪 | 前端录音 |
 | 工单 02 LlmClientService | 待实现 | 会议拆分复用 |
+| 工单 05 前置（缺口 D） | 待完成 | 建议先还原 `CloudSyncEndpointExtensions.cs`（MapCloudSyncProxySettings），再推 06 Program.cs 集成 |
+| Node.js + npm（构建机器） | 外部依赖 | 构建 Hua.Todo.Web 必备；缺失时 Host csproj Target 仅 Warning |
+| 01-项目架构.md §3 模式 B 端点划分表 | 已固化 | 本批次工单 05/06 的对齐基准 |
 
 ---
 
@@ -199,9 +250,25 @@ Hua.Todo v1.3.0 版本聚焦于三个核心能力的升级：
 | 会议录音文件过大 | 上传超时/存储压力 | 前端限制最长 2 小时；压缩音频格式 |
 | 浏览器 MediaRecorder 兼容性 | 部分平台录音不可用 | 降级提示使用文字输入 |
 | STT 转写准确率不足 | 会议纪要质量差 | 转写后支持用户编辑修正 |
+| **工单 05 风险：架构文档与代码路径反复漂移** | 后续智能体又按旧路径改错文件 | 05 验收完成后，01-项目架构.md §2 ASCII 图顶部加"最后一次代码对齐时间戳"；后续改架构章节必须更新时间戳 + 走 Glob 校验 |
+| **工单 05 风险：抽离 AddCloudSyncServer 时丢 using/命名空间** | Host 编译失败 | 改动范围严格控制在 CloudSync 两个文件；Program.cs 仅补 using；单步 build 验证后再提交 |
+| **工单 06 风险：MapFallbackToFile 覆盖 /api 或 /swagger** | API/Swagger 全 404 | 中间件顺序严格按 §5 固定模板；集成测试同时验证 `/`、`/settings`（fallback）、`/api/cloud-sync/probe`（DynamicApi）、`/swagger`（Swagger UI）四个端点 |
+| **工单 06 风险：CI 环境 npm 网络差/无 Node** | publish 超时或失败 | MSBuild Target 加 Node 缺失检测 → Warning + 跳过；生产部署可在外层 CI 先 build 前端再 publish Host |
+| **工单 06 风险：增量构建 Inputs/Outputs 粗粒度** | 前端代码改了不重 build 或每次都重 build | Inputs 精确到 `**/*.{ts,vue,css,html}` + `package.json`；Outputs 精确到 `wwwroot/index.html`，首次过 CI 后人工改一行 .vue 验证是否触发 rebuild |
 
 ---
 
+## 补充工单（追加于 2026-08-08）
+
+### 工单 10 - 数据库初始化默认管理员
+
+- **目标**：Host 服务端 DB Migrate 完成后自动创建默认管理员账号，免去手动调用 Bootstrap API
+- **范围**：仅 `Hua.Todo.Host`；嵌入式模式（MAUI/Avalonia）不涉及
+- **关联**：作为 06.1 服务端安全设计 Bootstrap 的自动前置项；与现有 `BootstrapAdmin` API 共存
+- **详见**：[10-数据库初始化默认管理员.md](10-数据库初始化默认管理员.md)
+---
+
 **创建日期**：2026-06-15
-**修订日期**：2026-06-16
+**修订日期**：2026-08-08
 **版本**：v1.3.0
+**修订说明（2026-08-08）**：新增架构对齐补充工单 05/06（01-项目架构.md §3 模式 B 端点划分表与代码实际不一致触发）；所有新增条目均以"追加末尾"形式写入，未改动 2026-06-16 版本已有表格行和章节结构（符合 04-研发工单全流程规范 §2.1 已有文件不可触碰）。