gsfdc/admin/AGENTS.md

Web 管理后台 AGENTS.md

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

职责

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

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

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

技术

• Vue 3、TypeScript、Vite。组件库是 Element Plus。工程骨架用 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。