# 管理工单公共对象

字段来自当前冻结模型的 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 已验证时加入，账号数组无项时为空数组，姓名缺失时当前回退为“-”。
