Skip to content

feat: 支持工时日志(effort)模块的查询、登记、编辑与删除 #16

Description

@shixiaoding

问题描述

当前 CLI(0.2.0)及底层 zentao-api SDK 均未注册 effort(工时日志)模块,无法通过 CLI 对工时记录进行查看、登记、编辑或删除。

工时日志目前唯一的产生途径是任务状态流转附带生成(task start / task finish),历史工时记录一旦登记有误(工作内容写错、剩余工时漏填等),CLI 无任何修正手段,只能回到 web 端手工处理。

使用场景

研发效能管理场景下,工程师及 AI Agent 需要:

  1. 查看任务已登记的工时记录列表(谁、哪天、耗时多少、剩余多少、工作内容)
  2. 在任务中途随时登记工时,而不必依赖 start/finish 状态流转
  3. 修正历史工时记录(工作内容、耗时、剩余工时)
  4. 删除误登记的工时记录

实测验证

# CLI 0.2.0
$ zentao ls effort --task 25146
Error(E2001): 未找到指定的模块 effort,请通过 `zentao help` 查看支持的模块

$ zentao create effort ...
Error(E2001): 未找到指定的模块 effort
  • task 模块全部 action 仅 activate / close / finish / start,无 recordEffort / editEffort / deleteEffort
  • zentao-api SDK(0.4.1)模块注册表中无 effort 相关定义
  • task finish 命名参数仅 currentConsumed / consumed / realStarted / finishedDate / comment,无 left(剩余工时)字段,显式填写剩余工时只能依赖 --data 透传,且服务端是否采纳无法确认

期望

按优先级排序,任一实现即可解决核心痛点:

  1. 新增 effort 模块:支持 ls / get / create / update / delete,与 web 端「任务 → 工时」能力对齐(禅道 web 端已具备完整工时管理,说明服务端数据模型与操作入口是现成的)
  2. 或在 task 模块增加扩展操作recordEffort(登记)、editEffort(编辑)、deleteEffort(删除)、efforts(列表)
  3. start / finish 支持显式 left 参数:登记工时时可明确填写剩余工时,而非依赖服务端自动清零

环境

  • zentao-cli: 0.2.0(当前最新稳定版,CHANGES.md 至 Unreleased 均无 effort 相关记录)
  • zentao-api: 0.4.1
  • 禅道服务端: BIZ 12.7.1

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions