# GitCandy 功能清单 > 版本：v1.0 | 日期：2026-07-20 | 来源：代码扫描重建 本文档追踪 GitCandy 各功能点的实现/测试/注释三维状态。 --- ## 拆分决策表 | 需求项（从代码推断） | 原因 | 拆分结果 | |-------------------|:----:|---------| | 用户管理 | 前后端 | USER-1a 用户管理接口 + USER-1b 用户管理页面 | | 仓库管理 | 前后端 | REPO-1a 仓库管理接口 + REPO-1b 仓库管理页面 + REPO-2 仓库浏览页面 | | 团队管理 | 前后端 | TEAM-1a 团队管理接口 + TEAM-1b 团队管理页面 | | 用户团队关联 | 前后端 | TEAM-2a 用户团队关联接口 + TEAM-2b 用户团队关联页面 | | 用户仓库关联 | 前后端 | REPO-3a 用户仓库关联接口 + REPO-3b 用户仓库关联页面 | | Git操作日志 | 前后端 | HIST-1a Git操作日志记录 + HIST-1b Git操作历史查看 | | 系统配置 | 前后端 | SYS-1a 系统配置接口 + SYS-1b 系统配置页面 | --- ## 功能清单 ### SYS — 系统基础 | 编码 | 功能 | 实现 | 测试 | 注释 | 说明 | |------|------|:--:|:--:|:--:|------| | SYS-1a | 系统配置管理接口 | ✅ | 🟡 | ✅ | `GitController : ConfigController<GitSetting>` — Areas/GitCandy/Controllers/GitController.cs:11; E2E 页面验证通过（ConfigController 需完整 Web 环境自动化测试） | | SYS-1b | 系统配置管理页面 | ✅ | ✅ | — | Cube ConfigController 自带UI; E2E 验证通过 | | SYS-2 | 用户自动同步 | ✅ | 🟡 | ✅ | `CandyControllerBase.OnActionExecuting` — Controllers/CandyControllerBase.cs:33; 中 `User.GetOrAdd` — Controllers/CandyControllerBase.cs:47; E2E 登录验证通过（需 Cube 认证上下文自动化） | | SYS-3 | 首页与语言切换 | ✅ | ✅ | ✅ | `HomeController` — Controllers/HomeController.cs:8; E2E 验证通过 | ### USER — 用户管理 | 编码 | 功能 | 实现 | 测试 | 注释 | 说明 | |------|------|:--:|:--:|:--:|------| | USER-1a | 用户管理接口（Cube CRUD） | ✅ | 🟡 | ✅ | `UserController : EntityController<User>` — Areas/GitCandy/Controllers/UserController.cs:10; Biz 层 UserTests + E2E 页面验证通过 | | USER-1b | 用户管理页面（Cube UI） | ✅ | ✅ | — | Cube EntityController 自带UI; E2E 验证通过 | | USER-2 | 用户账号页面（查看/搜索） | ✅ | 🟡 | ✅ | `AccountController` — Controllers/AccountController.cs; `User.Search`/`GetOrAdd` 有单元测试 | | USER-3 | Web用户认证 | ✅ | 🟡 | ✅ | `CandyControllerBase` + `AccountService` — AccountService.Login 有单元测试 | | USER-4 | 用户注册与创建 | ✅ | ✅ | ✅ | `User.Create` — Entity/Entity/用户.Biz.cs; 含重复名/重复邮箱异常测试 | ### TEAM — 团队管理 | 编码 | 功能 | 实现 | 测试 | 注释 | 说明 | |------|------|:--:|:--:|:--:|------| | TEAM-1a | 团队管理接口（Biz） | ✅ | ✅ | ✅ | `User.CreateTeam/SearchTeam` — Entity/Entity/用户.Biz.cs; 含重复团队名异常测试 | | TEAM-1b | 团队管理页面 | ✅ | 🟡 | ✅ | `TeamController` — Controllers/TeamController.cs; 后端 MembershipService 有单元测试 | | TEAM-2a | 用户团队关联接口（Cube CRUD） | ✅ | ✅ | ✅ | `UserTeamController : EntityController<UserTeam>` + Biz 方法已补注释; 含 CRUD 单元测试 | — Areas/GitCandy/Controllers/UserTeamController.cs:8 | | TEAM-2b | 用户团队关联页面（Cube UI） | ✅ | ✅ | — | Cube EntityController 自带UI; E2E 验证通过 | | TEAM-3 | 团队成员选择 | ✅ | 🟡 | ✅ | `TeamController.ChooseUser`; 后端 TeamAddUser/RemoveUser 有单元测试 | ### REPO — 仓库管理 | 编码 | 功能 | 实现 | 测试 | 注释 | 说明 | |------|------|:--:|:--:|:--:|------| | REPO-1a | 仓库管理接口（Cube CRUD） | ✅ | ✅ | ✅ | `RepositoryController : EntityController<Repository>` — Areas/GitCandy/Controllers/RepositoryController.cs:10; `Repository` Biz Search/FindByID/GetPublics 有单元测试 | | REPO-1b | 仓库管理页面（Cube UI） | ✅ | ✅ | — | Cube EntityController 自带UI; E2E 验证通过 | | REPO-2 | 仓库浏览页面（创建/编辑/删除/详情） | ✅ | 🟡 | ✅ | `RepositoryController` (Web); 后端 RepositoryService 有单元测试（Create/Update/Delete/权限） | | REPO-3a | 用户仓库关联接口（Cube CRUD） | ✅ | ✅ | ✅ | `UserRepositoryController : EntityController<UserRepository>` + Biz 方法已补注释; 含 CRUD 单元测试 + E2E 验证 | | REPO-3b | 用户仓库关联页面（Cube UI） | ✅ | ✅ | — | Cube EntityController 自带UI; E2E 验证通过 | | REPO-4 | 仓库协作管理 | ✅ | 🟡 | ✅ | `RepositoryController.Coop/ChooseUser/ChooseTeam`; 后端权限检查有单元测试 | | REPO-5 | 仓库列表浏览 | ✅ | ✅ | ✅ | `RepositoryController.Index`; 单元测试 + E2E 验证通过 | ### GIT — Git核心服务 | 编码 | 功能 | 实现 | 测试 | 注释 | 说明 | |------|------|:--:|:--:|:--:|------| | GIT-1 | Git Smart HTTP传输 | ✅ | ❌ | ✅ | `GitController` — Controllers/GitController.cs:36 + Git/GitService.cs; 需 git-core + 运行中 Web 服务器集成测试 | | GIT-2 | 代码树浏览 | ✅ | ✅ | ✅ | `RepositoryController.Tree` — Controllers/RepositoryController.cs; GitService GetTree 集成测试 | | GIT-3 | 文件内容查看（Blob/Raw） | ✅ | 🟡 | ✅ | `RepositoryController.Blob/Raw` — Controllers/RepositoryController.cs; GetBlob 需缓存基础设施（标记 Skip） | | GIT-4 | 提交历史浏览 | ✅ | ✅ | ✅ | `RepositoryController.Commits/Commit`; GitService GetCommits/GetCommit 集成测试 | | GIT-5 | 分支管理 | ✅ | ✅ | ✅ | `RepositoryController.Branches`; GitService GetBranches/GetHeadBranch 集成测试 | | GIT-6 | 标签管理 | ✅ | ✅ | ✅ | `RepositoryController.Tags`; GitService GetTags 集成测试 | | GIT-7 | 代码归档下载 | ✅ | ❌ | ✅ | `RepositoryController.Archive` + `ArchiverAccessor` — Controllers/RepositoryController.cs + Git/ArchiverAccessor.cs; 需真实 Git 仓库集成测试 | | GIT-8 | Blame代码审阅 | ✅ | ✅ | ✅ | `RepositoryController.Blame` + `BlameAccessor`; GitService GetBlame 集成测试 | | GIT-9 | 贡献者统计 | ✅ | 🟡 | ✅ | `RepositoryController.Contributors` + `ContributorsAccessor`; 统计需缓存基础设施（标记 Skip） | | GIT-10 | 分支差异比较 | ✅ | ✅ | ✅ | `RepositoryController.Compare` + `HistoryDivergenceAccessor`; GitService GetCompare 集成测试 | | GIT-11 | 仓库统计信息 | ✅ | ✅ | ✅ | `RepositorySizeAccessor`/`LastCommitAccessor`/`SummaryAccessor`; ScopeAccessor 通过 GetTree 集成测试 | ### HIST — 操作历史 | 编码 | 功能 | 实现 | 测试 | 注释 | 说明 | |------|------|:--:|:--:|:--:|------| | HIST-1a | Git操作日志记录 | ✅ | ✅ | ✅ | `GitHistory` 实体 + `GitHistory.Biz` — Entity/Entity/Git历史.Biz.cs; 含 CRUD/Search 单元测试 | | HIST-1b | Git操作历史查看（Cube UI） | ✅ | ✅ | ✅ | `GitHistoryController : ReadOnlyEntityController<GitHistory>`; E2E 验证通过 | --- ## 统计 | 统计项 | 数量 | 占比 | |--------|:----:|:----:| | 功能点总数 | 34 | — | | 实现 ✅ | 34 | 100% | | 测试 ✅ | 23 | 67.6% | | 测试 🟡 | 5 | 14.7% | | 测试 ❌ | 6 | 17.6% | | 注释 ✅ | 29 | 85.3% | | 注释 🟡 | 0 | 0% | | 注释 ❌ | 0 | 0% | | 注释 —（无可注释API） | 5 | 14.7% | > **项目完成度**：2026-07-20 全量审计 + 修复完成。实现 34/34 ✅（100%），注释 29/29 代码项 ✅（100%），测试覆盖 23/34 ✅（67.6%）。跨越四个测试层次：单元测试（Biz）→ SQLite 集成测试（Service）→ 真实 Git 仓库集成测试 → E2E 浏览器测试。剩余 6 项 ❌ 需 Web 框架/git-core 环境方可自动化。详见 `Doc/需求文档.md` 和 `Doc/架构设计.md`。 --- ## 🧊 暂缓/已排除 | 编码 | 功能 | 状态 | 说明 | |------|------|:--:|------| | — | SSH密钥管理 | ❌ 已排除 | `SshKey` 实体被 `.csproj` Compile Remove 排除 | | — | 认证日志管理 | ❌ 已排除 | `AuthorizationLog` 实体被 `.csproj` Compile Remove 排除 | | — | 性能分析器 | ❌ 已排除 | `Base/Profiler.cs` 被 `.csproj` Compile Remove 排除 | | — | 配置/安全模块 | ❌ 已排除 | `Configuration/` 和 `Security/` 目录被 `.csproj` Compile Remove 排除 |