Files

2.1 KiB

源码迁移交付说明

目标是独立仓库中的 TypeScript 源码迁移,原有两个仓库不修改。用户负责创建仓库,并授权 bot 初始化空仓库;后续迁移使用 codex/typescript-monorepo,面向 main 创建 PR,等待用户手动合并。

验证

  • workspace 静态类型检查:npm run typecheck(无输出产物)。
  • 结构检查:55 个旧 handler、17 个页面、11 张表、184 个旧字段。
  • 新增 6 项行为回归测试源码,包含外部 Fernet 固定向量、来源边界、杠杆止损、签名绑定、保守回测与缺失宏观指标。测试未执行。
  • 应用启动、功能测试、数据库操作、编译构建、部署和线上验证均未执行。

接口存在和类型通过并不等于行为等价已经验证。交易执行、并发操作、重启恢复、数据迁移、价格同步、第三方采集和消息推送都需要后续运行验收,本次没有将这些标为通过。

迁移中的明确调整

  • App Router 的 layout/server component 数据加载转换为 _app、_document 和 getServerSideProps,页面和 SEO 元数据保留。
  • HTTP 与持续运行任务拆分为 API 和 worker;价格、事件、控制状态和绑定码改为跨进程共享。
  • 使用 PostgreSQL advisory lock 串行化交易操作;嵌套锁复用连接,避免锁占满查询连接池。
  • Python 加密数据的 base64url padding 保持兼容;密钥不进入报告或 Git。
  • IOC 平仓只有部分成交时,保留已实现分段收益与剩余仓位,不提前报为全部平仓。
  • 资金费率等已知提醒来源继续发送提醒,但不会进入自动开仓;未知来源仅入库。
  • Python 运维脚本整合为 TypeScript 命令。历史调参实验不自动运行;原归档策略不重新启用。
  • SQLite 不作为新进程运行数据库,提供离线只读导入命令;实际数据未迁移。

后续人工步骤

PR 等待用户手动合并。若以后需要运行测试或构建,应先确认远程 runner,再执行验证;不要直接替换当前生产服务并把静态核对当作运行验收。