管理工单公共对象

字段来自当前冻结模型的 JSON 标签;标记“可省略”与值为 null 分开。GitHub 执行者/工作区/有效角色、载荷哈希和租约属于内部字段,不进入返回对象。

FeedbackTicket

字段

类型

说明

id

string

对象 ID。

ticket_no

string / null

反馈编号,可为 null。

account_id

string

提交工单的产品主体 ID。

uc_account_id

string / null

创建时保存的 UC 账号事实,可为 null;不是本次管理员的账号。

user_info

object / null,可省略

管理员读取时从当前身份目录投影的提交者信息;可省略,未持久化在工单中。

title

string / null

标题;工单可为 null。

description

string / null

问题描述,可为 null。

expected_behavior

string / null

期望行为,可为 null。

actual_behavior

string / null

实际行为,可为 null。

reproduction_steps

string / null

复现步骤,可为 null。

suggested_priority

string / null

用户建议优先级,可为 null,不承诺已分诊。

status

string

工单状态 submitted、processing 或 closed。

admin_reply

string / null

管理员回复,可为 null;空字符串与 null 不同。

created_at

string

创建时间,RFC 3339。

updated_at

string

更新时间,RFC 3339。

messages

object(对象数组),可省略

可选对话记录;列表未加载,详情空集合因 omitempty 可省略。

github_issue

object / null,可省略

可选主 GitHub Issue 请求;列表、详情与更新均可带该关联。

reward_event

object / null,可省略

可选奖励审批事实;列表当前未加载,详情与更新按存在与否返回。

FeedbackMessage

字段

类型

说明

sequence

integer

对话记录顺序。

role

string

user 或 assistant。

content

string

对话文本。

created_at

string

创建时间,RFC 3339。

FeedbackUserInfo

字段

类型

说明

name

string

当前目录显示名。

accounts

object(对象数组)

当前目录账号项数组。

FeedbackAccount

字段

类型

说明

type

string

目录账号类型,例如 email。

value

string

目录账号值,注意访问与证据脱敏。

FeedbackRewardEvent

字段

类型

说明

id

string

对象 ID。

event_type

string

审批事件类型 feedback.reward_approved。

source_type

string

来源类型 feedback_ticket。

source_id

string

关联的工单 ID。

subject_uc_account_id

string

被审批的提交者 UC 账号。

approved_by

string

首次审批的管理员主体 ID。

occurred_at

string

首次审批发生时间,RFC 3339。

delivery_status

string

pending 或 granted;审批成功不等于已发放。

attempt_count

integer

对应异步处理尝试次数。

last_attempt_at

string / null

最近尝试时间;未发生时为 null。

last_error

string / null

最近错误文本,可为 null。

billing_transaction_id

string / null

消费方账务关联 ID,可为 null。

granted_at

string / null

发放时间,可为 null。

created_at

string

创建时间,RFC 3339。

updated_at

string

更新时间,RFC 3339。

FeedbackRewardApprovalResult

字段

类型

说明

ticket

object

审批后重新读取的工单。

reward_event

object

当前工单唯一的奖励审批事实;不包含金额或活动规则。

FeedbackTicketList

字段

类型

说明

github_issue_creation_available

boolean

部署已配置创建工作区时为 true;不是完整执行链健康或权限验证。

items

object(对象数组)

当前页工单数组,可为空。

total

integer

符合筛选条件的工单总数。

limit

integer

当前页数量上限。

offset

integer

当前偏移量。

FeedbackGitHubIssue

字段

类型

说明

ticket_id

string

关联工单 ID。

kind

string

bug、feature 或 auto;创建策略,不等同最终 GitHub Type。

status

string

pending、creating、created 或 failed;与工单 status 独立。

draft_title

string

已冻结的请求标题。

draft_body

string

已冻结且规范化的请求正文。

request_id

string

本次创建尝试标识;重试可产生新值。

requested_by

string

请求创建的管理员主体。

attempt_count

integer

对应异步处理尝试次数。

last_attempt_at

string / null

最近尝试时间;未发生时为 null。

issue_number

integer / null

创建回执中的 Issue 编号,未创建时为 null。

issue_url

string / null

创建回执中的 Issue 地址,未创建时为 null。

created_by

string

创建成功时记录的请求者主体,未完成可为空字符串。

issue_created_at

string / null

收到创建回执的时间,未完成时为 null。

last_error_code

string

安全错误代码;未发生可为空字符串。

created_at

string

创建时间,RFC 3339。

updated_at

string

更新时间,RFC 3339。

FeedbackGitHubIssueDraft

字段

类型

说明

kind

string

bug、feature 或 auto;创建策略,不等同最终 GitHub Type。

template

string

当前模板标识 moi-bug、moi-feature 或 moi-auto。

title

string

生成的草稿标题,包含当前类型的前缀。

body

string

生成的 Markdown 草稿正文,需人工核对;不包含完整工单对话。

sensitive_findings

string(字符串数组)

检测到的类别数组;当前已知 token、credential、temporary_url、personal_data、business_data,不代表穷尽所有敏感内容。

查询与投影

列表按 created_at、id 倒序,total 是过滤后的总量,offset 为普通偏移,持续写入时不是快照分页。search 对标题、描述、期望、实际和复现做 LIKE 包含匹配(转义通配字符),并匹配 account_id 等值或目录查出的 UC/产品主体集合;不承诺覆盖 ticket_no、消息、管理员回复或所有账号字段。目录不可用可使管理查询失败。

列表加载当前 GitHub 关联并投影当前提交者信息,但不加载完整对话或奖励事件;详情加载消息、GitHub 和奖励关联,并投影当前目录信息;更新返回加载关联后的工单,但没有当前目录投影。user_info 为可选当前目录信息,不是创建时快照。

工单状态与 github_issue.status、reward_event.delivery_status 分开。关闭工单不自动创建 Issue 或批准奖励,审批事件存在也不证明发放。created_by/requested_by/approved_by 各有归属,不能统一写成当前用户。

历史账号在目录中不存在时,user_info 可省略,读取不因此失败;目录请求或依赖出错则继续返回错误,不能把两者合并为“无提交者”。当前账号投影可含 email、phone、github;邮箱只在 UC 已验证时加入,账号数组无项时为空数组,姓名缺失时当前回退为“-”。

最后更新于