旧数据导出

功能目标

旧数据导出用于加盟商到期不续签、门店资料交接或历史数据备份场景。运营可以在云平台一次选择小羽佳门店和金刚到家门店，导出两套系统中的历史订单、合同、补签合同和服务阿姨信息。

适用角色

角色	使用方式
运营负责人	导出加盟商历史业务数据，确认导出范围和文件交付。
客服/门店对接人	按门店名称预检查数据量，下载导出文件。
产品/技术	核对导出口径、任务状态和异常原因。

入口位置

云平台后台：合同管理 → 旧数据导出。

主流程

1. 在“小羽佳门店”输入门店名称或门店 ID，选择匹配门店；搜索结果包含正常门店和历史停用门店。页面默认先展示一批候选门店，并显示“已展示 / 总门店数”，需要时可继续加载或输入关键字精确搜索。
2. 在“金刚门店”输入门店名称或门店 UUID，选择匹配门店。
3. 如需限定范围，选择数据时间；不选择时默认导出全部历史数据。
4. 点击“预检查”，确认两边门店、订单数、合同数、补签数和门店阿姨数。
5. 填写导出原因，例如“加盟商到期不续签，门店资料交接备份”。
6. 点击“一键导出”，系统创建后台任务。
7. 任务完成后，在任务列表点击“下载”获取 Excel 文件。

导出口径

Sheet	数据范围
家姐联盟订单	小羽佳门店历史订单，包含客户、产品、金额、支付、服务人员和地址。
家姐联盟合同阿姨	小羽佳主合同，按订单所属门店和经纪人所属门店取并集。
家姐联盟补签阿姨	小羽佳补签合同，按订单所属门店和经纪人所属门店取并集。
家姐联盟门店阿姨	小羽佳门店服务员工/阿姨并集，包含门店档案阿姨，以及历史主合同、补签合同中出现过的新旧阿姨。
金刚到家订单合同	金刚到家的订单按合同口径导出，即合同就是订单。
金刚到家补签阿姨	金刚到家补签合同，关联主合同门店。
金刚到家门店阿姨	金刚门店阿姨并集，包含门店档案阿姨，以及历史主合同、补签合同中出现过的新旧阿姨。

导出文件只包含明细 Sheet，不生成第一页汇总页。

合同金额字段

字段	业务口径
合同约定阿姨工资（劳务报酬）	小羽佳主合同和补签取合同劳务报酬；金刚主合同优先取劳务报酬，历史合同缺失时取家政员工资，金刚补签取补签劳务报酬。
家政员工资（历史字段）	仅在金刚主合同 Sheet 展示，用于保留早期合同的原始家政员工资记录，不替代统一工资列。
客户服务费	金刚合同中客户向门店支付的服务费，与阿姨劳务报酬分别展示。
订单原价	小羽佳订单创建时的初始金额。
应收金额	小羽佳订单最终应收金额。
已付金额	小羽佳订单当前已支付金额。

纯数字金额会写成可计算的 Excel 数值，可直接求和和排序。历史数据中的工资区间、按天金额、中文金额等内容会保留合同原文，不自动推算为单一金额。

日期和时间字段会按 Excel 日期类型导出并显示为可读时间。例如“最后支付时间”显示为 年-月-日 时:分:秒，不会显示为 Excel 内部日期序列号。

核心规则

• 不选择数据时间时，导出全部历史数据。
• 预检查只统计数量，不拉取完整明细，避免大门店预检查超时。
• 小羽佳门店搜索不按启用状态过滤，已停用或历史门店也可以检索并导出。
• 小羽佳门店数量较多，页面不会一次性展开全部门店，避免浏览器卡顿；门店全量范围通过搜索接口覆盖。
• 金刚到家不再按普通订单表判断订单数，统一按合同记录作为订单数据。
• 小羽佳和金刚合同统一展示“合同约定阿姨工资（劳务报酬）”；金刚早期合同如未填写劳务报酬，使用历史家政员工资字段补足。
• 小羽佳合同和补签中的订单金额分为订单原价、应收金额和已付金额，不再使用含义不明确的“订单金额”。
• “最后支付时间”等时间字段按日期时间格式展示，不按金额格式处理。
• 阿姨信息分两类导出：合同/补签中的阿姨字段用于还原历史签约记录；门店阿姨 Sheet 用于交接门店档案阿姨和历史业务关联阿姨，避免转店、离职或补签换人导致遗漏。
• 所有状态都会导出，包括有效、作废、取消、暂存、终止等状态。
• 门店阿姨 Sheet 会展示关联来源，便于区分门店档案、主合同、补签新阿姨和补签原阿姨。
• 导出文件不包含数据库字段名、技术状态码等不适合给门店备份的字段。
• 导出任务异步执行，生成完成后提供下载链接。
• 创建导出任务必须填写导出原因，任务列表会保留操作人、导出原因、任务状态和完成后的数量统计。

异常处理

异常	处理方式
搜不到门店	先查看“已显示 / 总数”确认小羽佳门店总量，再换门店简称、全称或门店 ID 搜索。
预检查数据为 0	先确认门店是否选错，再确认是否选择了过窄的数据时间。
任务失败	查看失败原因，确认后点击“重试”。
下载链接打不开	重新刷新任务列表；仍失败时联系技术检查 OBS 上传状态。

运营配合

• 给加盟商交付前，先检查 Excel 中门店名称、阿姨关联来源和数据量是否符合预期。
• 涉及合同金额核对时，以“合同约定阿姨工资（劳务报酬）”作为统一工资口径，并分别核对订单原价、应收金额和已付金额。
• 核对订单支付信息时，“最后支付时间”应显示完整日期和时间；如出现纯数字日期序列号，应停止交付并重新生成文件。
• 如果只选择一套系统，另一套系统对应 Sheet 会保留表头但没有数据。
• 文件用于历史备份，不代表当前合同继续履约或续签状态。
• 导出文件包含客户和阿姨个人信息，只能提供给有交接授权的加盟商或内部负责人。

客户口径

可对加盟商说明：平台会按门店维度导出历史服务订单、合同和服务人员信息，用于到期后的资料备份。导出内容以平台留存记录为准。

上线检查

• 菜单 合同管理 → 旧数据导出 可见。
• 有合同导出权限的角色可以访问页面。
• 小羽佳门店和金刚门店均可搜索；小羽佳门店显示总数，并可加载更多候选。
• 预检查能返回数据量。
• 创建任务后任务列表可刷新状态。
• 任务完成后可下载 Excel。
• 任务列表能看到导出原因和导出数量。
• 合同和补签 Sheet 能看到“合同约定阿姨工资（劳务报酬）”；纯数字工资可在 Excel 中求和，历史文本工资保持原文。
• 小羽佳合同和补签 Sheet 同时展示订单原价、应收金额和已付金额。
• 家姐联盟订单 Sheet 的“最后支付时间”显示为可读日期时间，不显示 Excel 日期序列号。