dachui/order_site
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
1,102 Commits 3 Branches 0 Tags
5d1ba115235cef1de2c4f2c54a1767dc7fa22a7f
Commit Graph
37 Commits
Author SHA1 Message Date
yml2213 7bacb7d5eb docs: 重构项目文档并补充三块载体、成本中心与人工支出方案 
合并本轮全部文档改动（原 5 个 docs 提交压成 1 个）。

口径与索引：
- 新增 docs/README.md 文档总索引：三来源口径（91 + 快手 send-code = kuaishou-91）、
  「一个订单 = 骨架 + 买家凭证 + 一个执行载体」、成本只改一处、文档状态机
- 过期阶段文档移入 docs/archive/2026-10-08/（保留内容，不删除）

分析报告：
- docs/项目全量分析报告-2026-10-17.md：架构、五条业务链路、P0/P1/P2 风险与改进路线
- docs/载体判定与成本中心落地-复核与草案-2026-10-17.md：生产只读克隆量化、上一轮结论复核与 4 处修正

方案文档：
- docs/成本中心与三块履约模型.md：三块执行载体、标准商品、成本版本与快照、人工支出登记
- docs/财务系统集成方案.md：复式记账模型、分录表、分期落地
- docs/影子总账说明.md：影子期与转正期的边界、对账与转正标准

SQL 草案（docs/drafts/，未接入迁移）：
- 载体判定与人工块量化.sql：量化查询、carrier_type 判定与回填、守恒校验
- 成本中心与销售事实-DDL草案.sql：product_catalog / channel_product_mappings /
  cost_items / cost_versions / cost_snapshots / cost_exceptions / sales_daily_facts
- 人工支出登记-DDL草案.sql：manual_fulfillment_cases / manual_expense_records / manual_expense_events

业务口径确认（2026-10-17）：
- 收入 = 用户实付（orders.total_amount），与快手 paymentFen 数据核验 100% 一致
- 打手报酬 = 支出/成本（最终提现打款），按总额法
- 人工块以「支出可追溯」为先，SLA 监管延后
- 退款/仲裁暂未接入，先预留字段与反向冲正关系

三份草案已在一次性沙箱库按依赖顺序零错误应用（10 张新表、27 个 CHECK 约束）。
 2026-10-17 22:03:03 +08:00
yml2213 0b48313617 feat(deploy): 部署改成按需重建，无 schema 变更自动跳过备份 
每次部署都无条件重建 backend + web 两个镜像（实测后端 3m35s、前端 2m54s），
并且每次都在迁移前 pg_dump + 传 OSS（生产 492MB dump 那一步约 12 分钟）；
只改了后端也要把前端整条链重跑一遍。

改动：
- 新增 deploy/lib/classify-changes.sh：把改动文件映射成"要重建哪一端"，
  规则保守——apps/backend/** → backend、apps/frontend/**|deploy/caddy/**|前端 Dockerfile → web、
  文档/部署脚本/测试文件 → 不重建，compose 文件与未知路径 → 两端都重建。
- ubuntu-deploy.sh 用 .deploy-state（上次成功部署的 commit + .env 指纹）算 git diff，
  未变化的一端不 build、也不 --force-recreate，容器保持运行；若它没在跑则用现有镜像拉起。
  两端都要建时合并为一次 compose build（bake 并行）。
- 备份：改动不含 apps/backend/src/db/migrations/** 时自动跳过（--backup 强制、
  --skip-backup 无条件跳过）；算不出改动范围（首次使用、force push）时不自动跳过。
- compose pull 改 --policy missing：不再每次重新校验 postgres tag，避免顺手静默升级数据库镜像。
- 新增 --dry-run（打印计划后退出，含基础镜像 digest）、--all、--backend-only/--web-only；
  部署结束打印各阶段耗时，回答"这次怎么比上次慢"不用靠推算。
- .deploy-state 进 .gitignore；README 与 docs/部署启动与数据库重建.md 同步。

验证：新增 7 个用例直接执行分类脚本断言"改动→重建范围"，并守住"状态只在健康检查后才落盘"
等关键顺序；全量 595 个单测、typecheck、lint、check:sql 全通过。
 2026-10-03 16:29:05 +08:00
yml2213 ccb5b6f4d6 docs: 清理过时文档（以代码为准） 
删除（整篇已被代码淘汰 / 重复副本 / 与仓库无关）：
- cloudflared_tunnel.txt：全仓无 cloudflared 配置，个人终端记录，无任何引用
- 履约配置/工程债-lewan拆分与短链.md：文中 services/kuaishou-cloud 与 kuaishou-cloud-executor 已删除
- 履约配置/快手Cloud领取mock.md：mock:claim / mock:feifei 与 dev-mock 卡片已移除（只剩 mock:open91）
- 行业电子凭证/解决方案/技术方案/1.基础技术.md（+ 其孤立 image.png）：0.基础技术.md 的 75 行截断副本
- 寄卖库存功能设计与实施方案.md：手工入库已 409 停用、收集链接表已随 079 删除、统计看板未实现
- 服务器图片迁移到阿里云OSS.md：MinIO→OSS 迁移已完成（生产 STORAGE_MODE=oss）
- pgBackRest备份方案分析.md：全仓无 pgBackRest 落地痕迹，文档自述暂缓实施
- finance-implementation-plan.md：财务模块已落地（072 迁移 / RBAC / 页面接口），已实现部分与代码重复
  （未落地的二期三期路线图可从本提交的历史版本取回）

改写为与代码一致（已下线通道不再当作现行能力）：
- 履约配置/多发货平台与电子凭证整体链路.md：kuaishou-cloud / kuaishou-feifei 标注为已下线 legacy stub，
  现行自动通道 affiliate-dash、人工 manual_dispatch；核销时机与券表按实现校正
- 履约配置/{UID领取与旧单兼容, open91请求, TypeScript类型收紧}.md：lewan/feifei/cloudtentacles 表述改为
  现行 affiliate-dash 链路；normalize 具名类型 KuaishouCloudFlow/FeifeiFlow → AffiliateDashFlow
-  affiliate_dash_发货平台/affiliate-dash对接.md：§13/§14/§19/§21/§24/§25 的已删文件与已下线通道引用校正，
  §21/§22 加「当时快照 / 落地后现状」横幅，回调去重表按 013_affiliate_dash_webhook_events.sql 改写
- 91卡券/{3.异步卡密下单, 5.当前项目对接配置, 6.开发设计}.md：删掉不存在的后台入口、
  cloudtentacles/kuaishou_ct_assisted 依赖、cardsEncoding 与 .js 代码落点校正
- 行业电子凭证/技术方案.md：checklist 指向不存在的 测试用例.md → gen-test-cases.ts + 5.测试指南.md
- 履约配置/cloudtentacles发货平台.md：补「本仓库未接入该通道」说明（保持外部参考）
- 部署启动与数据库重建.md：补齐生产必需变量 APP_DOMAIN / CORS_ALLOWED_ORIGINS / STORAGE_MODE / STORAGE_OSS_*

其它：
- README.md：迁移序号范围 002~009 → 002~080
- 寄卖系统迁移079上库前检查.sql：第 2 段注释按批次 Y 的自动去重更新；新增 2.1「重复退款风险」只读排查
  （已在一次性 PostgreSQL 16 上跑通 001→080 迁移：整份脚本 exit=0，脏数据下 2/2.1 均按预期报警）
- 寄卖系统优化方案.md：删掉链路图里已下线的「客服手工录入」，去掉指向已删设计稿的引用
 2026-09-17 16:57:27 +08:00
yml2213 d47360f484 改用本地推送质量检查 2026-08-31 12:32:13 +08:00
yml2213 a1b3d9c70c docs: README 补充 ubuntu 部署脚本的 --skip-backup 等参数说明 2026-08-30 14:25:32 +08:00
yml2213 12ca943170 优化打手注册和列表筛选 2026-08-20 09:52:51 +08:00
yml2213 5c7c3e14e3 统一前后端代码格式化配置 2026-08-16 17:27:12 +08:00
yml2213 bc2909d6f2 打手端迁移至独立子域名 2026-08-16 16:08:38 +08:00
yml2213 e097ddad3d 支持领取链接长期有效 2026-08-11 14:06:29 +08:00
yml2213 2227cda73d 修复打手短信验证码发送 2026-08-02 15:12:02 +08:00
yml2213 043dd3c128 优化readme 2026-08-02 08:38:35 +08:00
yml2213 1155b3c608 文档对齐 React 技术栈，并支持渐进式数据库迁移 
将 README 与部署文档从仅 init 改为 001 基线 + 增量迁移约定，并补充 create/status 脚手架与序号校验。
 2026-07-10 12:36:36 +08:00
yml2213 dbcb5a4979 重命名前端目录 2026-07-07 19:55:18 +08:00
yml2213 4d7f9cbca2 增加ubuntu部署脚本 2026-05-26 16:54:30 +08:00
yml2213 6d9f267593 统一91卡券环境变量命名 2026-05-26 09:56:52 +08:00
yml2213 779287f662 精简环境变量配置 2026-05-26 09:48:05 +08:00
yml 851d1d1efc 清理轻量版残留文案 2026-05-25 23:17:01 +08:00
yml 90ad866ecc 收口数据库初始化脚本 2026-05-25 22:31:50 +08:00
yml b1979eea94 脱敏运行配置和旧文档 2026-05-25 22:27:11 +08:00
yml e7aa194dde 删除咸鱼旧链路 2026-05-25 21:46:39 +08:00
yml db22ff691b 拆分快手轻量后端入口 2026-05-25 20:42:27 +08:00
yml 6a9c231026 修复OCR容器编排 2026-05-21 17:57:34 +08:00
yml 0931975ed4 后端移除内嵌OCR子服务 2026-05-21 17:46:12 +08:00
yml 1476522ab5 后端建立 TypeScript 构建链路 2026-05-21 13:36:38 +08:00
yml 25671078d6 修复一些的过时测试 优化readme 2026-05-21 13:16:07 +08:00
yml 3b169df114 优化服务端部署-测试部署-1 2026-04-14 23:27:56 +08:00
yml2213 fa36be6539 后端可视化调试 2026-04-14 00:21:32 +08:00
yml a95247cd01 修复错误 2026-04-09 18:11:02 +08:00
yml 60054adcc4 彻底重构-3 2026-04-09 12:24:14 +08:00
yml a2b09c89e8 开始多平台 多店铺整改 2026-04-08 22:21:11 +08:00
yml d5b10e3f7f uv下载加速-2 2026-04-08 18:11:44 +08:00
yml 5787925179 Playwright 版本降到稳定旧版 2026-04-08 17:43:26 +08:00
yml c09368d2c2 Playwright固定官方镜像 2026-04-08 17:25:55 +08:00
yml 79c0fcb221 国内 PyPI 安装 uv 更稳 2026-04-08 17:13:52 +08:00
yml 92970780a4 优化下载速度, 配置镜像站-2 2026-04-08 17:09:31 +08:00
yml 1c3e306e36 优化下载速度, 配置镜像站 2026-04-08 17:05:25 +08:00
yml 313c036845 init 2026-04-08 16:30:42 +08:00