|
|
@@ -0,0 +1,63 @@
|
|
|
+# 设计:小程序知识分享页搜索功能
|
|
|
+
|
|
|
+- **编号**:ARTICLE-SEARCH-2026-11-14-DESIGN-V1
|
|
|
+- **状态**:已实现并合入 cfclub
|
|
|
+- **所属需求**:`docs/需求分析/2026-11-14-小程序知识分享页搜索功能需求变更.md`(ARTICLE-SEARCH-2026-11-14-V1)
|
|
|
+- **对应能力键**:`article.search`
|
|
|
+
|
|
|
+## 一、现状锚点(2026-11-14 只读调研实证)
|
|
|
+
|
|
|
+| 层 | 位置 | 现状 |
|
|
|
+|---|---|---|
|
|
|
+| 页面 | `cfc-frontend/pages/article-center/index.vue` | 搜索框骨架已有:🔍图标 `@click="focusSearch"`(:12)、搜索栏 `v-if="searchFocused || searchKeyword"` + 原生 input(:17-28)、`focusSearch/onSearch/onSearchBlur`(:317-330);`loadArticles` 已含 keyword 传参(:218-220);Tab 切换 `onTabChange` 已清 `searchKeyword`/`searchFocused`(:242-243);空态一律「暂无文章」(:71-74) |
|
|
|
+| API 封装 | `cfc-frontend/utils/api.js:1996` | `getArticleList(data)` → `POST /api/articles/list` |
|
|
|
+| Controller | `cfc-backend/.../controller/content/ArticleController.java` `list`(:135-160) | 已接 `keyword`(:140)透传 Service |
|
|
|
+| Service | `cfc-backend/.../service/ArticleService.java` `getPublicList`(:120-180) | `keyword` 走 MyBatis-Plus `like`:`title OR summary OR tags`(:131-134);SQL 查全量 → tag 内存过滤 → 权限过滤 → 手动分页(`total=visible.size()` + `subList`) |
|
|
|
+| 表 | `articles`(`schema.sql:1508-1535`;实体 `entity/Article.java`) | title/summary/content/tags(JSON 数组字符串)/status/auditStatus 等 |
|
|
|
+| 已有测试 | `cfc-backend/src/test/java/com/etotem/cfc/integration/controller/ArticleControllerTest.java` | `@SpringBootTest` + `@MockBean ArticleService`,直接调 `controller.list(body,null,null)`;`list_ByKeyword`(:93-110)即 keyword 透传同款 pattern |
|
|
|
+| 前端测试 | `cfc-frontend/__tests__/api/api.test.js:968-987` | `articles API` describe 已有 `getArticleList` URL 断言 |
|
|
|
+
|
|
|
+## 二、设计决策
|
|
|
+
|
|
|
+### D1 不新增后端接口
|
|
|
+`POST /api/articles/list` 的 `keyword` 已满足跨页检索(SQL 层过滤在分页前,语义正确)。数据量百级~千级,客户端本地过滤无法跨页命中 → **必须后端搜索**,保持现状接口。
|
|
|
+
|
|
|
+### D2 LIKE 字段范围保持现状
|
|
|
+`title/summary/tags`,**不含 `content`**。控制实现面,避免长文本 LIKE 的性能与误命中问题。此范围写入契约测试 C2 锁定。
|
|
|
+
|
|
|
+### D3 前端交互完整化(本次 YELLOW 实现主体)
|
|
|
+- **空态区分**(契约 C5):`noMore && articles.length === 0` 时,`searchKeyword` 非空 → 「未找到相关文章」;否则 → 「暂无文章」。
|
|
|
+- **互斥重置**(契约 C6):`onTabChange` 清 `searchKeyword`(已有,:242-243)补契约测试锁定;`focusSearch/onSearch` 进入搜索态时清当前 Tab 回到全量(回调 onTabChange 或等效逻辑,实现时按现有最大复用)。
|
|
|
+- **触发语义**(契约 C4):`onSearch` → `page=1`、`articles=[]`、`noMore=false`、`loadArticles()`,请求体 `keyword=trim(searchKeyword)`;keyword 为空 → 还原全量(取消语义)。
|
|
|
+- **输入防抖 + 搜索历史**(可选增强,编号 D3a):`@input` 400ms 防抖即时搜索;历史存 `uni.setStorageSync('article_search_history')` 上限 10 条、去重、可清空,交互参考 `pages/shop/search/search.vue`(:91 读历史 / :138 写历史 / :114 `{page,size,keyword}` 请求)。**实现会话须先核实该页现有写法再落,不得超出小程序约束。**
|
|
|
+
|
|
|
+### D4 契约测试布局(RED 产物,随任务化拆分)
|
|
|
+- 后端(cfc-backend `src/test/java/com/etotem/cfc/integration/controller/ArticleControllerTest.java` 扩展 + 可选 `integration/service/ArticleServiceSearchTest.java` 新增):
|
|
|
+ - C1:空 keyword → `getPublicList` 以 `isNull()` keyword 被调用(Controller 透传契约)
|
|
|
+ - C2:LIKE 语义 → Service 单测注入 mock mapper 断言 wrapper 构造(`verify(mapper).selectList(any())` 或行为等价);Controller 层断言 keyword 透传
|
|
|
+ - C3:`keyword`+`tag` 组合 → 断言交集语义与真实 total(手动分页口径防回归)
|
|
|
+- 前端(cfc-frontend):
|
|
|
+ - `__tests__/api/api.test.js`:`getArticleList({keyword})` 请求体断言(扩展)
|
|
|
+ - 页面方法单测(参考 `__tests__/pages/family-members.joinRequestCardInfo.test.js` 的 jest mock 环境):C4 请求参数断言 / C5 空态渲染 / C6 互斥重置
|
|
|
+
|
|
|
+**RED 契约测试只写测试、禁止改实现**:预期「C1/C2 现有实现可过(保障不破坏),C3/C5/C6 及前端交互断言当前不满足(预期红)」。
|
|
|
+
|
|
|
+## 三、派发注意
|
|
|
+
|
|
|
+- 实现仅在 feature 分支、不得假定包路径;工作目录独立 worktree。
|
|
|
+- 完成 = 已提交 + push 远端 + 工作目录干净(`git status --porcelain` 为空)。
|
|
|
+- 主工作树 E:/cfc 有他人并发 WIP,**严禁** `git add -A`/checkout/stash;只 `git add -- <精确路径>` 并 `diff --cached` 复核。
|
|
|
+- 小程序约束:禁可选链/CSS Grid/:key 表达式/`new Date(string)`(用 `parseDate`)。
|
|
|
+
|
|
|
+## 四、非目标
|
|
|
+
|
|
|
+- 全局聚合搜索(`global.search.query`,SC-P-82)不做。
|
|
|
+- `knowledge_base` RAG 检索不做;管理端搜索不改。
|
|
|
+- `content` 正文纳入 LIKE 不做(D2)。
|
|
|
+
|
|
|
+## 合入记录
|
|
|
+
|
|
|
+- RED 契约测试提交:__(闭环回填)
|
|
|
+- YELLOW 实现提交:__(闭环回填)
|
|
|
+- GREEN 校验:__(闭环回填)
|
|
|
+- DONE 收口:__(闭环回填)
|