closet-server
进入管理后台

智能衣橱 App 公开接口

智能衣橱 App 与外部调用方公开接口契约。本契约是 App/外部公开接口唯一结构化源头，不包含 Manage 后台接口。v20260727.1 将消息中心收敛为任务与系统消息两类展示：/messages、消息未读计数、已读和动作接口只处理 category=SYSTEM；天气穿搭提示仅在日历天气快照中即时返回，不再写入消息中心；Message.created_at 是服务端发送时间。延续 v20260726.1 的衣物四值 activity_status、五值 availability_status、角色级批量状态修改与 ACTIVE+AVAILABLE 推荐候选规则。

契约版本v20260727.1
模块数量23
接口数量130

范围：只包含 App/外部调用接口；不包含 Manage 后台接口。后端业务错误统一通过 JSON body.code 表示。

认证

验证码、第三方登录与登出

5

用户

当前用户资料、手机号绑定与风格偏好

8

角色

家庭成员角色资料与衣橱归属维度

4

形象

角色虚拟形象集合

5

衣物

衣物与图片资源。activity_status 使用 WISHLIST、ACTIVE、IDLE、DISPOSING 四值模型；availability_status 仅在 ACTIVE 下承载业务展示语义。终端可通过公开批量接口修改状态。

15

收纳

收纳位置

5

穿搭

穿搭方案

5

计划

穿搭计划

4

Calendar

日历、OOTD、计划候选、系统日程/待办和提醒聚合；天气穿搭提示只在日历天气快照内返回。

14

穿着

穿搭记录

4

统计

衣橱统计

3

首页

首页聚合与今日推荐

2

天气

天气代理能力

1

TaskCenter

账号级衣物任务、逐件状态流转与系统消息。

11

反馈

用户反馈

5

设备

登录设备

2

上传

上传凭证与服务端代传

5

客户端

客户端关键埋点

4

智能

衣物识别、语音、试穿与搭配推荐

10

版本

版本检测

1

隐私

隐私设置

2

电商

淘宝、闲鱼与购物辅助对外能力

10

TryOnRecords

5