feat: complete huihui square avatar workflows
This commit is contained in:
stefanfeng
169
docs/production-interface-inventory.md
Normal file
169
docs/production-interface-inventory.md
Normal file
@@ -0,0 +1,169 @@
|
||||
# 生产环境接口清单
|
||||
|
||||
更新时间：2026-06-23
|
||||
|
||||
本文档整理的是本项目当前代码里会主动调用的外部生产环境接口，以及当前运行环境通过系统配置接口读到的真实生产地址。
|
||||
|
||||
## 当前生产配置
|
||||
|
||||
- 认证服务基址：`https://99hui.com/api/usercenter`
|
||||
- 新闻业务基址：`https://99hui.com/api/huihuibusiness`
|
||||
- 文件上传基址：`https://99hui.com/api/filecenter`
|
||||
说明：代码通过把 `huihuibusiness` 替换成 `filecenter` 推导得到。
|
||||
- 当前默认 AI 模型：
|
||||
- 模型名：`阿里千问大模型`
|
||||
- 提供方：`qianwen`
|
||||
- API Base URL：`https://dashscope.aliyuncs.com/compatible-mode/v1`
|
||||
- 模型版本：`qwen-plus`
|
||||
|
||||
## 认证服务
|
||||
|
||||
基址：`https://99hui.com/api/usercenter`
|
||||
|
||||
### `POST /open/login/token`
|
||||
|
||||
- 用途：虚拟用户账号密码登录，换取 `access_token`
|
||||
- 代码位置：
|
||||
- [news_service.py](/Users/yqq/Works/AiProject/huihuiSquare/backend/app/services/news_service.py:149)
|
||||
- [system.py](/Users/yqq/Works/AiProject/huihuiSquare/backend/app/api/endpoints/system.py:86)
|
||||
|
||||
### `PATCH /v2/users/current`
|
||||
|
||||
- 用途：同步修改目标平台用户资料
|
||||
- 涉及字段：昵称、真实姓名、性别、头像、简介、邮箱
|
||||
- 代码位置：
|
||||
- [news_service.py](/Users/yqq/Works/AiProject/huihuiSquare/backend/app/services/news_service.py:946)
|
||||
|
||||
## 新闻业务服务
|
||||
|
||||
基址：`https://99hui.com/api/huihuibusiness`
|
||||
|
||||
### `GET /app/user/info`
|
||||
|
||||
- 用途：登录成功后探测用户所属组织 `orgId`
|
||||
- 代码位置：
|
||||
- [news_service.py](/Users/yqq/Works/AiProject/huihuiSquare/backend/app/services/news_service.py:250)
|
||||
|
||||
### `GET /open/user/info`
|
||||
|
||||
- 用途：登录成功后探测用户所属组织 `orgId`
|
||||
- 代码位置：
|
||||
- [news_service.py](/Users/yqq/Works/AiProject/huihuiSquare/backend/app/services/news_service.py:250)
|
||||
|
||||
### `GET /user/info`
|
||||
|
||||
- 用途：登录成功后探测用户所属组织 `orgId`
|
||||
- 代码位置：
|
||||
- [news_service.py](/Users/yqq/Works/AiProject/huihuiSquare/backend/app/services/news_service.py:250)
|
||||
|
||||
### `GET /news/list`
|
||||
|
||||
- 用途：会话有效性校验
|
||||
- 代码位置：
|
||||
- [news_service.py](/Users/yqq/Works/AiProject/huihuiSquare/backend/app/services/news_service.py:323)
|
||||
|
||||
### `GET /business/square/list`
|
||||
|
||||
- 用途：
|
||||
- 统计今日文章数量
|
||||
- 拉取今日广场文章
|
||||
- 拉取历史广场文章
|
||||
- 代码位置：
|
||||
- [news_service.py](/Users/yqq/Works/AiProject/huihuiSquare/backend/app/services/news_service.py:350)
|
||||
- [news_service.py](/Users/yqq/Works/AiProject/huihuiSquare/backend/app/services/news_service.py:483)
|
||||
- [news_service.py](/Users/yqq/Works/AiProject/huihuiSquare/backend/app/services/news_service.py:620)
|
||||
|
||||
### `GET /news/{article_id}`
|
||||
|
||||
- 用途：校验文章是否存在、正文是否足够长
|
||||
- 代码位置：
|
||||
- [news_service.py](/Users/yqq/Works/AiProject/huihuiSquare/backend/app/services/news_service.py:396)
|
||||
|
||||
### `PATCH /news/read/{news_id}`
|
||||
|
||||
- 用途：模拟用户阅读新闻
|
||||
- 代码位置：
|
||||
- [news_service.py](/Users/yqq/Works/AiProject/huihuiSquare/backend/app/services/news_service.py:711)
|
||||
|
||||
### `POST /message/comment`
|
||||
|
||||
- 用途：发表评论
|
||||
- 代码位置：
|
||||
- [news_service.py](/Users/yqq/Works/AiProject/huihuiSquare/backend/app/services/news_service.py:734)
|
||||
|
||||
### `GET /message/comment`
|
||||
|
||||
- 用途：获取评论列表，为回复链路提供上下文
|
||||
- 代码位置：
|
||||
- [news_service.py](/Users/yqq/Works/AiProject/huihuiSquare/backend/app/services/news_service.py:759)
|
||||
|
||||
### `POST /message/comment/reply`
|
||||
|
||||
- 用途：回复评论
|
||||
- 代码位置：
|
||||
- [news_service.py](/Users/yqq/Works/AiProject/huihuiSquare/backend/app/services/news_service.py:747)
|
||||
|
||||
### `POST /message/praise`
|
||||
|
||||
- 用途：
|
||||
- 点赞
|
||||
- 收藏
|
||||
说明：当前收藏复用了点赞接口
|
||||
- 代码位置：
|
||||
- [news_service.py](/Users/yqq/Works/AiProject/huihuiSquare/backend/app/services/news_service.py:771)
|
||||
- [news_service.py](/Users/yqq/Works/AiProject/huihuiSquare/backend/app/services/news_service.py:784)
|
||||
|
||||
### `GET /news/share/wechat/{news_id}`
|
||||
|
||||
- 用途：转发前的微信分享预热调用
|
||||
- 代码位置：
|
||||
- [news_service.py](/Users/yqq/Works/AiProject/huihuiSquare/backend/app/services/news_service.py:796)
|
||||
|
||||
### `POST /points/forward/news/{org_id}`
|
||||
|
||||
- 用途：真正执行转发积分动作
|
||||
- 代码位置：
|
||||
- [news_service.py](/Users/yqq/Works/AiProject/huihuiSquare/backend/app/services/news_service.py:802)
|
||||
|
||||
### `DELETE /message/praise/cancel`
|
||||
|
||||
- 用途：取消点赞 / 取消收藏
|
||||
- 代码位置：
|
||||
- [news_service.py](/Users/yqq/Works/AiProject/huihuiSquare/backend/app/services/news_service.py:830)
|
||||
|
||||
### `DELETE /message/comment/{news_id}/{comment_id}`
|
||||
|
||||
- 用途：删除评论
|
||||
- 代码位置：
|
||||
- [news_service.py](/Users/yqq/Works/AiProject/huihuiSquare/backend/app/services/news_service.py:865)
|
||||
|
||||
## 文件服务
|
||||
|
||||
基址：`https://99hui.com/api/filecenter`
|
||||
|
||||
### `POST /fileUpload`
|
||||
|
||||
- 用途：上传用户头像到平台文件中心
|
||||
- 代码位置：
|
||||
- [news_service.py](/Users/yqq/Works/AiProject/huihuiSquare/backend/app/services/news_service.py:1002)
|
||||
|
||||
## AI 模型服务
|
||||
|
||||
当前默认基址：`https://dashscope.aliyuncs.com/compatible-mode/v1`
|
||||
|
||||
### `POST /chat/completions`
|
||||
|
||||
- 用途：
|
||||
- 生成人格
|
||||
- 生成评论
|
||||
- 生成回复
|
||||
- 测试模型连通性
|
||||
- 代码位置：
|
||||
- [ai_service.py](/Users/yqq/Works/AiProject/huihuiSquare/backend/app/services/ai_service.py:70)
|
||||
- [ai_service.py](/Users/yqq/Works/AiProject/huihuiSquare/backend/app/services/ai_service.py:215)
|
||||
|
||||
## 说明
|
||||
|
||||
- `resource.99hui.com` 当前主要出现在头像上传成功后的返回 URL 中，属于资源访问域名，不是本项目后端主动调用的 API。
|
||||
- AI 服务基址不是写死生产地址，而是读数据库里的模型配置；如果后台切换默认模型，这一节需要随之更新。
|
||||
- 当前系统配置里 `platform_org_id` 为空，这和“部分用户点立即互动时取不到文章列表”现象高度相关，建议后续继续排查组织信息自动发现链路。
|
||||
Reference in New Issue
Block a user