feat(wm-base): #73 文档管理完整实现

db/postgresql/V2__doc.sql

@@ -0,0 +1,69 @@
+-- =============================================
+-- 文档管理模块 DDL
+-- =============================================
+
+-- 文档分类表
+CREATE TABLE IF NOT EXISTS doc_category (
+    id BIGSERIAL PRIMARY KEY,
+    name VARCHAR(100) NOT NULL,
+    parent_id BIGINT DEFAULT 0,
+    sort INT DEFAULT 0,
+    deleted SMALLINT DEFAULT 0,
+    create_time TIMESTAMP DEFAULT NOW()
+);
+COMMENT ON TABLE doc_category IS '文档分类表';
+
+-- 文档主表
+CREATE TABLE IF NOT EXISTS doc (
+    id BIGSERIAL PRIMARY KEY,
+    name VARCHAR(255) NOT NULL,
+    description TEXT,
+    file_type VARCHAR(20),
+    file_size BIGINT DEFAULT 0,
+    storage_path VARCHAR(500) NOT NULL,
+    category_id BIGINT REFERENCES doc_category(id),
+    tags VARCHAR(500),
+    current_version INT DEFAULT 1,
+    uploader_id BIGINT,
+    uploader_name VARCHAR(50),
+    access_level SMALLINT DEFAULT 0,
+    dept_id BIGINT,
+    download_count INT DEFAULT 0,
+    search_text TEXT,
+    deleted SMALLINT DEFAULT 0,
+    create_time TIMESTAMP DEFAULT NOW(),
+    update_time TIMESTAMP DEFAULT NOW()
+);
+COMMENT ON TABLE doc IS '文档主表';
+COMMENT ON COLUMN doc.access_level IS '权限级别: 0-公开 1-部门可见 2-仅自己';
+
+-- 文档版本表
+CREATE TABLE IF NOT EXISTS doc_version (
+    id BIGSERIAL PRIMARY KEY,
+    doc_id BIGINT NOT NULL REFERENCES doc(id),
+    version INT NOT NULL,
+    storage_path VARCHAR(500) NOT NULL,
+    file_size BIGINT DEFAULT 0,
+    change_log VARCHAR(500),
+    uploader_id BIGINT,
+    uploader_name VARCHAR(50),
+    create_time TIMESTAMP DEFAULT NOW()
+);
+COMMENT ON TABLE doc_version IS '文档版本表';
+
+-- 索引
+CREATE INDEX IF NOT EXISTS idx_doc_category ON doc(category_id);
+CREATE INDEX IF NOT EXISTS idx_doc_uploader ON doc(uploader_id);
+CREATE INDEX IF NOT EXISTS idx_doc_dept ON doc(dept_id);
+CREATE INDEX IF NOT EXISTS idx_doc_file_type ON doc(file_type);
+CREATE INDEX IF NOT EXISTS idx_doc_search_text ON doc USING gin(to_tsvector('simple', COALESCE(search_text, '')));
+CREATE INDEX IF NOT EXISTS idx_doc_version_doc_id ON doc_version(doc_id);
+
+-- 默认分类
+INSERT INTO doc_category (name, parent_id, sort) VALUES
+('技术规范', 0, 1),
+('操作手册', 0, 2),
+('设计图纸', 0, 3),
+('合同文件', 0, 4),
+('会议纪要', 0, 5)
+ON CONFLICT DO NOTHING;

frontend/src/router/index.ts

@@ -11,6 +11,8 @@ const routes = [
       { path: 'system/role', name: 'role', component: () => import('@/views/system/role/RoleList.vue') },
       { path: 'system/menu', name: 'menu', component: () => import('@/views/system/menu/MenuList.vue') },
       { path: 'system/dept', name: 'dept', component: () => import('@/views/system/dept/DeptList.vue') },
+      { path: 'doc', name: 'doc', component: () => import('@/views/doc/DocList.vue') },
+      { path: 'doc/detail/:id', name: 'docDetail', component: () => import('@/views/doc/DocDetail.vue') },
     ]
   },
   { path: '/:pathMatch(.*)*', redirect: '/dashboard' }

frontend/src/views/doc/DocDetail.vue

@@ -0,0 +1,321 @@
+<template>
+  <div class="doc-detail-container">
+    <el-page-header @back="goBack" :title="'返回'" />
+
+    <el-skeleton :loading="loading" animated>
+      <template #default>
+        <el-row :gutter="20" style="margin-top: 20px">
+          <!-- 左侧: 文档信息 -->
+          <el-col :span="16">
+            <el-card>
+              <template #header>
+                <div class="card-header">
+                  <span>{{ doc.name }}</span>
+                  <div>
+                    <el-button type="primary" @click="downloadDoc">下载</el-button>
+                    <el-button @click="showEditDialog = true">编辑</el-button>
+                  </div>
+                </div>
+              </template>
+
+              <el-descriptions :column="2" border>
+                <el-descriptions-item label="文档名称">{{ doc.name }}</el-descriptions-item>
+                <el-descriptions-item label="文件类型">
+                  <el-tag>{{ doc.fileType }}</el-tag>
+                </el-descriptions-item>
+                <el-descriptions-item label="文件大小">{{ formatSize(doc.fileSize) }}</el-descriptions-item>
+                <el-descriptions-item label="当前版本">v{{ doc.currentVersion }}</el-descriptions-item>
+                <el-descriptions-item label="分类">{{ doc.categoryName || '-' }}</el-descriptions-item>
+                <el-descriptions-item label="下载次数">{{ doc.downloadCount }}</el-descriptions-item>
+                <el-descriptions-item label="上传人">{{ doc.uploaderName }}</el-descriptions-item>
+                <el-descriptions-item label="权限级别">
+                  <el-tag :type="accessLevelType">{{ accessLevelText }}</el-tag>
+                </el-descriptions-item>
+                <el-descriptions-item label="创建时间">{{ doc.createTime }}</el-descriptions-item>
+                <el-descriptions-item label="更新时间">{{ doc.updateTime }}</el-descriptions-item>
+                <el-descriptions-item label="描述" :span="2">{{ doc.description || '-' }}</el-descriptions-item>
+                <el-descriptions-item label="标签" :span="2">
+                  <el-tag v-for="tag in doc.tagList" :key="tag" size="small" class="tag-item">{{ tag }}</el-tag>
+                  <span v-if="!doc.tagList || doc.tagList.length === 0">-</span>
+                </el-descriptions-item>
+              </el-descriptions>
+            </el-card>
+          </el-col>
+
+          <!-- 右侧: 版本历史 + 上传新版本 -->
+          <el-col :span="8">
+            <el-card>
+              <template #header>
+                <div class="card-header">
+                  <span>版本历史</span>
+                  <el-button type="primary" size="small" @click="showVersionUpload = true">上传新版本</el-button>
+                </div>
+              </template>
+
+              <el-timeline>
+                <el-timeline-item
+                  v-for="ver in versions"
+                  :key="ver.id"
+                  :timestamp="ver.createTime"
+                  :type="ver.version === doc.currentVersion ? 'primary' : 'info'"
+                >
+                  <div class="version-item">
+                    <div class="version-header">
+                      <strong>v{{ ver.version }}</strong>
+                      <el-button
+                        v-if="ver.version !== doc.currentVersion"
+                        size="small"
+                        text
+                        type="primary"
+                        @click="downloadVersion(ver.version)"
+                      >下载</el-button>
+                    </div>
+                    <div class="version-meta">{{ ver.uploaderName }} · {{ formatSize(ver.fileSize) }}</div>
+                    <div class="version-log">{{ ver.changeLog || '无说明' }}</div>
+                  </div>
+                </el-timeline-item>
+              </el-timeline>
+            </el-card>
+          </el-col>
+        </el-row>
+      </template>
+    </el-skeleton>
+
+    <!-- 编辑对话框 -->
+    <el-dialog v-model="showEditDialog" title="编辑文档信息" width="500px">
+      <el-form :model="editForm" label-width="80px">
+        <el-form-item label="名称">
+          <el-input v-model="editForm.name" />
+        </el-form-item>
+        <el-form-item label="描述">
+          <el-input v-model="editForm.description" type="textarea" :rows="3" />
+        </el-form-item>
+        <el-form-item label="标签">
+          <el-input v-model="editForm.tags" placeholder="逗号分隔" />
+        </el-form-item>
+        <el-form-item label="权限">
+          <el-radio-group v-model="editForm.accessLevel">
+            <el-radio :label="0">公开</el-radio>
+            <el-radio :label="1">部门可见</el-radio>
+            <el-radio :label="2">仅自己</el-radio>
+          </el-radio-group>
+        </el-form-item>
+      </el-form>
+      <template #footer>
+        <el-button @click="showEditDialog = false">取消</el-button>
+        <el-button type="primary" @click="submitEdit">保存</el-button>
+      </template>
+    </el-dialog>
+
+    <!-- 上传新版本对话框 -->
+    <el-dialog v-model="showVersionUpload" title="上传新版本" width="500px">
+      <el-form label-width="80px">
+        <el-form-item label="文件" required>
+          <el-upload :auto-upload="false" :limit="1" :on-change="handleVersionFileChange" drag>
+            <el-icon class="el-icon--upload"><UploadFilled /></el-icon>
+            <div class="el-upload__text">拖拽文件到此处或 <em>点击上传</em></div>
+          </el-upload>
+        </el-form-item>
+        <el-form-item label="变更说明">
+          <el-input v-model="versionChangeLog" type="textarea" :rows="2" placeholder="描述本次修改内容" />
+        </el-form-item>
+      </el-form>
+      <template #footer>
+        <el-button @click="showVersionUpload = false">取消</el-button>
+        <el-button type="primary" @click="submitVersionUpload" :loading="uploading">上传</el-button>
+      </template>
+    </el-dialog>
+  </div>
+</template>
+
+<script setup>
+import { ref, reactive, computed, onMounted } from 'vue'
+import { useRoute, useRouter } from 'vue-router'
+import { ElMessage } from 'element-plus'
+import { UploadFilled } from '@element-plus/icons-vue'
+import axios from 'axios'
+
+const route = useRoute()
+const router = useRouter()
+const docId = route.params.id
+
+const loading = ref(true)
+const uploading = ref(false)
+const showEditDialog = ref(false)
+const showVersionUpload = ref(false)
+const doc = ref({})
+const versions = ref([])
+const versionFile = ref(null)
+const versionChangeLog = ref('')
+
+const editForm = reactive({
+  name: '',
+  description: '',
+  tags: '',
+  accessLevel: 0
+})
+
+const accessLevelText = computed(() => {
+  const map = { 0: '公开', 1: '部门可见', 2: '仅自己' }
+  return map[doc.value.accessLevel] || '未知'
+})
+
+const accessLevelType = computed(() => {
+  const map = { 0: 'success', 1: 'warning', 2: 'danger' }
+  return map[doc.value.accessLevel] || 'info'
+})
+
+onMounted(async () => {
+  await loadDetail()
+  await loadVersions()
+  loading.value = false
+})
+
+const loadDetail = async () => {
+  try {
+    const res = await axios.get(`/api/base/doc/${docId}`)
+    if (res.data.code === 200) {
+      doc.value = res.data.data
+      Object.assign(editForm, {
+        name: doc.value.name,
+        description: doc.value.description || '',
+        tags: doc.value.tags || '',
+        accessLevel: doc.value.accessLevel || 0
+      })
+    }
+  } catch (e) {
+    ElMessage.error('加载文档详情失败')
+  }
+}
+
+const loadVersions = async () => {
+  try {
+    const res = await axios.get(`/api/base/doc/${docId}/versions`)
+    if (res.data.code === 200) {
+      versions.value = res.data.data
+    }
+  } catch (e) {
+    console.error('加载版本列表失败', e)
+  }
+}
+
+const downloadDoc = async () => {
+  try {
+    const res = await axios.get(`/api/base/doc/${docId}/download`, { responseType: 'blob' })
+    const url = window.URL.createObjectURL(new Blob([res.data]))
+    const link = document.createElement('a')
+    link.href = url
+    link.download = doc.value.name || `doc_${docId}`
+    link.click()
+    window.URL.revokeObjectURL(url)
+  } catch (e) {
+    ElMessage.error('下载失败')
+  }
+}
+
+const downloadVersion = async (version) => {
+  try {
+    const res = await axios.get(`/api/base/doc/${docId}/version/${version}/download`, { responseType: 'blob' })
+    const url = window.URL.createObjectURL(new Blob([res.data]))
+    const link = document.createElement('a')
+    link.href = url
+    link.download = `${doc.value.name}_v${version}`
+    link.click()
+    window.URL.revokeObjectURL(url)
+  } catch (e) {
+    ElMessage.error('下载失败')
+  }
+}
+
+const submitEdit = async () => {
+  try {
+    const res = await axios.put(`/api/base/doc/${docId}`, editForm)
+    if (res.data.code === 200) {
+      ElMessage.success('更新成功')
+      showEditDialog.value = false
+      await loadDetail()
+    }
+  } catch (e) {
+    ElMessage.error('更新失败')
+  }
+}
+
+const handleVersionFileChange = (file) => {
+  versionFile.value = file.raw
+}
+
+const submitVersionUpload = async () => {
+  if (!versionFile.value) {
+    ElMessage.warning('请选择文件')
+    return
+  }
+  uploading.value = true
+  const formData = new FormData()
+  formData.append('file', versionFile.value)
+  if (versionChangeLog.value) formData.append('changeLog', versionChangeLog.value)
+
+  try {
+    const res = await axios.post(`/api/base/doc/${docId}/version`, formData, {
+      headers: { 'Content-Type': 'multipart/form-data' }
+    })
+    if (res.data.code === 200) {
+      ElMessage.success('新版本上传成功')
+      showVersionUpload.value = false
+      versionFile.value = null
+      versionChangeLog.value = ''
+      await loadDetail()
+      await loadVersions()
+    }
+  } catch (e) {
+    ElMessage.error('上传失败')
+  } finally {
+    uploading.value = false
+  }
+}
+
+const goBack = () => {
+  router.push('/doc')
+}
+
+const formatSize = (bytes) => {
+  if (!bytes) return '0 B'
+  const units = ['B', 'KB', 'MB', 'GB']
+  let i = 0
+  let size = bytes
+  while (size >= 1024 && i < units.length - 1) {
+    size /= 1024
+    i++
+  }
+  return size.toFixed(1) + ' ' + units[i]
+}
+</script>
+
+<style scoped>
+.doc-detail-container {
+  padding: 20px;
+}
+.card-header {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+}
+.tag-item {
+  margin-right: 4px;
+}
+.version-item {
+  line-height: 1.6;
+}
+.version-header {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+}
+.version-meta {
+  font-size: 12px;
+  color: #999;
+}
+.version-log {
+  font-size: 13px;
+  color: #666;
+}
+</style>

frontend/src/views/doc/DocList.vue

@@ -0,0 +1,310 @@
+<template>
+  <div class="doc-container">
+    <!-- 搜索栏 -->
+    <el-card class="search-card">
+      <el-form :model="queryForm" inline>
+        <el-form-item label="关键词">
+          <el-input v-model="queryForm.keyword" placeholder="搜索文档名称/描述/标签" clearable @keyup.enter="handleSearch" />
+        </el-form-item>
+        <el-form-item label="分类">
+          <el-select v-model="queryForm.categoryId" placeholder="全部分类" clearable>
+            <el-option v-for="cat in categories" :key="cat.id" :label="cat.name" :value="cat.id" />
+          </el-select>
+        </el-form-item>
+        <el-form-item label="文件类型">
+          <el-select v-model="queryForm.fileType" placeholder="全部类型" clearable>
+            <el-option label="PDF" value="pdf" />
+            <el-option label="Word" value="docx" />
+            <el-option label="Excel" value="xlsx" />
+            <el-option label="图片" value="jpg" />
+            <el-option label="图片" value="png" />
+          </el-select>
+        </el-form-item>
+        <el-form-item>
+          <el-button type="primary" @click="handleSearch">
+            <el-icon><Search /></el-icon> 搜索
+          </el-button>
+          <el-button @click="resetQuery">重置</el-button>
+        </el-form-item>
+      </el-form>
+    </el-card>
+
+    <!-- 操作栏 -->
+    <el-card class="table-card">
+      <template #header>
+        <div class="card-header">
+          <span>文档列表</span>
+          <el-button type="primary" @click="showUploadDialog = true">
+            <el-icon><Upload /></el-icon> 上传文档
+          </el-button>
+        </div>
+      </template>
+
+      <el-table :data="docList" v-loading="loading" border stripe>
+        <el-table-column prop="name" label="文档名称" min-width="200" show-overflow-tooltip>
+          <template #default="{ row }">
+            <el-link type="primary" @click="viewDetail(row.id)">{{ row.name }}</el-link>
+          </template>
+        </el-table-column>
+        <el-table-column prop="fileType" label="类型" width="80" align="center">
+          <template #default="{ row }">
+            <el-tag size="small">{{ row.fileType }}</el-tag>
+          </template>
+        </el-table-column>
+        <el-table-column prop="currentVersion" label="版本" width="70" align="center">
+          <template #default="{ row }">v{{ row.currentVersion }}</template>
+        </el-table-column>
+        <el-table-column prop="fileSize" label="大小" width="100" align="center">
+          <template #default="{ row }">{{ formatSize(row.fileSize) }}</template>
+        </el-table-column>
+        <el-table-column prop="tags" label="标签" width="150" show-overflow-tooltip>
+          <template #default="{ row }">
+            <el-tag v-for="tag in parseTags(row.tags)" :key="tag" size="small" class="tag-item">{{ tag }}</el-tag>
+          </template>
+        </el-table-column>
+        <el-table-column prop="uploaderName" label="上传人" width="100" />
+        <el-table-column prop="downloadCount" label="下载" width="70" align="center" />
+        <el-table-column prop="updateTime" label="更新时间" width="160" />
+        <el-table-column label="操作" width="200" fixed="right">
+          <template #default="{ row }">
+            <el-button size="small" type="primary" @click="downloadDoc(row.id)">下载</el-button>
+            <el-button size="small" @click="viewDetail(row.id)">详情</el-button>
+            <el-button size="small" type="danger" @click="deleteDoc(row.id)">删除</el-button>
+          </template>
+        </el-table-column>
+      </el-table>
+
+      <!-- 分页 -->
+      <el-pagination
+        v-model:current-page="queryForm.pageNum"
+        v-model:page-size="queryForm.pageSize"
+        :total="total"
+        :page-sizes="[10, 20, 50, 100]"
+        layout="total, sizes, prev, pager, next, jumper"
+        @size-change="handleSearch"
+        @current-change="handleSearch"
+        class="pagination"
+      />
+    </el-card>
+
+    <!-- 上传对话框 -->
+    <el-dialog v-model="showUploadDialog" title="上传文档" width="600px">
+      <el-form :model="uploadForm" label-width="100px">
+        <el-form-item label="文件" required>
+          <el-upload
+            ref="uploadRef"
+            :auto-upload="false"
+            :limit="1"
+            :on-change="handleFileChange"
+            drag
+          >
+            <el-icon class="el-icon--upload"><UploadFilled /></el-icon>
+            <div class="el-upload__text">拖拽文件到此处或 <em>点击上传</em></div>
+          </el-upload>
+        </el-form-item>
+        <el-form-item label="文档名称">
+          <el-input v-model="uploadForm.name" placeholder="留空则使用文件名" />
+        </el-form-item>
+        <el-form-item label="描述">
+          <el-input v-model="uploadForm.description" type="textarea" :rows="3" />
+        </el-form-item>
+        <el-form-item label="分类">
+          <el-select v-model="uploadForm.categoryId" placeholder="选择分类">
+            <el-option v-for="cat in categories" :key="cat.id" :label="cat.name" :value="cat.id" />
+          </el-select>
+        </el-form-item>
+        <el-form-item label="标签">
+          <el-input v-model="uploadForm.tags" placeholder="多个标签用逗号分隔" />
+        </el-form-item>
+        <el-form-item label="权限">
+          <el-radio-group v-model="uploadForm.accessLevel">
+            <el-radio :label="0">公开</el-radio>
+            <el-radio :label="1">部门可见</el-radio>
+            <el-radio :label="2">仅自己</el-radio>
+          </el-radio-group>
+        </el-form-item>
+      </el-form>
+      <template #footer>
+        <el-button @click="showUploadDialog = false">取消</el-button>
+        <el-button type="primary" @click="submitUpload" :loading="uploading">上传</el-button>
+      </template>
+    </el-dialog>
+  </div>
+</template>
+
+<script setup>
+import { ref, reactive, onMounted } from 'vue'
+import { useRouter } from 'vue-router'
+import { ElMessage, ElMessageBox } from 'element-plus'
+import { Search, Upload, UploadFilled } from '@element-plus/icons-vue'
+import axios from 'axios'
+
+const router = useRouter()
+const loading = ref(false)
+const uploading = ref(false)
+const showUploadDialog = ref(false)
+const docList = ref([])
+const categories = ref([])
+const total = ref(0)
+const uploadRef = ref(null)
+
+const queryForm = reactive({
+  keyword: '',
+  categoryId: null,
+  fileType: '',
+  pageNum: 1,
+  pageSize: 20
+})
+
+const uploadForm = reactive({
+  file: null,
+  name: '',
+  description: '',
+  categoryId: null,
+  tags: '',
+  accessLevel: 0
+})
+
+onMounted(() => {
+  loadCategories()
+  handleSearch()
+})
+
+const loadCategories = async () => {
+  try {
+    const res = await axios.get('/api/base/doc/categories')
+    if (res.data.code === 200) {
+      categories.value = res.data.data
+    }
+  } catch (e) {
+    console.error('加载分类失败', e)
+  }
+}
+
+const handleSearch = async () => {
+  loading.value = true
+  try {
+    const res = await axios.get('/api/base/doc/search', { params: queryForm })
+    if (res.data.code === 200) {
+      docList.value = res.data.data.records || []
+      total.value = res.data.data.total || 0
+    }
+  } catch (e) {
+    ElMessage.error('搜索失败')
+  } finally {
+    loading.value = false
+  }
+}
+
+const resetQuery = () => {
+  Object.assign(queryForm, { keyword: '', categoryId: null, fileType: '', pageNum: 1, pageSize: 20 })
+  handleSearch()
+}
+
+const handleFileChange = (file) => {
+  uploadForm.file = file.raw
+  if (!uploadForm.name) {
+    uploadForm.name = file.name
+  }
+}
+
+const submitUpload = async () => {
+  if (!uploadForm.file) {
+    ElMessage.warning('请选择文件')
+    return
+  }
+  uploading.value = true
+  const formData = new FormData()
+  formData.append('file', uploadForm.file)
+  if (uploadForm.name) formData.append('name', uploadForm.name)
+  if (uploadForm.description) formData.append('description', uploadForm.description)
+  if (uploadForm.categoryId) formData.append('categoryId', uploadForm.categoryId)
+  if (uploadForm.tags) formData.append('tags', uploadForm.tags)
+  formData.append('accessLevel', uploadForm.accessLevel)
+
+  try {
+    const res = await axios.post('/api/base/doc/upload', formData, {
+      headers: { 'Content-Type': 'multipart/form-data' }
+    })
+    if (res.data.code === 200) {
+      ElMessage.success('上传成功')
+      showUploadDialog.value = false
+      Object.assign(uploadForm, { file: null, name: '', description: '', categoryId: null, tags: '', accessLevel: 0 })
+      handleSearch()
+    }
+  } catch (e) {
+    ElMessage.error('上传失败')
+  } finally {
+    uploading.value = false
+  }
+}
+
+const downloadDoc = async (docId) => {
+  try {
+    const res = await axios.get(`/api/base/doc/${docId}/download`, { responseType: 'blob' })
+    const url = window.URL.createObjectURL(new Blob([res.data]))
+    const link = document.createElement('a')
+    link.href = url
+    link.download = `doc_${docId}`
+    link.click()
+    window.URL.revokeObjectURL(url)
+  } catch (e) {
+    ElMessage.error('下载失败')
+  }
+}
+
+const viewDetail = (docId) => {
+  router.push(`/doc/detail/${docId}`)
+}
+
+const deleteDoc = async (docId) => {
+  try {
+    await ElMessageBox.confirm('确认删除该文档？', '提示', { type: 'warning' })
+    const res = await axios.delete(`/api/base/doc/${docId}`)
+    if (res.data.code === 200) {
+      ElMessage.success('删除成功')
+      handleSearch()
+    }
+  } catch (e) {
+    if (e !== 'cancel') ElMessage.error('删除失败')
+  }
+}
+
+const formatSize = (bytes) => {
+  if (!bytes) return '0 B'
+  const units = ['B', 'KB', 'MB', 'GB']
+  let i = 0
+  let size = bytes
+  while (size >= 1024 && i < units.length - 1) {
+    size /= 1024
+    i++
+  }
+  return size.toFixed(1) + ' ' + units[i]
+}
+
+const parseTags = (tags) => {
+  if (!tags) return []
+  return tags.split(',').filter(t => t.trim())
+}
+</script>
+
+<style scoped>
+.doc-container {
+  padding: 20px;
+}
+.search-card {
+  margin-bottom: 16px;
+}
+.card-header {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+}
+.pagination {
+  margin-top: 16px;
+  justify-content: flex-end;
+}
+.tag-item {
+  margin-right: 4px;
+}
+</style>

wm-base/src/main/java/com/water/base/controller/DocController.java

@@ -0,0 +1,212 @@
+package com.water.base.controller;
+
+import com.baomidou.mybatisplus.core.metadata.IPage;
+import com.water.base.entity.Doc;
+import com.water.base.entity.DocCategory;
+import com.water.base.entity.DocVersion;
+import com.water.base.entity.dto.DocQueryRequest;
+import com.water.base.entity.dto.DocVO;
+import com.water.base.service.DocService;
+import lombok.RequiredArgsConstructor;
+import org.springframework.core.io.InputStreamResource;
+import org.springframework.http.HttpHeaders;
+import org.springframework.http.MediaType;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.*;
+import org.springframework.web.multipart.MultipartFile;
+
+import java.io.InputStream;
+import java.net.URLEncoder;
+import java.nio.charset.StandardCharsets;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+
+@RestController
+@RequestMapping("/api/base/doc")
+@RequiredArgsConstructor
+public class DocController {
+
+    private final DocService docService;
+
+    /**
+     * 上传文档
+     */
+    @PostMapping("/upload")
+    public Map<String, Object> upload(
+            @RequestParam("file") MultipartFile file,
+            @RequestParam(value = "name", required = false) String name,
+            @RequestParam(value = "description", required = false) String description,
+            @RequestParam(value = "categoryId", required = false) Long categoryId,
+            @RequestParam(value = "tags", required = false) String tags,
+            @RequestParam(value = "accessLevel", required = false, defaultValue = "0") Integer accessLevel,
+            @RequestParam(value = "deptId", required = false) Long deptId,
+            @RequestParam(value = "uploaderId", required = false) Long uploaderId,
+            @RequestParam(value = "uploaderName", required = false) String uploaderName) throws Exception {
+
+        Doc doc = docService.upload(file, name, description, categoryId, tags, accessLevel, deptId, uploaderId, uploaderName);
+        Map<String, Object> result = new HashMap<>();
+        result.put("code", 200);
+        result.put("msg", "上传成功");
+        result.put("data", doc);
+        return result;
+    }
+
+    /**
+     * 上传新版本
+     */
+    @PostMapping("/{docId}/version")
+    public Map<String, Object> uploadVersion(
+            @PathVariable Long docId,
+            @RequestParam("file") MultipartFile file,
+            @RequestParam(value = "changeLog", required = false) String changeLog,
+            @RequestParam(value = "uploaderId", required = false) Long uploaderId,
+            @RequestParam(value = "uploaderName", required = false) String uploaderName) throws Exception {
+
+        DocVersion version = docService.uploadNewVersion(docId, file, changeLog, uploaderId, uploaderName);
+        Map<String, Object> result = new HashMap<>();
+        result.put("code", 200);
+        result.put("msg", "版本上传成功");
+        result.put("data", version);
+        return result;
+    }
+
+    /**
+     * 下载文档(当前版本)
+     */
+    @GetMapping("/{docId}/download")
+    public ResponseEntity<InputStreamResource> download(@PathVariable Long docId) throws Exception {
+        DocVO doc = docService.getDocDetail(docId);
+        if (doc == null) {
+            return ResponseEntity.notFound().build();
+        }
+        InputStream stream = docService.download(docId);
+        String filename = URLEncoder.encode(doc.getName(), StandardCharsets.UTF_8);
+        return ResponseEntity.ok()
+                .header(HttpHeaders.CONTENT_DISPOSITION, "attachment; filename*=UTF-8''" + filename)
+                .contentType(MediaType.APPLICATION_OCTET_STREAM)
+                .body(new InputStreamResource(stream));
+    }
+
+    /**
+     * 下载指定版本
+     */
+    @GetMapping("/{docId}/version/{version}/download")
+    public ResponseEntity<InputStreamResource> downloadVersion(
+            @PathVariable Long docId,
+            @PathVariable Integer version) throws Exception {
+        DocVO doc = docService.getDocDetail(docId);
+        if (doc == null) {
+            return ResponseEntity.notFound().build();
+        }
+        InputStream stream = docService.downloadVersion(docId, version);
+        String filename = URLEncoder.encode(doc.getName() + "_v" + version, StandardCharsets.UTF_8);
+        return ResponseEntity.ok()
+                .header(HttpHeaders.CONTENT_DISPOSITION, "attachment; filename*=UTF-8''" + filename)
+                .contentType(MediaType.APPLICATION_OCTET_STREAM)
+                .body(new InputStreamResource(stream));
+    }
+
+    /**
+     * 获取文档详情
+     */
+    @GetMapping("/{docId}")
+    public Map<String, Object> getDetail(@PathVariable Long docId) {
+        DocVO doc = docService.getDocDetail(docId);
+        Map<String, Object> result = new HashMap<>();
+        if (doc == null) {
+            result.put("code", 404);
+            result.put("msg", "文档不存在");
+        } else {
+            result.put("code", 200);
+            result.put("data", doc);
+        }
+        return result;
+    }
+
+    /**
+     * 获取版本列表
+     */
+    @GetMapping("/{docId}/versions")
+    public Map<String, Object> getVersions(@PathVariable Long docId) {
+        List<DocVersion> versions = docService.getVersionList(docId);
+        Map<String, Object> result = new HashMap<>();
+        result.put("code", 200);
+        result.put("data", versions);
+        return result;
+    }
+
+    /**
+     * 更新文档信息
+     */
+    @PutMapping("/{docId}")
+    public Map<String, Object> update(@PathVariable Long docId, @RequestBody Doc doc) {
+        doc.setId(docId);
+        docService.updateDoc(doc);
+        Map<String, Object> result = new HashMap<>();
+        result.put("code", 200);
+        result.put("msg", "更新成功");
+        return result;
+    }
+
+    /**
+     * 删除文档
+     */
+    @DeleteMapping("/{docId}")
+    public Map<String, Object> delete(@PathVariable Long docId) {
+        docService.deleteDoc(docId);
+        Map<String, Object> result = new HashMap<>();
+        result.put("code", 200);
+        result.put("msg", "删除成功");
+        return result;
+    }
+
+    /**
+     * 搜索文档(分页)
+     */
+    @GetMapping("/search")
+    public Map<String, Object> search(DocQueryRequest query) {
+        IPage<Doc> page = docService.search(query);
+        Map<String, Object> result = new HashMap<>();
+        result.put("code", 200);
+        result.put("data", page);
+        return result;
+    }
+
+    /**
+     * 获取分类列表
+     */
+    @GetMapping("/categories")
+    public Map<String, Object> getCategories() {
+        List<DocCategory> categories = docService.getCategoryTree();
+        Map<String, Object> result = new HashMap<>();
+        result.put("code", 200);
+        result.put("data", categories);
+        return result;
+    }
+
+    /**
+     * 创建分类
+     */
+    @PostMapping("/categories")
+    public Map<String, Object> createCategory(@RequestBody DocCategory category) {
+        DocCategory created = docService.createCategory(category);
+        Map<String, Object> result = new HashMap<>();
+        result.put("code", 200);
+        result.put("msg", "创建成功");
+        result.put("data", created);
+        return result;
+    }
+
+    /**
+     * 删除分类
+     */
+    @DeleteMapping("/categories/{categoryId}")
+    public Map<String, Object> deleteCategory(@PathVariable Long categoryId) {
+        docService.deleteCategory(categoryId);
+        Map<String, Object> result = new HashMap<>();
+        result.put("code", 200);
+        result.put("msg", "删除成功");
+        return result;
+    }
+}

wm-base/src/main/java/com/water/base/entity/Doc.java

@@ -0,0 +1,64 @@
+package com.water.base.entity;
+
+import com.baomidou.mybatisplus.annotation.*;
+import lombok.Data;
+import java.time.LocalDateTime;
+
+@Data
+@TableName("doc")
+public class Doc {
+    @TableId(type = IdType.AUTO)
+    private Long id;
+
+    /** 文档名称 */
+    private String name;
+
+    /** 文档描述 */
+    private String description;
+
+    /** 文件类型: pdf, docx, xlsx, jpg, png 等 */
+    private String fileType;
+
+    /** 文件大小(字节) */
+    private Long fileSize;
+
+    /** MinIO objectName */
+    private String storagePath;
+
+    /** 分类ID */
+    private Long categoryId;
+
+    /** 标签(逗号分隔) */
+    private String tags;
+
+    /** 当前版本号 */
+    private Integer currentVersion;
+
+    /** 上传人ID */
+    private Long uploaderId;
+
+    /** 上传人姓名 */
+    private String uploaderName;
+
+    /** 权限级别: 0-公开 1-部门可见 2-仅自己 */
+    private Integer accessLevel;
+
+    /** 所属部门ID */
+    private Long deptId;
+
+    /** 下载次数 */
+    private Integer downloadCount;
+
+    /** 全文检索文本 */
+    private String searchText;
+
+    /** 逻辑删除 */
+    @TableLogic
+    private Integer deleted;
+
+    @TableField(fill = FieldFill.INSERT)
+    private LocalDateTime createTime;
+
+    @TableField(fill = FieldFill.INSERT_UPDATE)
+    private LocalDateTime updateTime;
+}

wm-base/src/main/java/com/water/base/entity/DocCategory.java

@@ -0,0 +1,27 @@
+package com.water.base.entity;
+
+import com.baomidou.mybatisplus.annotation.*;
+import lombok.Data;
+import java.time.LocalDateTime;
+
+@Data
+@TableName("doc_category")
+public class DocCategory {
+    @TableId(type = IdType.AUTO)
+    private Long id;
+
+    /** 分类名称 */
+    private String name;
+
+    /** 父分类ID */
+    private Long parentId;
+
+    /** 排序 */
+    private Integer sort;
+
+    @TableLogic
+    private Integer deleted;
+
+    @TableField(fill = FieldFill.INSERT)
+    private LocalDateTime createTime;
+}

wm-base/src/main/java/com/water/base/entity/DocVersion.java

@@ -0,0 +1,36 @@
+package com.water.base.entity;
+
+import com.baomidou.mybatisplus.annotation.*;
+import lombok.Data;
+import java.time.LocalDateTime;
+
+@Data
+@TableName("doc_version")
+public class DocVersion {
+    @TableId(type = IdType.AUTO)
+    private Long id;
+
+    /** 文档ID */
+    private Long docId;
+
+    /** 版本号 */
+    private Integer version;
+
+    /** MinIO objectName */
+    private String storagePath;
+
+    /** 文件大小(字节) */
+    private Long fileSize;
+
+    /** 变更说明 */
+    private String changeLog;
+
+    /** 上传人ID */
+    private Long uploaderId;
+
+    /** 上传人姓名 */
+    private String uploaderName;
+
+    @TableField(fill = FieldFill.INSERT)
+    private LocalDateTime createTime;
+}

wm-base/src/main/java/com/water/base/entity/dto/DocQueryRequest.java

@@ -0,0 +1,30 @@
+package com.water.base.entity.dto;
+
+import lombok.Data;
+
+@Data
+public class DocQueryRequest {
+    /** 关键词(全文检索) */
+    private String keyword;
+
+    /** 分类ID */
+    private Long categoryId;
+
+    /** 标签 */
+    private String tag;
+
+    /** 文件类型 */
+    private String fileType;
+
+    /** 权限级别 */
+    private Integer accessLevel;
+
+    /** 上传人ID */
+    private Long uploaderId;
+
+    /** 页码 */
+    private Integer pageNum = 1;
+
+    /** 每页数量 */
+    private Integer pageSize = 20;
+}

wm-base/src/main/java/com/water/base/entity/dto/DocVO.java

@@ -0,0 +1,26 @@
+package com.water.base.entity.dto;
+
+import lombok.Data;
+import java.time.LocalDateTime;
+import java.util.List;
+
+@Data
+public class DocVO {
+    private Long id;
+    private String name;
+    private String description;
+    private String fileType;
+    private Long fileSize;
+    private Long categoryId;
+    private String categoryName;
+    private String tags;
+    private List<String> tagList;
+    private Integer currentVersion;
+    private Long uploaderId;
+    private String uploaderName;
+    private Integer accessLevel;
+    private Long deptId;
+    private Integer downloadCount;
+    private LocalDateTime createTime;
+    private LocalDateTime updateTime;
+}

wm-base/src/main/java/com/water/base/mapper/DocCategoryMapper.java

@@ -0,0 +1,9 @@
+package com.water.base.mapper;
+
+import com.baomidou.mybatisplus.core.mapper.BaseMapper;
+import com.water.base.entity.DocCategory;
+import org.apache.ibatis.annotations.Mapper;
+
+@Mapper
+public interface DocCategoryMapper extends BaseMapper<DocCategory> {
+}

wm-base/src/main/java/com/water/base/mapper/DocMapper.java

@@ -0,0 +1,17 @@
+package com.water.base.mapper;
+
+import com.baomidou.mybatisplus.core.mapper.BaseMapper;
+import com.baomidou.mybatisplus.core.metadata.IPage;
+import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
+import com.water.base.entity.Doc;
+import com.water.base.entity.dto.DocQueryRequest;
+import org.apache.ibatis.annotations.Mapper;
+import org.apache.ibatis.annotations.Param;
+
+@Mapper
+public interface DocMapper extends BaseMapper<Doc> {
+    /**
+     * 全文检索分页查询
+     */
+    IPage<Doc> searchPage(Page<Doc> page, @Param("q") DocQueryRequest query);
+}

wm-base/src/main/java/com/water/base/mapper/DocVersionMapper.java

@@ -0,0 +1,9 @@
+package com.water.base.mapper;
+
+import com.baomidou.mybatisplus.core.mapper.BaseMapper;
+import com.water.base.entity.DocVersion;
+import org.apache.ibatis.annotations.Mapper;
+
+@Mapper
+public interface DocVersionMapper extends BaseMapper<DocVersion> {
+}

wm-base/src/main/java/com/water/base/service/DocService.java

@@ -0,0 +1,301 @@
+package com.water.base.service;
+
+import com.baomidou.mybatisplus.core.metadata.IPage;
+import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
+import com.water.base.entity.Doc;
+import com.water.base.entity.DocCategory;
+import com.water.base.entity.DocVersion;
+import com.water.base.entity.dto.DocQueryRequest;
+import com.water.base.entity.dto.DocVO;
+import com.water.base.mapper.DocCategoryMapper;
+import com.water.base.mapper.DocMapper;
+import com.water.base.mapper.DocVersionMapper;
+import com.water.common.core.storage.MinioService;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+import org.springframework.web.multipart.MultipartFile;
+
+import java.io.InputStream;
+import java.time.LocalDateTime;
+import java.util.Arrays;
+import java.util.List;
+import java.util.stream.Collectors;
+
+@Slf4j
+@Service
+@RequiredArgsConstructor
+public class DocService {
+
+    private final DocMapper docMapper;
+    private final DocVersionMapper docVersionMapper;
+    private final DocCategoryMapper docCategoryMapper;
+    private final MinioService minioService;
+
+    /**
+     * 上传新文档
+     */
+    @Transactional
+    public Doc upload(MultipartFile file, String name, String description, Long categoryId,
+                      String tags, Integer accessLevel, Long deptId,
+                      Long uploaderId, String uploaderName) throws Exception {
+        // 上传文件到 MinIO
+        String storagePath = minioService.upload(file, "doc");
+
+        // 创建文档记录
+        Doc doc = new Doc();
+        doc.setName(name != null ? name : file.getOriginalFilename());
+        doc.setDescription(description);
+        doc.setFileType(getFileExtension(file.getOriginalFilename()));
+        doc.setFileSize(file.getSize());
+        doc.setStoragePath(storagePath);
+        doc.setCategoryId(categoryId);
+        doc.setTags(tags);
+        doc.setCurrentVersion(1);
+        doc.setUploaderId(uploaderId);
+        doc.setUploaderName(uploaderName);
+        doc.setAccessLevel(accessLevel != null ? accessLevel : 0);
+        doc.setDeptId(deptId);
+        doc.setDownloadCount(0);
+        doc.setSearchText(buildSearchText(name, description, tags));
+        doc.setDeleted(0);
+        doc.setCreateTime(LocalDateTime.now());
+        doc.setUpdateTime(LocalDateTime.now());
+        docMapper.insert(doc);
+
+        // 创建初始版本记录
+        DocVersion version = new DocVersion();
+        version.setDocId(doc.getId());
+        version.setVersion(1);
+        version.setStoragePath(storagePath);
+        version.setFileSize(file.getSize());
+        version.setChangeLog("初始上传");
+        version.setUploaderId(uploaderId);
+        version.setUploaderName(uploaderName);
+        version.setCreateTime(LocalDateTime.now());
+        docVersionMapper.insert(version);
+
+        log.info("文档上传成功: id={}, name={}", doc.getId(), doc.getName());
+        return doc;
+    }
+
+    /**
+     * 上传新版本
+     */
+    @Transactional
+    public DocVersion uploadNewVersion(Long docId, MultipartFile file, String changeLog,
+                                        Long uploaderId, String uploaderName) throws Exception {
+        Doc doc = docMapper.selectById(docId);
+        if (doc == null) {
+            throw new RuntimeException("文档不存在: " + docId);
+        }
+
+        // 上传新版本文件
+        String storagePath = minioService.upload(file, "doc/version");
+        int newVersion = doc.getCurrentVersion() + 1;
+
+        // 更新文档主记录
+        doc.setCurrentVersion(newVersion);
+        doc.setFileSize(file.getSize());
+        doc.setStoragePath(storagePath);
+        doc.setFileType(getFileExtension(file.getOriginalFilename()));
+        doc.setUpdateTime(LocalDateTime.now());
+        docMapper.updateById(doc);
+
+        // 创建版本记录
+        DocVersion version = new DocVersion();
+        version.setDocId(docId);
+        version.setVersion(newVersion);
+        version.setStoragePath(storagePath);
+        version.setFileSize(file.getSize());
+        version.setChangeLog(changeLog);
+        version.setUploaderId(uploaderId);
+        version.setUploaderName(uploaderName);
+        version.setCreateTime(LocalDateTime.now());
+        docVersionMapper.insert(version);
+
+        log.info("文档新版本上传成功: docId={}, version={}", docId, newVersion);
+        return version;
+    }
+
+    /**
+     * 下载文档
+     */
+    @Transactional
+    public InputStream download(Long docId) throws Exception {
+        Doc doc = docMapper.selectById(docId);
+        if (doc == null) {
+            throw new RuntimeException("文档不存在: " + docId);
+        }
+
+        // 增加下载计数
+        doc.setDownloadCount(doc.getDownloadCount() + 1);
+        docMapper.updateById(doc);
+
+        return minioService.download(doc.getStoragePath());
+    }
+
+    /**
+     * 下载指定版本
+     */
+    public InputStream downloadVersion(Long docId, Integer version) throws Exception {
+        DocVersion docVersion = docVersionMapper.selectOne(
+            new com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper<DocVersion>()
+                .eq(DocVersion::getDocId, docId)
+                .eq(DocVersion::getVersion, version)
+        );
+        if (docVersion == null) {
+            throw new RuntimeException("版本不存在: docId=" + docId + ", version=" + version);
+        }
+        return minioService.download(docVersion.getStoragePath());
+    }
+
+    /**
+     * 更新文档元信息
+     */
+    @Transactional
+    public void updateDoc(Doc doc) {
+        Doc existing = docMapper.selectById(doc.getId());
+        if (existing == null) {
+            throw new RuntimeException("文档不存在");
+        }
+        doc.setSearchText(buildSearchText(
+            doc.getName() != null ? doc.getName() : existing.getName(),
+            doc.getDescription() != null ? doc.getDescription() : existing.getDescription(),
+            doc.getTags() != null ? doc.getTags() : existing.getTags()
+        ));
+        doc.setUpdateTime(LocalDateTime.now());
+        docMapper.updateById(doc);
+    }
+
+    /**
+     * 删除文档(逻辑删除)
+     */
+    @Transactional
+    public void deleteDoc(Long docId) {
+        Doc doc = docMapper.selectById(docId);
+        if (doc == null) {
+            throw new RuntimeException("文档不存在");
+        }
+        docMapper.deleteById(docId);
+        log.info("文档已删除: id={}", docId);
+    }
+
+    /**
+     * 获取文档详情
+     */
+    public DocVO getDocDetail(Long docId) {
+        Doc doc = docMapper.selectById(docId);
+        if (doc == null) {
+            return null;
+        }
+        return convertToVO(doc);
+    }
+
+    /**
+     * 获取文档版本列表
+     */
+    public List<DocVersion> getVersionList(Long docId) {
+        return docVersionMapper.selectList(
+            new com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper<DocVersion>()
+                .eq(DocVersion::getDocId, docId)
+                .orderByDesc(DocVersion::getVersion)
+        );
+    }
+
+    /**
+     * 分页搜索文档
+     */
+    public IPage<Doc> search(DocQueryRequest query) {
+        Page<Doc> page = new Page<>(query.getPageNum(), query.getPageSize());
+        return docMapper.searchPage(page, query);
+    }
+
+    /**
+     * 获取分类树
+     */
+    public List<DocCategory> getCategoryTree() {
+        return docCategoryMapper.selectList(
+            new com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper<DocCategory>()
+                .eq(DocCategory::getDeleted, 0)
+                .orderByAsc(DocCategory::getSort)
+        );
+    }
+
+    /**
+     * 创建分类
+     */
+    public DocCategory createCategory(DocCategory category) {
+        category.setDeleted(0);
+        category.setCreateTime(LocalDateTime.now());
+        docCategoryMapper.insert(category);
+        return category;
+    }
+
+    /**
+     * 删除分类
+     */
+    @Transactional
+    public void deleteCategory(Long categoryId) {
+        // 检查是否有文档使用该分类
+        long count = docMapper.selectCount(
+            new com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper<Doc>()
+                .eq(Doc::getCategoryId, categoryId)
+                .eq(Doc::getDeleted, 0)
+        );
+        if (count > 0) {
+            throw new RuntimeException("该分类下有 " + count + " 个文档，无法删除");
+        }
+        docCategoryMapper.deleteById(categoryId);
+    }
+
+    private DocVO convertToVO(Doc doc) {
+        DocVO vo = new DocVO();
+        vo.setId(doc.getId());
+        vo.setName(doc.getName());
+        vo.setDescription(doc.getDescription());
+        vo.setFileType(doc.getFileType());
+        vo.setFileSize(doc.getFileSize());
+        vo.setCategoryId(doc.getCategoryId());
+        vo.setTags(doc.getTags());
+        vo.setCurrentVersion(doc.getCurrentVersion());
+        vo.setUploaderId(doc.getUploaderId());
+        vo.setUploaderName(doc.getUploaderName());
+        vo.setAccessLevel(doc.getAccessLevel());
+        vo.setDeptId(doc.getDeptId());
+        vo.setDownloadCount(doc.getDownloadCount());
+        vo.setCreateTime(doc.getCreateTime());
+        vo.setUpdateTime(doc.getUpdateTime());
+
+        // 设置分类名称
+        if (doc.getCategoryId() != null) {
+            DocCategory category = docCategoryMapper.selectById(doc.getCategoryId());
+            if (category != null) {
+                vo.setCategoryName(category.getName());
+            }
+        }
+
+        // 设置标签列表
+        if (doc.getTags() != null && !doc.getTags().isEmpty()) {
+            vo.setTagList(Arrays.asList(doc.getTags().split(",")));
+        }
+
+        return vo;
+    }
+
+    private String buildSearchText(String name, String description, String tags) {
+        StringBuilder sb = new StringBuilder();
+        if (name != null) sb.append(name).append(" ");
+        if (description != null) sb.append(description).append(" ");
+        if (tags != null) sb.append(tags);
+        return sb.toString().trim();
+    }
+
+    private String getFileExtension(String filename) {
+        if (filename == null || !filename.contains(".")) {
+            return "unknown";
+        }
+        return filename.substring(filename.lastIndexOf(".") + 1).toLowerCase();
+    }
+}

wm-base/src/main/resources/application.yml

@@ -4,6 +4,10 @@ server:
 spring:
   application:
     name: wm-base
+  servlet:
+    multipart:
+      max-file-size: 100MB
+      max-request-size: 100MB
   datasource:
     url: jdbc:postgresql://${PG_HOST:127.0.0.1}:5432/water_management
     username: ${PG_USER:water}
@@ -29,3 +33,9 @@ mybatis-plus:
       logic-delete-field: deleted
       logic-delete-value: 1
       logic-not-delete-value: 0
+
+minio:
+  endpoint: ${MINIO_ENDPOINT:http://127.0.0.1:9000}
+  access-key: ${MINIO_ACCESS_KEY:minioadmin}
+  secret-key: ${MINIO_SECRET_KEY:minioadmin}
+  bucket: ${MINIO_BUCKET:water-management}

wm-base/src/main/resources/mapper/DocMapper.xml

@@ -0,0 +1,34 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
+<mapper namespace="com.water.base.mapper.DocMapper">
+
+    <select id="searchPage" resultType="com.water.base.entity.Doc">
+        SELECT * FROM doc
+        WHERE deleted = 0
+        <if test="q.keyword != null and q.keyword != ''">
+            AND (
+                name ILIKE CONCAT('%', #{q.keyword}, '%')
+                OR description ILIKE CONCAT('%', #{q.keyword}, '%')
+                OR search_text ILIKE CONCAT('%', #{q.keyword}, '%')
+                OR tags ILIKE CONCAT('%', #{q.keyword}, '%')
+            )
+        </if>
+        <if test="q.categoryId != null">
+            AND category_id = #{q.categoryId}
+        </if>
+        <if test="q.tag != null and q.tag != ''">
+            AND tags LIKE CONCAT('%', #{q.tag}, '%')
+        </if>
+        <if test="q.fileType != null and q.fileType != ''">
+            AND file_type = #{q.fileType}
+        </if>
+        <if test="q.accessLevel != null">
+            AND access_level = #{q.accessLevel}
+        </if>
+        <if test="q.uploaderId != null">
+            AND uploader_id = #{q.uploaderId}
+        </if>
+        ORDER BY update_time DESC
+    </select>
+
+</mapper>

wm-base/src/test/java/com/water/base/service/DocServiceTest.java

@@ -0,0 +1,263 @@
+package com.water.base.service;
+
+import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
+import com.baomidou.mybatisplus.core.metadata.IPage;
+import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
+import com.water.base.entity.Doc;
+import com.water.base.entity.DocCategory;
+import com.water.base.entity.DocVersion;
+import com.water.base.entity.dto.DocQueryRequest;
+import com.water.base.entity.dto.DocVO;
+import com.water.base.mapper.DocCategoryMapper;
+import com.water.base.mapper.DocMapper;
+import com.water.base.mapper.DocVersionMapper;
+import com.water.common.core.storage.MinioService;
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
+import org.junit.jupiter.api.extension.ExtendWith;
+import org.mockito.InjectMocks;
+import org.mockito.Mock;
+import org.mockito.junit.jupiter.MockitoExtension;
+import org.springframework.mock.web.MockMultipartFile;
+
+import java.io.ByteArrayInputStream;
+import java.io.InputStream;
+import java.util.Arrays;
+import java.util.List;
+
+import static org.junit.jupiter.api.Assertions.*;
+import static org.mockito.ArgumentMatchers.*;
+import static org.mockito.Mockito.*;
+
+@ExtendWith(MockitoExtension.class)
+class DocServiceTest {
+
+    @Mock
+    private DocMapper docMapper;
+    @Mock
+    private DocVersionMapper docVersionMapper;
+    @Mock
+    private DocCategoryMapper docCategoryMapper;
+    @Mock
+    private MinioService minioService;
+
+    @InjectMocks
+    private DocService docService;
+
+    private MockMultipartFile testFile;
+
+    @BeforeEach
+    void setUp() {
+        testFile = new MockMultipartFile("file", "test.pdf", "application/pdf", "test content".getBytes());
+    }
+
+    @Test
+    void testUpload() throws Exception {
+        when(minioService.upload(any(), eq("doc"))).thenReturn("doc/uuid_test.pdf");
+        when(docMapper.insert(any(Doc.class))).thenAnswer(invocation -> {
+            Doc doc = invocation.getArgument(0);
+            doc.setId(1L);
+            return 1;
+        });
+        when(docVersionMapper.insert(any(DocVersion.class))).thenReturn(1);
+
+        Doc result = docService.upload(testFile, "测试文档", "描述", 1L, "标签1,标签2", 0, 1L, 1L, "张三");
+
+        assertNotNull(result);
+        assertEquals("测试文档", result.getName());
+        assertEquals("pdf", result.getFileType());
+        assertEquals(1, result.getCurrentVersion());
+        assertEquals(0, result.getDownloadCount());
+        verify(minioService).upload(any(), eq("doc"));
+        verify(docMapper).insert(any(Doc.class));
+        verify(docVersionMapper).insert(any(DocVersion.class));
+    }
+
+    @Test
+    void testUploadNewVersion() throws Exception {
+        Doc existingDoc = new Doc();
+        existingDoc.setId(1L);
+        existingDoc.setCurrentVersion(1);
+        existingDoc.setStoragePath("doc/old.pdf");
+
+        when(docMapper.selectById(1L)).thenReturn(existingDoc);
+        when(minioService.upload(any(), eq("doc/version"))).thenReturn("doc/version/uuid_new.pdf");
+        when(docMapper.updateById(any(Doc.class))).thenReturn(1);
+        when(docVersionMapper.insert(any(DocVersion.class))).thenReturn(1);
+
+        DocVersion result = docService.uploadNewVersion(1L, testFile, "修复错误", 1L, "张三");
+
+        assertNotNull(result);
+        assertEquals(2, result.getVersion());
+        assertEquals("修复错误", result.getChangeLog());
+        assertEquals(2, existingDoc.getCurrentVersion());
+    }
+
+    @Test
+    void testUploadNewVersionDocNotFound() {
+        when(docMapper.selectById(999L)).thenReturn(null);
+
+        assertThrows(RuntimeException.class, () ->
+            docService.uploadNewVersion(999L, testFile, "test", 1L, "张三")
+        );
+    }
+
+    @Test
+    void testDownload() throws Exception {
+        Doc doc = new Doc();
+        doc.setId(1L);
+        doc.setStoragePath("doc/test.pdf");
+        doc.setDownloadCount(5);
+
+        when(docMapper.selectById(1L)).thenReturn(doc);
+        when(docMapper.updateById(any(Doc.class))).thenReturn(1);
+        when(minioService.download("doc/test.pdf")).thenReturn(new ByteArrayInputStream("data".getBytes()));
+
+        InputStream result = docService.download(1L);
+
+        assertNotNull(result);
+        assertEquals(6, doc.getDownloadCount());
+    }
+
+    @Test
+    void testDownloadDocNotFound() {
+        when(docMapper.selectById(999L)).thenReturn(null);
+
+        assertThrows(RuntimeException.class, () -> docService.download(999L));
+    }
+
+    @Test
+    void testGetDocDetail() {
+        Doc doc = new Doc();
+        doc.setId(1L);
+        doc.setName("测试文档");
+        doc.setFileType("pdf");
+        doc.setTags("标签1,标签2");
+        doc.setCategoryId(1L);
+
+        DocCategory cat = new DocCategory();
+        cat.setId(1L);
+        cat.setName("技术规范");
+
+        when(docMapper.selectById(1L)).thenReturn(doc);
+        when(docCategoryMapper.selectById(1L)).thenReturn(cat);
+
+        DocVO result = docService.getDocDetail(1L);
+
+        assertNotNull(result);
+        assertEquals("测试文档", result.getName());
+        assertEquals("技术规范", result.getCategoryName());
+        assertEquals(2, result.getTagList().size());
+    }
+
+    @Test
+    void testGetDocDetailNotFound() {
+        when(docMapper.selectById(999L)).thenReturn(null);
+
+        DocVO result = docService.getDocDetail(999L);
+        assertNull(result);
+    }
+
+    @Test
+    void testGetVersionList() {
+        DocVersion v1 = new DocVersion();
+        v1.setVersion(1);
+        DocVersion v2 = new DocVersion();
+        v2.setVersion(2);
+
+        when(docVersionMapper.selectList(any(LambdaQueryWrapper.class))).thenReturn(Arrays.asList(v2, v1));
+
+        List<DocVersion> result = docService.getVersionList(1L);
+
+        assertEquals(2, result.size());
+        assertEquals(2, result.get(0).getVersion());
+    }
+
+    @Test
+    void testSearch() {
+        DocQueryRequest query = new DocQueryRequest();
+        query.setKeyword("测试");
+        query.setPageNum(1);
+        query.setPageSize(10);
+
+        Page<Doc> page = new Page<>(1, 10);
+        page.setTotal(1);
+        page.setRecords(List.of(new Doc()));
+
+        when(docMapper.searchPage(any(Page.class), any(DocQueryRequest.class))).thenReturn(page);
+
+        IPage<Doc> result = docService.search(query);
+
+        assertNotNull(result);
+        assertEquals(1, result.getTotal());
+    }
+
+    @Test
+    void testCreateCategory() {
+        DocCategory category = new DocCategory();
+        category.setName("新分类");
+        category.setParentId(0L);
+
+        when(docCategoryMapper.insert(any(DocCategory.class))).thenAnswer(invocation -> {
+            DocCategory c = invocation.getArgument(0);
+            c.setId(1L);
+            return 1;
+        });
+
+        DocCategory result = docService.createCategory(category);
+
+        assertNotNull(result);
+        assertEquals("新分类", result.getName());
+        assertEquals(0, result.getDeleted());
+    }
+
+    @Test
+    void testDeleteCategory() {
+        when(docMapper.selectCount(any(LambdaQueryWrapper.class))).thenReturn(0L);
+        when(docCategoryMapper.deleteById(1L)).thenReturn(1);
+
+        assertDoesNotThrow(() -> docService.deleteCategory(1L));
+    }
+
+    @Test
+    void testDeleteCategoryWithDocs() {
+        when(docMapper.selectCount(any(LambdaQueryWrapper.class))).thenReturn(5L);
+
+        RuntimeException ex = assertThrows(RuntimeException.class, () -> docService.deleteCategory(1L));
+        assertTrue(ex.getMessage().contains("无法删除"));
+    }
+
+    @Test
+    void testDeleteDoc() {
+        Doc doc = new Doc();
+        doc.setId(1L);
+        when(docMapper.selectById(1L)).thenReturn(doc);
+        when(docMapper.deleteById(1L)).thenReturn(1);
+
+        assertDoesNotThrow(() -> docService.deleteDoc(1L));
+    }
+
+    @Test
+    void testDeleteDocNotFound() {
+        when(docMapper.selectById(999L)).thenReturn(null);
+
+        assertThrows(RuntimeException.class, () -> docService.deleteDoc(999L));
+    }
+
+    @Test
+    void testUpdateDoc() {
+        Doc existing = new Doc();
+        existing.setId(1L);
+        existing.setName("旧名称");
+
+        Doc update = new Doc();
+        update.setId(1L);
+        update.setName("新名称");
+
+        when(docMapper.selectById(1L)).thenReturn(existing);
+        when(docMapper.updateById(any(Doc.class))).thenReturn(1);
+
+        assertDoesNotThrow(() -> docService.updateDoc(update));
+        verify(docMapper).updateById(any(Doc.class));
+    }
+}