FR-119 盤點：主專案未掃清單重數與切棒

盤點日期 2026-09-24｜盤點卡 CM-2140（母卡 CM-2139）｜這份文件只盤點、不掃描——切好棒等首腦決定要不要開卡派工。 行數全部是 wc -l 逐檔實算。基準：BE feature/review commit 3ef11c640（工作區有平行 session 未 commit 的改動，都在 docs/，不影響程式檔行數）。

名詞先講清楚（讀者是 PM 與新手工程師）：

• 主專案：BE repo 本身的程式（不含 21 支 jedi-* 套件）。正式程式的算法是 git ls-files -- '*.py' | grep -v -E '^(test|tests|scripts|docs|migrations)/'，共 826 支、87,324 行。
• 掃過：掃描工具實際把這支檔讀進去、而且三人檢查面板有跑完（驗證章 verified）。
• 部分掃過：工具讀過，但面板沒跑完（沒驗證章）。這種檔「讀過」但不能當作掃乾淨。
• 沒碰：125 輪裡沒有任何一輪把它排進範圍。
• 一棒：派給一個 session 跑一次掃描工具的份量，上限 2,000 行、30 檔。

1. 數字：826 支裡 380 支（56,131 行）掃過、21 支（3,237 行）部分掃過、425 支（27,956 行）沒碰。沒碰的 425 支裡，真正有判斷邏輯、該掃的是 119 支、17,511 行；其餘是純宣告（258 支）、DI 組裝（38 支）、離線小工具（10 支）。
2. 切成 12 棒（U1～U12），每棒 709～1,908 行、6～20 檔，全部在 2,000 行／30 檔以內。加上「DI 組裝專掃」一棒（U13，17 檔 2,840 行，要再切成兩半）＝13～14 棒。
3. 🔴 權限檢查的共用那一層（common/authz/）有 9 支從來沒被掃過。先前 FR-115 盤點寫「common/authz/ 全專案共用守門本體，FR-085 C1 已掃」——這句不成立：FR-085 C1 掃的是 jedi-common 套件的 session／identity／handler，不是主專案的 common/authz/。stamp 顯示主專案這層只有 project.py／ssp.py／workflow.py 三支被別棒順帶讀過；license.py（367 行，授權檔功能開關）、sharing.py、__init__.py（180 行，決策表）等 9 支沒人讀過。建議排第一棒（U1）。
4. 🔴 「每個請求都經過」的中介層還有兩支沒碰：common/middleware/jwt_mw.py、common/middleware/license_readonly_mw.py（217 行，授權到期時的唯讀閘門），加上 core/app_factory.py（469 行，把中介層與路由組起來的地方）。總表第 154 項（唯一不必登入就能讓全產品停擺）就是在同一個目錄抓到的。建議排第二棒（U2）。
5. 最大一塊是「Google 雲端硬碟整合」（cloud_integration），51 支 6,000 多行完全沒碰，其中背景同步那半（U5／U6）守門字眼是 0——它不接網址，是 Google 通知回呼＋背景工作在跑，工具要看的是「回呼憑什麼信任」與「背景工作用誰的身分動誰的資料」。

1.1 已掃範圍怎麼算的（三個來源）

兩個容易看錯的地方：

• FR-085 C1～C3 是套件棒：掃的是 jedi-common 的 session/、logger/、utils/，報告裡提到的主專案檔（request_context_mw.py、app_mw.py、redis_client_util.py）是 runner「越界核對」讀的，不算掃過。前兩支後來由 FR-115 W5／W7 正式掃了；redis_client_util.py 仍是沒碰。
• 2026-07 那批（security-scan-2607/）是 Semgrep 規則掃描，不是同一種工具，不算入本表。
• 另外 FR-087 T1 是人工查資料庫，沒有讀程式的範圍，不算入。

1.2 「部分掃過」是哪 21 支

全部來自 FR-113 的三棒面板沒跑完：

建議：這 21 支不另開棒——O9b 那 12 支裡 reconciliation/ 五支＋party_reconciliation_service.py 是「把 Word 裡的人名對到系統使用者」，是 FR-113 O9b 報告點名沒查完的「跨公司比對」；若決策者要補，可以併進 U12（零散殘段，709 行）帶入，約 +400 行、合計約 1,110 行，不破上限（併進 U9 會超過 2,000 行）。

1.3 沒碰的 425 支怎麼分三堆

判準照 FR-118 盤點：函式裡有 if／for／while／try／推導式，或有資料庫查詢組裝，才算「判斷邏輯」（用 Python AST 逐檔算，不是看檔名）。

1.4 已裁不掃

• jedi-task-platform 剩 108 檔（套件側，不在 BE repo）——與本盤點無關。
• 主專案側沒有任何「裁不掃」的區塊。但以下兩支在 FR-115 盤點被寫成「屬任務平台（FR-095）地盤、FR-095 裁停在三棒所以沒掃」：job_import_service.py、job_batch_complete_service.py、job_route.py。FR-095 H2（CM-1783）從來沒派。本盤點把它們排進 U7，是否要掃要決策者確認（見第 7 節）。

每棒 ≤2,000 行、≤30 檔。沒有任何一支檔超過 1,000 行（最大 core/scheduler.py 550 行），所以沒有「單檔一棒」。中文註解密度最高的是 U3（每字元約 18% 是中文），但也只有 930 行，不用再壓。

（「守門字眼」＝grep -c 'require_\|assert_\|_check_'，「函式」＝grep -c 'def [a-z]'，照卡片口徑。0 不等於沒守門——有些守門在上一層或用 @jwt_required，但 0 的棒要特別看「這些方法被誰呼叫、呼叫前有沒有人檢查」。）

接縫（刻意重疊或越界讀、不報）

• U1 ↔︎ 全部：每棒研究員都會追進 common/authz/，只有 U1 報它本身的問題。
• U4 ↔︎ U5 ↔︎ U6：三棒共用 tenant_drive_integration（授權紀錄），U4 報「存與取」，U5／U6 讀它只為了知道背景工作用哪把授權。drive_project_verify_service.py（FR-095 H1 已掃）三棒都可讀不報。
• U7 ↔︎ U8：task_existence_query.py 放 U8；U7 會讀。job_service.py（FR-115 W2 已掃）U7 可讀不報。
• U2 ↔︎ U3：core/app_factory.py 放 U2；U3 要追「安裝精靈的路由是怎麼繞過中介層的」會讀它。
• U10 ↔︎ U11：diag_bundle_app_service.py 放 U10，是 U11 七支收集器的唯一呼叫者。

2.1 各棒檔案清單與驗證指令

行數旁邊的「守門字眼」是該檔 require_|assert_|_check_|jwt_required|ForbiddenError|_require 的出現次數，0 的要特別看。

U1 — 權限檢查共用層（common/authz）＋共用小工具（15 檔／1,132 行）

common/authz/__init__.py                                                          180   守門字眼 45
common/authz/admin.py                                                              12   守門字眼 3
common/authz/capability.py                                                         22   守門字眼 3
common/authz/decorators.py                                                         11   守門字眼 6
common/authz/license.py                                                           367   守門字眼 17
common/authz/menu_license_filter.py                                                76   守門字眼 0
common/authz/platform.py                                                           11   守門字眼 3
common/authz/sharing.py                                                            35   守門字眼 4
common/authz/signed_token.py                                                       22   守門字眼 3
common/iam_ports.py                                                               100   守門字眼 0
common/util/round_guard.py                                                         46   守門字眼 3
common/util/ssp_resource_name_dup.py                                               56   守門字眼 0
common/util/common_util.py                                                         65   守門字眼 0
common/util/redis_client_util.py                                                   79   守門字眼 0
common/util/resource_path.py                                                       50   守門字眼 0

驗證（預期 15 檔／1,132 行）：

git ls-files -- common/authz/__init__.py \
  common/authz/admin.py \
  common/authz/capability.py \
  common/authz/decorators.py \
  common/authz/license.py \
  common/authz/menu_license_filter.py \
  common/authz/platform.py \
  common/authz/sharing.py \
  common/authz/signed_token.py \
  common/iam_ports.py \
  common/util/round_guard.py \
  common/util/ssp_resource_name_dup.py \
  common/util/common_util.py \
  common/util/redis_client_util.py \
  common/util/resource_path.py | xargs wc -l | tail -1

U2 — 啟動與中介層（每個請求都經過的那層）（6 檔／1,233 行）

common/middleware/jwt_mw.py                                                        46   守門字眼 0
common/middleware/license_readonly_mw.py                                          217   守門字眼 10
core/app_factory.py                                                               469   守門字眼 0
core/host_capabilities.py                                                          76   守門字眼 1
main.py                                                                           302   守門字眼 3
config/config_loader.py                                                           123   守門字眼 4

驗證（預期 6 檔／1,233 行）：

git ls-files -- common/middleware/jwt_mw.py \
  common/middleware/license_readonly_mw.py \
  core/app_factory.py \
  core/host_capabilities.py \
  main.py \
  config/config_loader.py | xargs wc -l | tail -1

U3 — 首次安裝精靈＋版本資訊（登入前就打得到）（9 檔／930 行）

api/setup/__init__.py                                                              22   守門字眼 0
api/setup/routes/setup_route.py                                                   128   守門字眼 8
app/setup/service/setup_wizard_service.py                                         395   守門字眼 6
common/setup/setup_token.py                                                       113   守門字眼 0
infra/setup/setup_state_reader.py                                                  89   守門字眼 0
api/version/__init__.py                                                            19   守門字眼 0
api/version/routes/client_config_route.py                                          47   守門字眼 0
api/version/routes/version_route.py                                                29   守門字眼 0
common/util/app_version.py                                                         88   守門字眼 0

驗證（預期 9 檔／930 行）：

git ls-files -- api/setup/__init__.py \
  api/setup/routes/setup_route.py \
  app/setup/service/setup_wizard_service.py \
  common/setup/setup_token.py \
  infra/setup/setup_state_reader.py \
  api/version/__init__.py \
  api/version/routes/client_config_route.py \
  api/version/routes/version_route.py \
  common/util/app_version.py | xargs wc -l | tail -1

U4 — 雲端硬碟整合：設定、授權與金鑰（13 檔／1,786 行）

api/cloud_integration/__init__.py                                                  84   守門字眼 0
api/cloud_integration/routes/drive_app_credential_verify_route.py                  44   守門字眼 3
api/cloud_integration/routes/google_drive_integration_route.py                    140   守門字眼 11
api/cloud_integration/routes/google_drive_sync_route.py                           260   守門字眼 23
app/cloud_integration/service/drive_app_credential_verify_service.py               94   守門字眼 2
app/cloud_integration/service/drive_sync_admin_service.py                         164   守門字眼 2
app/cloud_integration/service/google_drive_integration_service.py                 288   守門字眼 2
app/system_config/service/google_drive_app_config_resolver.py                     224   守門字眼 0
domain/cloud_integration/service/google_drive_token_manager.py                    131   守門字眼 3
domain/cloud_integration/service/tenant_drive_integration_domain_service.py        65   守門字眼 1
infra/cloud_integration/crypto/fernet_crypto.py                                    18   守門字眼 0
infra/cloud_integration/google_drive/google_oauth_client.py                       180   守門字眼 0
infra/cloud_integration/repository/tenant_drive_integration_repo_impl.py           94   守門字眼 0

驗證（預期 13 檔／1,786 行）：

git ls-files -- api/cloud_integration/__init__.py \
  api/cloud_integration/routes/drive_app_credential_verify_route.py \
  api/cloud_integration/routes/google_drive_integration_route.py \
  api/cloud_integration/routes/google_drive_sync_route.py \
  app/cloud_integration/service/drive_app_credential_verify_service.py \
  app/cloud_integration/service/drive_sync_admin_service.py \
  app/cloud_integration/service/google_drive_integration_service.py \
  app/system_config/service/google_drive_app_config_resolver.py \
  domain/cloud_integration/service/google_drive_token_manager.py \
  domain/cloud_integration/service/tenant_drive_integration_domain_service.py \
  infra/cloud_integration/crypto/fernet_crypto.py \
  infra/cloud_integration/google_drive/google_oauth_client.py \
  infra/cloud_integration/repository/tenant_drive_integration_repo_impl.py | xargs wc -l | tail -1

U5 — 雲端硬碟整合：Google 回呼通知＋同步排程主幹（9 檔／1,838 行）

api/cloud_integration/routes/google_drive_webhook_route.py                         64   守門字眼 0
app/cloud_integration/service/google_drive_webhook_service.py                     127   守門字眼 0
app/cloud_integration/service/webhook_channel_manager.py                          202   守門字眼 1
app/cloud_integration/service/drive_sync_orchestration_service.py                 529   守門字眼 0
app/cloud_integration/service/drive_sync_worker.py                                149   守門字眼 0
app/cloud_integration/service/project_tree_loader.py                              171   守門字眼 0
domain/cloud_integration/service/drive_sync_job_domain_service.py                 104   守門字眼 0
infra/cloud_integration/repository/drive_sync_job_repo_impl.py                    191   守門字眼 0
infra/cloud_integration/google_drive/google_drive_api_client.py                   301   守門字眼 0

驗證（預期 9 檔／1,838 行）：

git ls-files -- api/cloud_integration/routes/google_drive_webhook_route.py \
  app/cloud_integration/service/google_drive_webhook_service.py \
  app/cloud_integration/service/webhook_channel_manager.py \
  app/cloud_integration/service/drive_sync_orchestration_service.py \
  app/cloud_integration/service/drive_sync_worker.py \
  app/cloud_integration/service/project_tree_loader.py \
  domain/cloud_integration/service/drive_sync_job_domain_service.py \
  infra/cloud_integration/repository/drive_sync_job_repo_impl.py \
  infra/cloud_integration/google_drive/google_drive_api_client.py | xargs wc -l | tail -1

U6 — 雲端硬碟整合：八支檔案搬移處理器（10 檔／1,758 行）

app/cloud_integration/service/handlers/archive_drive_file_handler.py              165   守門字眼 0
app/cloud_integration/service/handlers/create_folder_handler.py                    71   守門字眼 0
app/cloud_integration/service/handlers/import_drive_file_handler.py               264   守門字眼 0
app/cloud_integration/service/handlers/init_project_folders_handler.py            449   守門字眼 3
app/cloud_integration/service/handlers/process_drive_changes_handler.py           275   守門字眼 2
app/cloud_integration/service/handlers/reconcile_task_folder_handler.py           129   守門字眼 0
app/cloud_integration/service/handlers/rename_folder_handler.py                    59   守門字眼 0
app/cloud_integration/service/handlers/soft_delete_evidence_handler.py             42   守門字眼 0
domain/cloud_integration/service/drive_folder_mapping_domain_service.py           133   守門字眼 0
infra/cloud_integration/repository/drive_folder_mapping_repo_impl.py              171   守門字眼 0

驗證（預期 10 檔／1,758 行）：

git ls-files -- app/cloud_integration/service/handlers/archive_drive_file_handler.py \
  app/cloud_integration/service/handlers/create_folder_handler.py \
  app/cloud_integration/service/handlers/import_drive_file_handler.py \
  app/cloud_integration/service/handlers/init_project_folders_handler.py \
  app/cloud_integration/service/handlers/process_drive_changes_handler.py \
  app/cloud_integration/service/handlers/reconcile_task_folder_handler.py \
  app/cloud_integration/service/handlers/rename_folder_handler.py \
  app/cloud_integration/service/handlers/soft_delete_evidence_handler.py \
  domain/cloud_integration/service/drive_folder_mapping_domain_service.py \
  infra/cloud_integration/repository/drive_folder_mapping_repo_impl.py | xargs wc -l | tail -1

U7 — 任務入口與批次（任務增刪改查、Excel 批次匯入、批次完成、我的任務）（7 檔／1,908 行）

api/flow_control/routes/job_route.py                                              259   守門字眼 14
api/flow_control/serializers/job.py                                               417   守門字眼 6
app/flow_control/service/job_import_service.py                                    470   守門字眼 6
app/flow_control/service/job_batch_complete_service.py                            193   守門字眼 2
app/readmodel/service/my_jobs_app_service.py                                      117   守門字眼 0
infra/readmodel/tasks/my_grc_jobs_query.py                                        198   守門字眼 0
infra/readmodel/audit/flow_control_dashboard_repo_impl.py                         254   守門字眼 0

驗證（預期 7 檔／1,908 行）：

git ls-files -- api/flow_control/routes/job_route.py \
  api/flow_control/serializers/job.py \
  app/flow_control/service/job_import_service.py \
  app/flow_control/service/job_batch_complete_service.py \
  app/readmodel/service/my_jobs_app_service.py \
  infra/readmodel/tasks/my_grc_jobs_query.py \
  infra/readmodel/audit/flow_control_dashboard_repo_impl.py | xargs wc -l | tail -1

U8 — 流程背景作業（排程器、流程圖同步、孤兒清理、重新驗證繼承）（8 檔／1,716 行）

core/scheduler.py                                                                 550   守門字眼 4
app/flow_control/service/workflow_xml_sync_service.py                             246   守門字眼 10
app/flow_control/service/job_binding_orphan_cleanup_service.py                    174   守門字眼 0
infra/flow_control/repository/job_binding_orphan_query.py                         129   守門字眼 5
app/flow_control/service/reverify_inheritance_service.py                           73   守門字眼 0
infra/flow_control/repository/reverify_clone_query.py                             176   守門字眼 3
infra/flow_control/repository/task_execution_query.py                             292   守門字眼 0
infra/flow_control/task_existence_query.py                                         76   守門字眼 0

驗證（預期 8 檔／1,716 行）：

git ls-files -- core/scheduler.py \
  app/flow_control/service/workflow_xml_sync_service.py \
  app/flow_control/service/job_binding_orphan_cleanup_service.py \
  infra/flow_control/repository/job_binding_orphan_query.py \
  app/flow_control/service/reverify_inheritance_service.py \
  infra/flow_control/repository/reverify_clone_query.py \
  infra/flow_control/repository/task_execution_query.py \
  infra/flow_control/task_existence_query.py | xargs wc -l | tail -1

U9 — 專案摘要報告＋專案關聯表＋使用者／角色殘段（20 檔／1,658 行）

api/project_summary_report/__init__.py                                             43   守門字眼 0
api/project_summary_report/routes/project_summary_report_route.py                 170   守門字眼 7
api/project_summary_report/routes/project_summary_report_history_route.py          71   守門字眼 4
app/project_summary_report/service/project_summary_report_service.py              178   守門字眼 9
app/project_summary_report/service/project_summary_report_history_service.py       77   守門字眼 2
infra/project_summary_report/repository/project_summary_report_hitrosy_repo_impl.py   36   守門字眼 0
api/project/__init__.py                                                            88   守門字眼 0
api/project/routes/project_route.py                                                69   守門字眼 6
api/project/serializers/assessment_plan.py                                        148   守門字眼 0
app/associations/service/project_assessment_plan_mapping_service.py                67   守門字眼 0
app/associations/service/project_org_unit_mapping_service.py                       44   守門字眼 0
domain/associations/service/project_system_characteristic_mapping_domain_service.py   50   守門字眼 0
infra/associations/repository/project_assessment_plan_mapping_repo_impl.py         71   守門字眼 0
infra/associations/repository/project_org_unit_mapping_repo_impl.py                38   守門字眼 0
infra/associations/repository/project_system_characteristic_mapping_repo_impl.py   59   守門字眼 0
app/auth/service/role_app_service.py                                               94   守門字眼 6
app/auth/service/user_app_service.py                                              122   守門字眼 9
app/auth/service/user_import_template_app_service.py                              106   守門字眼 0
infra/auth/root_admin_reader.py                                                    40   守門字眼 0
common/util/audit_nickname.py                                                      87   守門字眼 0

驗證（預期 20 檔／1,658 行）：

git ls-files -- api/project_summary_report/__init__.py \
  api/project_summary_report/routes/project_summary_report_route.py \
  api/project_summary_report/routes/project_summary_report_history_route.py \
  app/project_summary_report/service/project_summary_report_service.py \
  app/project_summary_report/service/project_summary_report_history_service.py \
  infra/project_summary_report/repository/project_summary_report_hitrosy_repo_impl.py \
  api/project/__init__.py \
  api/project/routes/project_route.py \
  api/project/serializers/assessment_plan.py \
  app/associations/service/project_assessment_plan_mapping_service.py \
  app/associations/service/project_org_unit_mapping_service.py \
  domain/associations/service/project_system_characteristic_mapping_domain_service.py \
  infra/associations/repository/project_assessment_plan_mapping_repo_impl.py \
  infra/associations/repository/project_org_unit_mapping_repo_impl.py \
  infra/associations/repository/project_system_characteristic_mapping_repo_impl.py \
  app/auth/service/role_app_service.py \
  app/auth/service/user_app_service.py \
  app/auth/service/user_import_template_app_service.py \
  infra/auth/root_admin_reader.py \
  common/util/audit_nickname.py | xargs wc -l | tail -1

U10 — 系統診斷包：下載入口與組裝（8 檔／1,295 行）

api/support/__init__.py                                                            30   守門字眼 0
api/support/routes/diagnostic_bundle_route.py                                      67   守門字眼 2
api/support/routes/recent_error_route.py                                           43   守門字眼 3
app/support/diag_cli.py                                                           366   守門字眼 0
app/support/service/diag_bundle_app_service.py                                    334   守門字眼 0
app/support/service/diag_bundle_export_service.py                                 133   守門字眼 3
app/support/service/recent_error_app_service.py                                    52   守門字眼 4
domain/support/service/diag_slice_domain_service.py                               270   守門字眼 0

驗證（預期 8 檔／1,295 行）：

git ls-files -- api/support/__init__.py \
  api/support/routes/diagnostic_bundle_route.py \
  api/support/routes/recent_error_route.py \
  app/support/diag_cli.py \
  app/support/service/diag_bundle_app_service.py \
  app/support/service/diag_bundle_export_service.py \
  app/support/service/recent_error_app_service.py \
  domain/support/service/diag_slice_domain_service.py | xargs wc -l | tail -1

U11 — 系統診斷包：資料收集器（讀主機／容器／日誌／資料庫）（7 檔／1,548 行）

infra/support/collector/container_collector.py                                    105   守門字眼 0
infra/support/collector/host_collector.py                                         201   守門字眼 0
infra/support/collector/staged_collector.py                                       178   守門字眼 0
infra/support/diag_db_reader.py                                                   242   守門字眼 0
infra/support/diag_event_fetcher.py                                               303   守門字眼 0
infra/support/diag_log_reader.py                                                  176   守門字眼 0
infra/support/diag_packer.py                                                      343   守門字眼 0

驗證（預期 7 檔／1,548 行）：

git ls-files -- infra/support/collector/container_collector.py \
  infra/support/collector/host_collector.py \
  infra/support/collector/staged_collector.py \
  infra/support/diag_db_reader.py \
  infra/support/diag_event_fetcher.py \
  infra/support/diag_log_reader.py \
  infra/support/diag_packer.py | xargs wc -l | tail -1

U12 — 零散殘段（防竄改接線、解析工作單、即時通知、人員欄位格式）（7 檔／709 行）

common/integrity/adapters.py                                                      357   守門字眼 0
domain/oscal/service/ssp_docx_parse_job_domain_service.py                          71   守門字眼 0
domain/oscal/service/ssp_excel_parse_job_domain_service.py                         71   守門字眼 0
infra/oscal/repository/ssp_docx_parse_job_repo_impl.py                             54   守門字眼 0
infra/oscal/repository/ssp_excel_parse_job_repo_impl.py                            56   守門字眼 0
api/oscal/serializers/ssp/ssp_party.py                                             47   守門字眼 0
app/notification/handler/notification_socketio_handler.py                          53   守門字眼 0

驗證（預期 7 檔／709 行）：

git ls-files -- common/integrity/adapters.py \
  domain/oscal/service/ssp_docx_parse_job_domain_service.py \
  domain/oscal/service/ssp_excel_parse_job_domain_service.py \
  infra/oscal/repository/ssp_docx_parse_job_repo_impl.py \
  infra/oscal/repository/ssp_excel_parse_job_repo_impl.py \
  api/oscal/serializers/ssp/ssp_party.py \
  app/notification/handler/notification_socketio_handler.py | xargs wc -l | tail -1

每一棒開工前都先做的一件事

# 守門字眼 vs 函式數，0 命中的檔標紅
git ls-files -- <本棒檔案> | xargs grep -c 'require_\|assert_\|_check_'
git ls-files -- <本棒檔案> | xargs grep -c 'def [a-z]'

U1 — 權限檢查共用層＋共用小工具

• 🔴 common/authz/license.py（367 行）：授權檔決定「這家客戶買了哪些模組」，掛在每支 route 的 @require_license 就是它。問：授權檔讀不到、過期、被竄改時是擋下還是放行（fail-open）？快取多久、換客戶會不會拿到上一家的結果？
• common/authz/__init__.py（180 行）是決策表：它 re-export 哪一軸給誰用。問：五支 shim（admin／capability／decorators／platform／signed_token）轉到 jedi_iam.authz 時，有沒有哪一支名字對了、實作指到舊路徑。
• sharing.py：母租戶分享資源給子樹的判斷（FR-094.4b 新增）。問：「分享給子樹」會不會被反過來用——子租戶改到母租戶的資源。
• round_guard.py：稽核輪次的狀態守門。問：只看狀態、還是也看「這一輪屬於你的專案」。
• redis_client_util.py：FR-085 C1 報告提到這支（Redis 金鑰前綴），當時是越界讀、沒正式掃。問：鍵名有沒有帶租戶，跨客戶會不會讀到彼此的快取。

U2 — 啟動與中介層

• 🔴 license_readonly_mw.py（217 行）：授權到期後全站唯讀的閘門。問：它用什麼判斷「這是寫入請求」（HTTP 方法？網址白名單？）——有沒有 POST 其實是讀、或 GET 其實是寫的漏網；白名單網址是前綴比對還是完整比對。
• jwt_mw.py：登入權杖的解析。問：權杖過期、簽章錯誤、缺欄位時的處理；有沒有哪條路會把「解不開」當成「匿名但放行」。
• core/app_factory.py（469 行）：中介層的掛載順序＋哪些路由被豁免。問：豁免清單（免登入、免授權）列了誰，是不是每一個都有理由。
• main.py 的 diag 子命令分支：命令列入口，確認只在本機命令列觸發、網址打不到。

U3 — 首次安裝精靈＋版本資訊（登入前就打得到）

• 🔴 setup_route.py＋setup_token.py：精靈用 install.sh 印出的一次性設定碼代替登入。問：設定碼怎麼比對（常數時間比對？）、用過一次後真的失效嗎、「已開通」之後再打 POST /setup/provision 會不會再建一個管理員。
• setup_state_reader.py：判斷「是否已開通」的唯一依據是「root 以外的租戶底下有沒有使用者」。問：這個判據能不能被繞——例如把那個使用者刪掉，精靈是不是就重新打開了。
• version_route.py、client_config_route.py（完全免認證）：確認只回版本號與錯誤收集站連線字串，不夾帶環境變數、主機路徑、內部 IP。

U4 — 雲端硬碟：設定、授權、金鑰

• 🔴 google_drive_token_manager.py＋fernet_crypto.py：客戶的 Google 授權權杖怎麼加密存、用哪把金鑰。總表 CM-1631 已知「加密金鑰寫在版控裡」，這棒問的是程式邏輯：解密失敗時怎麼處理、權杖過期換新時會不會寫錯租戶。
• google_drive_integration_route.py／google_drive_sync_route.py（22 次守門字眼、7 支方法）：守門很多，照手冊問「守的問題對不對」——是檢查「你是這家公司的管理員」，還是只檢查「你有 drive 能力點」。
• google_drive_app_config_resolver.py（224 行、10 支公開方法、0 守門）：Google 應用程式設定從哪讀（租戶→原廠→環境變數）。問：租戶層設定能不能被一般使用者寫入、進而把整家公司的同步導到攻擊者的 Google 應用程式。
• drive_sync_admin_service.py：手動觸發同步。問：能不能觸發別家公司的同步。

U5 — 雲端硬碟：Google 回呼＋同步排程主幹

• 🔴 google_drive_webhook_route.py（不登入）：Google 送變更通知進來，靠 header 裡的 channel id＋token 認身分。問：token 比對是不是常數時間；找不到 channel 時回的錯誤訊息會不會洩露「這個 channel 存在與否」；攻擊者能不能狂打這支讓系統無限排同步工作（總表 🅹 資源耗盡同型）。
• drive_sync_orchestration_service.py（529 行、0 守門）：背景同步的總指揮。問：背景工作用「哪個租戶的機器身分」跑，身分是從工作紀錄讀的還是從呼叫者帶的；工作紀錄能不能被使用者塞一筆指定別家租戶。
• webhook_channel_manager.py：向 Google 註冊通知頻道。問：token 怎麼產生（夠不夠隨機）。

U6 — 雲端硬碟：八支檔案搬移處理器

• 🔴 會寫 compliance.job_evidences（沒 RLS、沒租戶欄位的表）：五支處理器（import／archive／soft_delete／reconcile／process_drive_changes）直接新增或軟刪證據紀錄。問：寫入前有沒有確認「這個任務屬於這家公司」——資料庫不會幫忙擋。
• import_drive_file_handler.py：把雲端硬碟的檔案抓回系統存成證據。問：檔名、大小、類型有沒有限制（與總表 🅹 資源耗盡、檔案上傳那批比對）。
• process_drive_changes_handler.py：處理 Google 送來的變更清單。問：變更清單裡的檔案編號如果指到別家公司的資料夾，會不會被照單全收。

U7 — 任務入口與批次

• 🔴 job_batch_complete_service.py:50-56：總表第 59 項「預設把呼叫者當管理員」的未核對點，FR-095 盤點明寫「待 H2 核對」。
• job_import_service.py（470 行、控制流程 101 處）：Excel 批次建任務。FR-095 盤點寫「匯入三步只有最後一步有守門」。問：前兩步（上傳、預覽）能不能讀到別的專案的資料。
• my_grc_jobs_query.py、flow_control_dashboard_repo_impl.py：「我的任務」與儀表板查詢，原生 SQL。問：WHERE 條件有沒有限定「是我的」／「是我能看的專案」，還是只靠 RLS。
• job_route.py：只掛登入＋授權模組，權限在 job_service._require_manager（FR-115 W2 已掃）。問 route 這層有沒有哪支方法沒走到那道。

U8 — 流程背景作業

• 🔴 用原生 SQL 寫五張沒 RLS 的表：reverify_clone_query.py 對 job_evidences、job_execution_devices、job_execution_org_units、task_assignees 做 INSERT … SELECT；workflow_xml_sync_service.py 更新 workflow_templates_trans（沒 RLS）。問：來源與目的的專案編號是不是從同一個已驗證的物件來，還是參數各自傳進來。
• core/scheduler.py（550 行、控制流程 91 處、46 處查詢）：所有背景排程的總表。問：每個排程工作用誰的身分跑、有沒有「逐租戶切換身分」，還是一個系統身分掃全庫。
• job_binding_orphan_cleanup_service.py：孤兒清理會刪資料。問：「孤兒」的判定條件有沒有可能誤判活資料。

U9 — 專案摘要報告＋關聯表＋使用者／角色殘段

• 🔴 摘要報告兩支 route、三支關聯表 service 零守門字眼：摘要報告表沒有租戶欄位，RLS 是「專案看得到就看得到」（EXISTS projects）。問：同一家公司內，非專案成員能不能讀／改別的專案的摘要報告——RLS 只擋跨公司、不擋公司內跨專案。
• user_import_template_app_service.py：產生使用者匯入範本 Excel。FR-113 B6 的公式注入（第 150 項）這支是外部消費者，當時沒掃。問：範本裡帶的現有資料有沒有中和 = + - @。
• role_app_service.py／user_app_service.py：主專案側對 jedi-iam 的包裝。問：有沒有繞過套件守門直接改角色。
• root_admin_reader.py：讀原廠管理員帳號。問：誰能呼叫、回傳什麼欄位。

U10 — 系統診斷包：入口與組裝

• 守門在服務層（diag_bundle_export_service.py:74 require_platform_admin()，已開檔確認）。
• 🔴 打包的內容：diag_bundle_app_service.py 收環境變數、授權檔、應用日誌、資料庫摘要、事件。問：環境變數與日誌有沒有遮罩密碼／金鑰（總表 🅳「敏感內容寫進日誌」同型）；平台管理員是原廠人員，但包會被寄出去給支援，外流風險在包本身。
• since／until 參數：問時間範圍有沒有上限（一次打包半年日誌＝資源耗盡）。
• recent_error_route.py：回最近的錯誤訊息。問：錯誤訊息會不會帶 stack trace 與內部路徑。

U11 — 系統診斷包：資料收集器

• 🔴 host_collector.py／container_collector.py／diag_log_reader.py：讀主機檔案與容器。問：讀哪些路徑是寫死的還是可被參數影響（路徑穿越）；有沒有呼叫外部指令、參數怎麼組（指令注入）。
• diag_db_reader.py（242 行、16 處查詢）：讀 system_logs、schema_migrations。問：用哪個資料庫帳號、會不會把其他客戶的日誌一起打包。
• diag_packer.py：打 tar.gz。問：檔名與壓縮大小的上限。

U12 — 零散殘段

• common/integrity/adapters.py（357 行、24 處查詢）：主專案給 jedi-integrity（防竄改）套件的接線，FR-084 只掃了套件本體。問：雜湊鏈寫入 api_logs（沒 RLS）時的租戶歸屬。
• 兩支解析工作單 repo（ssp_docx_parse_job_repo_impl.py／ssp_excel_parse_job_repo_impl.py）：FR-116 C4a 驗收時登記「兩張解析工作單表 RLS 壞規則」，這兩支就是讀寫那兩張表的程式，當時沒在範圍內。
• notification_socketio_handler.py：即時通知的 WebSocket 連線。問：連線時怎麼認身分、能不能訂閱別人的通知頻道。

做法：每支「已掃」檔，拿它最後一次被掃時的 commit（stamp 裡的 revision.commit）對 HEAD 做 git diff，數新增行與新增 def。41 支掃後有改動，其中 8 支新增了函式、0 支新增了網址入口。只改註解、import 路徑、欄位的列在後面。

4.1 🔴 有新增函式的 8 支（建議決策者裁要不要補掃）

4.2 有改動但沒新增函式的 33 支（不建議補）

大宗是三種：①09-12～16 的「wiring 併進 core/plugins/」「import 路徑改指套件」「施工日誌註解收斂」；②09-14 FR-094.4b 的 flow_template 系列加 scope／tenant_id 欄位（8 支，最多 15 行）；③09-13 FR-092 刪死碼（只減不增）。唯一值得一提的是：

• di_containers/bulletin/bulletin_containers.py（+70 行，09-12 wiring 搬家）、di_containers/flow_control/flow_control_containers.py（+31 行，09-20 FR-112「強制開始」端點的接線）——兩支都是 DI，併入 U13 專掃時一起看。FR-112 強制開始的 route／service 本身 FR-115 W8 已在 09-23 掃過。
• app/upload_file/service/managed_file_upload_service.py（+33 行，09-16 批次 API 儲存轉接頭）——沒新增函式，改的是既有方法的參數，影響小。

完整 41 支清單的驗證方式：

# 對某支檔：<commit> 取該檔最後一次掃描 stamp 的 revision.commit
git diff -U0 <commit> HEAD -- <檔> | grep -E '^\+\s*(async\s+)?def '

為什麼另列：FR-113 O9b 與 FR-116 C1／C5 證實「組裝時漏接一個零件，守門程式寫得再完整也不會執行，而且不會報錯」。這種問題不在任何一支業務程式裡，只看得出「宣告需要四個零件、組裝時只給了三個」。所以 DI 檔要用「對照表」的方式掃：每個需要守門零件的 service，它在容器裡的建構參數是不是全部接上。

5.1 全貌

主專案 DI 相關檔（di_containers/＋core/plugins/＋config/di_modules.py，排除 0 行 __init__）共 75 支、11,062 行：

⚠️ 「掃過」不等於「對照過零件」：前面各棒把容器檔放進範圍，是為了讓研究員追得到 service 從哪來，不是專門核對「每個參數都接了」。真正專門做這件事的只有 FR-113 O9b（面板沒跑完）與 FR-116 C1／C5。

5.2 從沒碰過的 17 支

5.3 建議：U13 DI 專掃（兩種做法擇一）

• 做法 A（只掃沒碰過的）：17 支 2,840 行，超過 2,000 行上限，切兩半——U13a：core/plugins/ 九支＋config/di_modules.py（1,666 行）；U13b：di_containers/ 七支（996 行）。
• 做法 B（全部對照一遍）：75 支 11,062 行，要切 6～7 棒。不建議用掃描工具做——這件事用工具效益低（工具擅長找「程式寫錯」，不擅長找「少接一條線」），用一支腳本比較快：列出每個 service 建構子的參數、再列出容器給的參數，比對缺漏。這是實作卡，不是掃描卡，建議首腦裁要不要開。

查 scripts/init/02-schema.sql（出貨基線）。「有客戶欄位」＝表上有 tenant_id；「RLS」＝有 ENABLE ROW LEVEL SECURITY。全檔只有 1 張表開了 FORCE，下表全部沒開 FORCE（表的擁有者帳號會繞過 RLS）。

1. 要不要掃 U7（任務入口與批次）：這三支在 FR-115 盤點被寫成「屬任務平台地盤、FR-095 裁停」，但 FR-095 H2（CM-1783）是「待派」不是「裁不掃」，而且這三支在主專案、不在套件。本盤點建議掃（總表第 59 項的核對點在這）。
2. 總表／FR-115 盤點有一句要更正：「common/authz/ 全專案共用守門本體，FR-085 C1 已掃」不成立（見開頭第 3 點）。建議首腦在總表 §0.5 補一句。
3. guarded_system_config_service.py 要不要補掃（第 4.1 節）：掃後新增 391 行、12 支函式，新增的就是守門。建議補，放 U12 一起（合計 1,374 行）。
4. DI 專掃用工具還是用腳本（第 5.3 節）。
5. O9b 沒查完的「人員對帳跨公司比對」要不要補（第 1.2 節）：可併 U12。若 3 與 5 都併 U12，U12 會到約 1,770 行，仍在上限內。
6. 打折處照實講：①「部分掃過」21 支依報告與盤點檔判定，四棒 stamp 目錄已不在 BE repo 根下，無法用 stamp 複核；② 判斷邏輯／純宣告的分法是 AST 自動算的，純宣告裡有 14 支不屬於標準宣告目錄（例如 config/config.py、兩支只有轉呼叫的 domain service），已逐支看過列在附錄 A；③ 守門字眼只是 grep，0 次不等於沒守（例如診斷包守門在 export service，路由檔是 0）。

總量：判斷邏輯 12 棒 17,511 行；加上補掃與 DI 最多 14 棒約 21,300 行。時間參考（報告實記，不是估算）：FR-113 O9a 916 行 1 小時 37 分、B1c 925 行 1 小時 27 分、O9b 1,903 行研究階段 1 小時 52 分（面板另計）。本批每棒 700～1,900 行，照這個量級每棒約 1.5～3 小時；幾線並行由首腦依額度定。

理由：沒有 if／for／try、沒有查詢組裝，只是資料形狀、名稱、常數的宣告。其中 160 支是 __init__.py（共 372 行，多半 0 行）不逐列；其餘 98 支如下。

清單（__init__.py 除外）：

「哪一棒」欄：掃過／部分掃過的列掃描目錄或棒名；沒碰的列所屬的堆，判斷邏輯堆標出排進哪一棒。

沿革見 FR-119 母卡 CM-2139 與 git log。