weijuesen
694 lines
30 KiB
Markdown
694 lines
30 KiB
Markdown
# 知识库初始版（蚕病百科 + AI 结果解读）Implementation Plan
|
||
|
||
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
|
||
|
||
**Goal:** 交付知识库初始版：Go 后端蚕病百科/知识文章 API + 规格书种子数据，Web 后台管理页，小程序农户查看页。
|
||
|
||
**Architecture:** 沿用现有分层（Go/Gin/GORM、React/AntD Pro、Taro 4）。新增 `diseases`（蚕病百科）与 `knowledge_articles`（AI 结果解读等文章）两表；CRUD 复用现有 handler 模式与 `bindUpdates`；种子数据启动时幂等写入；权限码 `knowledge:read` / `knowledge:write` 控制读写。
|
||
|
||
**Tech Stack:** Go 1.23 / Gin / GORM（PostgreSQL）；React 19 / antd 5 / @ant-design/pro-components；Taro 4 + React + Sass。
|
||
|
||
## Global Constraints
|
||
|
||
- 不得修改生成产物（`miniapp/dist/`、`web/dist/`）；只改源文件。
|
||
- 蚕病内容以规格书 `.cc-connect/attachments/蚕病智能防控平台规格说明书.md` 附录 11.1、3.1.4（风险分级）、3.8（处置方向/排查清单）为准，不编造。
|
||
- 风险分级阈值（绿 0-30 / 黄 31-60 / 橙 61-80 / 红 81-100）来自规格书 3.1.4。
|
||
- 权限：读 `knowledge:read`，写 `knowledge:write`。
|
||
- 字段风格沿用现有约定：Go JSON camelCase、DB 列 snake_case、web/miniapp 接口类型与后端 JSON 一致。
|
||
- 验证命令：后端 `go test ./... && go build ./... && go vet ./...`；Web `npm run lint && npm run build`；小程序 `npm run build:weapp`。
|
||
- 本仓库当前无前端测试基建（Vitest/Jest 均未配置，属后续工作计划 #27），UI 验证以 lint + 类型检查 + 构建为准；Go 侧对纯逻辑（种子数据）写单元测试（TDD）。
|
||
|
||
---
|
||
|
||
### Task 1: Go 模型 + 种子数据测试（TDD RED）
|
||
|
||
**Files:**
|
||
- Create: `server-go/internal/model/knowledge.go`
|
||
- Test: `server-go/internal/model/knowledge_seed_test.go`
|
||
|
||
**Interfaces:**
|
||
- Produces: `model.Disease`、`model.KnowledgeArticle` 结构体；包变量 `model.SeedDiseases []Disease`、`model.SeedKnowledgeArticles []KnowledgeArticle`（Task 2 填充内容）。
|
||
|
||
- [ ] **Step 1: 写失败测试**（先建 `knowledge.go` 只含结构体定义，不含种子变量）
|
||
|
||
`server-go/internal/model/knowledge_seed_test.go`：
|
||
|
||
```go
|
||
package model
|
||
|
||
import "testing"
|
||
|
||
func TestSeedDiseasesCoverCoreFour(t *testing.T) {
|
||
core := []string{"核型多角体病", "白僵病", "软化病", "微粒子病"}
|
||
got := map[string]bool{}
|
||
for _, d := range SeedDiseases {
|
||
got[d.Name] = true
|
||
}
|
||
for _, name := range core {
|
||
if !got[name] {
|
||
t.Errorf("核心蚕病缺失: %s", name)
|
||
}
|
||
}
|
||
}
|
||
|
||
func TestSeedDiseasesRequiredFields(t *testing.T) {
|
||
for _, d := range SeedDiseases {
|
||
if d.Name == "" || d.Category == "" {
|
||
t.Errorf("病种名称/类别不能为空: %+v", d)
|
||
}
|
||
if d.Pathogen == "" || d.Symptoms == "" || d.Transmission == "" || d.Prevention == "" {
|
||
t.Errorf("病种必备字段缺失(病原/症状/传播途径/防治指南): %s", d.Name)
|
||
}
|
||
}
|
||
}
|
||
|
||
func TestSeedDiseasesNamesUnique(t *testing.T) {
|
||
seen := map[string]bool{}
|
||
for _, d := range SeedDiseases {
|
||
if seen[d.Name] {
|
||
t.Errorf("病种名称重复: %s", d.Name)
|
||
}
|
||
seen[d.Name] = true
|
||
}
|
||
}
|
||
|
||
func TestSeedKnowledgeArticlesHasAIGuide(t *testing.T) {
|
||
found := false
|
||
for _, a := range SeedKnowledgeArticles {
|
||
if a.Kind == "ai_guide" && a.Title != "" && a.Content != "" {
|
||
found = true
|
||
}
|
||
}
|
||
if !found {
|
||
t.Error("缺少 AI 结果解读文章（kind=ai_guide）")
|
||
}
|
||
}
|
||
```
|
||
|
||
- [ ] **Step 2: 运行测试确认失败**
|
||
|
||
Run: `cd server-go && go test ./internal/model/ -run TestSeed -v`
|
||
Expected: 编译失败 `undefined: SeedDiseases` / `undefined: SeedKnowledgeArticles`（或测试失败）
|
||
|
||
- [ ] **Step 3: 最小实现**：`knowledge.go` 定义结构体（见下方 Task 2 代码中结构体部分），并声明空变量 `var SeedDiseases []Disease`、`var SeedKnowledgeArticles []KnowledgeArticle` 使编译通过、测试失败。
|
||
|
||
- [ ] **Step 4: 再运行测试，确认失败原因是数据缺失**（如 `核心蚕病缺失: 核型多角体病`），而非编译错误。
|
||
|
||
- [ ] **Step 5: Commit**
|
||
|
||
```bash
|
||
git add server-go/internal/model/knowledge.go server-go/internal/model/knowledge_seed_test.go
|
||
git commit -m "test(knowledge): seed 数据完整性测试（RED）"
|
||
```
|
||
|
||
---
|
||
|
||
### Task 2: Go 种子数据填充（TDD GREEN）
|
||
|
||
**Files:**
|
||
- Create: `server-go/internal/model/knowledge_seed.go`（完整内容见下方代码块）
|
||
|
||
**Interfaces:**
|
||
- Consumes: Task 1 的 `Disease` / `KnowledgeArticle` 结构体。
|
||
- Produces: `SeedDiseases`（9 条，含 4 类核心病种）、`SeedKnowledgeArticles`（1 条 AI 结果解读）。字段值全部来自规格书附录 11.1 与 3.1.4；`Prevention`（防治指南）按规格书 3.8 处置方向（内源扩散/外源侵入）与分病种排查清单整理。
|
||
|
||
- [ ] **Step 1: 写入种子数据**（代码见下）
|
||
|
||
```go
|
||
package model
|
||
|
||
// SeedDiseases 蚕病百科种子数据（内容来源：规格书附录 11.1 / 3.8）
|
||
var SeedDiseases = []Disease{
|
||
{
|
||
Name: "核型多角体病", Category: "viral", SortOrder: 1,
|
||
Pathogen: "家蚕核型多角体病毒（杆状病毒科，双链DNA病毒）",
|
||
Transmission: "食下传染为主，创伤传染次之",
|
||
Medium: "多角体（2-6μm包涵体，存在于病蚕血液、脓汁、粪便中，污染蚕座、桑叶、蚕具）",
|
||
Incubation: "3-6天",
|
||
Symptoms: "体色乳白、环节肿胀如竹节、体壁紧张发亮、狂躁爬行、体壁易破流乳白色脓汁",
|
||
HighRiskStage: "5龄后期至蛹期，春蚕期较多发",
|
||
HighRiskCondition: "温度突变、密集饲养等环境应激可诱发潜伏感染转急性",
|
||
LethalTime: "感染后3-5天",
|
||
SpreadTrend: "病蚕体壁破裂流脓→脓汁污染蚕座桑叶→健康蚕食下感染→群体内快速扩散",
|
||
Recurrence: "多角体环境存活2-3年，不彻底消毒则跨批次跨年度反复发病",
|
||
Detection: "LAMP 靶标：polh 基因（已有引物序列）",
|
||
Prevention: "立即隔离病蚕并深埋；对发病区域及周边彻底消毒；上批次发病后升级消毒方案（含蚕具浸泡）；排查蚕具跨批次共用、桑叶来源变更、人员进出记录；保持温湿度稳定、控制饲养密度",
|
||
},
|
||
{
|
||
Name: "白僵病", Category: "fungal", SortOrder: 2,
|
||
Pathogen: "白僵菌（丛梗孢科，兼性寄生菌——既有寄生能力又能腐生）",
|
||
Transmission: "接触传染为主（分生孢子接触蚕体壁→发芽侵入→体腔内繁殖），创伤传染次之，一般不能食下传染",
|
||
Medium: "分生孢子，通过气流扩散，是真菌病传播的核心媒介",
|
||
Incubation: "2-6天",
|
||
Symptoms: "体色暗淡、油渍斑、行动呆滞、死蚕僵硬覆白粉",
|
||
HighRiskStage: "温度25-30℃、湿度>75%时孢子萌发，连续阴雨高发",
|
||
HighRiskCondition: "湿度>75%是孢子萌发关键条件，连续阴雨",
|
||
LethalTime: "小蚕2-3天，大蚕5-6天",
|
||
SpreadTrend: "点发→面发→暴发；尸体持续产孢，适宜湿度下指数级扩散",
|
||
Recurrence: "白僵菌广泛寄生于桑园害虫和野外昆虫，可腐生存活，极难彻底清除",
|
||
Detection: "早期无症状识别难，需结合湿度监测与 AI 巡检",
|
||
Prevention: "立即隔离病蚕并深埋，防止尸体产孢扩散；湿度>75%时加强通风排湿；检查并加装通风口过滤网；加强人员/蚕具进出管控；蚕房周边昆虫防治、桑园害虫治理",
|
||
},
|
||
{
|
||
Name: "软化病", Category: "bacterial", SortOrder: 3,
|
||
Pathogen: "肠道致病菌（多种细菌）",
|
||
Transmission: "食下传染，环境恶化引发肠道菌群失调，与饲养管理密切相关",
|
||
Medium: "污染桑叶、蚕座环境",
|
||
Incubation: "病程缓慢，5龄集中暴发",
|
||
Symptoms: "食桑减少、排念珠状粪、胸部半透明（空头蚕）、群体发育不齐",
|
||
HighRiskStage: "蚕头密度大、通风不良、桑叶潮湿，5龄期集中暴发",
|
||
HighRiskCondition: "密度过大、通风不良、桑叶潮湿",
|
||
SpreadTrend: "往往群体性发生，同批次扩散；常存在混合感染",
|
||
Recurrence: "与饲养管理密切相关，密度/通风/桑叶卫生不改善易反复",
|
||
Detection: "与质型多角体病肉眼难以区分，需分子检测（16S rRNA / LAMP）确认",
|
||
Prevention: "控制蚕头密度、加强通风、避免桑叶潮湿；发现病蚕及时隔离；桑叶来源批次追溯，排查桑园害虫粪便污染；混合感染风险高，建议结合检测确认病原",
|
||
},
|
||
{
|
||
Name: "微粒子病", Category: "protozoan", SortOrder: 4,
|
||
Pathogen: "家蚕微粒子虫（Nosema bombycis），细胞内专性寄生的微孢子虫",
|
||
Transmission: "双重传播：食下传染（水平传播）+ 胚种传染（垂直传播，经卵传给下一代）",
|
||
Medium: "孢子，通过粪便、蚕蜕、尸体污染环境；通过卵细胞侵入子代",
|
||
Incubation: "慢性，可整个幼虫期无明显外观异常",
|
||
Symptoms: "发育不齐、群体陆续死亡、蚕体瘦小",
|
||
HighRiskStage: "种蚕生产中发病率可达50-60%；跨代累积，越种越弱",
|
||
HighRiskCondition: "蚕种来源不明、消毒不彻底",
|
||
SpreadTrend: "水平传播（病蚕排孢污染环境）+ 垂直传播（带毒母蛾产卵→子代先天感染→跨代累积）",
|
||
Recurrence: "唯一法定检疫对象；胚种传染使带毒批次代代相传",
|
||
Detection: "法定检疫：母蛾镜检；qPCR 已开展推广培训；LAMP 可参考文献设计引物",
|
||
Prevention: "种场必须逐批检测，蚕种来源全链追溯（母蛾镜检→蚕种批次→种场供种链）；隔离发病批次；可喷施“防微灵”（国内唯一获兽药批文的治疗药物）后饲蚕；排查桑园周边野外昆虫交叉感染",
|
||
},
|
||
{
|
||
Name: "质型多角体病", Category: "viral", SortOrder: 5,
|
||
Pathogen: "家蚕质型多角体病毒（呼肠孤病毒科，双链RNA病毒）",
|
||
Transmission: "食下传染（经口），侵入中肠上皮细胞",
|
||
Medium: "多角体随病蚕粪便排出，持续污染蚕座和桑叶",
|
||
Incubation: "病程较缓慢",
|
||
Symptoms: "发育缓慢、体躯瘦小、呆滞、体色略带乳白、排出带乳白色的软粪",
|
||
HighRiskStage: "夏秋蚕期多发（与核型多角体病的春蚕期形成对比）",
|
||
HighRiskCondition: "夏秋蚕期高温闷热",
|
||
SpreadTrend: "病蚕排毒（粪便含病毒）→蚕座环境污染→同群体经口反复感染；病程缓慢但粪便持续污染使群体发病率累积上升；可通过卵传给下一代",
|
||
Recurrence: "可通过卵传代，在种群中形成病毒流行病",
|
||
Detection: "症状与软化病肉眼难以区分，需分子检测确认",
|
||
Prevention: "及时清除病蚕与蚕座污染物，防止粪便持续排毒；夏秋高温闷热期加强通风降温；同区域其他蚕房发病关联排查",
|
||
},
|
||
{
|
||
Name: "浓核病/传染性软化病", Category: "viral", SortOrder: 6,
|
||
Pathogen: "浓核病毒（BmDNV）、二分浓核病毒（BmBDV）、传染性软化病毒（BmIFV）",
|
||
Transmission: "食下感染",
|
||
Medium: "传染源主要来自桑园害虫粪便污染桑叶",
|
||
Incubation: "—",
|
||
Symptoms: "空头、下痢、吐液（与质型多角体病肉眼难以区分）",
|
||
HighRiskStage: "夏秋蚕期多发",
|
||
HighRiskCondition: "桑叶被桑园害虫粪便污染",
|
||
SpreadTrend: "桑园害虫粪便污染桑叶→食下感染→慢性消耗死亡或继发细菌感染；常存在混合感染",
|
||
Recurrence: "病原来自桑园害虫粪便污染，桑园防治不到位易反复",
|
||
Detection: "裸露病毒，不形成包涵体（多角体），普通显微镜无法观察，诊断难度大",
|
||
Prevention: "桑叶来源批次追溯（哪个桑园、哪天采摘）；核查桑园近期害虫防治记录；保证桑叶储运条件；识别混合感染（常与质型多角体病混合）",
|
||
},
|
||
{
|
||
Name: "细菌性败血病", Category: "bacterial", SortOrder: 7,
|
||
Pathogen: "苏云金杆菌等多种细菌",
|
||
Transmission: "创伤传染——细菌通过蚕体表伤口侵入血腔",
|
||
Medium: "环境中广泛存在的细菌，通过蚕具刮伤、蚕互相抓伤等创口侵入",
|
||
Incubation: "—",
|
||
Symptoms: "密集饲养下蚕体互相抓伤概率增大→个体发病死亡→尸体腐烂细菌扩散",
|
||
HighRiskStage: "密集饲养、蚕具粗糙时多发",
|
||
HighRiskCondition: "蚕具刮伤、操作粗暴、消毒不彻底",
|
||
SpreadTrend: "个体发病死亡→尸体腐烂细菌扩散→接触传染加重",
|
||
Recurrence: "反复发作时需排查蚕具毛刺/操作粗暴/消毒盲区",
|
||
Detection: "—",
|
||
Prevention: "排查蚕具是否有尖锐边缘/毛刺；控制蚕头密度减少相互抓伤；给桑操作轻柔；反复发作时排查消毒盲区并升级消毒",
|
||
},
|
||
{
|
||
Name: "猝倒病", Category: "bacterial", SortOrder: 8,
|
||
Pathogen: "细菌毒素（如苏云金杆菌毒素）",
|
||
Transmission: "食下传染——蚕食入细菌产生的毒素",
|
||
Medium: "桑叶被细菌污染",
|
||
Incubation: "急性中毒，发病快、死亡快",
|
||
Symptoms: "急性中毒，发病快、死亡快",
|
||
HighRiskStage: "—",
|
||
HighRiskCondition: "桑叶储运环节污染",
|
||
SpreadTrend: "与桑叶污染直接相关",
|
||
Recurrence: "桑叶储运环节污染或蚕房环境",
|
||
Detection: "—",
|
||
Prevention: "桑叶来源批次追溯并检查储运条件；发现后立即更换桑叶来源；避免桑叶被细菌污染",
|
||
},
|
||
{
|
||
Name: "其他真菌病（绿僵病/黄僵病/曲霉病）", Category: "fungal", SortOrder: 9,
|
||
Pathogen: "金龟子绿僵菌（绿僵病）、曲霉菌（曲霉病）、黄僵病病原（较少见）",
|
||
Transmission: "接触传染、气流扩散（真菌分生孢子）",
|
||
Medium: "分生孢子",
|
||
Incubation: "—",
|
||
Symptoms: "绿僵病死蚕呈绿色；黄僵病较少见；曲霉病多发于小蚕期",
|
||
HighRiskStage: "曲霉病多发于小蚕期；高温高湿季真菌病暴发",
|
||
HighRiskCondition: "高温高湿、蚕座卫生差",
|
||
SpreadTrend: "绿僵病多为野外昆虫交叉感染",
|
||
Recurrence: "真菌孢子兼性腐生，环境残留难彻底清除",
|
||
Detection: "按死蚕孢子颜色肉眼初步区分",
|
||
Prevention: "与白僵病防控一致：加强通风排湿（湿度>75%重点防范）；小蚕期注意蚕座卫生防曲霉病；蚕房周边昆虫防治与桑园害虫治理",
|
||
},
|
||
}
|
||
|
||
// SeedKnowledgeArticles 知识文章种子数据（AI 结果解读，分级阈值来自规格书 3.1.4）
|
||
var SeedKnowledgeArticles = []KnowledgeArticle{
|
||
{
|
||
Kind: "ai_guide",
|
||
Title: "AI 巡检结果怎么看（风险分级解读）",
|
||
Summary: "了解 AI 拍照巡检返回的绿/黄/橙/红风险等级含义与建议动作",
|
||
Content: "AI 巡检将蚕病风险分为四级：\n绿（0-30分）：健康，正常巡检节奏，无需操作。\n黄（31-60分）：需观察，增加巡检频次，人工复查、关注异常个体。\n橙（61-80分）：疑似异常，触发分子检测任务（如 LAMP），按系统指引取样送检。\n红（81-100分）：高度疑似/已发病，立即隔离病蚕、启动消毒，并触发专家会诊。\n\nAI 结果仅为筛查参考，最终确诊以分子检测（LAMP/qPCR）和专家诊断为准。",
|
||
SortOrder: 1,
|
||
},
|
||
}
|
||
```
|
||
|
||
- [ ] **Step 2: 运行测试确认通过**
|
||
|
||
Run: `cd server-go && go test ./internal/model/ -run TestSeed -v`
|
||
Expected: 4 个测试全部 PASS
|
||
|
||
- [ ] **Step 3: Commit**
|
||
|
||
```bash
|
||
git add server-go/internal/model/knowledge_seed.go
|
||
git commit -m "feat(knowledge): 蚕病百科与 AI 解读种子数据"
|
||
```
|
||
|
||
---
|
||
|
||
### Task 3: Go handler、路由、权限、迁移
|
||
|
||
**Files:**
|
||
- Create: `server-go/internal/handler/knowledge.go`
|
||
- Modify: `server-go/internal/model/permission_seed.go`（新增 2 条权限 + 角色映射）
|
||
- Modify: `server-go/internal/database/db.go`（AutoMigrate 注册 + `seedKnowledge`）
|
||
- Modify: `server-go/cmd/server/main.go`（注册 `RegisterKnowledgeRoutes`）
|
||
|
||
**Interfaces:**
|
||
- Consumes: Task 1-2 的 `model.Disease` / `model.KnowledgeArticle` / 种子变量；`handler.bindUpdates`（现有）。
|
||
- Produces: API `GET/POST/PATCH/DELETE /knowledge/diseases(/:id)`、`GET/POST/PATCH/DELETE /knowledge/articles(/:id)`；权限码 `knowledge:read` / `knowledge:write`。
|
||
|
||
`server-go/internal/handler/knowledge.go` 完整实现：
|
||
|
||
```go
|
||
package handler
|
||
|
||
import (
|
||
"net/http"
|
||
|
||
"silk-server-go/internal/middleware"
|
||
"silk-server-go/internal/model"
|
||
|
||
"github.com/gin-gonic/gin"
|
||
"gorm.io/gorm"
|
||
)
|
||
|
||
// RegisterKnowledgeRoutes 注册知识库路由
|
||
func RegisterKnowledgeRoutes(rg *gin.RouterGroup, db *gorm.DB) {
|
||
read := middleware.RequirePermission(db, "knowledge:read")
|
||
write := middleware.RequirePermission(db, "knowledge:write")
|
||
|
||
rg.GET("/knowledge/diseases", read, listDiseases(db))
|
||
rg.GET("/knowledge/diseases/:id", read, getDisease(db))
|
||
rg.POST("/knowledge/diseases", write, createDisease(db))
|
||
rg.PATCH("/knowledge/diseases/:id", write, updateDisease(db))
|
||
rg.DELETE("/knowledge/diseases/:id", write, deleteDisease(db))
|
||
|
||
rg.GET("/knowledge/articles", read, listArticles(db))
|
||
rg.GET("/knowledge/articles/:id", read, getArticle(db))
|
||
rg.POST("/knowledge/articles", write, createArticle(db))
|
||
rg.PATCH("/knowledge/articles/:id", write, updateArticle(db))
|
||
rg.DELETE("/knowledge/articles/:id", write, deleteArticle(db))
|
||
}
|
||
|
||
func listDiseases(db *gorm.DB) gin.HandlerFunc {
|
||
return func(c *gin.Context) {
|
||
q := db.Model(&model.Disease{})
|
||
if cat := c.Query("category"); cat != "" {
|
||
q = q.Where("category = ?", cat)
|
||
}
|
||
if kw := c.Query("keyword"); kw != "" {
|
||
q = q.Where("name ILIKE ?", "%"+kw+"%")
|
||
}
|
||
if enabled := c.Query("enabled"); enabled != "" {
|
||
q = q.Where("enabled = ?", enabled == "true")
|
||
}
|
||
var list []model.Disease
|
||
q.Order("sort_order ASC, name ASC").Find(&list)
|
||
c.JSON(http.StatusOK, list)
|
||
}
|
||
}
|
||
|
||
func getDisease(db *gorm.DB) gin.HandlerFunc {
|
||
return func(c *gin.Context) {
|
||
var d model.Disease
|
||
if db.Where("id = ?", c.Param("id")).First(&d).Error != nil {
|
||
c.JSON(http.StatusNotFound, gin.H{"error": "disease not found"})
|
||
return
|
||
}
|
||
c.JSON(http.StatusOK, d)
|
||
}
|
||
}
|
||
|
||
func createDisease(db *gorm.DB) gin.HandlerFunc {
|
||
return func(c *gin.Context) {
|
||
var d model.Disease
|
||
if err := c.ShouldBindJSON(&d); err != nil {
|
||
c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
|
||
return
|
||
}
|
||
d.ID = ""
|
||
if d.Name == "" {
|
||
c.JSON(http.StatusBadRequest, gin.H{"error": "病种名称不能为空"})
|
||
return
|
||
}
|
||
if err := db.Create(&d).Error; err != nil {
|
||
c.JSON(http.StatusBadRequest, gin.H{"error": "创建失败"})
|
||
return
|
||
}
|
||
c.JSON(http.StatusCreated, d)
|
||
}
|
||
}
|
||
|
||
func updateDisease(db *gorm.DB) gin.HandlerFunc {
|
||
return func(c *gin.Context) {
|
||
id := c.Param("id")
|
||
var d model.Disease
|
||
if db.Where("id = ?", id).First(&d).Error != nil {
|
||
c.JSON(http.StatusNotFound, gin.H{"error": "disease not found"})
|
||
return
|
||
}
|
||
updates, err := bindUpdates(c)
|
||
if err != nil {
|
||
c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
|
||
return
|
||
}
|
||
if len(updates) > 0 {
|
||
db.Model(&model.Disease{}).Where("id = ?", id).Updates(updates)
|
||
}
|
||
db.Where("id = ?", id).First(&d)
|
||
c.JSON(http.StatusOK, d)
|
||
}
|
||
}
|
||
|
||
func deleteDisease(db *gorm.DB) gin.HandlerFunc {
|
||
return func(c *gin.Context) {
|
||
id := c.Param("id")
|
||
var d model.Disease
|
||
if db.Where("id = ?", id).First(&d).Error != nil {
|
||
c.JSON(http.StatusNotFound, gin.H{"error": "disease not found"})
|
||
return
|
||
}
|
||
db.Where("id = ?", id).Delete(&model.Disease{})
|
||
c.JSON(http.StatusOK, gin.H{"id": id})
|
||
}
|
||
}
|
||
|
||
func listArticles(db *gorm.DB) gin.HandlerFunc {
|
||
return func(c *gin.Context) {
|
||
q := db.Model(&model.KnowledgeArticle{})
|
||
if kind := c.Query("kind"); kind != "" {
|
||
q = q.Where("kind = ?", kind)
|
||
}
|
||
if enabled := c.Query("enabled"); enabled != "" {
|
||
q = q.Where("enabled = ?", enabled == "true")
|
||
}
|
||
var list []model.KnowledgeArticle
|
||
q.Order("sort_order ASC, created_at DESC").Find(&list)
|
||
c.JSON(http.StatusOK, list)
|
||
}
|
||
}
|
||
|
||
func getArticle(db *gorm.DB) gin.HandlerFunc {
|
||
return func(c *gin.Context) {
|
||
var a model.KnowledgeArticle
|
||
if db.Where("id = ?", c.Param("id")).First(&a).Error != nil {
|
||
c.JSON(http.StatusNotFound, gin.H{"error": "article not found"})
|
||
return
|
||
}
|
||
c.JSON(http.StatusOK, a)
|
||
}
|
||
}
|
||
|
||
func createArticle(db *gorm.DB) gin.HandlerFunc {
|
||
return func(c *gin.Context) {
|
||
var a model.KnowledgeArticle
|
||
if err := c.ShouldBindJSON(&a); err != nil {
|
||
c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
|
||
return
|
||
}
|
||
a.ID = ""
|
||
if a.Kind == "" || a.Title == "" {
|
||
c.JSON(http.StatusBadRequest, gin.H{"error": "文章类型和标题不能为空"})
|
||
return
|
||
}
|
||
if err := db.Create(&a).Error; err != nil {
|
||
c.JSON(http.StatusBadRequest, gin.H{"error": "创建失败"})
|
||
return
|
||
}
|
||
c.JSON(http.StatusCreated, a)
|
||
}
|
||
}
|
||
|
||
func updateArticle(db *gorm.DB) gin.HandlerFunc {
|
||
return func(c *gin.Context) {
|
||
id := c.Param("id")
|
||
var a model.KnowledgeArticle
|
||
if db.Where("id = ?", id).First(&a).Error != nil {
|
||
c.JSON(http.StatusNotFound, gin.H{"error": "article not found"})
|
||
return
|
||
}
|
||
updates, err := bindUpdates(c)
|
||
if err != nil {
|
||
c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
|
||
return
|
||
}
|
||
if len(updates) > 0 {
|
||
db.Model(&model.KnowledgeArticle{}).Where("id = ?", id).Updates(updates)
|
||
}
|
||
db.Where("id = ?", id).First(&a)
|
||
c.JSON(http.StatusOK, a)
|
||
}
|
||
}
|
||
|
||
func deleteArticle(db *gorm.DB) gin.HandlerFunc {
|
||
return func(c *gin.Context) {
|
||
id := c.Param("id")
|
||
var a model.KnowledgeArticle
|
||
if db.Where("id = ?", id).First(&a).Error != nil {
|
||
c.JSON(http.StatusNotFound, gin.H{"error": "article not found"})
|
||
return
|
||
}
|
||
db.Where("id = ?", id).Delete(&model.KnowledgeArticle{})
|
||
c.JSON(http.StatusOK, gin.H{"id": id})
|
||
}
|
||
}
|
||
```
|
||
|
||
`server-go/internal/model/permission_seed.go` 追加：
|
||
|
||
```go
|
||
{"knowledge:read", "知识库查看", "查看蚕病百科和知识文章"},
|
||
{"knowledge:write", "知识库管理", "新增、编辑、删除知识库内容"},
|
||
```
|
||
|
||
并在 `RolePermissionMap`：admin/operator 增加 `"knowledge:read", "knowledge:write"`；viewer/farmer 增加 `"knowledge:read"`。
|
||
|
||
`server-go/internal/database/db.go`：
|
||
- `AutoMigrate` 列表追加 `&model.Disease{}, &model.KnowledgeArticle{},`
|
||
- 新增 `seedKnowledge(db)`（幂等，按 `name` / `kind+title` 判重，不存在才 `Create`），并在 `Init` 中 `seedPermissions(db)` 之后调用。
|
||
|
||
`server-go/cmd/server/main.go`：在 `RegisterStorageRoutes` 后追加 `handler.RegisterKnowledgeRoutes(api, db)`。
|
||
|
||
- [ ] **Step 1: 修改代码**
|
||
- [ ] **Step 2: 验证**
|
||
|
||
Run: `cd server-go && go build ./... && go vet ./... && go test ./...`
|
||
Expected: exit 0，无错误
|
||
|
||
- [ ] **Step 3: Commit**
|
||
|
||
```bash
|
||
git add server-go/internal/handler/knowledge.go server-go/internal/model/permission_seed.go server-go/internal/database/db.go server-go/cmd/server/main.go
|
||
git commit -m "feat(knowledge): 知识库 API、权限与迁移"
|
||
```
|
||
|
||
---
|
||
|
||
### Task 4: Web 后台知识库页
|
||
|
||
**Files:**
|
||
- Create: `web/src/dal/knowledge.ts`
|
||
- Create: `web/src/pages/Knowledge.tsx`
|
||
- Modify: `web/src/router.tsx`（注册 `/knowledge`，权限 `knowledge:read`）
|
||
- Modify: `web/src/layout/BasicLayout.tsx`（菜单“知识库”，`BookOutlined`，权限 `knowledge:read`）
|
||
|
||
**Interfaces:**
|
||
- Consumes: 后端 `Disease` / `KnowledgeArticle` JSON 字段（与 Go JSON tag 完全一致）。
|
||
|
||
`web/src/dal/knowledge.ts`：
|
||
|
||
```ts
|
||
import { get, post, patch, del } from '../api/http';
|
||
|
||
export interface Disease {
|
||
id: string;
|
||
name: string;
|
||
category: string;
|
||
pathogen?: string;
|
||
transmission?: string;
|
||
medium?: string;
|
||
incubation?: string;
|
||
symptoms?: string;
|
||
highRiskStage?: string;
|
||
highRiskCondition?: string;
|
||
lethalTime?: string;
|
||
spreadTrend?: string;
|
||
recurrence?: string;
|
||
detection?: string;
|
||
prevention?: string;
|
||
imageUrl?: string;
|
||
sortOrder?: number;
|
||
enabled?: boolean;
|
||
createdAt?: string;
|
||
updatedAt?: string;
|
||
}
|
||
|
||
export interface KnowledgeArticle {
|
||
id: string;
|
||
kind: string;
|
||
title: string;
|
||
summary?: string;
|
||
content?: string;
|
||
sortOrder?: number;
|
||
enabled?: boolean;
|
||
createdAt?: string;
|
||
updatedAt?: string;
|
||
}
|
||
|
||
export const listDiseases = (params?: any) => get<Disease[]>('/knowledge/diseases', { params });
|
||
export const getDisease = (id: string) => get<Disease>(`/knowledge/diseases/${id}`);
|
||
export const createDisease = (data: Partial<Disease>) => post<Disease>('/knowledge/diseases', data);
|
||
export const updateDisease = (id: string, data: Partial<Disease>) => patch<Disease>(`/knowledge/diseases/${id}`, data);
|
||
export const deleteDisease = (id: string) => del(`/knowledge/diseases/${id}`);
|
||
|
||
export const listArticles = (params?: any) => get<KnowledgeArticle[]>('/knowledge/articles', { params });
|
||
export const createArticle = (data: Partial<KnowledgeArticle>) => post<KnowledgeArticle>('/knowledge/articles', data);
|
||
export const updateArticle = (id: string, data: Partial<KnowledgeArticle>) => patch<KnowledgeArticle>(`/knowledge/articles/${id}`, data);
|
||
export const deleteArticle = (id: string) => del(`/knowledge/articles/${id}`);
|
||
```
|
||
|
||
`web/src/pages/Knowledge.tsx`：参照 `web/src/pages/Silkworm.tsx` 的 ProTable + Modal 风格：
|
||
- 页面顶部 `Tabs`：Tab1「蚕病百科」，Tab2「AI 结果解读」。
|
||
- 蚕病百科 Tab：ProTable（rowKey=id，序号列、名称、类别 Tag、高发阶段、排序、状态、操作列 编辑/删除），toolBar「新建病种」；编辑/新建 Modal 表单含全部字段（名称、类别 Select[viral/fungal/bacterial/protozoan/other]、病原、传播途径、传染媒介、潜伏期、主要症状、高发阶段、高发条件、致死时间、传播趋势、连发性特征、检测方法、防治指南 TextArea、排序、启用 Switch）。
|
||
- AI 解读 Tab：ProTable（序号、标题、类型 Tag、摘要、排序、操作），编辑/新建 Modal 含 kind Select[ai_guide/lamp_guide/sers_guide/seasonal_tip]、标题、摘要、正文 TextArea、排序、启用。
|
||
- 类别中文映射：`{ viral: '病毒性', fungal: '真菌性', bacterial: '细菌性', protozoan: '原虫性', other: '其他' }`。
|
||
- 写操作按钮仅当 `authService.hasPermission('knowledge:write')` 时渲染；无权限时只读列表。
|
||
|
||
- [ ] **Step 1: 新增 dal 与页面，注册路由与菜单**
|
||
- [ ] **Step 2: 验证**
|
||
|
||
Run: `cd web && npm run lint && npm run build`
|
||
Expected: exit 0，无 lint 错误，tsc + vite 构建通过
|
||
|
||
- [ ] **Step 3: Commit**
|
||
|
||
```bash
|
||
git add web/src/dal/knowledge.ts web/src/pages/Knowledge.tsx web/src/router.tsx web/src/layout/BasicLayout.tsx
|
||
git commit -m "feat(web): 知识库页面（蚕病百科 + AI 解读）"
|
||
```
|
||
|
||
---
|
||
|
||
### Task 5: 小程序知识库查看页
|
||
|
||
**Files:**
|
||
- Create: `miniapp/src/api/knowledge.ts`
|
||
- Modify: `miniapp/src/types/index.ts`（追加 `Disease`、`KnowledgeArticle` 接口）
|
||
- Create: `miniapp/src/pages/knowledge/index.tsx`、`index.config.ts`、`index.module.scss`
|
||
- Create: `miniapp/src/pages/knowledge/detail/index.tsx`、`detail/index.config.ts`、`detail/index.module.scss`
|
||
- Modify: `miniapp/src/pages/settings/index.tsx`（“监控管理”菜单追加“知识库”入口）
|
||
- Modify: `miniapp/src/app.config.ts`（pages 追加两个页面）
|
||
|
||
**Interfaces:**
|
||
- Consumes: 后端 `GET /knowledge/diseases`、`GET /knowledge/articles?kind=ai_guide`。
|
||
|
||
`miniapp/src/api/knowledge.ts`：
|
||
|
||
```ts
|
||
import { get } from './request';
|
||
|
||
export interface Disease {
|
||
id: string;
|
||
name: string;
|
||
category: string;
|
||
pathogen?: string;
|
||
transmission?: string;
|
||
medium?: string;
|
||
incubation?: string;
|
||
symptoms?: string;
|
||
highRiskStage?: string;
|
||
highRiskCondition?: string;
|
||
lethalTime?: string;
|
||
spreadTrend?: string;
|
||
recurrence?: string;
|
||
detection?: string;
|
||
prevention?: string;
|
||
sortOrder?: number;
|
||
}
|
||
|
||
export interface KnowledgeArticle {
|
||
id: string;
|
||
kind: string;
|
||
title: string;
|
||
summary?: string;
|
||
content?: string;
|
||
sortOrder?: number;
|
||
}
|
||
|
||
export const listDiseases = () => get<Disease[]>('/knowledge/diseases');
|
||
export const listAIGuides = () => get<KnowledgeArticle[]>('/knowledge/articles', { kind: 'ai_guide' });
|
||
```
|
||
|
||
页面行为：
|
||
- `pages/knowledge/index`：页面标题“知识库”；顶部渲染 AI 结果解读卡片（`listAIGuides` 取第一条，展示标题+摘要，点击 `navigateTo('/pages/knowledge/detail/index?kind=ai_guide&id=xx')`）；下方按类别分组渲染病种列表（类别中文 Tag + 病种名 + 症状摘要），点击进入 `detail?kind=disease&id=xx`。
|
||
- `pages/knowledge/detail`：按 `kind` 区分：`disease` 用 `get<Disease>('/knowledge/diseases/'+id)` 渲染分段卡片（病原/传播途径/传染媒介/潜伏期/主要症状/高发阶段/高发条件/致死时间/传播趋势/连发性/检测方法/防治指南）；`ai_guide` 用 `get<KnowledgeArticle>('/knowledge/articles/'+id)` 渲染标题+正文（`white-space: pre-wrap`）。
|
||
- 样式参照 `miniapp/src/pages/settings/index.module.scss` 的卡片风格。
|
||
- `settings/index.tsx` 的 `handleMenuTap` 增加 `case 'knowledge': Taro.navigateTo({ url: '/pages/knowledge/index' }); break;`，菜单项文案“知识库”。
|
||
|
||
- [ ] **Step 1: 新增 api、类型与两个页面，注册路由与设置页入口**
|
||
- [ ] **Step 2: 验证**
|
||
|
||
Run: `cd miniapp && npm run build:weapp`
|
||
Expected: exit 0，`miniapp/dist` 重新生成（生成产物不提交）
|
||
|
||
- [ ] **Step 3: Commit**
|
||
|
||
```bash
|
||
git add miniapp/src
|
||
git commit -m "feat(miniapp): 知识库查看页"
|
||
```
|
||
|
||
---
|
||
|
||
### Task 6: 全量验证与交付
|
||
|
||
- [ ] **Step 1: 后端**
|
||
|
||
Run: `cd server-go && go test ./... && go build ./... && go vet ./...`
|
||
|
||
- [ ] **Step 2: Web**
|
||
|
||
Run: `cd web && npm run lint && npm run build`
|
||
|
||
- [ ] **Step 3: 小程序**
|
||
|
||
Run: `cd miniapp && npm run build:weapp`
|
||
|
||
- [ ] **Step 4: 检查变更范围**
|
||
|
||
Run: `git status --short`，确认只包含知识库相关源文件，未动生成产物。
|
||
|
||
- [ ] **Step 5: 交付说明**
|
||
|
||
汇总：修改文件清单、验证输出、种子数据说明（9 病种 + 1 AI 文章）、风险提示（handler 端到端 API 需 PostgreSQL 运行环境联调；前端测试基建未配置，属于计划 #27）。
|