# Web 管理后台 AGENTS.md

本目录是运营管理后台。仓库根目录 `AGENTS.md` 同时有效；范围冲突时以根目录和合同批注版为准。

## 职责

给协会工作人员使用，不提供公众版移动端。两类能力：

- 门户配置：站点信息、图片与 Banner、栏目、模板参数、新闻和政策、富文本、分类、定时发布、审核。
- 业务运营：机构名录、报告备案、投诉受理、诚信档案、会员账号、入会与合作意向、专家留言、操作审计。

教育课程的运营入口可以跳转到教育平台管理端。学习过程本身不在本目录实现。

## 技术

- Vue 3、TypeScript、Vite。组件库是 Element Plus。工程骨架用 [art-design-pro](https://github.com/Daymychen/art-design-pro) 开源版，不要从 `gitee.com/djxchi/art-design-pro` 开工程。
- 不要把这套 UI 用于 `portal/`，也不要改成 Nuxt。初始化后清掉演示页面和演示接口。登录、动态菜单、按钮权限对接仓库根目录的 Python 接口。保留 MIT 版权声明。不引入该模板自带的后端。
- 富文本用 wangEditor-next（`@wangeditor-next/editor-for-vue`）。不要安装已停更的 `@wangeditor/editor`，不要改用 TipTap。工具栏使用编辑器自带菜单。图片、视频自定义上传到 MinIO，正文不存 base64。
- 接口走 `server/` 的 REST，前缀只用 `/api/admin`。该前缀下每个接口都要求工作人员登录。

## 权限

用「用户、角色、角色菜单」控制能看见的菜单和按钮。按钮隐藏不能代替接口鉴权，鉴权在 `server/` 实现。

账号支持开通、强密码和注销。注销由服务端处理档案保留与脱敏，后台只发起操作并展示结果。

## 未细化之前不要做

栏目专篇没有写出字段和流程时，不要做该栏目的表单和审核流。可以先做的公共骨架：登录与验证码、菜单权限、站点配置、附件上传、内容草稿与审核、操作日志查看。

明确不做：

- 报告审核引擎，以及让会员在门户提交备案。备案只在报告中心由工作人员维护，见 `docs/adr/0010-report-query-is-filing-lookup.md`。
- 中房学、住建厅的数据同步界面。只保留可配置外链的维护项。
- 智能估价平台配置以外的业务页面。
- 不限制大小的上传。上限由服务端配置，上传过程要可见，支持批量、粘贴、删除和下载。

投诉处理时限、专家回复时限做成可配置项，不把「30 个工作日」「3 个工作日」写死在前端。行业自律的投诉受理、警示案例、诚信档案和结果公示见 `docs/adr/0012-industry-discipline-articles-and-complaint-code.md`。