毕业设计实战：基于Spring Boot的文档管理系统全栈开发 [特殊字符]一、项目缘起：从纸质到数字的蜕变之旅记得大

一、项目缘起：从纸质到数字的蜕变之旅

记得大二那年，我在学校图书馆做志愿者，看着老师们还在用Excel表格管理各种文档资料，找一份文件要翻半天，有时候还会出现版本混乱的情况。😅 那时候我就在想，要是能开发一个文档管理系统该多好啊！现在终于有机会把这个想法变成现实了！

随着国内市场经济这几十年来的蓬勃发展，互联网技术已经深入到我们生活的方方面面。想想看，从最初大家对网购的怀疑，到现在离不开外卖、网约车，这个转变真是太大了！🌟 文档管理也是一样，传统的文件柜管理方式已经远远跟不上时代的步伐了。

二、技术选型：为什么选择这些技术？

2.1 Spring Boot - 开发效率的保障

选择Spring Boot真的是太明智了！它就像个贴心的助手，帮我们处理了各种繁琐的配置。记得第一次用Spring MVC的时候，光配置文件就写了一堆，现在用Spring Boot，几行代码就能跑起来一个Web服务，这种感觉不要太爽！💪

@SpringBootApplication
public class DocumentApplication {
    public static void main(String[] args) {
        SpringApplication.run(DocumentApplication.class, args);
        System.out.println("文档管理系统启动成功！🎉");
    }
}

2.2 Vue + Layui - 前端的完美组合

前端技术选型时我纠结了好久，最终选择了Vue + Layui的组合。Vue负责数据驱动，Layui提供美观的UI组件，这个组合简直绝配！特别是Layui的表格和表单组件，用起来特别顺手。

2.3 MySQL - 可靠的数据管家

数据库选MySQL真的是毋庸置疑的选择！开源、免费、性能稳定，对于学生项目来说再合适不过了。而且社区活跃，遇到问题随时都能找到解决方案。

三、系统设计：我是这样思考的

3.1 功能模块设计

在设计系统功能时，我站在用户的角度思考了很多实际使用场景：

管理员功能：

🎯 用户管理：管理注册用户，设置权限
📝 资料审核：审核用户上传的文档
📢 公告发布：发布系统通知
💬 论坛管理：维护交流环境

用户功能：

📤 文档上传：上传各种格式的文档
🔍 文档下载：下载审核通过的文档
💭 论坛交流：与其他用户交流心得
📋 公告查看：查看最新通知

3.2 数据库设计心得

数据库设计真的是个技术活！我前前后后改了不下十遍。特别是用户权限这块，要考虑各种边界情况。最终的设计既保证了数据完整性，又考虑了查询效率。

-- 资料信息表的设计
CREATE TABLE document_info (
    id BIGINT PRIMARY KEY AUTO_INCREMENT,
    title VARCHAR(200) NOT NULL,          -- 文档标题
    file_path VARCHAR(500),               -- 文件存储路径
    upload_user_id BIGINT,                -- 上传用户
    status TINYINT DEFAULT 0,             -- 审核状态
    create_time DATETIME,                 -- 上传时间
    download_count INT DEFAULT 0          -- 下载次数
);

四、核心功能实现：代码的奇妙冒险

4.1 文档上传功能

实现文档上传功能时遇到了不少坑，特别是大文件上传和格式校验这块。经过多次调试，终于找到了比较完美的解决方案：

@RestController
@RequestMapping("/api/document")
public class DocumentController {
    
    @Autowired
    private DocumentService documentService;
    
    /**
     * 文档上传
     * 这个功能可是系统的核心，要考虑的事情真不少！
     */
    @PostMapping("/upload")
    public ResponseEntity<?> uploadDocument(
            @RequestParam("file") MultipartFile file,
            @RequestParam String title,
            @RequestParam String description,
            @RequestHeader("userId") Long userId) {
        
        try {
            // 文件大小校验（不能超过50MB）
            if (file.getSize() > 50 * 1024 * 1024) {
                return ResponseEntity.badRequest().body("文件大小不能超过50MB哦！😅");
            }
            
            // 文件类型校验
            String fileType = getFileType(file.getOriginalFilename());
            if (!isAllowedFileType(fileType)) {
                return ResponseEntity.badRequest().body("不支持的文件类型！目前支持：PDF、Word、Excel、PPT");
            }
            
            // 保存文档
            Document document = documentService.saveDocument(file, title, description, userId);
            return ResponseEntity.ok("文档上传成功！等待管理员审核~ 📤");
            
        } catch (Exception e) {
            return ResponseEntity.internalServerError()
                .body("上传失败：" + e.getMessage());
        }
    }
    
    /**
     * 获取允许的文件类型
     * 这里我可是仔细研究了各种文档格式呢！
     */
    private boolean isAllowedFileType(String fileType) {
        String[] allowedTypes = {"pdf", "doc", "docx", "xls", "xlsx", "ppt", "pptx"};
        return Arrays.asList(allowedTypes).contains(fileType.toLowerCase());
    }
}

4.2 文档审核功能

审核功能是管理员的核心工作，我设计了一个直观的审核界面，让管理员能够快速处理待审核文档：

@Service
@Transactional
public class DocumentServiceImpl implements DocumentService {
    
    @Autowired
    private DocumentMapper documentMapper;
    
    @Override
    public void auditDocument(Long documentId, Integer status, String auditRemark) {
        Document document = documentMapper.selectById(documentId);
        if (document == null) {
            throw new RuntimeException("文档不存在！");
        }
        
        // 更新审核状态
        document.setStatus(status);
        document.setAuditRemark(auditRemark);
        document.setAuditTime(new Date());
        
        documentMapper.updateById(document);
        
        // 记录审核日志
        saveAuditLog(documentId, status, auditRemark);
    }
    
    /**
     * 获取待审核文档列表
     * 用了分页查询，性能杠杠的！
     */
    @Override
    public PageResult<DocumentVO> getPendingDocuments(int page, int size) {
        PageHelper.startPage(page, size);
        
        List<Document> documents = documentMapper.selectPendingDocuments();
        List<DocumentVO> voList = convertToVOList(documents);
        
        PageInfo<Document> pageInfo = new PageInfo<>(documents);
        return new PageResult<>(voList, pageInfo.getTotal());
    }
}