Boonlive_RD_Web/Wx_WxCheck_Prod

Fork 0

Files

XuJiacheng 845f1c6618 新增：管理后台前端页面，以及openspec内容。

2025-12-24 20:15:28 +08:00

3.7 KiB

Raw Blame History

微信小程序（CommunicationRecords）规范

Purpose

本能力描述小程序端的主要用户流程、页面职责以及与后端 API 的交互约定。

Requirements

Requirement: 协议勾选门槛

系统 SHALL 要求用户在登录前勾选用户协议（隐私合规前置）。

实现位置：pages/logs/logs.js

Scenario: 未勾选协议尝试登录

WHEN 用户未勾选协议并触发登录流程
THEN 小程序提示“请先勾选用户协议”

系统 SHALL 使用 wx.login() 获取 code 并调用后端登录接口。

接口：POST /api/Login/Login

行为：

登录成功时，SHALL 将 openid(UserKey) 写入本地缓存 openid，并同步到 app.globalData。
若用户资料未完善（缺少 UserName/WeChatName/PhoneNumber），SHALL 进入注册/完善资料流程。

Scenario: 已注册用户直接进入聊天页

WHEN 登录接口返回完整用户信息
THEN 小程序跳转到 pages/chat/chat

Scenario: 未注册用户提示完善信息

WHEN 登录接口成功但返回的用户信息不完整
THEN 小程序提示需要完善资料并展示注册表单

Requirement: 注册/完善资料流程

系统 SHALL 提供表单采集姓名、手机号、昵称与头像，并调用后端注册接口更新用户资料。

接口：POST /api/Login/Register

实现位置：pages/logs/logs.js

行为：

注册接口成功后，SHALL 触发头像上传（/api/Check/UploadFile）并更新页面头像。

Scenario: 正常注册

WHEN 用户提交有效姓名与手机号
THEN 小程序完成注册并进入聊天页

Requirement: 头像上传

系统 SHALL 允许用户选择头像并上传到服务器，后端返回永久 URL 后用于展示。

接口：POST /api/Check/UploadFile

实现位置：pages/logs/logs.js 与 pages/chat/chat.js

Scenario: 上传成功

WHEN 上传接口返回 success: true
THEN 小程序使用返回的 url 更新头像展示

Requirement: 聊天页加载历史会话

系统 SHALL 在进入聊天页时请求历史会话并渲染。

接口：POST /api/Check/GetConversationsByPage

实现位置：pages/chat/chat.js（loadHistory / GetConversations）

Scenario: 首次进入加载第一页

WHEN 进入聊天页
THEN 请求第一页（Page=1, PageSize=20）并展示

Requirement: 发送消息

系统 SHALL 通过后端新增会话接口发送消息。

接口：POST /api/Check/AddConversation

实现位置：pages/chat/chat.js

Scenario: 文本发送成功

WHEN 用户发送文本消息
THEN 小程序调用新增会话接口并更新列表

Requirement: 编辑与删除消息

系统 SHALL 支持对会话进行更新与软删除。

接口：

POST /api/Check/UpdateConversation
POST /api/Check/DeleteConversation