FR-192.A-1 Agent 新模組 feedback：表、新增／清單／單筆、主控台 API、outbox 類型與保序、類別選項套用者（evidence-agent）

本卡屬 FR-192（母卡 FR-192 母案（同清單上一張）），卡 A-1，批 2。只改 evidence-agent。依賴：P-1。

這張卡做什麼（白話）

Agent 這邊「意見回饋」功能的本體：一張本機表存回饋、一組函式負責新增與查自己的、一組主控台 API 給前端打，加上把回饋排進既有的「待回傳佇列」等連上主系統再送。整個照「執行紀錄」那套機制的形狀長（本機先存、心跳補送、同步狀態三態），新模組叫 feedback。這張卡只做新增、清單、單筆；修改、刪除、主系統回拉在 A-3。類別下拉的選項由主系統設定通道下發，本卡也接這一類。

reuse／extend／new

new（新模組，照型）：表欄位與 app 函式簽名照 scan/app/local_runs.py（_insert／record_sync／list_page／get）；console API 照 console/api/runs_routes.py（清單、404 不分查無與非本人、resend）；附件 reuse files/app/blob_ops.save_upload；extend：outbox 加 KIND_FEEDBACK 進 _NEVER_DROP／_ORDERED／SENDABLE，批次送 FEEDBACKS_PATH 照 _post_local_runs

在哪裡

repo：~/Projects/Billows/Audit-Manager/evidence-agent
改既有：guidant_agent/sync/ports/result_outbox.py（KIND_FEEDBACK）
改既有：guidant_agent/sync/app/outbox.py（三個集合＋`_post_feedbacks`）
改既有：guidant_agent/platform/registry.py（MODULES 加 feedback：migrations、config、register）
改既有：guidant_agent/shared/event_codes.py（AGENT_FEEDBACK_CREATED／SYNCED／SYNC_FAILED）
改既有：common/code/（新 ConsoleFeedbackErrorCode 檔）
新開：guidant_agent/feedback/__init__.py
新開：guidant_agent/feedback/migrations.py（新版號：feedbacks 表）
新開：guidant_agent/feedback/app/feedbacks.py（create／list_mine／get／record_sync）
新開：guidant_agent/feedback/app/labels.py（KIND_FEEDBACK_LABELS 套用者＋options()）
新開：guidant_agent/feedback/adapters/feedback_repo.py（SQL 只在這）
新開：guidant_agent/feedback/api/feedback_routes.py（GET list／GET one／POST／POST resend／GET labels）
新開：test/feedback/test_feedbacks.py

怎麼做

① 新模組 guidant_agent/feedback/，目錄照 netdiag（app/、adapters/、api/、migrations.py、__init__.py）；platform/registry.py 的 MODULES 加一項（migrations、config、register 三個申報都要）。依賴方向 console → feedback → platform，入列走 sync/ports/result_outbox.py 的 port，🔴 不 import sync/app/outbox.py。
② migrations.py：新版號一步建 feedbacks 表，欄位照 design §5.1 那張表（列舉不下 CHECK、時間 DATETIME、JSON 存 TEXT，與 console/migrations.py 同寫法）。
③ app/feedbacks.py：create(title, description, type_label_uid, files, created_by)——附件逐檔 files.app.blob_ops.save_upload(file, created_by) 拿 uid／sha256／size／mimetype 寫進 files JSON（where=agent）→ adapters/feedback_repo.insert → outbox.enqueue(KIND_FEEDBACK, uid, "create", payload)；list_mine(sub)、get(uid, sub)（非本人回 None，route 回 404）；record_sync(conn, uids, error) 簽名照 scan/app/local_runs.py 第 288 行。payload 形狀照 design §5.2。
④ app/labels.py：設定類 KIND_FEEDBACK_LABELS 的套用者（照 netdiag 或 scan 既有 config 套用者形狀，寫 platform 的 kv）；options() 回 [{uid, name}]。
⑤ sync/ports/result_outbox.py 加 KIND_FEEDBACK；sync/app/outbox.py：_NEVER_DROP、_ORDERED、SENDABLE 三個集合加它；_post_feedbacks(items, channel, out) 照 _post_local_runs 批次送 FEEDBACKS_PATH，回應 accepted settle、rejected 標 sync_error；🔴 _ORDERED 既有語意是「各 kind 各排各的」，本案要「同一 uid 內保序」，看 _ordered_heads_waiting 的 key 要不要加 uid，實測後回寫。stale 分支留給 A-3。
⑥ api/feedback_routes.py（掛 console blueprint，require_session() 不帶 scope）：GET /console/api/feedbacks、GET /console/api/feedbacks/<uid>、POST /console/api/feedbacks（multipart：json 欄＋file 多檔；🔴 guard 已把 stream 讀進 g.console_body，multipart 要照 license_routes.py 第 62 行的做法自己解）、POST /console/api/feedbacks/<uid>/resend（照 runs_routes.resend_run）、GET /console/api/feedback-labels。error code 新檔 common/code/console_feedback_error_code.py。
⑦ shared/event_codes.py 加 AGENT_FEEDBACK_CREATED／SYNCED／SYNC_FAILED（號碼接現有最大＋1，回寫列出）；稽核照 runs_routes 的 audit(logger, …) 寫法。
⑧ 新檔要被 .claude/rules/security/ 某支的 paths 命中（test_security_rules_cover_sources.py），沒命中就補進最接近那支。

驗收（首腦照這個驗）

守衛六支綠（含 test_security_rules_cover_sources.py 新檔都被命中）；主控台 POST /console/api/feedbacks multipart 建一筆，GET /console/api/feedbacks 只回本人的，換另一個 session 打單筆 404；outbox 表多一列 kind=feedback；同一 uid 入列 create 再 update，drain 時 create 沒送成 update 不送（test）；離線時 resend 回 409；設定類 feedback_labels 套用後 GET /console/api/feedback-labels 回三個

必讀

設計：~/Projects/Billows/Audit-Manager/compliance-manager-be/docs/features/FR-192-2611-agent-console-feedback/design.md §3 決策定案、§5 詳細設計（本卡那節）、§6 拆卡表本卡那列、§8 風險；討論稿 discussion.md §4 只在想知道「為什麼這樣裁」時看