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