企业官网建设流程全解析

本周属于高密度、系统性迭代。从业务功能开发、接口重构，到代码规范、配置统一，一次性完成多模块落地。

没有零散问题堆砌，全部为实打实的业务落地与工程化优化。本篇统一复盘本周完整开发内容。

一、成果资产详情模块｜数据重构与VO精简

对成果资产详情模块完成全量数据封装与接口能力升级，解决原有字段冗余、返回杂乱、信息展示不全等问题。

核心内容

• 为4张核心实体PO补充Swagger接口注释，优化接口文档可读性；

• 新建4个精简业务VO，仅保留前端展示所需字段，过滤内部冗余数据；

• 扩展成果详情VO，补充公式、表格、文档列表相关字段；

• 改造详情查询接口，统一封装成果主体、项目信息、附件、公式、表格等全量数据；

• 在Service层增加空集合、空对象判断，有效规避空指针异常。

设计思路：附属子表数据直接通过Mapper按需查询，不额外新建Service层，采用轻量化设计，符合项目开发规范。

二、入库流水线｜新增「重新解构」独立接口

围绕AI解析流水线进行迭代，单独抽离重启解构能力，实现业务逻辑解耦隔离。

核心内容

• 新增接口/pipeline/restart-analysis，专门对接前端「重新解构」操作按钮；

• Service层新增restartAiAnalysis方法，完成任务状态重置、重启AI解构全流程；

• 将首次解析、重新解析两套逻辑完全拆分，避免代码耦合与逻辑污染。

优势：接口仅传递taskId，入参简洁，职责单一，便于后续功能扩展。

三、离线批量导入｜多文件批量入库

补齐平台能力短板，实现企业知识库离线文件批量入库核心功能。

核心内容

• 开发多文件批量上传接口，支持多文件同时并发上传；

• 增加文件校验逻辑，实现同名文件处理、重复文件拦截；

• 完成文件持久化、业务数据关联，并自动创建离线解析任务；

• 支持批量触发AI解析，兼容部分成功、全部失败、运行异常等各类场景提示。

业务价值：满足企业大批量离线文件快速入库、统一结构化解析的业务需求。

四、公共数据源接入｜双数据源兼容

搭建企业私有库 + 公共行业库双数据源架构，完成数据隔离与权限管控。

核心内容

• 完成公共数据源、公共基础库底层接入逻辑开发；

• 实现公共成果数据拉取，严格区分私有数据与公共数据权限；

• 适配原有列表、数据统计、3D图表等模块，双数据源均可正常展示；

• 对公共数据源设置只读权限，防止越权编辑、删除操作。

架构升级：平台由单一企业库，升级为私有库与公共库并存的双数据源架构。

五、系统配置模块｜全局规范统一与缓存优化

针对配置格式混乱、缓存策略不清晰等问题，进行整体性优化整改。

核心内容

• 梳理所有配置相关接口，划分为后台管理、业务调用两大使用场景；

• 规范化缓存策略，仅缓存配置字符串，保证缓存轻量化，预留后台维护页面扩展空间；

• 全量统一JSON字段为驼峰命名，彻底解决下划线与驼峰混用引发的字段映射异常；

• 拆分缓存查询、原生数据库查询接口，做到职责分离，避免缓存数据错乱。

六、全局代码规范与健壮性优化

所有新增代码严格遵循项目工程化标准，从源头规避技术负债。

• 全量补充Swagger注释，完善接口与字段说明；

• 所有接口统一增加异常捕获、空值及空集合校验，提升接口健壮性；

• 恪守项目分层架构，采用低侵入方式开发，不改动原有代码结构；

• 统一类、方法、变量的命名规则，保持项目代码风格一致。

写在最后

本周没有复杂疑难问题，重点是全面落地功能、统一技术规范。

后端开发不只是单纯实现业务功能，更要兼顾代码解耦、分层设计、兼容性与可扩展性。本次迭代从业务开发、架构优化，再到数据规范、代码整洁度全面升级，每一处调整都在为项目长期稳定运行筑牢基础。

稳扎稳打，持续沉淀。

本文是《技术底稿》系列第44篇，记录本周全模块迭代开发与全局优化全过程。