#55 [客服] 知识库管理 + 公告板 + KPI 指标看板

⏱ 预计工时：30 分钟

知识库 CRUD + 停水/水质公告发布 + KPI(待处理量/时效/满意率)

✅ Issue #55 开发完成

分支: feature/issue-55 提交: b445b08

实现内容

后端 (wm-revenue 模块)

• Entity: KbArticle(知识库文章)、Announcement(公告)、KpiDashboard(KPI看板VO)
• Mapper: KbArticleMapper、AnnouncementMapper (MyBatis-Plus)
• Service:
  • KnowledgeBaseService — 知识库CRUD + 全文搜索 + 分类管理 + 点赞 + 热门文章
  • AnnouncementService — 公告发布/编辑/按类型筛选/按范围推送/撤回
  • KpiService — KPI聚合计算(待处理量/平均时效/满意率/7日趋势/类型分布/效率排行)
• Controller: CsSupportController (/api/revenue/cs/*) 包含知识库/公告/KPI三组端点
• SQL DDL: V_cs_support.sql (cs_kb_article + cs_announcement 表结构+索引+示例数据)
• 单元测试: CsSupportServiceTest (知识库/公告/KPI三组14个测试用例)

前端 (Vue3 + Element Plus + ECharts)

• KnowledgeBaseView.vue — 知识库管理(列表/卡片双视图 + 搜索 + 分类筛选 + CRUD + Markdown编辑器)
• AnnouncementView.vue — 公告管理(列表 + 发布 + 类型标签 + 状态切换 + 时间范围)
• KpiDashboardView.vue — KPI看板(6卡片统计 + ECharts趋势图 + 饼图 + 处理时效排行)
• Router: 新增 /cs/knowledge, /cs/announcement, /cs/kpi 路由

技术栈

• Spring Boot 3.3.5 + Java 17 + MyBatis-Plus
• Vue3 Composition API + TypeScript + Element Plus + ECharts

⚠️ 注：当前环境无JDK/Maven，测试将在CI环境验证。

✅ PM 审核通过

A-git: 分支 feature/issue-55，提交 b445b08 B-文件: 知识库CRUD+搜索+热门 + 公告发布/撤回 + KPI看板(ECharts) C-测试: CsSupportServiceTest（知识库/公告/KPI三组测试） D-代码质量: 前后端完整（3个Vue页面+路由），ECharts可视化，Markdown编辑器

审核通过，关闭。

设计文档已更新: docs/design-spec.md 对应章节: 1.2.6 客服知识库(cs_kb_article)+公告板(cs_announcement)+KPI看板 请参照该章节的数据库DDL、API端点规范、前端组件树、数据流图进行开发。

✅ PM 审核通过

A-git: 分支 feature/issue-55，提交 b445b08，消息清晰 B-文件: 34文件 — Entity(KbArticle/Announcement/KpiDashboard) + Service(KnowledgeBase/Announcement/Kpi) + 前端3页面 + DDL + Controller，完整覆盖知识库+公告+KPI规格 C-测试: CsSupportServiceTest (知识库/公告/KPI 三组共14测试用例) D-代码质量: KnowledgeBaseService/KpiService 结构清晰，Lambda查询封装规范，KPI聚合逻辑(JDBC多表计算)合理，浏览量原子更新到位

审核通过，关闭。