合同到期与审批跟进台账

你是一名擅长 Windows 桌面软件的资深工程师。请帮我做一个本地运行的 Windows 小工具，使用者是公司法务同事，关注业务结果和操作体验。

【目标】

把所有合同集中登记、按状态跟进、到期前自动提醒，避免漏签漏催。

【平台与技术】

- Windows 10/11 桌面应用
- Electron + React + TypeScript
- 本地 SQLite
- 打包成 Windows .exe 安装包
- 完全离线

【核心功能】

1. 首页卡片列表：可按状态筛选；可按到期日排序；每张卡片左侧有状态色块（红黄绿）。
2. 新建 / 编辑合同：表单清晰，必填项标注；"附件"字段支持选本地文件，保存相对路径而非复制。
3. 待办看板：单独一页，汇总所有"待寄送 / 待签回 / 30 天内到期"的合同，便于每周例会使用。
4. 自动提醒规则（可在设置里改）：
   - 到期前 30 天 -> 红色
   - 到期前 60 天 -> 黄色
   - 其他 -> 绿色
5. 风险视图：集中列出缺附件、到期日为空、待签回超过 7 天、到期未续约、金额为空但合同类型需要金额的记录。
6. 导入 / 导出：
   - Excel 批量导入，表头：对方 / 类型 / 金额 / 币种 / 签署日 / 生效日 / 到期日 / 状态 / 备注。
   - 导出待办清单到 Excel，字段包括：编号 / 对方 / 状态 / 到期日 / 剩余天数 / 风险原因 / 建议动作，作为法务周会材料。
7. 隐私保护：
   - 敏感字段（金额、对方名称）在列表页可切换"隐藏"按钮，临时遮蔽便于共享屏幕。
   - 不联网，不上传。
8. 搜索 / 筛选：支持关键词搜索合同编号、对方、备注。

【界面风格】

- 业务型：表格清晰、信息密度适中、分隔线柔和。
- 状态色块饱和度低；不用刺眼红。
- 字体系统默认；中英双语可切换。
- 深浅模式跟随系统。

【稳健性】

- 数据库损坏自动恢复到最近备份。
- 表单必填项缺失时友好提示不崩溃。
- 日期错乱（生效日晚于到期日）给出提示。
- 附 3 份示例数据：正常合同、待签回超期、到期日缺失 / 日期错乱。

【数据模型】
合同字段：编号（自动）、对方名称、合同类型、金额、币种、签署日、生效日、到期日、续约周期、经办人、当前状态、续约负责人、提前提醒天数、备注、附件路径（指向本地文件）。

状态：起草中、待寄送、待签回、已生效、到期、已终止。

【约束】
- 全部本地处理，数据不上传外部服务。
- 缺真实数据时先造脱敏 sample-data，不等用户提供文件才开工。
- 不引入不存在的 npm 包；不确定时先查 npm view。
- 不写死 API Key、绝对路径、个人邮箱或内网地址。
- 输出不覆盖原文件，冲突加时间后缀。
- 同一问题 3 次失败 → 降级边缘功能，先交付主流程。

【交付】
1. 摘要需包含首页 / 编辑页 / 待办看板界面安排。
2. 分三步：卡片列表 + 新建 -> 待办看板 + 自动染色 -> 导入导出 + 隐私遮蔽。
3. 打包 .exe，附 500 字内中文使用说明。

验收清单（全部通过才算完成）：
□ 双击 .exe 启动，首页是合同卡片列表
□ 新建合同 → 表单填写 → 保存 → 列表显示
□ 到期前 30 天自动红色，60 天黄色
□ 待办看板汇总需跟进合同 → 导出 Excel
□ 敏感字段可切换隐藏/显示
□ 日期错乱、缺必填项 → 友好提示，不闪退

【高质量交付补充】
若上文要求等待确认，改为：≤8 行摘要后直接实现、运行、修复、验证；只因真实文件、账号、证书或不可逆操作停下。

【桌面交付契约】
- 交付本地可运行应用，不是方案；第一屏就是主工作台。M1≤15 分钟先出可启动窗口+示例数据/试用模式，M2 接通真实主流程，M3 补异常/UI/隐私，M4 测试+打包+文档。
- 没有用户真实文件时，先创建贴近业务的脱敏 sample-data 并继续推进。
- 每个里程碑卡住时的降级策略：M1 卡住 → 换更简单的实现方式先出窗口；M2 卡住 → 先跑通核心 3 步，边缘路径后面补；同一问题 3 次失败 → 降级或禁用边缘功能，先交付主流程。
- 每次汇报≤6行：完成、验证、跳过原因、下一步+预计时间，让进度清楚。
- 用业务语言写按钮、错误和说明；支持拖拽+系统打开/保存；空/错格式/取消/无权限/大文件/重名冲突都友好处理，不暴露堆栈。
- 路径兼容中文、空格、括号、长路径和 Windows/macOS 分隔差异；Windows 快捷键用 Ctrl/Alt，macOS 用 Command/Option。
- 默认离线、本地处理；不覆盖原文件；不写死密钥、绝对路径、个人邮箱或内网地址。
- 项目分层：desktop shell / controlled API / UI / core / tests / sample-data / docs；IPC 白名单化，UI 不直接执行本地命令。
- 真实接线：导入、预览、生成/保存、导出、错误状态都可用；不把 TODO、空函数、未用大组件或假数据当完成。

【DoD / 停止 Vibe Coding】
完成标准（逐条检查，全部通过才停手）：
□ 能启动；示例数据跑通真实主流程并产生产物
□ 异常路径友好（空数据、错格式、取消、重名冲突 → 不闪退）
□ lint/typecheck/test/build 通过
□ 已用 sample-data 完成 启动 → 主流程 → 导出/保存 烟测，并记录结果
□ 有 setup/dev/package 脚本、README、使用说明、已知限制、示例数据
满足即停，新想法写 v2；同一 bug 3 次失败就降级或禁用边缘功能，先交付主流程。