A端（公司后台 `a.kailashi.cn`）功能缺口与补建清单

生成时间：2026-09-23 ｜ 数据来源：①后端 backend/app/routers/*.py 全量路由静态解析 ②A端 admin-console/src/services/api.ts 实际调用解析 ③线上 https://a.kailashi.cn 带真实管理员 token 实测

一、总账

指标数值
后端接口总量374
A端已接入调用25
未接入总数346
其中平台管控（/admin）未接108
已接接口的实测健康度GET 类全部 200（无故障）

核心结论：A端不是坏了，是没开发完。 后端能力已就绪，后台只消费了 6.7%。

特别说明：menu.ts 中「分销运营 / 福钥配置」仍标注「WIP-303 后端待落地」，该注释已过时——实测对应接口全部 200 且返回真实数据。误导源于注释未随后端交付更新。

二、A端现有已接能力（确认可用，勿重复建设）

方法路径
—/api/admin/audit-logs
—/api/admin/cms/posts
—/api/admin/cms/posts/{id}
—/api/admin/cms/posts/{id}/offline
—/api/admin/cms/posts/{id}/publish
—/api/admin/merchants/{id}/status
—/api/admin/orders
—/api/admin/orders/{id}/intervene
—/api/admin/orders/{id}/interventions
—/api/admin/stats/overview
—/api/miniapp/admin/config/current
—/api/miniapp/admin/config/publish
—/api/miniapp/admin/config/rollback
—/api/miniapp/admin/config/versions
—/api/miniapp/admin/destinations
—/api/miniapp/admin/merchant-pages
—/api/miniapp/admin/merchant-pages/{id}
—/api/miniapp/admin/merchants
—/api/miniapp/admin/merchants/{id}
—/api/miniapp/auth/password-login
—/api/miniapp/identity
—/api/miniapp/packages/admin
—/api/miniapp/packages/admin/all
—/api/miniapp/packages/admin/{id}
—/api/miniapp/packages/admin/{id}/status

三、缺口清单（按优先级，实测状态码为真实线上结果）

实测列图例：✅ 200 = 带有效 token 直连返回成功，可直接接页面；⚠️ 422 = 该接口有必填参数（GET 需 query / POST 需 body），探活时未传故被参数校验拦下，属正常校验不是故障；⚠️ 0 = 请求超时；— = 含路径参数未逐个探测。

P0 · 涉钱 · 分销与结算（22 个未接）

模块文件：backend/app/routers/admin_distribution.py ｜ 业务说明：分销商审核/冻结、佣金记录结算作废、提现审核打款、风险裁决、保障支付、全局配置

方法接口路径线上实测
GET/api/admin/distribution/config⚠️ 422
GET/api/admin/distribution/distributors✅ 200
GET/api/admin/distribution/overview✅ 200
GET/api/admin/distribution/records✅ 200
GET/api/admin/distribution/risk✅ 200
GET/api/admin/distribution/settings✅ 200
GET/api/admin/distribution/withdrawals✅ 200
POST/api/admin/distribution/bills/generate⚠️ 422
POST/api/admin/distribution/distributors/{id}/approve—（含路径参数）
POST/api/admin/distribution/distributors/{id}/freeze—（含路径参数）
POST/api/admin/distribution/distributors/{id}/unfreeze—（含路径参数）
POST/api/admin/distribution/guest-bindings/{id}/release—（含路径参数）
POST/api/admin/distribution/protection-pay⚠️ 422
POST/api/admin/distribution/records/{id}/settle—（含路径参数）
POST/api/admin/distribution/records/{id}/void—（含路径参数）
POST/api/admin/distribution/risk/{id}/ruling—（含路径参数）
POST/api/admin/distribution/subscription/{id}/confirm—（含路径参数）
POST/api/admin/distribution/withdrawals/{id}/approve—（含路径参数）
POST/api/admin/distribution/withdrawals/{id}/paid—（含路径参数）
POST/api/admin/distribution/withdrawals/{id}/reject—（含路径参数）
PUT/api/admin/distribution/config⚠️ 422
PUT/api/admin/distribution/settings⚠️ 422

P0 · 风控运营 · 运营管控（20 个未接）

模块文件：backend/app/routers/admin_ops.py ｜ 业务说明：对账汇总、路况发布、护照寺庙、AI 配置、天气窗口规则、商户动态、测试数据清理

方法接口路径线上实测
DELETE/api/miniapp/admin/passport/temples/{id}—（含路径参数）
DELETE/api/miniapp/admin/updates/{id}—（含路径参数）
GET/api/miniapp/admin/ai-config✅ 200
GET/api/miniapp/admin/config/weather-window-rules✅ 200
GET/api/miniapp/admin/orders/{id}/interventions—（含路径参数）
GET/api/miniapp/admin/passport/temples✅ 200
GET/api/miniapp/admin/recon-summary✅ 200
GET/api/miniapp/admin/road-status✅ 200
GET/api/miniapp/admin/test-data/summary⚠️ 0
POST/api/miniapp/admin/ai-config/test✅ 200
POST/api/miniapp/admin/merchants/{id}/updates—（含路径参数）
POST/api/miniapp/admin/orders/{id}/intervene—（含路径参数）
POST/api/miniapp/admin/passport/temples⚠️ 422
POST/api/miniapp/admin/test-data/cleanup⚠️ 422
POST/api/miniapp/admin/weather-window/run✅ 200
PUT/api/miniapp/admin/ai-config⚠️ 422
PUT/api/miniapp/admin/config/weather-window-rules⚠️ 422
PUT/api/miniapp/admin/merchants/{id}/profile—（含路径参数）
PUT/api/miniapp/admin/passport/temples/{id}—（含路径参数）
PUT/api/miniapp/admin/road-status⚠️ 422

P0 · 权限与退款 · 后台基础能力（15 个未接）

模块文件：backend/app/routers/admin_backend.py ｜ 业务说明：身份列表/撤销、角色、商品详情与组件、商户签约与费率档、退款执行

方法接口路径线上实测
DELETE/api/admin/products/{id}—（含路径参数）
DELETE/api/admin/products/{id}/components/{id}—（含路径参数）
GET/api/admin/identities✅ 200
GET/api/admin/merchants/{id}/service-fee-profile—（含路径参数）
GET/api/admin/products✅ 200
GET/api/admin/products/{id}—（含路径参数）
GET/api/admin/roles✅ 200
POST/api/admin/identities/{id}/revoke—（含路径参数）
POST/api/admin/login⚠️ 422
POST/api/admin/merchants/{id}/sign—（含路径参数）
POST/api/admin/orders/{id}/refund/execute—（含路径参数）
POST/api/admin/products⚠️ 422
POST/api/admin/products/{id}/components—（含路径参数）
POST/api/admin/track/event⚠️ 422
PUT/api/admin/products/{id}—（含路径参数）

P0 · 入驻把关 · 商户入驻审核（5 个未接）

模块文件：backend/app/routers/miniapp_merchant_applications.py ｜ 业务说明：入驻申请列表/详情、开始审核、通过、驳回

方法接口路径线上实测
GET/api/miniapp/merchant-applications/admin✅ 200
GET/api/miniapp/merchant-applications/admin/{id}—（含路径参数）
POST/api/miniapp/merchant-applications/admin/{id}/approve—（含路径参数）
POST/api/miniapp/merchant-applications/admin/{id}/reject—（含路径参数）
POST/api/miniapp/merchant-applications/admin/{id}/start-review—（含路径参数）

P0 · 入驻把关 · 民宿申请审核（4 个未接）

模块文件：backend/app/routers/miniapp_homestay_applications.py ｜ 业务说明：民宿申请列表/详情、通过、驳回

方法接口路径线上实测
GET/api/miniapp/homestay-apply/admin✅ 200
GET/api/miniapp/homestay-apply/admin/{id}—（含路径参数）
POST/api/miniapp/homestay-apply/admin/{id}/approve—（含路径参数）
POST/api/miniapp/homestay-apply/admin/{id}/reject—（含路径参数）

P1 · 在地内容与规则（14 个未接）

模块文件：backend/app/routers/admin_content.py ｜ 业务说明：POI / 路线 / 攻略知识 / 规则 全套增删改

方法接口路径线上实测
DELETE/api/miniapp/admin/content/knowledge/{id}—（含路径参数）
DELETE/api/miniapp/admin/content/pois/{id}—（含路径参数）
DELETE/api/miniapp/admin/content/routes/{id}—（含路径参数）
DELETE/api/miniapp/admin/content/rules/{id}—（含路径参数）
GET/api/miniapp/admin/content/knowledge✅ 200
GET/api/miniapp/admin/content/pois✅ 200
GET/api/miniapp/admin/content/routes✅ 200
GET/api/miniapp/admin/content/rules✅ 200
POST/api/miniapp/admin/content/knowledge⚠️ 422
POST/api/miniapp/admin/content/pois⚠️ 422
POST/api/miniapp/admin/content/routes⚠️ 422
POST/api/miniapp/admin/content/rules⚠️ 422
PUT/api/miniapp/admin/content/pois/{id}—（含路径参数）
PUT/api/miniapp/admin/content/routes/{id}—（含路径参数）

P1 · 故事管理（6 个未接）

模块文件：backend/app/routers/miniapp_stories.py ｜ 业务说明：故事列表、创建、编辑、发布、下线、删除

方法接口路径线上实测
DELETE/api/miniapp/stories/admin/{id}—（含路径参数）
GET/api/miniapp/stories/admin✅ 200
POST/api/miniapp/stories/admin⚠️ 422
POST/api/miniapp/stories/admin/{id}/offline—（含路径参数）
POST/api/miniapp/stories/admin/{id}/publish—（含路径参数）
PUT/api/miniapp/stories/admin/{id}—（含路径参数）

P1 · 场景管理（4 个未接）

模块文件：backend/app/routers/scenes.py ｜ 业务说明：场景列表、创建、更新、删除

方法接口路径线上实测
DELETE/api/miniapp/admin/scenes/{id}—（含路径参数）
GET/api/miniapp/admin/scenes✅ 200
POST/api/miniapp/admin/scenes⚠️ 422
PUT/api/miniapp/admin/scenes⚠️ 422

P1 · 套餐任务项与订单（4 个未接）

模块文件：backend/app/routers/packages.py ｜ 业务说明：任务项完成/释放、订单指派、mock 支付

方法接口路径线上实测
POST/api/miniapp/packages/admin/items/{id}/complete—（含路径参数）
POST/api/miniapp/packages/admin/items/{id}/release—（含路径参数）
POST/api/miniapp/packages/admin/orders/{id}/assign—（含路径参数）
POST/api/miniapp/packages/admin/orders/{id}/mock-pay—（含路径参数）

P1 · 员工账号（3 个未接）

模块文件：backend/app/routers/employees.py ｜ 业务说明：员工删除、改密、邀请链接

方法接口路径线上实测
DELETE/api/miniapp/admin-settings/employees/{id}—（含路径参数）
GET/api/miniapp/admin-settings/employees/invite-link✅ 200
PUT/api/miniapp/admin-settings/employees/{id}/password—（含路径参数）

P2 · 站点文案（3 个未接）

模块文件：backend/app/routers/miniapp_site_texts.py ｜ 业务说明：白标文案读取与删除

方法接口路径线上实测
DELETE/api/miniapp/site-texts/admin/{id}/{id}—（含路径参数）
GET/api/miniapp/site-texts/admin✅ 200
PUT/api/miniapp/site-texts/admin/{id}/{id}—（含路径参数）

P2 · 管理员安全设置（2 个未接）

模块文件：backend/app/routers/admin_settings.py ｜ 业务说明：密码修改、二次验证

方法接口路径线上实测
POST/api/miniapp/admin-settings/password⚠️ 422
POST/api/miniapp/admin-settings/verify⚠️ 422

待定 · admin（2 个未接）

模块文件：backend/app/routers/admin.py ｜ 业务说明：

方法接口路径线上实测
POST/api/miniapp/admin/identities/grant⚠️ 422
POST/api/miniapp/admin/staff/invite⚠️ 422

待定 · miniapp_config_governance（1 个未接）

模块文件：backend/app/routers/miniapp_config_governance.py ｜ 业务说明：

方法接口路径线上实测
GET/api/miniapp/admin/config/draft✅ 200

待定 · miniapp_messages（2 个未接）

模块文件：backend/app/routers/miniapp_messages.py ｜ 业务说明：

方法接口路径线上实测
GET/api/miniapp/messages/admin/broadcasts✅ 200
POST/api/miniapp/messages/admin/send⚠️ 422

待定 · settings（1 个未接）

模块文件：backend/app/routers/settings.py ｜ 业务说明：

方法接口路径线上实测
PUT/api/miniapp/admin/settings/{id}—（含路径参数）

四、现有三个空壳页面（对应后端已就绪，可直接改为真页面）

页面文件行数当前状态后端依赖现状
结算分账 Settlement.tsx26仅显示「尚未上线」占位distribution/records、records/{id}/settle、withdrawals 均已可用
核销对账 RedeemLedger.tsx27仅显示「端点未提供」占位/api/miniapp/admin/recon-summary 已 200
配置中心 Settings.tsx344 项全标「待开放」distribution/settings、ai-config 已可用

五、路径两套体系（补页面时的硬约束）