dachui/order_site
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
10464fea89b6cae346c5e2dd799dc6b5d01d0303
order_site/apps/backend
T
History
yml2213 10464fea89 refactor(product-match): 抽离接单模板匹配引擎（来源适配器/引擎/价格收口 + 后台按订单项试匹配） 
新增 services/product-match：来源适配器（kuaishou-91 合成 91+快手 / pdd / douyin-mashida）+ 平台无关匹配上下文 + 条件打分引擎（并列最高=ambiguous 不猜、逐维诊断）+ 价格数量拼单唯一实现。

- 商店键命名空间化（kuaishou:/pdd:/douyin:），店铺为可选作用域：留空即可按订单信息匹配
- 抖音匹配文本只取内部 SKU，引流标题只进 promoTitle，itemTitle 恒空（修复 0.85 元误命中碎梦浮光珍宝礼盒、拼单未开）
- work-product-match-mappers 改为门面（签名不变），work-order-pricing 改为转发
- 新增后台「按订单项试匹配」接口与面板：走发单同一套链路，返回模板/数量/单价/总额/拼单
- 生产样本回放：91/PDD 6000 条决策 0 差异；抖音 5 条全为修正

设计见 docs/接单模板匹配引擎重构设计.md
2026-10-14 15:58:21 +08:00
..
data
feat(pdd): 原生内嵌拼多多多店铺订单同步子服务与anti-content纯算引擎
2026-09-12 14:12:11 +08:00
scripts
fix(worker-platform): 补齐拼单份额超时自动处置机制与退回大厅流程
2026-10-11 14:53:56 +08:00
src
refactor(product-match): 抽离接单模板匹配引擎（来源适配器/引擎/价格收口 + 后台按订单项试匹配）
2026-10-14 15:58:21 +08:00
.gitignore
脱敏运行配置和旧文档
2026-05-25 22:27:11 +08:00
eslint.config.js
接入 ESLint 并清理未使用代码
2026-08-16 18:04:55 +08:00
package-lock.json
准备迁移1
2026-08-23 12:54:38 +08:00
package.json
chore(douyin-mashida): 新增推送订阅与自测脚本
2026-10-09 12:43:34 +08:00
README.md
优化：降低访问日志噪声并增加日志文件轮转
2026-08-30 16:59:11 +08:00
tsconfig.build.json
统一前后端代码格式化配置
2026-08-16 17:27:12 +08:00
tsconfig.eslint.json
接入 ESLint 并清理未使用代码
2026-08-16 18:04:55 +08:00
tsconfig.json
统一前后端代码格式化配置
2026-08-16 17:27:12 +08:00

README.md

order-site-backend

快手轻量后端：订单入库、履约任务编排、91 卡券 / kuaishou-cloud / kuaishou-feifei / 行业电子凭证对接、后台管理接口，以及数据库迁移。

快速启动

npm install
cp ../../.env.mac-docker.example ../../.env
npm run dev

推荐优先用仓库根目录 Docker 开发环境（含 PostgreSQL 与 Caddy）。

生产构建：

npm run build
npm run start

常用验证：

npm run typecheck
npm run build
npm test

配置

环境变量来自工作区根目录 .env：

  • 默认值：src/config/defaults.ts
  • 覆盖：根目录 .env

常用项：

变量 说明
PORT 服务端口（Compose 中常由 BACKEND_PORT 映射）
LOG_LEVEL debug / info / warn / error
LOG_MAX_FILE_SIZE_MB 单个应用日志文件大小上限，默认 20 MB，超出后轮转
LOG_MAX_FILES 同一日期最多保留的日志文件数量，默认 5（含当前文件）
LOG_RETENTION_DAYS 日志日期保留天数，默认 30
DATABASE_URL PostgreSQL 连接串
ADMIN_SESSION_SECRET 后台登录态签名密钥
ADMIN_DEFAULT_USERS_JSON 默认后台用户
KAQUAN91_USER_ID / KAQUAN91_SECRET 91 卡券凭据

接口

路径 说明
GET /health 健康检查
GET /health/live 存活
GET /health/ready 就绪
/api/v1/open/91/* 91 卡券开放接口
/api/v1/open/kuaishou-industry/* 快手行业电子凭证
/api/v1/open/kuaishou-feifei/* 发货平台 feifei 回调等
/api/v1/claim/* 领取页接口
/api/v1/admin/* 后台管理
/s/* 短链跳转

目录

路径 职责
src/index.ts 服务入口
src/app.ts Express 组装
src/routes API 路由
src/services/order 订单与任务同步
src/services/fulfillment 履约路由与执行器
src/services/platforms 外部平台实现
src/services/admin 后台读写与配置
src/repositories 数据库访问
src/db/migrations SQL 迁移

数据库迁移

策略：001 基线 + 后续渐进增量。

文件 作用
src/db/migrations/001_init.sql 空库完整基线结构
src/db/migrations/002_*.sql 起 增量变更

规则：

  1. 已应用的迁移文件禁止改内容。
  2. 结构变更只新增文件，不回写 001_init.sql。
  3. 启动时自动执行未应用迁移；记录在 schema_migrations。
  4. 文件名必须为 NNN_name.sql（三位序号）。

命令：

# 对齐状态
npm run db:migrate:status

# 手动 up
npm run db:migrate

# 创建下一份增量（生成 00N_xxx.sql 模板）
npm run db:migrate:create -- add_something

创建后编辑 SQL，与业务代码一并提交。Docker 开发环境示例：

docker compose -f ../../docker-compose.dev.yml exec -T backend npm run db:migrate:create -- add_something
docker compose -f ../../docker-compose.dev.yml exec -T backend npm run db:migrate

Docker 开发

开发 Compose 会挂载源码：

  • postgres 提供开发库
  • 后端启动时安装依赖并 npm run dev
  • 改 src/ 或 .env 通常不必重建镜像

需要重建 backend 镜像的情况：

  • deploy/docker/backend*.Dockerfile 变更
  • Node 版本或系统依赖变更
  • package.json / package-lock.json 变更

运行产物

日志默认：

  • data/logs/app-YYYY-MM-DD.log
  • data/logs/integration-YYYY-MM-DD.log

按天切分并按大小轮转，默认单文件 20MB、单日最多 5 个分片、保留 30 天。成功的 GET/HEAD 请求以 DEBUG 记录，生产默认 LOG_LEVEL=info 不落盘；写请求和所有 4xx/5xx 仍保留 access log。成功的 /health* 探活默认不写 access log。

data/*.json 为本地运行配置，可能含敏感信息，默认不提交；请从 *.example.json 复制后填写。

Reference in New Issue View Git Blame Copy Permalink