2.9 KiB
2.9 KiB
门户网站 AGENTS.md
本目录是协会门户。仓库根目录 AGENTS.md 同时有效;范围冲突时以根目录和合同批注版为准。
职责
面向公众、估价师、估价机构和会员。十一项栏目都挂在这里:首页、关于协会、机构名录、资料库、报告核验、继续教育、行业自律、会员中心、行业党建、专家服务、技术交流。
只做 PC 与手机同一套响应式页面。不单独建手机站。兼容 Chrome、Edge、360、火狐、Safari,以及微信内打开。移动端保留一键拨号、地图导航、微信分享。
首页首次加载目标不超过 2 秒。图片、图标、LOGO、Banner、配色和栏目从管理后台配置读取,不写死在页面里。
技术
- Nuxt 4(Vue 3)。不要使用 Nuxt 3、Quasar、Bootstrap 组件库或 art-design-pro。
- 页面、组件、布局放在本目录的
app/下。本目录里的server/若存在,只允许放 Nuxt 自身文件,不写业务接口,也不要和仓库根目录的 Pythonserver/混放。 - 数据与登录走仓库根目录
server/的 REST 接口,前缀只用/api/site。不在门户里直连 MySQL、Redis 或 MinIO。
栏目未细化之前
不要新增栏目页面、路由表或写死的业务字段。可以预留的只有:工程骨架、站点配置读取、登录态、公开页与登录页的区分。
这些能力即使做了骨架,也不要写成可用业务:
- 运行时做成两套独立网站或两套完整页面代码。两套外观若要保留,只能是同一套页面下的两个主题包:各自含配色、字体、页头、页脚和首页模块排布,不含栏目页面的第二份实现。访客不提供换肤。后台是否开放切换,等协会确认后再做。
- 数据看板和数据挖掘的真实图表。
- 在报告审核页保存文件、调用模型或给出审核结论。查询页只对照已发布备案,见根目录
docs/adr/0010-report-query-is-filing-lookup.md。 - 智能估价平台的评估流程。
- 中房学、住建厅窗口的对接页面。外链地址以后台配置为准。
- 继续教育的学习过程、进度、学分,以及考试报名和缴费。门户栏目只做在线教育外链卡片和教育公告,见
docs/adr/0011-continuing-education-is-links-and-notices.md。 - 行业自律做成投诉举报表单,以及警示案例、诚信档案、结果公示三类栏目文章,见
docs/adr/0012-industry-discipline-articles-and-complaint-code.md。
页面约束
- 风格:官方、简洁、庄重、大气。备案号放在页脚:陇ICP备19001227号、甘公网安备62010202001984号。
- 隐私政策、使用条款、网站声明从后台取文。注册和登录须勾选同意隐私政策。
- 公示类信息默认脱敏。未审核或未发布的内容不可展示。
- 附件回显用异步懒加载。私有附件走鉴权地址,不把 MinIO 内网地址写进页面。