Files
gsfdc/portal/AGENTS.md
T

2.9 KiB
Raw Blame History

门户网站 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 自身文件,不写业务接口,也不要和仓库根目录的 Python server/ 混放。
  • 数据与登录走仓库根目录 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 内网地址写进页面。