Files

T

yml2213 b70741daec feat(admin): 后台可配领取链接/发消息模板 + 可见买家账号 + 修正皮肤领取链接

**面板新增三项（抖音码速达接入配置）**
- 领取链接基址 (claimLinkBase)：带实时预览「皮肤订单最终链接」，并拦截两类误配 ——
  带 `#`（`#/claim` 是打手领取页，会把买家带进绑定 UID 流程）、缺 http(s) 协议
- 发消息模板 (messageTemplate)：提示可用占位符；模板里没有 `{link}` 直接报错提示
- 付款后发领取消息开关 (claimMessageEnabled)
- 顺带把默认出网超时的展示值对齐后端（10s → 20s）

**后台可见买家提交的账号（运营发货依据）**
- `getAdminTaskDetail` 新增 `claimSubmission`，按 `canViewSensitiveTaskData` 门禁下发
  （与 claimToken 明文同一门禁）；任务详情新增「买家提交信息」卡片（可一键复制账号）

**修正：皮肤任务的领取链接**
- 详情接口原来用全局 `buildClaimUrl`（默认 hash 形式 `…/#/claim/…`），那是**打手**领取页；
  皮肤任务改用 `claimLinkBase + '/' + token`，运营复制给买家的链接才是买家页
- 顺带把「履约渠道」筛选项加上「皮肤自动发货」、任务详情执行器标签加上它、
  「来源渠道」加上「抖音码速达」（此前筛不出来抖音订单）

2026-10-09 15:06:49 +08:00

data

feat(pdd): 原生内嵌拼多多多店铺订单同步子服务与anti-content纯算引擎

2026-09-12 14:12:11 +08:00

scripts

chore(douyin-mashida): 新增推送订阅与自测脚本

2026-10-09 12:43:34 +08:00

src

feat(admin): 后台可配领取链接/发消息模板 + 可见买家账号 + 修正皮肤领取链接

2026-10-09 15:06:49 +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` 起	增量变更

规则：

已应用的迁移文件禁止改内容。
结构变更只新增文件，不回写 001_init.sql。
启动时自动执行未应用迁移；记录在 schema_migrations。
文件名必须为 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 复制后填写。

README.md Unescape Escape

order-site-backend

快速启动

配置

接口

目录

数据库迁移

Docker 开发

运行产物

README.md