diff --git a/Project/fonrey/PRD/房源管理模块PRD.md b/Project/fonrey/PRD/房源管理模块PRD.md index 87362bb8..12fa6bb5 100644 --- a/Project/fonrey/PRD/房源管理模块PRD.md +++ b/Project/fonrey/PRD/房源管理模块PRD.md @@ -1,8 +1,8 @@ # PRD: 房源管理模块 **状态**: Draft **作者**: 产品经理 -**最后更新**: 2026-04-23（v1.2 新增房源详情页浮窗快捷编辑操作说明） -**版本**: 1.2 +**最后更新**: 2026-04-23（v1.3 新增跟进管理各 Tab 页详细说明及业务信息模块：钥匙/委托/实勘） +**版本**: 1.3 **所属系统**: Fonrey 房产经纪管理系统 **关联模块**: 客源管理、组织人事管理、权限管理 @@ -89,10 +89,14 @@ - [ ] 跟进目的为必填下拉选项（如：业主跟进、电话、带看、回访等） - [ ] 跟进内容为必填文本框，最少 6 字，最多 500 字 - [ ] 支持附件上传（最多 10 张图片，每张最大 20MB，格式：bmp/jpg/png/svg/gif） -- [ ] 跟进记录展示：跟进类型标签 + 内容 + 操作人（姓名+所属门店）+ 时间 +- [ ] 跟进日志展示以时间线方式组织，按日期分组，每条记录包含：类型标签（颜色区分）+ 内容 + 操作人（[角色]姓名+门店-组别）+ 时间戳 +- [ ] 跟进记录右侧提供"公开/隐藏"切换按钮，控制记录在团队内的可见范围 +- [ ] 每条跟进记录右上角"..."菜单支持：查看详情 / 编辑 / 删除（受权限控制） - [ ] 跟进日志支持按类型筛选（全部/写入跟进/敏感信息跟进/敏感信息查看/修改跟进/其他跟进） - [ ] 跟进日志支持关键词搜索 + 操作员筛选 + 日期范围筛选 -- [ ] 跟进目的支持按维度统计展示（如：电话 45 次、业主跟进 20 次、回访 1 次） +- [ ] 写入跟进 Tab 中，跟进目的统计显示各类型数量（如：电话 46 次、业主跟进 41 次、议价 1 次） +- [ ] 写入跟进 Tab 支持 AI 标签筛选（AI-在售 / AI-不售），辅助判断业主出售意向 +- [ ] 敏感信息查看 Tab 提供"查看地址"/"查看号码"复选框过滤；敏感信息查看记录由系统自动生成，不可删除 ### Story 4：经纪人查看同业主其他房源 @@ -766,34 +770,366 @@ ### 5.4 跟进管理 -#### 5.4.1 写跟进 +房源详情页的跟进管理区域通过 Tab 页签切换，展示不同维度的跟进记录。共有 6 个 Tab：**全部 / 写入跟进 / 敏感信息跟进 / 敏感信息查看 / 修改跟进 / 其他跟进**。 -跟进功能以浮层（Drawer/Modal）方式呈现，不离开当前页面： +所有 Tab 共用以下通用设计： +- 时间线布局：按日期分组（日期为橙色圆点 + 日期文字），同日记录依时间倒序排列 +- 每条记录右侧提供**公开/隐藏**切换操作（控制该条记录在团队内的可见性） +- 顶部显示**智能总结**入口横幅（AI 功能，快速了解近期跟进关键内容，属增值功能） +- 底部提供"查看全部跟进"按钮（部分 Tab 默认仅展示最近若干条） + +--- + +#### 5.4.1 全部（Tab：全部） + +**功能说明**：聚合展示该房源所有类型的跟进记录，是最完整的视图。 + +**过滤器**（位于 Tab 内容区顶部）： +- 复选框过滤：`有录音` / `有附件` + +**展示的跟进类型标签**（方括号标注，以下为从截图归纳的完整枚举）： + +| 跟进类型标签 | 产生来源 | 说明示例 | +|------------|---------|---------| +| 【查看号码】 | 敏感信息查看 | 经纪人查看业主电话号码，自动记录 | +| 【图片下载】 | 其他跟进 | 经纪人下载了房源图片，自动记录 | +| 【查看隐号业主】 | 敏感信息查看 | 经纪人查看业主隐号信息，自动记录 | +| 【编辑房源】 | 修改跟进 | 房源字段被修改，自动记录变更前后值 | +| 【房源置顶】 | 修改跟进 | 房源被设置为置顶，记录置顶期限及理由 | +| 【房源相关方保护/未保护】 | 敏感信息跟进 | 相关方保护状态变更，system 自动记录 | +| 【修改相关方】 | 修改跟进 | 手动修改出售方等相关方信息 | +| 【改状态】 | 修改跟进 | 房源状态变更记录 | +| 【改价格】 | 修改跟进 | 调价记录（含调价前后值） | +| 【改等级】 | 修改跟进 | 等级变更（含系统自动修改） | +| 【修改】 | 修改跟进 | 其他信息修改（如联系人电话变更） | +| 【完善相册】 | 修改跟进 | 图片编辑/上传操作记录 | +| 跟进-电话 | 写入跟进 | 经纪人主动写入，跟进目的为电话 | +| 跟进-业主跟进 | 写入跟进 | 经纪人主动写入，跟进目的为业主跟进 | +| 跟进-议价 | 写入跟进 | 经纪人主动写入，跟进目的为议价 | + +**交互规则**： +- [ ] 所有类型的跟进记录均展示于此 Tab，不做类型过滤 +- [ ] 支持通过"有录音"、"有附件"复选框快速过滤含特定附属内容的记录 +- [ ] 每条记录显示：类型标签 + 操作人（[角色]姓名 门店-组别）+ 时间戳 + 内容摘要 + 右侧"公开/隐藏"操作 + +--- + +#### 5.4.2 写入跟进（Tab：写入跟进） + +**功能说明**：仅展示经纪人**主动写入**的跟进记录（区别于系统自动生成的修改/敏感类日志）。 + +**过滤器**（位于 Tab 内容区顶部）： + +| 过滤维度 | 选项 | 说明 | +|---------|------|------| +| 跟进目的 | 电话（N）/ 业主跟进（N）/ 议价（N） | 复选框，括号内显示该类型当前记录数量 | +| 跟进标签 | 有录音 / 有附件 / 我的跟进 / AI-在售（N）/ AI-不售（N） | 复选框，AI 标签表示 AI 辅助判断业主出售意向 | + +**记录展示格式**： + +``` +[跟进类型标签]（如"跟进-业主跟进"蓝色标签） ...（操作菜单） +跟进内容正文（如：sqcs 房子650万在卖 看房联系 号码不变） +[角色] 姓名 门店名称-组别 YYYY-MM-DD HH:mm:ss +``` + +**交互规则**： +- [ ] 跟进目的过滤器以复选框形式排列，支持多选组合过滤 +- [ ] 跟进目的旁显示对应数量统计（如：电话(46) / 业主跟进(41) / 议价(1)），实时反映当前过滤结果数 +- [ ] AI 标签（AI-在售 / AI-不售）为系统根据跟进内容智能分析后打的标记，协助经纪人判断业主意向 +- [ ] 每条记录右上角"..."操作菜单提供：查看详情 / 编辑 / 删除（受权限控制） +- [ ] 右侧提供"公开/隐藏"切换（隐藏后仅本人及上级可见） + +--- + +#### 5.4.3 敏感信息跟进（Tab：敏感信息跟进） + +**功能说明**：展示涉及**相关方保护机制**的系统自动日志，记录房源相关方（首录方/号码方/出售方等）保护状态的变更。此类日志由系统（system）自动生成，不由经纪人手动写入。 + +**展示的记录类型**： + +| 记录标签 | 触发场景 | 记录内容示例 | +|---------|---------|------------| +| 【房源相关方未保护】 | 前一相关方离职或保护期到期，保护自动解除 | "【都市港湾店一组 - 史彬彬】未能成为房源【出售方】，原房源下架时间：【2025-06-13 13:47:11】，保护期0天；" | +| 【房源相关方保护】 | 房源下架后系统自动分配相关方保护 | "【都市港湾店一组 - 史彬彬】成为房源【员工】，原房源下架时间：【2025-06-13 13:47:11】；" | +| 【修改相关方】 | 管理员或行政人员手动修改相关方 | "【出售方】由【都市港湾店一组-史彬彬】，修改为【都市港湾店一组-雷威】" | +| 【改状态】 | 房源状态变更（含相关方保护联动） | "将房源【暂缓】状态，修改为【出售】状态，备注：申请出售" | +| 【改价格】 | 房源价格调整 | "售价：8500000=>7500000；备注：0" | + +**交互规则**： +- [ ] 此 Tab 无额外过滤器，仅展示敏感信息类系统日志 +- [ ] 操作人显示为 `[初始职务]system 系统管理组` 的记录为系统自动生成，不可编辑或删除 +- [ ] 右侧"公开/隐藏"操作对系统自动日志同样有效，管理员可选择是否对普通经纪人展示 + +--- + +#### 5.4.4 敏感信息查看（Tab：敏感信息查看） + +**功能说明**：专项记录所有**查看敏感信息**的操作日志，包括查看业主电话号码、查看业主隐号（打码号码解码查看）等。用于合规审计和追溯，防止信息泄露。 + +**过滤器**（位于 Tab 内容区顶部）： +- 复选框过滤：`查看地址` / `查看号码` + +**展示的记录类型**： + +| 记录标签 | 触发场景 | +|---------|---------| +| 【查看号码】 | 经纪人点击查看业主电话明文号码 | +| 【查看隐号业主】 | 经纪人查看已被打码的业主联系人信息（解密查看） | + +**每条记录格式**： + +``` +【查看号码】 [角色]姓名 门店名称-组别 YYYY-MM-DD HH:mm:ss ⓘ 公开 隐藏 +``` + +**交互规则**： +- [ ] 每次经纪人点击查看号码或查看隐号业主，系统自动生成一条记录，无需经纪人手动操作 +- [ ] 记录不可删除（合规要求） +- [ ] 可通过"查看地址"/"查看号码"复选框过滤对应类型的查看记录 +- [ ] 底部提供"查看全部跟进"按钮，跳转至全部 Tab 并应用对应过滤条件 + +--- + +#### 5.4.5 修改跟进（Tab：修改跟进） + +**功能说明**：聚合展示所有**房源信息变更**的操作日志，包括字段修改、状态变更、价格调整、等级调整、相册编辑、置顶操作等。由操作行为自动触发生成，为管理者提供完整的房源信息变更追溯。 + +**展示的记录类型**： + +| 记录标签 | 触发场景 | 记录格式示例 | +|---------|---------|------------| +| 【编辑房源】 | 房源字段被修改 | "阳台：0=>2；" 或 "状态：暂缓=>出售；厨房：0=>1；装修：=>精装；等级：D（较弱）=>C（一般）；售价（元）：7500000=>6500000；" | +| 【房源置顶】 | 房源被设为置顶 | "将房源设为置顶（2026-04-02至2026-05-02），置顶理由：12" | +| 【完善相册】 | 房源图片编辑 | "编辑了16张照片，上传了0张照片" | +| 【改等级】 | 等级变更（含系统自动变更） | "由于不符合等级与状态的对应关系，系统自动修改房源等级：B=>D" | +| 【修改】 | 其他信息修改 | "【修改】联系人电话2：==>17721156903；" | +| 【改状态】 | 房源状态变更 | "将房源【出售】状态，修改为【暂缓】状态；状态：出售=>暂缓；保护房设置：否=>；备注：0" | +| 【改价格】 | 价格调整（历史格式含 HTML 标签） | "售价↓：860=>850；售单价：78345.63=>77434.64" | + +**交互规则**： +- [ ] 系统自动生成的修改日志（操作人为 system）与人工操作日志混排，均按时间倒序展示 +- [ ] 变更内容以"字段名：旧值=>新值"格式记录，多字段同时变更则在同一条记录中逐行列出 +- [ ] 等级联动状态的自动变更（如：出售=>暂缓时系统自动降等级）单独生成一条系统操作记录 +- [ ] 此 Tab 不提供额外过滤器（已通过类型 Tab 本身完成过滤） + +--- + +#### 5.4.6 其他跟进（Tab：其他跟进） + +**功能说明**：展示非写入跟进、非修改、非敏感类的其他自动操作记录，主要包括**图片下载**等操作日志。同时，此 Tab 内容区底部展示**业务信息**面板（钥匙 / 委托 / 实勘）的当前状态概览及快捷操作入口。 + +**展示的记录类型**： + +| 记录标签 | 触发场景 | +|---------|---------| +| 【图片下载】 | 经纪人下载了房源图片，自动记录 | + +**业务信息面板**（位于此 Tab 跟进记录下方，独立区块）： + +此面板为快捷入口，展示三类业务信息的当前状态，并提供操作按钮： + +| 业务项 | 无记录时展示 | 操作按钮 | +|--------|------------|---------| +| 钥匙 | `无钥匙`（灰色标签） | 钥匙在他司 / 新增钥匙 | +| 委托 | `无委托`（灰色标签）| 新增委托 / 全部（N）| +| 实勘 | `无实勘`（灰色标签） | 新增实勘 | + +**交互规则**： +- [ ] 业务信息面板与跟进日志列表在同一 Tab 页内垂直排列（跟进日志在上，业务信息在下） +- [ ] 三项业务信息（钥匙/委托/实勘）均显示当前有效记录状态；若无记录则显示对应灰色"无XX"标签 +- [ ] 委托旁"全部（N）"链接显示已有委托数量，点击跳转至委托列表 + +--- + +#### 5.4.7 写跟进（新增跟进浮窗） + +**入口**：房源详情页顶部操作区"写跟进"按钮，或跟进日志区顶部入口 + +**功能说明**：跟进功能以浮层（Drawer/Modal）方式呈现，不离开当前页面： | 字段 | 类型 | 必填 | 说明 | |------|------|------|------| -| 跟进目的 | 下拉选择 | 是 | 电话/业主跟进/带看/回访/其他等 | +| 跟进目的 | 下拉选择 | 是 | 电话 / 业主跟进 / 议价 / 带看 / 回访 / 其他等（枚举值由业务运营维护） | | 跟进内容 | 文本区域 | 是 | 最少 6 字，最多 500 字 | | 附件 | 文件上传 | 否 | 最多 10 张，单张最大 20MB，格式：bmp/jpg/png/svg/gif | 支持"跟进模版"功能（快速套用常用跟进话术模板）。 -#### 5.4.2 跟进日志展示 +**交互规则**： +- [ ] 跟进目的为必填，未选择时不可提交 +- [ ] 跟进内容少于 6 字时提交弹出错误提示 +- [ ] 提交成功后浮窗关闭，跟进日志列表实时更新，新记录出现在列表顶部 +- [ ] 写入的跟进记录同步出现在"全部"及"写入跟进"两个 Tab 中 -跟进日志以时间线方式展示，每条记录包含： +--- -- **跟进类型标签**：不同颜色区分（如绿色=业主跟进、蓝色=电话、橙色=其他） -- **跟进内容正文** -- **操作信息**：`[角色] 姓名 门店名称-组别 时间` -- **操作菜单**（...）：查看详情/编辑/删除（权限控制） +### 5.4.8 业务信息：钥匙管理 -**跟进过滤 Tab**： -- 全部 -- 写入跟进 -- 敏感信息跟进 -- 敏感信息查看 -- 修改跟进 -- 其他跟进 +#### 5.4.8.1 新增钥匙 + +**入口**：其他跟进 Tab → 业务信息面板 → "新增钥匙"按钮 + +**功能说明**：经纪人从业主处获取房源钥匙后，在系统中登记钥匙托管信息。托管钥匙是房源维护完成度的重要维度，有助于提升带看便利性。 + +**浮窗字段**： + +| 字段 | 类型 | 必填 | 说明 | +|------|------|------|------| +| 钥匙类型 | 单选 | 是 | 机械锁 / 密码锁 | +| 钥匙方 | 下拉选择 | 是 | 选择持有钥匙的经纪人（默认显示当前登录用户），格式：姓名 - 所属组 | +| 保管部门 | 下拉选择 | 是 | 钥匙实际存放的部门/门店（联动钥匙方所属组，可单独修改） | +| 上传附件 | 文件上传 | 否 | 上传钥匙相关附件（如钥匙图片、委托书扫描件等） | +| 选择录音 | 音频上传 | 否 | 上传与业主沟通的录音文件 | +| 备注 | 文本区域 | 否 | 最多 200 字，补充说明钥匙情况 | + +**交互规则**： +- [ ] 钥匙类型为必填单选，默认无选中 +- [ ] 钥匙方默认填充当前登录用户，可从下拉中切换为其他经纪人 +- [ ] 保管部门根据钥匙方自动联动，也可独立选择 +- [ ] 确认后在业务信息面板"钥匙"一栏展示已登记的钥匙记录（如"机械锁 - 张三 - 都市港湾店一组"） +- [ ] 新增钥匙操作自动写入跟进日志（归类至"其他跟进"） + +--- + +#### 5.4.8.2 备注钥匙在他司 + +**入口**：其他跟进 Tab → 业务信息面板 → "钥匙在他司"按钮 + +**功能说明**：当业主的钥匙由其他中介公司持有时，经纪人可登记此信息，系统将在房源上标注"钥匙在他司"提示，供其他同事知悉，避免带看时出现钥匙无法获取的情况。 + +**注意事项说明**（浮窗内显示）： +1. 备注钥匙在他司信息不生成钥匙方 +2. 新增钥匙后将覆盖钥匙在他司信息 + +**浮窗字段**： + +| 字段 | 类型 | 必填 | 说明 | +|------|------|------|------| +| 钥匙在 | 文本区域 | 否 | 输入钥匙所在公司和门店信息，最多 30 字 | + +**交互规则**： +- [ ] 文本框为选填，可为空提交（仅标记"钥匙在他司"状态） +- [ ] 确认后业务信息面板"钥匙"一栏显示"钥匙在他司"标记及输入的文本说明 +- [ ] 当后续通过"新增钥匙"登记己方钥匙后，"钥匙在他司"信息自动被覆盖清除 +- [ ] 该操作不生成钥匙方记录，不影响房源维护完成度中"钥匙"维度的计分 + +--- + +### 5.4.9 业务信息：委托管理 + +#### 5.4.9.1 新增委托 + +**入口**：其他跟进 Tab → 业务信息面板 → "新增委托"按钮 + +**功能说明**：经纪人与业主签署房源委托协议后，在系统中录入委托信息并上传相关证明文件。委托信息是房源维护完成度的重要权重项（10%），也是合规管理的重要依据。 + +**页面布局**：新增委托为**独立页面**（非浮窗 Modal），包含三个信息区块： + +##### 区块一：委托信息 + +| 字段 | 类型 | 必填 | 说明 | +|------|------|------|------| +| 委托类型 | 下拉选择 | 是 | 如：独家委托 / 非独家委托 等（枚举值由业务运营维护） | +| 委托期限 | 日期区间 | 是 | 开始日期（默认今日）- 结束日期（可选"已知结束日期"下拉或手动选择截止时间） | +| 委托方 | 下拉选择 | 是 | 负责该委托的经纪人（默认当前登录用户），格式：姓名 - 所属组 | + +##### 区块二：委托内容 + +| 字段 | 类型 | 必填 | 说明 | +|------|------|------|------| +| 签约方式 | 下拉选择 | 是 | 选择委托签约的方式（选项由业务定义），选择后下方动态展示对应委托书模板 | +| 委托书 | 动态展示 | — | 根据签约方式自动展示对应委托书内容/模板（"选择签约方式后展示对应内容"） | + +##### 区块三：委托人（产权信息） + +| 字段 | 类型 | 必填 | 说明 | +|------|------|------|------| +| 委托人类型 | 单选 | 是 | 产权人本人 / 授权第三方 | +| 产权人 | 下拉选择 | 是 | 从业主联系人中选择产权人 | +| 产权人姓名 | 文本输入 | 是 | 产权人真实姓名 | +| 产权人证件 | 证件类型下拉 + 证件号文本 + 附件上传 | 否 | 证件类型（如：身份证）+ 证件号码 + 上传证件扫描件 | +| 房产证 | 文件上传 | 否 | 上传房产证扫描件/照片 | + +##### 区块四：其他 + +| 字段 | 类型 | 必填 | 说明 | +|------|------|------|------| +| 其他资料 | 文件上传 | 否 | 上传其他相关附件（每项附件内容最多可上传 10 个附件） | +| 备注 | 文本区域 | 否 | 最多 200 字 | + +**底部操作**： +- 提交：保存委托信息 +- 取消：返回上一页 + +**交互规则**： +- [ ] 委托类型、委托期限、委托方、签约方式、委托人类型、产权人、产权人姓名均为必填 +- [ ] 签约方式选择后，委托书区域动态加载对应模板内容 +- [ ] 委托人类型选择"授权第三方"时，需额外填写授权人信息 +- [ ] 每项附件上传最多支持 10 个文件 +- [ ] 提交成功后跳回房源详情页，业务信息面板"委托"一栏更新状态，"全部（N）"数量+1 +- [ ] 新增委托操作自动写入跟进日志 + +--- + +### 5.4.10 业务信息：实勘管理 + +#### 5.4.10.1 新增实勘 + +**入口**：其他跟进 Tab → 业务信息面板 → "新增实勘"按钮 + +**功能说明**：经纪人对房源进行实地勘察（简称"实勘"）后，在系统中提交实勘报告，包括实地说明和分类实勘照片。实勘记录是房源维护完成度的核心权重项（16%），也是保障房源信息真实性的关键环节。 + +**页面布局**：新增实勘为**独立页面**（非浮窗 Modal），包含以下区块： + +##### 顶部提示区 + +- 显示实地核验说明：若该小区不支持实地核验，显示"该小区不支持实地核验，无需拍图" + +##### 区块一：实勘信息 + +| 字段 | 类型 | 必填 | 说明 | +|------|------|------|------| +| 实勘定位 | 只读文本/GPS | — | 显示"—"表示当前未获取定位（支持 GPS 定位功能） | +| 实勘说明 | 文本区域 | 否 | 最多 200 字，描述实地情况 | + +##### 区块二：实勘相册 + +实勘照片按空间分类上传，规则如下： + +| 分类 | 最低上传数量要求 | 说明 | +|------|--------------|------| +| 户型图 | 至少 1 张 | 必须上传，支持手绘/打印户型图 | +| 绘制户型图 | — | 与户型图并列 Tab，支持手绘上传 | +| 客厅 | 至少 2 张（客厅和餐厅任意上传 2 张即可） | 必须上传 | +| 餐厅 | 至少 2 张（客厅和餐厅任意上传 2 张即可） | 必须上传（与客厅共享要求） | +| 卧室 | 至少 2 张 | 必须上传 | +| 卫生间 | 至少 1 张 | 必须上传 | +| 厨房 | 至少 1 张 | 必须上传 | +| 玄关 | 无最低要求 | 选填 | +| 阳台 | 无最低要求 | 选填 | +| 书房 | 无最低要求 | 选填 | +| 室内其他 | 无最低要求 | 选填 | +| 室外 | 无最低要求 | 选填 | + +**实勘相册顶部辅助功能**： +- 图片大小限制：每张最大 20MB +- "VR 一键截图"按钮：快捷从已有 VR 素材截取图片 +- "批量上传照片"按钮：支持一次性多选并上传 + +**底部操作**： +- 提交实勘：保存并提交实勘记录 +- 另存草稿：暂存未完成的实勘，不计入维护完成度 +- 取消：返回上一页 + +**交互规则**： +- [ ] 标有星号（*）的照片分类为必填项（户型图、客厅、餐厅、卧室、卫生间、厨房），未上传时不可提交实勘 +- [ ] 客厅和餐厅照片数量合并计算，两类合计 ≥ 2 张即满足要求 +- [ ] 每类照片支持单张点击上传或拖拽上传 +- [ ] "VR 一键截图"按钮仅在该房源已有 VR 素材时可用，否则置灰 +- [ ] 提交成功后跳回房源详情页，业务信息面板"实勘"一栏更新状态 +- [ ] 新增实勘记录后，房源维护完成度"实勘"维度得分更新 +- [ ] 实勘记录自动写入跟进日志 --- @@ -996,3 +1332,15 @@ - 更改房源用途：`Project/fonrey/sreenshots/房源/更改房源用途.png` - 看房时间：`Project/fonrey/sreenshots/房源/看房时间.png` - 挂牌历史记录：`Project/fonrey/sreenshots/房源/挂牌历史记录.png` + +**跟进管理截图（v1.3 新增）**： +- 跟进管理-全部：`Project/fonrey/sreenshots/房源/跟进管理/全部.png` +- 跟进管理-写入跟进：`Project/fonrey/sreenshots/房源/跟进管理/写入跟进.png` +- 跟进管理-敏感信息跟进：`Project/fonrey/sreenshots/房源/跟进管理/敏感信息跟进.png` +- 跟进管理-敏感信息查看：`Project/fonrey/sreenshots/房源/跟进管理/敏感信息查看.png` +- 跟进管理-修改跟进：`Project/fonrey/sreenshots/房源/跟进管理/修改跟进.png` +- 跟进管理-其他跟进（含业务信息面板）：`Project/fonrey/sreenshots/房源/跟进管理/其他跟进.png` +- 新增钥匙：`Project/fonrey/sreenshots/房源/跟进管理/新增钥匙.png` +- 备注钥匙在他司：`Project/fonrey/sreenshots/房源/跟进管理/钥匙在他司.png` +- 新增委托：`Project/fonrey/sreenshots/房源/跟进管理/新增委托.png` +- 新增实勘：`Project/fonrey/sreenshots/房源/跟进管理/新增实勘.png` diff --git a/wiki/concepts/Analogy-as-Straitjacket.md b/wiki/concepts/Analogy-as-Straitjacket.md new file mode 100644 index 00000000..b280a055 --- /dev/null +++ b/wiki/concepts/Analogy-as-Straitjacket.md @@ -0,0 +1,63 @@ +--- +title: "Analogy as Straitjacket" +type: concept +tags: + - "Conceptual Thinking" + - "AI Tooling Design" +last_updated: 2026-04-13 +--- + +# Analogy as Straitjacket（类比作为束缚） + +## Definition +类比是探索新领域的自然方式——通过将未知映射到已知，降低认知成本并借用已有的理解框架。然而，一旦深度理解形成后仍固守类比，类比就会从**认知杠杆**转变为**思维枷锁**，阻碍更深层次的洞察和更好的替代设计方案。 + +## Mechanism +``` +阶段1: 类比作为杠杆 + - 借用已知领域的框架理解新领域 + - 提供初始认知入口 + - 帮助建立初步直觉 + +阶段2: 深度理解形成 + - 新领域有了独立的理解框架 + - 类比不再提供额外价值 + - 开始出现失配和不精确 + +阶段3: 类比成为束缚 + - 困在类比框架中解读一切 + - 难以采用不同视角 + - 过度简化抹杀了复杂性 + - 排挤更好的设计方案 +``` + +## Case Study: AI Tooling +[[The Picture They Paint of You]] 指出当前 AI 工具设计中的类比困境： + +**软件工厂类比**（Software Factory）： +- 将软件开发类比为工厂制造 +- 导致泰勒制回归——工人被视为可替代的生产单元 +- 忽视了软件工程的创造性、探索性和学习性本质 + +**AI SRE 的类比**： +- 将 AI SRE 类比为"替代者"或"下属" +- 暗示 SRE 工作是可以被标准化和替代的体力活 +- 忽视了 SRE 中的判断力、上下文理解和从事故中学习的能力 + +## Core Argument +> "As much as an analogy can be a lever, it can also be a straitjacket. When you're stuck inside a model, you interpret everything in its own terms, and it becomes much harder to adopt a different perspective or to break out of the oversimplification." + +更好的类比应该： +- 反映工作的真实复杂性 +- 给予人类工作者应有的尊严和判断力 +- 承认人类与 AI 的协作而非替代关系 +- 在深度理解后能够被抛弃 + +## Connections +- [[Taylorism]] ← 过度类比的产物 ← Analogy as Straitjacket +- [[AI SRE]] ← 被类比框架束缚 ← Analogy as Straitjacket +- [[Software Factory]] ← 泰勒制类比 ← Analogy as Straitjacket +- [[The Picture They Paint of You]] ← 核心论点 ← Analogy as Straitjacket + +## Sources +- [[the-picture-they-paint-of-you]] diff --git a/wiki/concepts/Left-over-Principle.md b/wiki/concepts/Left-over-Principle.md new file mode 100644 index 00000000..a2430b14 --- /dev/null +++ b/wiki/concepts/Left-over-Principle.md @@ -0,0 +1,51 @@ +--- +title: "Left-over Principle" +type: concept +tags: + - "Automation Theory" + - "Labor Economics" +last_updated: 2026-04-13 +--- + +# Left-over Principle（剩余原则） + +## Definition +剩余原则（Left-over Principle）是一个历史观察：在自动化进程中，一项工作的**部分**可以被自动化和集中化，而**剩余难以自动化的部分**则堆积到更少的人身上——这些人负责完成机器无法处理的复杂任务，然后协调其余部分的自动化。 + +该概念最早由 Jesse Robbins 在《A Mature Role for Automation》文章中提出（KitchenSoap, 2013）。 + +## Mechanism +``` +原始工作 → 部分自动化 → 剩余工作堆积 + ↘ 少数人承担 + ↘ 协调自动化 +``` + +自动化不是简单地"替代"工作，而是**重新分配**工作的复杂性： +- 容易自动化的部分 → 交给机器 +- 难以自动化的部分 → 人类专家承担 +- 人类角色从"执行者"转变为"协调者和判断者" + +## Application in AI SRE Context +[[The Picture They Paint of You]] 引用了这一原则来反驳"AI SRE 将完全替代人类 SRE"的论点： + +> "This does not mean organizations can fully succeed in the substitution effort. Time and time again history has shown that *part* of a role can be automated and centralized, and the rest of it will be piled onto fewer individuals who will do the hard-to-automate bits and will then coordinate the automation for the rest of it." + +这意味着即使 AI SRE 能自动化大部分 SRE 工作，仍然需要人类： +- 理解无法自动化的边界在哪里 +- 在自动化系统失败时接管 +- 协调 AI 和人工的配合 +- 从事故中提取新模式来改进自动化系统 + +## Implications +1. **AI SRE 不会消灭 SRE 角色**，而是改变其性质——从执行者变成协调者和监督者 +2. **SRE 的价值被低估**：难以自动化的 SRE 工作（理解业务上下文、复杂故障诊断、跨团队协调）恰恰是最需要人类判断力的高价值工作 +3. **自动化能力提高**会导致对 SRE 协调能力的需求**增加**而非减少 + +## Connections +- [[AI SRE]] ← 被分析 ← Left-over Principle +- [[SRE]] ← 剩余价值被凸显 ← Left-over Principle +- [[The Picture They Paint of You]] ← 引用 ← Left-over Principle + +## Sources +- [[the-picture-they-paint-of-you]] diff --git a/wiki/concepts/Taylorism.md b/wiki/concepts/Taylorism.md new file mode 100644 index 00000000..e3ea75e4 --- /dev/null +++ b/wiki/concepts/Taylorism.md @@ -0,0 +1,36 @@ +--- +title: "Taylorism" +type: concept +tags: + - "Scientific Management" + - "AI Tooling" +last_updated: 2026-04-13 +--- + +# Taylorism（泰勒制） + +## Definition +Taylorism（泰勒制/科学管理）是由 Frederick Winslow Taylor 在 19 世纪末提出的管理哲学，核心思想是将制造业工作分解为最简单、最重复的动作，通过标准化流程和时钟管理最大化劳动效率。工人被视为可替代的生产单元，而非具有创造性和判断力的知识工作者。 + +## Role in AI Tooling Debate +在 [[The Picture They Paint of You]] 一文中，作者指出当前的"AI 软件工厂"（Software Factory）框架正在回归泰勒制思维： + +- Anthropic 的 Agent Teams 将团队成员定位为"在你之下"的下属，核心话语是**控制** +- GasTown 将开发者抽象为产品经理，整个开发团队变成更深层级的代理层级 +- OpenAI Codex 定位为"智能编码的指挥中心"，暗示人类控制者指挥一群无面孔的代理 +- 这些框架将软件工程视为可以被分解、标准化的流水线工作，而非需要创造力、判断力和上下文理解的复杂知识劳动 + +## Core Critique +泰勒制框架的问题在于： + +1. **将知识工作还原为体力工作**：软件开发不仅是执行指令，还包括需求理解、架构决策、技术判断——这些本质上需要人类专业知识 +2. **忽视学习的价值**：Taylor 的框架假设最优方法可以被一次性发现并固定；真正的软件工程需要从事故和错误中持续学习 +3. **默许工作贬值**：接受泰勒制的 AI SRE 框架意味着接受"SRE 工作是低地位杂活"的叙事，这会进一步压低该角色的薪酬和社会认可 + +## Connections +- [[AI SRE]] ← 被泰勒制框架批评 ← Taylorism +- [[Software Factory]] ← 回归泰勒制的表现 ← Taylorism +- [[类比作为束缚]] ← Taylorism 的另一种表达 ← [[The Picture They Paint of You]] + +## Sources +- [[the-picture-they-paint-of-you]] diff --git a/wiki/index.md b/wiki/index.md index 788e0a4c..d4dceb42 100644 --- a/wiki/index.md +++ b/wiki/index.md @@ -4,6 +4,7 @@ - [Overview](overview.md) — living synthesis ## Sources +- [2026-04-22] [The Picture They Paint of You](sources/the-picture-they-paint-of-you.md) - [2026-04-22] [Nano Banana 提示词框架](sources/nano-banana-提示词框架.md) - [2026-04-22] [谷歌深夜甩出一份【Nano Banana Pro提示词指南】，手把手教你生产专业级内容，实战案例+提示词模版](sources/谷歌深夜甩出一份-nano-banana-pro提示词指南-手把手教你生产专业级内容-实战案例-提示词模版.md) - [2026-04-22] [详细！离线部署大模型：ollama+deepseek+open-webui安装使用方法及常见问题解决 1](sources/详细-离线部署大模型-ollama-deepseek-open-webui安装使用方法及常见问题解决-1.md) @@ -413,7 +414,6 @@ - [2026-04-18] [best-7-news-api-data-feeds-ai-news](sources/best-7-news-api-data-feeds-ai-news.md) — (expected: wiki/sources/best-7-news-api-data-feeds-ai-news.md — source missing) - [2026-04-18] [useful-prompt-lib](sources/useful-prompt-lib.md) — (expected: wiki/sources/useful-prompt-lib.md — source missing) - [2026-04-18] [二创视频必不可少-2025年最热门ai工具推荐合集-ai配音-声音克隆](sources/二创视频必不可少-2025年最热门ai工具推荐合集-ai配音-声音克隆.md) — (expected: wiki/sources/二创视频必不可少-2025年最热门ai工具推荐合集-ai配音-声音克隆.md — source missing) -- [2026-04-18] [the-picture-they-paint-of-you](sources/the-picture-they-paint-of-you.md) — (expected: wiki/sources/the-picture-they-paint-of-you.md — source missing) - [Your-AI-Isn-t-Stupid---It-Just-Needs-a-Better-Harness--Lychee-Technology-Engineering-Blog](sources/Your-AI-Isn-t-Stupid---It-Just-Needs-a-Better-Harness--Lychee-Technology-Engineering-Blog.md) — (expected: wiki/sources/Your-AI-Isn-t-Stupid---It-Just-Needs-a-Better-Harness--Lychee-Technology-Engineering-Blog.md — source missing) - [Expose-hermes-agent-as-an-OpenAI-compatible-API-for-any-frontend](sources/Expose-hermes-agent-as-an-OpenAI-compatible-API-for-any-frontend.md) — (expected: wiki/sources/Expose-hermes-agent-as-an-OpenAI-compatible-API-for-any-frontend.md — source missing) - [zk-steward](sources/zk-steward.md) — (expected: wiki/sources/zk-steward.md — source missing) @@ -709,6 +709,7 @@ - [AI簡報工作流](concepts/AI簡報工作流.md) - [Alerting](concepts/Alerting.md) - [AmbientMessageMonitoring](concepts/AmbientMessageMonitoring.md) +- [Analogy-as-Straitjacket](concepts/Analogy-as-Straitjacket.md) - [APT-仓库配置](concepts/APT-仓库配置.md) - [arXiv-API](concepts/arXiv-API.md) - [Asset-Management](concepts/Asset-Management.md) @@ -861,6 +862,7 @@ - [launchd](concepts/launchd.md) - [Layered-Configuration](concepts/Layered-Configuration.md) - [Lead-Time](concepts/Lead-Time.md) +- [Left-over-Principle](concepts/Left-over-Principle.md) - [LLM-Wiki](concepts/LLM-Wiki.md) - [Local-Caching](concepts/Local-Caching.md) - [Local-first-Git](concepts/Local-first-Git.md) @@ -976,6 +978,7 @@ - [systemd](concepts/systemd.md) - [Task-Query](concepts/Task-Query.md) - [TaskAutomation](concepts/TaskAutomation.md) +- [Taylorism](concepts/Taylorism.md) - [TCP隧道](concepts/TCP隧道.md) - [Telegram-Trigger](concepts/Telegram-Trigger.md) - [Telephony-Integration](concepts/Telephony-Integration.md) diff --git a/wiki/log.md b/wiki/log.md index bd51bfce..4027cd91 100644 --- a/wiki/log.md +++ b/wiki/log.md @@ -1,3 +1,15 @@ +## [2026-04-23] ingest | The Picture They Paint of You +- Source file: AI/The Picture They Paint of You.md +- Status: ✅ 成功摄入 +- Summary: 探讨 AI 工具的市场定位如何折射对人类工作者的隐性认知。对比 10+ 款 AI SRE 产品和 8+ 款 Coding Assistant 的营销话语，发现：AI SRE 被建构为"替代者"，Coding Assistant 被建构为"合作伙伴"。这种差异映射了组织内部对不同角色真实价值的认知分裂，暗示决策者与从业者之间对工作意义理解的根本分歧。 +- Concepts created: [[Taylorism]], [[Left-over-Principle]], [[Analogy-as-Straitjacket]] +- Source page: wiki/sources/the-picture-they-paint-of-you.md +- Notes: + - 新增 Sources 条目至 index.md + - 新增 3 个 Concept 页面：Taylorism.md、Left-over-Principle.md、Analogy-as-Straitjacket.md + - 冲突检测：与 wiki/sources/what-i-know-about-cloud-service-delivery-1.md 中 SRE 角色认知存在冲突（已记录至 source page Contradictions 部分） + - Entities: Anthropic、GitHub Copilot、OpenAI Codex、Cline、AWS DevOps Agent 均未创建独立页面（属产品类 Entity，命名类 Entity 价值待定） + ## [2026-04-23] ingest | Nano Banana 提示词框架 - Source file: AI/Nano Banana 提示词框架.md - Status: ✅ 成功摄入 diff --git a/wiki/sources/the-picture-they-paint-of-you.md b/wiki/sources/the-picture-they-paint-of-you.md new file mode 100644 index 00000000..d366c81c --- /dev/null +++ b/wiki/sources/the-picture-they-paint-of-you.md @@ -0,0 +1,58 @@ +--- +title: "The Picture They Paint of You" +type: source +tags: + - "AI SRE" + - "Coding Assistant" + - "AI Tooling" + - "Labor Perception" +date: 2026-04-13 +--- + +## Source File +- [[AI/The Picture They Paint of You]] + +## Summary（用中文描述） +- 核心主题：AI 工具的市场定位如何折射出对人类工作者的隐性认知 +- 问题域：AI SRE（站点可靠性工程）和 AI Coding Assistant 两大类 AI 工具的营销话语框架差异 +- 方法/机制：横向对比 10+ 款 AI SRE 产品和 8+ 款 Coding Assistant 的营销文案，提炼命名策略和话语框架 +- 结论/价值：AI 工具的命名与定位不只是营销技巧，更是一种对工作价值的隐性评判——软件工程被建构为"值得赋能的合作伙伴"，而 SRE 被建构为"需要被替代的障碍物"。这种差异映射了组织内部对不同角色真实价值的认知分裂，也暗示决策者与从业者之间对工作意义理解的根本分歧。 + +## Key Claims（用中文描述） +- AI SRE 的营销话语普遍将 SRE 工作框架为低价值、可替代的"杂活"——"停止救火""让工程师摆脱繁琐排障""无需全员参与事故处理"，而 Coding Assistant 则强调"赋能""增强""合作伙伴"——"为你构建""让你掌控""让建设者继续建设" +- 命名本身即是态度：大多数 AI SRE 直接以"AI SRE"命名（直接替代目标角色），而 Coding Assistant 普遍采用人名或隐喻性名称（Copilot/Cline/Cascade）——命名方式暗示了工具被期待扮演的角色 +- AI 工具的市场定位同时映射了**买家（管理者）**对工作的看法，而非仅反映工具本身的能力——当你销售"替代者"时，只需说服付钱的人；当你销售"合作伙伴"时，需要同时说服使用工具的员工和管理者 +- 类比思维既是探索新领域的杠杆，也可能是束缚——泰勒制工厂框架和低地位工作框架一旦被接受，就会在社会层面默许并强化这些刻板印象，代价是排挤更好的替代设计方案 + +## Key Quotes +> "Coding assistants are framed as augmenting engineers and are given names, and AI SREs are named 'AI SRE' and generally marketed as a good way to make sure nobody is distracted by unproductive work." — 核心对比 +> "Software Engineering work is perceived as valuable work; the engineer is in control and deserves more power, more control, more productivity. The AI exists to be a partner, a teammate, or an assistant." — AI SRE 眼中的软件工程 +> "Software Reliability Engineering work is a hindrance; teams need to be distracted less by these tasks and instead focus on more valuable work. Human limitations—such as needing to sleep—need to be overcome. The AI exists to replace or be a substitute to the worker." — AI SRE 眼中的 SRE +> "The picture they paint of you says a lot. Just not about you." — 结论 +> "As much as an analogy can be a lever, it can also be a straitjacket." — 关于类比思维的局限性 +> "In accepting the Taylorist software factory frameworks or AI SREs built while framing the work as low-status, we also—at a social level—tacitly amplify these representations and give them validity." — 对泰勒制框架的批判 + +## Key Concepts +- [[AI SRE]]：站点可靠性工程的 AI 替代方案，营销话语普遍以"替代"为核心框架 +- [[Coding Assistant]]：编码助手，营销话语普遍以"赋能/增强"为核心框架 +- [[Taylorism]]（泰勒制）：科学管理思想，以效率为核心将工人视为可替代的生产单元，本文认为 AI 软件工厂框架正在回归泰勒制思维 +- [[剩余原则（Left-over Principle）]]：历史表明一项工作的部分可被自动化，剩余难以自动化的部分则堆积到更少的人身上 +- [[类比作为束缚（Analogy as Straitjacket）]]：类比既可以是探索新领域的杠杆，也可能在深度理解后仍被其框架所限制 + +## Key Entities +- [[Anthropic]]：Claude Code 的开发商，引入 Agent Teams 概念，定位为"在你之下"的团队成员，核心话语是"控制" +- [[GitHub Copilot]]：命名采用协作角色隐喻（副驾驶），定位为加速工作流程的伙伴，强调"在你主导下协作" +- [[OpenAI Codex]]：定位为"智能编码的指挥中心"，是少数明确趋向替代角色的 AI 编码工具之一 +- [[Cline]]："你的编码伙伴"——唯一直接采用伙伴（partner）语言的编码助手 +- [[AWS DevOps Agent]]：定位为"全天候自主值班工程师"，直接替代人类值班工程师 + +## Connections +- [[AI SRE]] ← 工作价值被低估 ← [[SRE]]（wiki 中已存在） +- [[Anthropic]] ← Claude Code 产品定位 ← [[Claude Code]]（AI Coding Assistant） +- [[Taylorism]] → 回归趋势 ← [[AI 软件工厂框架]]（Software Factory） + +## Contradictions +- 与传统 SRE 认知冲突（[[what-i-know-about-cloud-service-delivery-1]]）： + - 冲突点：SRE 被认为是低成本、可替代的"杂活" vs SRE 被认为是保障系统可靠性的高价值职能 + - 当前观点（本文）：AI SRE 的营销话语揭示了 SRE 工作被决策者视为低地位、应被自动化的观点 + - 对方观点：Cloud Service Delivery 文章将 SRE 视为多学科团队的核心组成部分，与 FinOps/安全并列