2.1 KiB
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,再执行验证;不要直接替换当前生产服务并把静态核对当作运行验收。