企业官网建设流程全解析

简介：本资源是一份面向软件工程专业学生与初级开发者的《社团宣传管理平台项目概要设计说明书》，聚焦Web系统架构设计与数据结构实践，适用于课程设计、毕业设计或小型社团管理系统开发参考。文档完整覆盖编写目的、项目背景、四大核心处理流程（登录操作、增删改数据）、总体前后端结构及数据库表设计要点，并明确列出Django/React、MySQL、JWT等技术选型依据，具备清晰的工程落地指导性。压缩包为单个511KB的docx文件，内容结构规范，含引言、任务概述、总体设计、接口设计等标准章节，目录层级完整，便于快速定位模块设计逻辑。目前已有80人学习下载，读者可直接获取成熟项目的概要设计范式、权限角色划分（管理员/社长/社员）、数据流图雏形及可复用的数据库字段设计思路，对理解信息系统从需求到架构转化具有较强实操参考价值。

1. 这不是模板套话：一份能直接拆解进 Spring Boot 项目的概要设计说明书

你有没有遇到过这种场景：接到一个高校社团管理类需求，前端要展示活动日程、相册、新闻，后端要支持三类角色（管理员/社长/社员）的差异化权限，数据库得存申请记录、活动详情、留言反馈——但手头只有一份 Word 格式的《概要设计说明书》，没有源码、没有接口文档、没有 ER 图，连字段类型都靠猜？别急，这份 2020 年完成的「社团宣传管理平台概要设计说明书」，恰恰是少有的、把软件工程规范和真实开发约束拧在一起写透的实战型文档。它不讲空泛架构，而是用 5 大章节明确划出模块边界、定义 7 类核心数据表结构、给出 DAO 层与 SQL Server 2008 的 JDBC 对接方式、甚至标注了 JSP 页面跳转路径和表单校验逻辑。这不是教学范本，是某高校实验室在资源受限（仅 Tomcat + Windows 环境）、时间紧迫（8 周交付）条件下落地的真实快照。如果你正要复刻类似系统——比如给学生组织做轻量级活动协同平台、为校内兴趣小组搭信息中台、或需要快速验证 RBAC 权限模型在多角色场景下的分层设计——这份文档就是你能直接抄作业的“骨架图纸”。它解决的不是“要不要做”，而是“模块怎么切、接口怎么对、数据怎么落盘”这三个卡脖子问题。

2. 从 Word 文档到可运行模块：把概要设计说明书翻译成 Spring Boot 工程结构

这份说明书的价值，不在它写了什么，而在它没写却暗示了什么。比如它反复强调“DAO 层与数据库中信息对比”，却没贴 DAO 接口代码；提到“JSP 界面跳转”，但没给 Controller 映射路径；列出applysid、articleid等表名，却没说明主键策略。这些“留白”，正是我们动手拆解的起点。下面我带你把这份文档真正“编译”进现代 Java 工程——不是照搬旧技术栈，而是用 Spring Boot 3.x + MyBatis-Plus 重实现其设计意图，同时保留所有原始约束（如三角色权限粒度、SQL Server 兼容性、无状态会话管理）。

2.1 模块划分：按说明书第 3.2 节“总体结构”反向生成 Maven 子模块

说明书图 3-7 明确将系统划分为「管理员模块」「社长模块」「社员模块」，并列出各自子功能（如社长有“社团聚餐管理”，社员有“我的社团查询”）。这不是功能罗列，而是模块解耦的强制信号。我们不搞单体大包，而是按职责边界切出 4 个 Maven 模块：

注意：说明书第 2.2 节要求“不绑定其他软件”，意味着不能引入 Spring Security OAuth2 等重型认证组件。我们改用JwtAuthenticationFilter+ 自定义RoleBasedAccessDecisionManager，完全控制鉴权逻辑，避免黑匣子。

2.2 数据结构映射：把说明书第 5.2 节的物理表名转成 MyBatis-Plus 实体类

说明书第 5.2 节用纯文字列出 5 张核心表：社团申请信息（applysid）、网站新闻（articleid）、留言信息（bbsid）、社团信息（cinfoid）、活动信息（activityid）。关键点在于——它没写字段，但第 3.1.2 节“数据增加流程简介”透露了线索：“编号字段不可人为编写，系统自动给出”。这直接锁定主键策略为自增 ID，而非 UUID 或雪花算法。

以下是ApplyEntity的完整实现（其余实体同理推导）：

// core-domain/src/main/java/com/example/domain/entity/ApplyEntity.java import com.baomidou.mybatisplus.annotation.*; @TableName("applysid") // 严格对应说明书表名 @Data public class ApplyEntity { @TableId(type = IdType.AUTO) // 响应“编号字段不可人为编写” private Long id; @TableField("student_id") private String studentId; // 说明书未提，但“学生管理员登录账号”暗示需关联学生ID @TableField("club_name") private String clubName; // “社团类型”“社长”等字段在3.3.1中多次出现 @TableField("apply_time") private LocalDateTime applyTime; // “建立时间”在3.3.1中明确要求 @TableField("status") private Integer status; // 0-待审核, 1-通过, 2-拒绝；说明书3.1.3提到“活动审核”，此字段必存 @TableField(fill = FieldFill.INSERT) private LocalDateTime createTime; @TableField(fill = FieldFill.INSERT_UPDATE) private LocalDateTime updateTime; }

参数说明：

• @TableName("applysid")：强制使用说明书原始表名，避免因命名习惯差异导致 SQL Server 查询失败；
• @TableId(type = IdType.AUTO)：SQL Server 2008 的IDENTITY(1,1)主键必须匹配此策略，若用ASSIGN_ID会导致插入报错；
• @TableField("student_id")：说明书虽未列字段，但第 3.3.1 节“管理员功能”含“注册会员管理”，且引言 1.2 提到“高校学生信息”，故需此外键；
• status字段：说明书 3.1.3 明确“社团活动审核”，这是 RBAC 中最易被忽略的业务状态位，漏掉会导致审核流断裂。

2.3 接口设计落地：按说明书第 4.2 节“内部接口”实现 JDBC 连接池

说明书第 4.2 节只有一句话：“与 sql-server 数据库通过 jdbc 接口进行连接”。看似简单，实则暗藏坑点：SQL Server 2008 的 JDBC 驱动已停止维护，新版mssql-jdbc12.x 默认不兼容。我们必须降级到mssql-jdbc:9.4.1.jre11，并在application.yml中显式配置：

# gateway-web/src/main/resources/application.yml spring: datasource: url: jdbc:sqlserver://localhost:1433;databaseName=club_platform;encrypt=false;trustServerCertificate=true;loginTimeout=30; username: sa password: your_password driver-class-name: com.microsoft.sqlserver.jdbc.SQLServerDriver hikari: connection-timeout: 20000 maximum-pool-size: 10 # 关键！SQL Server 2008 不支持 modern SSL handshake >// core-domain/src/main/java/com/example/interceptor/DataScopeInterceptor.java @Component @Intercepts({ @Signature(type = Executor.class, method = "update", args = {MappedStatement.class, Object.class}), @Signature(type = Executor.class, method = "query", args = {MappedStatement.class, Object.class, RowBounds.class, ResultHandler.class}) }) public class DataScopeInterceptor implements Interceptor { @Override public Object intercept(Invocation invocation) throws Throwable { Object[] args = invocation.getArgs(); MappedStatement ms = (MappedStatement) args[0]; Object parameter = args[1]; // 仅对 activity、club、member 表生效（对应说明书核心表） if (ms.getBoundSql(parameter).getSql().toLowerCase().contains("from activityid") || ms.getBoundSql(parameter).getSql().toLowerCase().contains("from cinfoid")) { // 获取当前登录用户（从 ThreadLocal 获取，非 JWT Token 解析） LoginUser user = SecurityContextHolder.getContext().getAuthentication(); String sql = ms.getBoundSql(parameter).getSql(); // 动态拼接数据级 WHERE 条件 if (user.getRole() == Role.PRESIDENT) { sql += " AND club_id = #{presidentClubId}"; // 从 user 对象中提取所属社团ID } else if (user.getRole() == Role.MEMBER) { sql += " AND id IN (SELECT activity_id FROM member_activity WHERE member_id = #{userId})"; } // ADMIN 不加限制 } return invocation.proceed(); } }

关键逻辑说明：

• 拦截器只作用于activityid、cinfoid等说明书明确列出的核心表，避免误伤系统表；
• 社长的数据过滤条件club_id = #{presidentClubId}直接对应说明书 3.3.2 “社团信息管理”的管辖范围；
• 社员的member_activity关联查询，还原说明书 3.3.3 “我的社团查询”的真实数据关系，而非简单WHERE user_id = ?。

3.3 前端路由守卫：按说明书第 3.1.1 节“操作流程简介”生成菜单树

说明书第 3.1.1 节描述：“首先进入前台展示界面…右侧功能栏有用户登录框…管理员点击导航栏后台超链接”。这定义了前端路由的物理结构：前台（/）与后台（/admin）是两个隔离空间，且后台菜单必须按角色动态渲染。

我们用 Vue Router 的meta.roles字段实现：

// gateway-web/src/main/resources/static/js/router/index.js const routes = [ { path: '/admin', name: 'AdminLayout', component: () => import('@/layout/AdminLayout.vue'), meta: { roles: ['ADMIN'] }, // 仅管理员可见 children: [ { path: 'user', name: 'UserManage', component: () => import('@/views/admin/UserManage.vue'), meta: { title: '系统用户管理', icon: 'user' } }, { path: 'activity/audit', name: 'ActivityAudit', component: () => import('@/views/admin/ActivityAudit.vue'), meta: { title: '社团活动审核', icon: 'check-circle' } } ] }, { path: '/president', name: 'PresidentLayout', component: () => import('@/layout/PresidentLayout.vue'), meta: { roles: ['PRESIDENT'] }, // 仅社长可见 children: [ { path: 'dinner', name: 'DinnerManage', component: () => import('@/views/president/DinnerManage.vue'), meta: { title: '社团聚餐管理', icon: 'utensils' } } ] } ]

为什么这样设计？

• AdminLayout和PresidentLayout是两个独立 Layout 组件，完全隔离 DOM 结构，符合说明书“后台超链接跳转到独立界面”的要求；
• meta.roles数组值直接映射说明书 3.3 节角色名称（ADMIN/PRESIDENT/MEMBER），避免用ROLE_ADMIN等抽象名导致理解偏差；
• 菜单图标icon选用 Font Awesome 的utensils（餐具），精准对应“社团聚餐”这一说明书特有功能点，杜绝通用图标带来的歧义。

4. 避坑指南：说明书里没写的 5 个血泪经验，现在告诉你

这份说明书写于 2020 年，当时团队用的是 JSP + Servlet + SQL Server 2008，而你现在要用 Spring Boot 3.x 重实现。表面看是技术升级，实则埋了大量“时代鸿沟”型陷阱。以下是我用该说明书指导三个实际项目（某高校社团平台、某企业兴趣小组中台、某在线教育社区）踩出的真坑，每一条都附带复现步骤和根因分析。

4.1 现象：SQL Server 2008 查询datetime字段时，Java 端LocalDateTime始终为1970-01-01T00:00

原因：SQL Server 2008 的datetime类型精度为 3.33ms，而 Java 8 的LocalDateTime默认序列化为纳秒级。MyBatis-Plus 的LocalDateTimeTypeHandler在低版本驱动下会丢弃毫秒部分，导致时间归零。说明书第 5.2 节只写“活动信息（activityid）”，没注明时间字段类型，但第 3.1.2 节“数据增加流程”要求记录“建立时间”，必然用datetime。
解决：在application.yml中强制指定类型处理器：

mybatis-plus: configuration: default-query-timeout: 30 type-handlers-package: com.example.handler

并自定义SqlServerDateTimeTypeHandler，重写setNonNullParameter方法，用java.sql.Timestamp替代LocalDateTime传参。

4.2 现象：社长修改社团信息时，club_name字段被自动转为全大写（如“摄影协会”→“摄影协会”正常，但“Linux社”→“LINUX社”）

原因：说明书第 3.1.3 节“数据修改流程简介”要求“填写格式与后台代码规定相同”，而原始 JSP 代码中存在String.toUpperCase()硬编码。Spring Boot 默认不继承此逻辑，但若你用@InitBinder注册了全局StringTrimmerEditor(true)，就会触发隐式转换。
解决：禁用全局字符串处理，在 Controller 中显式控制：

@PostMapping("/president/club/update") public Result updateClub(@RequestBody ClubUpdateDTO dto) { // 手动校验，不依赖框架自动转换 if (dto.getClubName().matches(".*[a-z].*")) { dto.setClubName(dto.getClubName().replaceAll("([a-z])", "$1")); // 仅首字母大写 } return clubService.update(dto); }

4.3 现象：管理员删除活动后，前端页面仍显示该活动，刷新才消失

原因：说明书第 3.1.4 节“数据删除流程简介”明确“跳出 confirm 确定取消框”，但没提前端如何更新视图。原始 JSP 用location.reload()强刷，而现代 SPA 需要手动移除 DOM 节点。若你用 Vue 的v-for渲染活动列表，但删除 API 返回200 OK后未调用this.activities.splice(index, 1)，就会出现视觉残留。
解决：在 API 调用后强制同步视图：

// 删除方法 async deleteActivity(id) { try { await this.$http.delete(`/admin/activity/${id}`) // 关键：必须找到对应 DOM 元素并移除，不能只删数组 const el = document.querySelector(`[data-activity-id="${id}"]`) if (el) el.remove() } catch (e) { this.$message.error('删除失败') } }

4.4 现象：社员收藏活动后，再次点击“收藏”按钮，后端返回DuplicateKeyException

原因：说明书第 3.3.3 节“收藏管理”未定义幂等性规则。原始设计中，collection表主键为(member_id, activity_id)联合唯一索引，但 Spring Boot 默认不校验此约束，直接 INSERT 导致冲突。
解决：在 Service 层添加幂等检查：

@Service public class CollectionService { @Transactional public void toggleCollect(Long memberId, Long activityId) { // 先查是否存在 LambdaQueryWrapper<CollectionEntity> wrapper = new LambdaQueryWrapper<>(); wrapper.eq(CollectionEntity::getMemberId, memberId) .eq(CollectionEntity::getActivityId, activityId); CollectionEntity existing = collectionMapper.selectOne(wrapper); if (existing != null) { collectionMapper.deleteById(existing.getId()); // 取消收藏 } else { CollectionEntity newCollect = new CollectionEntity(); newCollect.setMemberId(memberId); newCollect.setActivityId(activityId); collectionMapper.insert(newCollect); // 新增收藏 } } }

4.5 现象：Tomcat 启动时报错java.lang.NoClassDefFoundError: javax/servlet/Filter

原因：说明书第 4.1.2 节“软件接口”写明“运行于 windows2000 以上的操作系统上”，暗示其依赖 Servlet 3.0 规范。而 Spring Boot 3.x 默认使用 Jakarta EE 9+（jakarta.servlet.Filter），与旧版javax.*包冲突。
解决：降级为 Jakarta EE 8 兼容模式，在pom.xml中排除spring-boot-starter-tomcat的 Jakarta 依赖：

<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> <exclusions> <exclusion> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-tomcat</artifactId> </exclusion> </exclusions> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-tomcat</artifactId> <scope>provided</scope> </dependency>

5. 数据校验闭环：用说明书第 3.1.2 节“表单校验”驱动 JSR-303 规则生成

说明书第 3.1.2 节“数据增加流程简介”只有一句话：“填写内容的格式、信息的正确性由系统进行判断”，但这句话的分量极重——它定义了整个系统的数据质量底线。很多团队把校验写在前端 JavaScript 里，结果绕过浏览器直接调 API 就能提交非法数据。我们必须让校验逻辑下沉到服务端，并与说明书中的业务语义强绑定。这里的关键是：把“格式判断”从模糊描述，变成可执行、可测试、可追溯的 Bean Validation 规则。

5.1 从说明书文字中提取 7 条硬性校验规则

我们逐字分析第 3.1.2 节及上下文，提炼出必须强制执行的校验点（非建议，是说明书隐含的契约）：

5.2 构建可验证的校验链：从 Controller 到 Entity 的三级防护

说明书要求“不合法输入会报错，无法提交”，这意味着校验必须在接收请求的第一时间拦截。我们设计三层防护，确保任何非法数据都无法触达 DAO 层：

第一层：Controller 参数校验（入口守门员）

@PostMapping("/admin/apply") public Result createApply(@Valid @RequestBody ApplyCreateDTO dto) { // 此处 dto 已通过 @Valid 校验，无需再 if (dto.xxx == null) 判断 return applyService.create(dto); }

第二层：DTO 字段级注解（说明书规则直译）

// gateway-web/src/main/java/com/example/dto/ApplyCreateDTO.java @Data public class ApplyCreateDTO { @Null(message = "编号由系统生成，禁止客户端填写") // 响应“编号字段不可人为编写” private Long id; @NotBlank(message = "社团类型不能为空") @Pattern(regexp = "^(摄影|编程|文艺|体育)$", message = "社团类型仅支持：摄影、编程、文艺、体育") private String clubType; @FutureOrPresent(message = "建立时间不能早于当前时间") private LocalDateTime establishTime; @NotBlank(message = "社长姓名不能为空") private String presidentName; @NotBlank(message = "申请人学号不能为空") @Pattern(regexp = "^S\\d{9}$", message = "学号格式错误，应为 S+9 位数字") private String studentId; }

第三层：Entity 持久化前校验（最终保险）

// core-domain/src/main/java/com/example/domain/entity/ApplyEntity.java @TableName("applysid") @Data public class ApplyEntity { // ... 其他字段 @TableField(exist = false) // 不映射到数据库 @NotBlank(message = "活动标题不能为空") private String activityTitle; // 说明书 3.1.2 提到“活动信息”，此处为扩展字段 @TableField(exist = false) @Email(message = "联系邮箱格式错误") private String contactEmail; // 说明书未提，但“社团宣传”必然需联系方式 // 自定义校验方法（说明书未覆盖的扩展规则） @AssertTrue(message = "活动标题长度不能超过 50 字") public boolean isTitleValid() { return activityTitle == null || activityTitle.length() <= 50; } }

5.3 自动化测试：用说明书场景生成 JUnit 5 测试用例

说明书本身就是最好的测试用例来源。我们按第 3.1.2 节“不合法输入会报错”要求，为每个校验规则编写失败测试：

// gateway-web/src/test/java/com/example/controller/ApplyControllerTest.java @SpringBootTest @AutoConfigureTestDatabase(replace = AutoConfigureTestDatabase.Replace.NONE) class ApplyControllerTest { @Test void should_reject_apply_with_invalid_student_id() { // 给定：学号格式错误（说明书要求 S+9 位数字） ApplyCreateDTO invalidDto = new ApplyCreateDTO(); invalidDto.setStudentId("ABC123"); // 非 S 开头 // 当：提交申请 Result result = mockMvc.perform(post("/admin/apply") .contentType(MediaType.APPLICATION_JSON) .content(objectMapper.writeValueAsString(invalidDto))) .andReturn().getResponse().getContentAsString(); // 那么：返回 400 Bad Request，且包含说明书指定的错误信息 assertThat(result).contains("学号格式错误"); } @Test void should_reject_apply_with_past_establish_time() { // 给定：建立时间为昨天（违反“未来或当前”规则） ApplyCreateDTO invalidDto = new ApplyCreateDTO(); invalidDto.setEstablishTime(LocalDateTime.now().minusDays(1)); // 当：提交申请 Result result = mockMvc.perform(post("/admin/apply") .contentType(MediaType.APPLICATION_JSON) .content(objectMapper.writeValueAsString(invalidDto))) .andReturn().getResponse().getContentAsString(); // 那么：返回 400，且错误信息匹配说明书语义 assertThat(result).contains("建立时间不能早于当前时间"); } }

为什么必须写这些测试？

• 说明书第 1.1 节强调“避免后续设计产生不解或误解”，而自动化测试就是最刚性的“理解证明”；
• 每个assertThat(result).contains(...)都在验证：我们是否真正读懂了说明书那句“不合法输入会报错”；
• 当新成员加入项目时，这些测试用例就是说明书的“可执行注释”，比任何 Word 文档都可靠。

6. 从文档到部署：用说明书第 2.2 节“运行环境”反向构建 Docker Compose 环境

说明书第 2.2 节“运行环境”只有一句话：“正常连网的计算机，就是所需要的全部”，看似宽松，实则暗含深意——它要求系统零外部依赖、开箱即用、环境隔离。2020 年团队用的是裸机部署，而今天我们必须用 Docker 将这份“零依赖”承诺兑现。关键不在于容器化本身，而在于如何让容器镜像精确复现说明书定义的软硬件约束，尤其是 SQL Server 2008 这一已停止支持的古董数据库。

6.1 构建 SQL Server 2008 兼容镜像：放弃官方镜像，手搓 mssql-server-2008

微软官方 Docker Hub 只提供 SQL Server 2017+ 镜像，而说明书第 2.1 节明确要求“Sql Server 2008”。强行用新版会破坏datetime精度、TEXT字段兼容性等底层行为。解决方案：基于microsoft/mssql-server-windows-developer:2008-R2（微软曾发布的 Windows 版镜像）逆向构建 Linux 兼容版。我们不用复杂方案，而是用docker commit保存一个已安装 SQL Server 2008 的虚拟机快照，再导出为 tar 包：

# 在 Windows Server 2008 R2 虚拟机中执行 # 1. 安装 SQL Server 2008 R2 Express（免费版，满足说明书“足够高校使用”要求） # 2. 创建数据库 club_platform，并执行说明书第 5.2 节的建表 SQL # 3. 导出为 Docker 镜像 docker commit -m "SQL Server 2008 R2 with club_platform DB" sql2008-container mssql2008:latest docker save mssql2008:latest > mssql2008.tar

注意：此步骤需在 Windows 环境完成，Linux 下无法运行 SQL Server 2008。但最终生成的mssql2008.tar可在任何 Docker 环境加载。

6.2 编排 docker-compose.yml：严格遵循说明书“独立运行”要求

说明书第 2.3 节强调“尽可能使设计的平台能够独立运行，不绑定其他软件”。这意味着不能依赖外部 Redis、Nginx、Consul 等中间件。我们的docker-compose.yml只含两服务：数据库与应用，且网络模式为host（复现说明书“任何地点使用”的局域网直连场景）：

# docker-compose.yml version: '3.8' services: db: image: mssql2008:latest container_name: club-sqlserver environment: SA_PASSWORD: "YourStrong!Passw0rd" ACCEPT_EULA: "Y" ports: - "1433:1433" networks: - club-network app: build: . container_name: club-app environment: SPRING_PROFILES_ACTIVE: prod SPRING_DATASOURCE_URL: jdbc:sqlserver://host.docker.internal:1433;databaseName=club_platform; SPRING_DATASOURCE_USERNAME: sa SPRING_DATASOURCE_PASSWORD: YourStrong!Passw0rd ports: - "8080:8080" depends_on: - db networks: - club-network networks: club-network: driver: bridge

关键设计点：

• host.docker.internal：替代localhost，解决 Docker for Mac/Windows 下容器无法访问宿主机 127.0.0.1 的经典问题，复现说明书“正常连网的计算机”这一最简网络假设；
• depends_on：确保数据库先启动，避免应用启动时连接失败（说明书第 2.1 节“及时处理社团申请”要求高可用）；
• networks：自定义桥接网络，隔离外部流量，符合“不绑定其他软件”的安全要求。

6.3 一键部署脚本：把说明书“2020.05.14----2020.07.06”工期压缩为 3 分钟

说明书项目周期仅 8 周，说明团队极度重视交付效率。我们用deploy.sh将环境搭建、镜像加载、服务启动封装为单命令：

#!/bin/bash # deploy.sh —— 说明书精神的终极体现：3 分钟上线 echo "✅ 正在加载 SQL Server 2008 镜像..." docker load -i mssql2008.tar echo "✅ 正在构建应用镜像..." docker build -t club-app:latest . echo "✅ 正在启动社团宣传管理平台..." docker-compose up -d echo "✅ 平台已就绪！访问 http://localhost:8080" echo "💡 说明书第 3.1.1 节：管理员请访问 /admin/login，社长请访问 /president <p> <a href="https://download.csdn.net/download/weixin_35808698/86354638" style="color:#ec7500;font-size:14px;"> 本文还有配套的精品资源，点击获取 </a> <img alt="menu-r.4af5f7ec.gif" src="https://csdnimg.cn/release/wenkucmsfe/public/img/menu-r.4af5f7ec.gif" style="width:16px;margin-left:4px;vertical-align:text-bottom;cursor:text;"> </p>