添加变更历史 添加ARD文档

Project/fonrey/PRD/PRD_MVP.md

@@ -7,6 +7,13 @@
 
 > **For AI assistants**: 本文件定义 Phase 1（MVP）的边界。在任何功能实现前，先对照本文确认是否在范围内。范围外的功能禁止在 MVP 阶段实现。
 
+## 变更历史
+
+| 版本 | 日期 | 作者 | 变更说明 |
+|------|------|------|---------|
+| v1.0 | 2026-04-24 | Product Team | 初稿：定义 Phase 1（MVP）边界与范围 |
+
+
 ---
 
 ## 1. 产品背景与目标

Project/fonrey/PRD/发布管理/客户端发布管理模块PRD.md

@@ -1,11 +1,20 @@
 # PRD: 客户端发布管理模块
 **状态**: Draft  
 **作者**: 产品经理  
-**最后更新**: 2026-04-24（v1.0 初稿）  
-**版本**: 1.0  
+**最后更新**: 2026-04-30（v1.2）  
+**版本**: 1.2  
 **所属系统**: Fonrey 房产经纪管理系统  
-**关联模块**: 系统管理、权限管理  
-**干系人**: 工程负责人、运维负责人、Tenant Admin（租户管理员）
+**关联模块**: 系统管理  
+**干系人**: 工程负责人、运维负责人、Platform Admin（平台超级管理员）
+
+## 变更历史
+
+| 版本 | 日期 | 作者 | 变更说明 |
+|------|------|------|---------|
+| v1.0 | 2026-04-24 | 产品经理 | 初稿 |
+| v1.1 | 2026-04-30 | 产品经理 | Persona 与命名修正：① Story 4 / Story 5 责任角色由 Tenant Admin（租户管理员）修正为 Platform Admin（平台超级管理员），客户端版本上传与版本分布监控属于平台运营职责，跨租户统一管理；② §5.3 版本管理后台从"租户系统管理模块"迁移至"平台运营后台"，明确 public schema 跨租户、Tenant Admin 与 Agent 无访问权限、不配置 RBAC permission_code；③ 全部 API 路径 `/api/client/updates/...` 重命名为 `/api/release/updates/...`，避免与客源管理模块（apps/client/）命名空间冲突，与 AGENTS.md §3 的 `apps/release/` 目录约定对齐；④ 头部"关联模块"由"系统管理、权限管理"修订为"系统管理"（不再涉及租户 RBAC）；⑤ 干系人列表 Tenant Admin → Platform Admin。 |
+| v1.2 | 2026-04-30 | 产品经理 | Story 5 验收标准追加"按租户统计安装数"能力：① 新增验收项——可查看任意租户的"当前活跃安装数（最近 24h）"与"历史装机总数"；② 新增验收项——全平台租户活跃榜视图，按 `tenant_code` + 租户名称 + 活跃安装数 + 历史装机数列表展示，按活跃安装数降序。底层数据由 `public.client_heartbeats` 表的 `tenant_id` 维度聚合提供（详见 DATA_MODEL_PUBLIC v1.5 §5.1 租户维度安装/活跃统计查询专区）。 |
+
 
 ---
 
@@ -26,7 +35,7 @@ Fonrey 房产经纪管理系统当前为纯 Web 应用，依赖用户自行通
 |------|---------|----------|
 | Agent（经纪人） | 下载安装客户端、日常登录使用系统、接受自动更新 | 每日 |
 | 店长/经理 | 同上 | 每日 |
-| Tenant Admin（租户管理员） | 发布新版本、管理安装包下载地址、监控客户端版本分布 | 按需 |
+| Platform Admin（平台超级管理员） | 发布新版本、管理安装包下载地址、监控客户端版本分布 | 按需 |
 | IT 运维人员 | 维护更新服务器、签名证书、构建发布流水线 | 按发布周期 |
 
 ### 核心痛点
@@ -108,12 +117,12 @@ Fonrey 房产经纪管理系统当前为纯 Web 应用，依赖用户自行通
 
 ---
 
-### Story 4：Tenant Admin（租户管理员）发布新版本
+### Story 4：Platform Admin（平台超级管理员）发布新版本
 
-**As** Tenant Admin（租户管理员），**I want** 通过管理后台上传新版客户端安装包并配置版本信息，**So that** 客户端能感知到更新并引导用户升级。
+**As** Platform Admin（平台超级管理员），**I want** 通过平台运营后台上传新版客户端安装包并配置版本信息，**So that** 全平台所有租户的客户端能感知到更新并引导用户升级。
 
 **验收标准**：
-- [ ] 系统管理后台提供"客户端版本管理"页面（位于系统管理模块下）
+- [ ] 平台运营后台提供"客户端版本管理"页面（位于平台运营后台下，不在租户系统管理模块）
 - [ ] 支持上传 `.exe` 安装包，并填写版本号（遵循 SemVer：`X.Y.Z`）、版本说明（更新日志，支持 Markdown）、发布日期
 - [ ] 支持设置版本类型：普通更新 / 强制更新
 - [ ] 支持设置版本状态：草稿（不对外生效）/ 已发布 / 已下线
@@ -123,13 +132,15 @@ Fonrey 房产经纪管理系统当前为纯 Web 应用，依赖用户自行通
 
 ---
 
-### Story 5：管理员监控客户端版本分布
+### Story 5：Platform Admin（平台超级管理员）监控客户端版本分布
 
-**As** Tenant Admin（租户管理员），**I want** 查看当前所有在线客户端的版本分布情况，**So that** 了解升级覆盖率，对仍在使用旧版本的客户端发出提醒或强制升级。
+**As** Platform Admin（平台超级管理员），**I want** 跨租户查看当前所有在线客户端的版本分布情况，**So that** 了解全平台升级覆盖率，对仍在使用旧版本的客户端发出提醒或强制升级。
 
 **验收标准**：
 - [ ] 客户端版本管理页面展示版本分布统计：各版本在线客户端数量及占比（饼图或条形图）
-- [ ] 支持按租户维度查看版本分布（多租户场景下，区分不同经纪公司的版本使用情况）
+- [ ] 支持按租户维度查看版本分布（区分不同经纪公司的版本使用情况，便于平台超管识别落后租户）
+- [ ] 支持**按租户统计安装数**：可查看任意租户的"当前活跃安装数（最近 24h）"与"历史装机总数（不论是否活跃）"，用于评估各租户的客户端覆盖率与渗透率
+- [ ] 支持全平台租户活跃榜视图：以列表形式展示各 active 状态租户的 `tenant_code`、租户名称、活跃安装数、历史装机总数，按活跃安装数降序排列
 - [ ] 支持对指定版本范围的用户推送"强制更新"通知（如：将所有低于 v1.5.0 的客户端标记为强制更新）
 
 ---
@@ -178,7 +189,7 @@ Fonrey 房产经纪管理系统当前为纯 Web 应用，依赖用户自行通
 客户端启动 / 定时检测（每4小时）
       │
       ▼
-GET /api/client/updates/latest?platform=win32&arch=x64&current_version=1.2.0
+GET /api/release/updates/latest?platform=win32&arch=x64&current_version=1.2.0
       │
       ▼
 更新服务器（Fonrey 后端 Django API）
@@ -201,10 +212,10 @@ GET /api/client/updates/latest?platform=win32&arch=x64&current_version=1.2.0
 
 | 端点 | 方法 | 说明 |
 |------|------|------|
-| `/api/client/updates/latest/` | GET | 客户端查询最新版本，返回版本信息和下载 URL |
-| `/api/client/updates/` | GET | 管理端查询版本列表（需认证） |
-| `/api/client/updates/` | POST | 管理端发布新版本（需管理员权限） |
-| `/api/client/updates/<id>/` | PATCH | 管理端修改版本状态（发布/下线/强制） |
+| `/api/release/updates/latest/` | GET | 客户端查询最新版本，返回版本信息和下载 URL |
+| `/api/release/updates/` | GET | 管理端查询版本列表（需认证） |
+| `/api/release/updates/` | POST | 管理端发布新版本（需管理员权限） |
+| `/api/release/updates/<id>/` | PATCH | 管理端修改版本状态（发布/下线/强制） |
 
 ---
 
@@ -259,9 +270,11 @@ GET /api/client/updates/latest?platform=win32&arch=x64&current_version=1.2.0
 
 ---
 
-### 5.3 版本管理后台（系统管理模块新增页面）
+### 5.3 版本管理后台（平台运营后台新增页面）
 
-**页面路径**：系统管理 → 客户端发布管理
+**页面路径**：平台运营后台 → 客户端发布管理
+
+> **归属说明**：本页面归属 Platform Admin（平台超级管理员），位于平台运营后台（public schema 跨租户），不在租户的"系统管理"模块下。Tenant Admin 与 Agent 均无访问权限。
 
 #### 5.3.1 版本列表
 
@@ -300,7 +313,7 @@ GET /api/client/updates/latest?platform=win32&arch=x64&current_version=1.2.0
 
 ### 5.4 更新 API 规格
 
-#### GET `/api/client/updates/latest/`
+#### GET `/api/release/updates/latest/`
 
 **请求参数（Query String）**：
 
@@ -346,7 +359,7 @@ GET /api/client/updates/latest?platform=win32&arch=x64&current_version=1.2.0
 | EV 代码签名证书 | 需提前申请，EV 证书审核周期 1-2 周 | IT/运维 | 中（需提前排期） |
 | Cloudflare R2 存储桶 | 存放安装包，利用现有账号新增 bucket | 运维 | 低 |
 | `electron-updater` | 自动更新库，需配合更新 API 端点实现 | 客户端工程师 | 低 |
-| Django 更新 API | 新增 `/api/client/updates/` 相关接口 | 后端工程师 | 低 |
+| Django 更新 API | 新增 `/api/release/updates/` 相关接口 | 后端工程师 | 低 |
 | CI/CD 构建流水线 | 自动构建、签名、上传安装包 | 运维/DevOps | 中 |
 
 ### 6.2 已知风险

Project/fonrey/PRD/客源管理/客源管理模块PRD.md

@@ -6,6 +6,14 @@
 **所属系统**: Fonrey 房产经纪管理系统  
 **关联模块**: 房源管理、组织人事管理、权限管理
 
+## 变更历史
+
+| 版本 | 日期 | 作者 | 变更说明 |
+|------|------|------|---------|
+| v1.0 | — | 产品经理 | 初稿 |
+| v1.4 | 2026-04-23 | 产品经理 | 新增客源信息概览/编辑基础信息/收藏/改等级/改状态/转公客/转成交/转无效/联系人管理/相关员工管理/操作日志章节及 Story 15-24，基于 35 张截图分析完成 |
+
+
 ---
 
 ## 1. 问题陈述

Project/fonrey/PRD/房源管理/房源管理模块PRD.md

@@ -6,6 +6,14 @@
 **所属系统**: Fonrey 房产经纪管理系统  
 **关联模块**: 客源管理、组织人事管理、权限管理
 
+## 变更历史
+
+| 版本 | 日期 | 作者 | 变更说明 |
+|------|------|------|---------|
+| v1.0 | — | 产品经理 | 初稿 |
+| v2.1 | 2026-04-23 | 产品经理 | 重写 §8.3 相关截图参考：修正所有路径拼写错误（sreenshots→screenshots）；补充全部未收录截图（房源详情1-3、房源备注、价格解读、市场报盘、全部商铺、全部写字楼、附件信息、编辑业主联系人、小区/楼盘管理全部截图）；按文档章节分组重新整理为表格格式 |
+
+
 ---
 
 ## 1. 问题陈述

Project/fonrey/PRD/房源管理/楼盘管理模块PRD.md

@@ -6,6 +6,13 @@
 **所属系统**: Fonrey 房产经纪管理系统  
 **关联模块**: 房源管理、客源管理、组织人事管理、权限管理
 
+## 变更历史
+
+| 版本 | 日期 | 作者 | 变更说明 |
+|------|------|------|---------|
+| v1.0 | 2026-04-23 | 产品经理 | 初稿，基于楼盘管理列表、楼盘详情（楼盘信息/楼栋管理/结构管理/楼盘照片/楼盘价格走势/周边配套）、区域管理（城区/商圈/关联关系）、学校管理共 14 张截图分析完成 |
+
+
 ---
 
 ## 1. 问题陈述

Project/fonrey/PRD/权限管理/权限管理模块PRD.md

@@ -6,6 +6,14 @@
 **所属系统**: Fonrey 房产经纪管理系统  
 **关联模块**: 组织人事管理、房源管理、客源管理、系统设置
 
+## 变更历史
+
+| 版本 | 日期 | 作者 | 变更说明 |
+|------|------|------|---------|
+| v1.0 | — | 产品经理 | 初稿 |
+| v1.1 | 2026-04-24 | 产品经理 | 锁定多角色合并规则 = 并集 / 最宽松 |
+
+
 ---
 
 ## 1. 问题陈述

Project/fonrey/PRD/登录管理/用户登录管理模块PRD.md

@@ -7,6 +7,14 @@
 **所属系统**: Fonrey 房产经纪管理系统  
 **关联模块**: 组织人事管理、权限管理、系统管理
 
+## 变更历史
+
+| 版本 | 日期 | 作者 | 变更说明 |
+|------|------|------|---------|
+| v1.x | — | 产品经理 | 初稿至 v1.9（详见 git 历史） |
+| v2.0 | 2026-04-30 | 产品经理 | 根据 review 后的 §4 用户故事全面同步 §5 功能详细说明：删除找回用户名流程及邮件模板；找回密码改为纯短信流程；新增 §5.5 手机验证码登录详细说明；§6 技术注意事项更新短信依赖/风险/开放问题；§8.2 接口清单同步正式功能状态；全文「Tenant ID」对外概念统一替换为「Tenant Code」 |
+
+
 ---
 
 ## 1. 问题陈述

Project/fonrey/PRD/系统管理/系统管理模块PRD.md

@@ -6,6 +6,13 @@
 **版本**：v1.0  
 **利益相关方**：工程负责人、运营团队、安全合规、客户成功团队
 
+## 变更历史
+
+| 版本 | 日期 | 作者 | 变更说明 |
+|------|------|------|---------|
+| v1.0 | 2026-04-24 | 产品经理 | 初稿 |
+
+
 ---
 
 ## 1. 问题陈述

Project/fonrey/PRD/系统配置/系统配置模块PRD.md

@@ -7,6 +7,13 @@
 **关联 Task**：US-SETTING-001  
 **相关文档**：`DATA_MODEL/ENUMS.md`、`PRD/系统配置/系统配置参数数据.md`、`DATA_MODEL/DATA_MODEL.md`
 
+## 变更历史
+
+| 版本 | 日期 | 作者 | 变更说明 |
+|------|------|------|---------|
+| v0.1 | 2026-04-27 | Nova（PM） | 初稿（MVP 范围） |
+
+
 ---
 
 ## 1. 问题陈述

Project/fonrey/PRD/组织人事管理/组织人事管理模块PRD.md

@@ -6,6 +6,15 @@
 **所属系统**: Fonrey 房产经纪管理系统  
 **关联模块**: 权限管理、房源管理、客源管理、系统设置
 
+## 变更历史
+
+| 版本 | 日期 | 作者 | 变更说明 |
+|------|------|------|---------|
+| v1.0 | — | 产品经理 | 初稿 |
+| v1.1 | — | 产品经理 | （详见 git 历史） |
+| v1.2 | 2026-04-24 | 产品经理 | 移除技术实现章节，该部分由独立 DATA_MODEL 文档承载 |
+
+
 ---
 
 ## 1. 问题陈述