小冈接手知识库 · 后端端点地图(2026-09-05 盘点)

用途:随时顶替小齐/开发岗时的手边索引。盘点基线=仓库 main(09-05);生产容器 routers 53 文件(B1 后)/staging 同步。
每域速查:文件 → 前缀 → 用途 → 鉴权要点。

一、C 端小程序域(/api/miniapp/*)

域文件前缀要点
miniapp_site/api/miniapp/site站点配置类
miniapp_status/api/miniapp/status路况(today/confirm);L1 路况端点(status-states 接线争议点)
miniapp_messages/api/miniapp/messages消息中心(stats/unread/alerts/read)
miniapp_products/api/miniapp/products商品(list/detail/addons;price=元浮点)
miniapp_orders/api/miniapp/orders订单域核心:precheck/create/list/detail/pay(501 暂停)/cancel/review/pending-services/refund-preview/refund/confirm-consumed;4 硬规则退款、60s 幂等、owner 闸
miniapp_redemption/api/miniapp/redemption核销码(列表/单码/verify 商户侧)
miniapp_user/api/miniapp/user用户(info/passport/footprints/medals/checklist)
miniapp_merchants/api/miniapp/merchants商户 presentation 等
miniapp_distribution/api/miniapp/distribution分销(share-code/commissions/settle/guests/subscription)
miniapp_guide_profiles/api/miniapp/guide-profiles向导档案列表/详情(id=guide_profiles.id≠users.id;review 一期空)
miniapp_workbench_redeem/api/miniapp/workbench-redeemB 端核销台
miniapp_bills/api/miniapp/bills服务费账单(B 端只读)
scenes/api/miniapp/scenes场景引擎(list/{id}/judge/progress/checkin/certificate;J 域全链路)
packages/api/miniapp/packages套餐(list/detail/orders 下单=package_orders 独立域;admin/partner 子路由)
feed_demand/api/miniapp/(stats/trustweather/todayrecommendations/*today/kora-trackersguides/:id/levelme/assets-overviewcontent/*merchants/:id/presentationservices/categories)B-011 十接口({ok,data} 包装!前端未发版前请求层已兼容)
calendar/api/miniapp/calendar藏历(月度节日/upcoming)
recommendations/api/miniapp/recommendations推荐位(A1;price=分)
safety/api/miniapp/safetySOS(POST 必带坐标/cancel/assessment)
weather/api/miniapp/weather天气(today/full/window;sourceName=气象法权威)
demand/api/miniapp/demands需求单(详情/interest 商户侧/close/renew)
auth/api/miniapp/auth微信登录/login/me(token 体系)
identity/api/miniapp/identity身份(mode/permissions;G7 管理入口显隐)
upload?/api/miniapp/upload图片上传(G8)
files/api/files文件服务
guides (content-b 域)/api/miniapp/guides攻略(list/{id} 正文;B1)

二、B 端 / 管理端域

三、迁移台账(backend/sql/,生产执行至 048 已落——B1 步④「047/048 新执行 2/跳过 44」)

段迁移生产状态
001-030基础+订单+员工+服务费+核销✅ 已执行(029 marked 异常已修账 WIP-155)
032-036天气窗口/分销域/schema 补/任务域护照/逆向定制对齐✅(B1 前已入生产? 034-036 见台账——生产 46 文件齐)
037-041员工角色三档/场景引擎/任务模板/双轨福钥/B-011✅ B1 步④ 047/048 为最新(040/041 早些批次已随 B1? —— 以 migrate.sh 台账 46 文件为准)
042-048最新批次(含 047 服务费? 048 双轨?)✅ B1 已落 047/048
049merchants business_type/quota_tier + service_fee_records(WIP-196 阿仁)⏳ 待 WIP-196 推 main 后执行(DEPLOY_WITH_MIGRATIONS=1 或 migrate.sh)

四、鉴权与身份速记