docs: README+模块技能同步项目归属口径(挖掘分项目,可见性对齐opp_reports,E2E 11项全过)

README.md

@@ -118,11 +118,17 @@ CRUD 页（`opp_reports/` `opp_approvals/`）保留供后台运维直接编辑
 
 - `opp_reports`：研发报告（software/title/content/status/confirm_task_id/confirmed_by）
 - `opp_approvals`：研发审批（report_id/status/note/resolved_by）
-- `opp_mining_batches`：需求挖掘批次（org_id 隔离；scope=top/targeted；状态机
-  pulling→embedding→clustering→naming→done/failed；stats_json 进度统计；error_msg 可行动报错）
+- `opp_mining_batches`：需求挖掘批次（org_id+project_id 隔离，project_id 空=平台级挖掘；
+  scope=top/targeted；状态机 pulling→embedding→clustering→naming→done/failed；
+  stats_json 进度统计；error_msg 可行动报错）
 - `opp_demand_snap`：需求快照（batch_id+src_id 去重；cluster_id 聚类回填；embed_status）
 - `opp_clusters`：需求类别（heat_rank 热度排名/share 占比/naming_evidence 命名证据/centroid_snap_id）
 
+挖掘结果的项目可见性口径与 opp_reports 对齐（2026-09-12 用户确认挖掘也分项目）：
+挂项目的批次仅本项目会话可见；平台级批次（无项目会话发起）本机构登录可见；
+无当前项目的会话只见平台级批次。`_check_batch_visible` 是单一规则源
+（mining_status/list_clusters/cluster_detail 三层复用，E2E 11 项断言实测全过）。
+
 ## 需求挖掘架构（P1，2026-09-11）
 
 众包需求（爬虫平台 record_type=demand）→ 语义聚类 → TopX/指定类型分析：

skill/SKILL.md

@@ -94,8 +94,11 @@ draft ──人工确认──> confirmed ──发起──> approval_initiated
 - **编排** opp_mining_flow.py：状态机 pulling→embedding→clustering→naming→done/failed，
   `asyncio.create_task` 后台跑，进度实时落 `stats_json`，失败落 `error_msg`（可行动报错，
   禁前端挂起干等）。**算法/VDB/embedding** opp_mining.py。
-- **机构隔离**（用户定夺）：基础数据（需求快照+embedding缓存）全机构共享；分析结果
-  （批次/快照归属/类别）挂 `org_id`，所有查询按 ctx.org_id 强制过滤（伪 org 拒绝实测通过）。
+- **机构隔离 + 项目归属**（用户定夺 2026-09-12：挖掘也分项目）：基础数据（需求快照+embedding缓存）
+  全机构共享；分析结果（批次/快照归属/类别）挂 `org_id` + `project_id`（空=平台级挖掘），
+  可见性对齐 opp_reports 口径——挂项目批次仅本项目会话可见，平台级批次本机构登录可见，
+  无项目会话只见平台级。`_check_batch_visible` 单一规则源三层复用（status/list_clusters/
+  cluster_detail），E2E 11 项断言实测全过（scripts/p1_proj_e2e.py）。
 - **VDB 协议**（实测，详见技能 rag-module-operations）：kNN=`/v1/query`+vector+pagerows
   （非 /v1/search）；标量过滤=`expr`（非 filter）；kNN+expr 组合可用；output_fields 可取回
   vector；dropcollection 可用（旧批工作集自动清理，保留最近 opp_mine_keep_batches 个）。