Files
gsfdc/.scratch/tech-exchange/spec.md
T

9.9 KiB
Raw Blame History

Status: ready-for-agent

技术交流

Problem Statement

公众需要在门户阅读协会的技术研讨活动、专项研究报告、专家文章与优秀报告评选公示。工作人员要在管理端分别维护「技术研讨」与「技术交流(模块)」两类列表内容。未发布内容不能被公众读到。本期不做会员自助投稿,也不做可核对的全量旧站栏目迁移。

Solution

门户顶栏在资质荣誉与联系合作之间增加固定站内栏目「技术交流(栏目)」。顶栏无下拉;进入后用子路由与子导航分两个模块:技术研讨、技术交流(模块)。默认进入技术研讨。每个模块是栏目文章列表 → 详情:过滤后富文本、多附件、可选封面。页头页脚随当前启用模板(ADR-0001)。站内切换保持页壳。

两类栏目文章与首页新闻动态等共用同一文章库,仅类别不同(ADR-0006):tech_seminars、tech_exchange。11.1.1 与专项研究报告合在技术研讨;专家文章与优秀报告评选合在技术交流(模块),由编辑用标题、正文、附件与封面表达,不拆四个后台入口,也不设类型或届次结构化字段。

列表支持栏目列表分页:默认每页 10 条,访客可改为 10、20 或 100 条/页。同一分页约定也适用于已交付的年度报告/工作计划、工作简报、资质荣誉列表。

管理端一个一级菜单「技术交流」,无子菜单;页内两个模块分别维护两类。权限 tech:edit。首页文章管理界面不混出这两类。交付 seed,精选现站相关稿使演示库非空。

User Stories

  1. 作为公众,我要在页头看到「技术交流」固定站内项,以便进入该栏目。
  2. 作为公众,我要点「技术交流」时留在本站,以便连续阅读。
  3. 作为公众,我要在顶栏顺序中看到:首页 → 组织概况 →(快捷菜单)→ 资质荣誉 → 技术交流 → 联系合作。
  4. 作为公众,我要点页头的首页回到首页。
  5. 作为公众,我要在继续教育、会员服务按配置展示时仍能在同一条菜单里看到它们。
  6. 作为公众,我要在科技蓝与 LOGO 蓝下看到与启用模板一致的页头和页脚。
  7. 作为公众,我要点进技术交流后默认看到技术研讨子页。
  8. 作为公众,我要在技术交流下看到技术研讨、技术交流两个子导航项,以便在模块间切换。
  9. 作为公众,我要在子导航里始终看到这两项,即使某列表为空。
  10. 作为工作人员,我要按通知公告方式发布技术研讨(标题、富文本、多附件、可选封面、发布),以便公示活动与专项研究报告。
  11. 作为公众,我要在技术研讨列表看到已发布条目;有封面则见缩略图,无封面则只见标题。
  12. 作为公众,我要点一条技术研讨打开详情,看到过滤后正文、可下载附件;有封面则在正文上方展示。
  13. 作为公众,我要不看到未发布的技术研讨。
  14. 作为公众,我要在没有可展示的技术研讨时看到「暂无技术研讨」。
  15. 作为工作人员,我要按同样方式发布技术交流(模块)条目,以便公示专家文章与优秀报告评选。
  16. 作为公众,我要在技术交流(模块)列表看到已发布条目及封面规则,并进详情。
  17. 作为公众,我要不看到未发布的技术交流(模块)条目。
  18. 作为公众,我要在没有可展示的技术交流(模块)条目时看到「暂无技术交流」。
  19. 作为公众,我要在技术研讨与技术交流(模块)列表上翻页,默认每页 10 条。
  20. 作为公众,我要把每页条数改为 10、20 或 100,改后从第 1 页重新看。
  21. 作为公众,我要在年度报告/工作计划、工作简报、资质荣誉列表上使用同样的分页与条数选项。
  22. 作为公众,我要在详情正文里看不到脚本和未发布附件。
  23. 作为工作人员,我要在保存正文时由服务端做 HTML 白名单过滤。
  24. 作为工作人员,我要用工作人员身份写入这两类;会员身份不能写入。
  25. 作为公众,我要不登录也能读取已发布内容。
  26. 作为工作人员,我要在写入被拒绝时,公众仍看到写入前的公开内容。
  27. 作为工作人员,我要在管理端用一级菜单「技术交流」进入配置,页内两个模块分别维护技术研讨与技术交流(模块)。
  28. 作为工作人员,我要在首页文章管理界面里看不到 tech_seminars 与 tech_exchange。
  29. 作为工作人员,我要为条目配置封面图(公开桶配图校验),也可不配。
  30. 作为公众,我要点栏目文章详情时,页头页脚与当前启用模板相同。
  31. 作为开发或演示人员,我要能运行 seed,使两类列表有若干已发布样例,以便库看起来非空。

Implementation Decisions

  • 顶栏:固定站内路由「技术交流(栏目)」,插在资质荣誉与联系合作之间;不进快捷菜单可配置键。
  • 门户:父页 + 子路由 + 左侧(窄屏可顶栏)子导航。子项固定为技术研讨、技术交流(模块)。默认子页为技术研讨。页壳复用既有站点页壳缓存。
  • 栏目文章两类:tech_seminars(技术研讨)、tech_exchange(技术交流模块)。扩 COLUMN_ARTICLE_CATEGORIES(ADR-0006)。字段对齐通知公告:标题、过滤后富文本、多附件、可选封面(imageFileId)、是否发布。不设类型/届次字段。
  • 公开列表接口带 current、size;size 仅允许 10、20、100,非法值回落默认 10。响应含 items、total、current、size;无已发布时含约定占位句。详情沿用既有栏目文章详情读取。
  • 栏目列表分页同样适用于 annual_reports、work_briefs、qualifications(已先落地的共享行为,本努力验收时一并守住)。
  • 列表有封面则展示缩略图,无则纯标题;详情有封面则在正文上方展示。封面上传沿用公开桶配图校验。
  • 占位句:技术研讨「暂无技术研讨」;技术交流(模块)「暂无技术交流」。
  • 管理端:一级菜单「技术交流」,无子菜单;页内两模块。权限 tech:edit。首页文章界面不混出这两类。
  • 会员投稿本期仅工作人员代发;无会员自助投稿入口与审核流。
  • 工作人员写入走管理端前缀与工作人员令牌;公众读取走门户前缀。
  • 正文 HTML 白名单;已发布公开附件策略与首页一致;上传大小沿用可配置上限。
  • Seed:精选 docs/参考/现站 或现网相关稿写入两类并发布,演示非空;不宣称可核对全量旧站技术交流迁移。
  • 门户版式以 portal/prototype/tech-exchange.html 为浏览器验收参照(?variant=tech|brand,含分页与 10/20/100);两套模板视觉差异不写入公开 HTTP 断言。

Testing Decisions

只通过技术交流相关 HTTP 的对外行为断言。工作人员写入后,断言公开读取;写入被拒绝时,断言公开读取与写入前一致。期望值用下面已知样例里的原句,不用实现里的算法再算一遍。不断言数据库表名、管理端组件树、滚动动画或像素级版式。两套模板页头与子导航观感放在浏览器对照原型验收。

测试 seam:工作人员令牌调用管理端 HTTP,再读取门户公开 HTTP。与首页、关于协会同一套做法,不新开第二套测试入口。

已知样例名为「技术交流公开样例」:

  • 技术研讨已发布一条,标题「城市更新中的房地产估价服务专题研讨」,正文保存前含 <p>城市更新研讨</p><script>alert(1)</script>,附件「研讨通知.pdf」,封面已配。公开列表含该标题;公开详情正文含「城市更新研讨」,不含 script 和 alert;附件「研讨通知.pdf」可下载;详情带封面图地址。
  • 另有一条技术研讨标题「内部筹备研讨」未发布,公开读取中没有这六个字。
  • 技术研讨若无已发布条目,公开读取含「暂无技术研讨」。
  • 技术交流(模块)已发布一条,标题「2018年度优秀报告评选表彰与实践分享(公示)」,附件「获奖名单公示.pdf」。公开读取含该标题与附件名。
  • 技术交流(模块)若无已发布条目,公开读取含「暂无技术交流」。
  • 技术研讨已发布 11 条时:current=1&size=10 返回 total 为 11、items 长度为 10、size 为 10;current=2&size=10 的 items 长度为 1;size=20 时一页可含全部 11 条;size=15 时 size 回落为 10。
  • 会员令牌写入技术研讨时被拒绝;公开读取仍为写入前状态。
  • 管理端首页文章读取中不含 tech_seminars / tech_exchange 类别条目。

Out of Scope

  • 教育平台。
  • 会员自助投稿入口与投稿审核流。
  • 可核对的旧站「技术交流」全量迁移验收(本期仅 seed 演示填充)。
  • 报告真伪查询、验真规则、审核引擎。
  • 智能估价;中房学、住建厅账号打通与数据回写。
  • 将「技术研讨 / 技术交流(模块)」拆成四个后台入口或加类型/届次结构化字段。
  • 专家委员会列表分页(本期未点名)。
  • 其他未开栏目的表结构与页面。
  • 单独的手机站;访客换肤。
  • 为技术交流另建与首页平行的第二套文章引擎。

Further Notes

  • grilling 已定:栏目名「技术交流」;模块名「技术研讨」「技术交流」;两类别键 tech_seminars / tech_exchange;顶栏位置;子路由+子导航;封面列表与详情;分页默认 10 可选 10/20/100;工作人员代发;seed 非空;不另开 ADR(沿用 ADR-0006)。
  • 术语见根目录 GLOSSARY.md「技术交流」与「栏目列表分页」。
  • 浏览器验收对照:portal/prototype/tech-exchange.html、portal/prototype/about-association.html(列表分页)。