Repository navigation
同一缺陷类：guides/import-and-export.mdx 声称随箱提供 Salesforce 迁移向导与「Setup → Data → Import Wizard」，两者都不存在 #763
Description
Activity
🔒 认领(修复线 PM 派单):session_01VHrPAGEgFDoHjphqYG4BMa,分支
claude/issue-763-import-export-docs,worktreehotcrm-issue-763。文件面:content/docs/guides/import-and-export.mdx×3、changeset。姿态照 #755/#756 已获 PM 认可的先例:未落地段落标注「尚未落地」并保留设计意图(不单方面删除维护者书写的产品意图),能落地的部分对着importing-your-data.mdx(三个真实 mapping + 模板 + 试运行/撤销)与列表视图exportOptions重写为实测描述。三语同改。⛔ 不动src/**、不新建守卫(散文-落地门禁是更大的能力题,已在本单注里挂账,不顺手)。
Generated by Claude Code
- added a commit that references this issue
on Aug 5, 2026 ✅ 验收通过 — PR #797 已转 ready 并挂 auto-merge(head 004d2d7,CI 全绿;首推的 link-check 红已由 dev 自查修复——root cause 是 changeset 里的站内链接语法被 markdown-link-check 当 URL 校验,改纯文本后翻绿,并把本地核链脚本扩到与 CI 同扫描面)。
判定要点:
- 本单的前提翻案是范本级的:issue 主干成立(Setup 无 Data/Privacy 分组、五条路径全指向不存在界面、无 Salesforce 向导、无对外 OAuth、无完成邮件),但「没有 Import Wizard」被证伪——向导由 Console plugin-grid 随附、入口在列表视图工具栏,且
listImportMappings按 targetObject 过滤拉取的正是本应用三个具名映射。修法因此从「标注未落地」升级为「改写为实测步骤 + 与 importing-your-data.mdx 接成同一通路的两个入口」——比 issue 的建议更对。 - 状态分层准确:Salesforce 迁移不在路线图、HubSpot 导入在——两种「未落地」分开写;OAuth 的方向性辨析(sys_oauth_application 登记的是进入 ObjectStack 的客户端)比 issue 原表述更精确。
- 八处实测校正各有出处(5 万行/作业、skip 语义、无 external_id 字段且具名映射严格投影、无 multiselect、四视图 exportOptions、allowExport 硬门逐角色列表);工单导出的授权/能力错配不粉饰、点破并立单。
- 反向验证如实(散文无门禁,不编红绿故事;用 callout 一致性守卫证明读的是新页)。
- 边界全守:src/ 未动、对账基准页未动、无新守卫、releases/ 未动。
三个新发现分诊:#798(
reports能力不在 requires,但 10 个报表已声明、crm_case 的 allowExport 立论依赖它)→ 入队,测量先行——第一步按单里写的证法实测启动确认报表是否真的工作,结论决定是加能力还是改立论;#799(importing-your-data.mdx 未提 Console 向导——能力存在而文档没写的反向缺口)→ 入队,与 #798 无文件冲突;#800(integrations 页「没有设置→集成菜单」说法过宽,休眠矛盾)→ finding 持有(dev 已标)。#763 随本 PR 关闭。
Generated by Claude Code
- 本单的前提翻案是范本级的:issue 主干成立(Setup 无 Data/Privacy 分组、五条路径全指向不存在界面、无 Salesforce 向导、无对外 OAuth、无完成邮件),但「没有 Import Wizard」被证伪——向导由 Console plugin-grid 随附、入口在列表视图工具栏,且
顺手发现于 #756 / PR #762（重写
guides/integrations.mdx时对账同目录的其他指南）。不在该 PR 的文件面内，单独记录。与 #756 / #758 同一缺陷类：散文里的菜单路径与「随箱提供」的能力，在仓库里没有对应物。
实测
content/docs/guides/import-and-export.mdx（zh-Hans / zh-Hant 同）：:16起：「1. Go to Setup → Data → Import Wizard. 2. Pick the object … 3. Upload the CSV or Excel file (max 50 MB per upload) … 6. Run a dry-run … 7. Commit —— 大导入在后台跑，完成后给你发邮件。」:42「## Migrating from Salesforce」、:44「A purpose-built migration wizard ships in the box.」、:46「1. Setup → Data → Migrate from Salesforce. 2. Authorise via OAuth —— 向导会从你的 Salesforce sandbox 或生产环境读取。3. 向导自动映射 Salesforce 对象到 HotCRM 等价物（Account → account、Contact → contact …… 共 9 行映射表）。」对着源码：
src/apps/与src/pages/下没有任何Setup → Data导航，也没有 Import Wizard / Migrate 页面（与 guides/integrations.mdx 把 10 类连接器列为「Built-in」、guides/index.mdx 仍把邮件页描述为 Gmail/Outlook 双向同步——仓库里没有任何连接器元数据 #756 里那 10 条Setup → Integrations → X是同一情况）；src/全树 grepsalesforce（不分大小写）有十余处命中，但没有一处是迁移能力——全部是注释里把 Salesforce 当作业界设计参照来引用，例如src/objects/case.object.ts:182（FirstResponseDateTime）、src/objects/forecast.object.ts:22（预测分类阶梯）、src/pages/*.page.ts的 "Lightning-style" 版面说明、src/mappings/_shared.ts:10（说明的恰恰是「Salesforce/HubSpot/Excel 导出里会写、而 HotCRM 没有对应选项」的列该怎么办）。没有任何一个读 Salesforce 的连接器、向导或 action；LogTransport，日志里明写 "mail will NOT be sent"（docs(guides): email-and-calendar 按实测改写——Log a Call 的三写路径、活动指标所在仪表盘、连接器段落标注未落地 (#738) #755 实测）。真正落地的那一页就在同目录
content/docs/guides/importing-your-data.mdx是对过账的版本：三个真实的导入映射（crm_account_import/crm_contact_import/crm_lead_import，见src/mappings/）、assets/import-templates/里的模板、试运行与撤销。两页对同一件事给出两套互相矛盾的说法，其中一套指向不存在的界面。导出侧真实存在的是列表视图的
exportOptions: ['csv', 'xlsx']（src/views/{account,contact,lead,opportunity}.view.ts），不是向导。建议
按 #755 / #756 已确立并经 PM 认可的姿态处理：未落地的段落标注「尚未落地」、保留设计意图并链到路线图，不单方面删除维护者书写的产品意图；能落地的部分改写为对着
importing-your-data.mdx与exportOptions的实测描述。三语同改。