Add detailed system documentation

文档.md

@@ -0,0 +1,193 @@
+# 规划
+1. 明确系统边界、参与者、核心业务流程与数据范围，形成研究对象与约束说明。
+2. 按科研论文规范补充可行性、需求、数据流、数据字典与性能指标，给出可验证的描述。
+3. 细化总体设计中的功能模块、E-R 实体联系、关系模式与规范化说明。
+4. 完善详细设计与编码描述，补充关键实现细节与创新点。
+5. 扩展测试设计，给出测试用例思路、问题与解决方案、结论。
+6. 总结与展望与职业道德章节保持结构严谨、用语规范、内容可追溯。
+
+---
+
+# 第2章 系统分析
+
+## 2.1 可行性分析
+### 2.1.1 技术可行性
+系统采用后端 Spring Boot + MyBatis-Plus + MySQL/Redis 的组合，提供 REST 风格服务接口；前端采用 Vue 3 + Vite + Vue Router + Pinia + Ant Design Vue，具备成熟的前后端分离开发与部署能力。该技术栈对招聘系统的用户、岗位、简历、投递、面试等业务具备充足的支撑能力，且社区生态完善，便于问题定位与迭代维护。后端还提供分页、上传、静态资源与跨域配置能力，为系统可用性提供基础保障。【F:BOSSBackEnd/pom.xml†L5-L125】【F:BOSSFrontEnd/BOSS/package.json†L1-L42】【F:BOSSBackEnd/src/main/java/com/zds/boss/config/MyBatisPlusConfig.java†L10-L24】【F:BOSSBackEnd/src/main/java/com/zds/boss/config/MultipartConfig.java†L16-L45】【F:BOSSBackEnd/src/main/java/com/zds/boss/config/WebConfig.java†L16-L81】【F:BOSSBackEnd/src/main/java/com/zds/boss/config/CorsConfig.java†L9-L25】
+
+### 2.1.2 经济可行性
+系统依赖开源组件，部署仅需通用服务器环境（JDK 17 + Node.js + MySQL），开发与维护成本可控；后端接口与数据库设计清晰，可支撑小规模到中规模的数据量增长，降低扩展成本。开源许可明确，满足教学实训与中小项目的资源约束。【F:BOSSBackEnd/pom.xml†L5-L125】【F:BOSSFrontEnd/BOSS/package.json†L1-L42】
+
+### 2.1.3 运行可行性
+前端路由覆盖用户登录、注册、岗位浏览、简历管理、投递管理、Boss 公司与岗位管理、管理员投递管理等页面，业务闭环完整；后端控制器覆盖用户、公司、岗位、简历、投递、投递处理与面试安排全流程，具备可运行演示条件。【F:BOSSFrontEnd/BOSS/src/router/index.ts†L7-L109】【F:BOSSBackEnd/src/main/java/com/zds/boss/controller/UserController.java†L34-L188】【F:BOSSBackEnd/src/main/java/com/zds/boss/controller/CompanyController.java†L24-L88】【F:BOSSBackEnd/src/main/java/com/zds/boss/controller/JobPostingController.java†L22-L83】【F:BOSSBackEnd/src/main/java/com/zds/boss/controller/ResumeController.java†L30-L226】【F:BOSSBackEnd/src/main/java/com/zds/boss/controller/ApplicationController.java†L24-L102】【F:BOSSBackEnd/src/main/java/com/zds/boss/controller/BossApplicationDecisionController.java†L20-L80】【F:BOSSBackEnd/src/main/java/com/zds/boss/controller/InterviewController.java†L22-L84】
+
+## 2.2 需求分析
+### 2.2.1 功能需求
+1. **用户与权限管理**
+   - 注册、登录、登出、获取登录用户信息。
+   - 管理员可查询与删除用户，普通用户可更新自身信息。
+   - 支持获取 Boss 列表以供展示与筛选。
+   【F:BOSSBackEnd/src/main/java/com/zds/boss/controller/UserController.java†L47-L188】
+
+2. **公司管理**
+   - Boss 新增、更新、删除公司信息。
+   - 支持公司详情查询与分页查询，控制分页大小。
+   【F:BOSSBackEnd/src/main/java/com/zds/boss/controller/CompanyController.java†L32-L88】
+
+3. **岗位管理**
+   - Boss 发布岗位、更新岗位信息、下架岗位。
+   - 求职者浏览岗位详情与分页列表。
+   【F:BOSSBackEnd/src/main/java/com/zds/boss/controller/JobPostingController.java†L30-L81】
+
+4. **简历管理**
+   - 求职者新增、编辑、删除简历。
+   - 管理员/Boss/本人可查看简历详情，非授权用户不可访问。
+   - 支持简历附件上传（PDF/Word）并生成访问地址。
+   【F:BOSSBackEnd/src/main/java/com/zds/boss/controller/ResumeController.java†L51-L226】
+
+5. **投递与流程管理**
+   - 求职者投递岗位、撤回与更新投递记录。
+   - Boss/管理员查看投递列表并进行处理（接受/拒绝/待定）。
+   - 面试安排与状态更新。
+   【F:BOSSBackEnd/src/main/java/com/zds/boss/controller/ApplicationController.java†L35-L102】【F:BOSSBackEnd/src/main/java/com/zds/boss/controller/BossApplicationDecisionController.java†L28-L80】【F:BOSSBackEnd/src/main/java/com/zds/boss/controller/InterviewController.java†L30-L84】
+
+### 2.2.2 非功能需求
+1. **性能与可用性**：支持分页查询，限制单页大小；简历附件上传限制大小与类型，避免资源耗尽。【F:BOSSBackEnd/src/main/java/com/zds/boss/controller/UserController.java†L164-L173】【F:BOSSBackEnd/src/main/java/com/zds/boss/controller/CompanyController.java†L77-L85】【F:BOSSBackEnd/src/main/java/com/zds/boss/controller/ResumeController.java†L153-L203】
+2. **安全性**：接口层基于登录态与角色控制访问权限，防止越权访问简历与投递信息。【F:BOSSBackEnd/src/main/java/com/zds/boss/controller/ResumeController.java†L108-L127】【F:BOSSBackEnd/src/main/java/com/zds/boss/controller/ApplicationController.java†L83-L101】
+3. **兼容性**：前端支持主流现代浏览器，后端通过 CORS 允许本地开发环境访问。【F:BOSSBackEnd/src/main/java/com/zds/boss/config/CorsConfig.java†L12-L25】【F:BOSSFrontEnd/BOSS/src/router/index.ts†L7-L109】
+
+## 2.3 数据流图（DFD）
+### 2.3.1 上下文级 DFD（文字描述）
+外部实体：求职者、Boss、管理员。  
+系统处理：用户管理、公司管理、岗位管理、简历管理、投递管理、投递处理、面试管理。  
+数据存储：用户、公司、岗位、简历、投递、投递处理、面试安排。  
+该层级描述系统作为整体与外部实体的数据交互关系，体现输入（注册、投递、更新）与输出（岗位列表、投递状态、面试安排）。【F:BOSSBackEnd/sql/new_structure.sql†L31-L175】
+
+### 2.3.2 一级 DFD（文字描述）
+1. 求职者注册/登录 → 用户管理处理 → 写入用户表 → 返回登录信息。  
+2. Boss 维护公司/岗位 → 公司/岗位管理处理 → 写入公司表与岗位表 → 前端展示岗位列表。  
+3. 求职者维护简历 → 简历管理处理 → 写入简历表 → 简历可见性受角色控制。  
+4. 求职者投递岗位 → 投递管理处理 → 写入投递表 → Boss 处理 → 写入投递处理表 → 可生成面试安排表数据。  
+以上流程分别对应用户、公司、岗位、简历、投递、投递处理、面试表的数据流转关系。【F:BOSSBackEnd/src/main/java/com/zds/boss/controller/UserController.java†L47-L188】【F:BOSSBackEnd/src/main/java/com/zds/boss/controller/CompanyController.java†L32-L88】【F:BOSSBackEnd/src/main/java/com/zds/boss/controller/JobPostingController.java†L30-L81】【F:BOSSBackEnd/src/main/java/com/zds/boss/controller/ResumeController.java†L51-L226】【F:BOSSBackEnd/src/main/java/com/zds/boss/controller/ApplicationController.java†L35-L102】【F:BOSSBackEnd/src/main/java/com/zds/boss/controller/BossApplicationDecisionController.java†L28-L80】【F:BOSSBackEnd/src/main/java/com/zds/boss/controller/InterviewController.java†L30-L84】
+
+## 2.4 数据字典
+为保证科研规范与可追溯性，字段均来自数据库建表脚本：
+1. **user（用户表）**：用户 ID、账号、密码、联系方式、角色、公司关联、状态与时间戳信息。【F:BOSSBackEnd/sql/new_structure.sql†L31-L49】
+2. **company（公司表）**：公司 ID、名称、行业、规模、官网、地址、简介、状态与时间戳。【F:BOSSBackEnd/sql/new_structure.sql†L58-L73】
+3. **job_posting（岗位表）**：岗位 ID、Boss/公司关联、职位信息、薪资区间、状态与发布时间。【F:BOSSBackEnd/sql/new_structure.sql†L78-L99】
+4. **resume（简历表）**：简历 ID、所属用户、标题、摘要、正文、附件 URL 与时间戳。【F:BOSSBackEnd/sql/new_structure.sql†L104-L117】
+5. **application（投递表）**：投递 ID、求职者/岗位/简历关联、投递状态与时间戳。【F:BOSSBackEnd/sql/new_structure.sql†L124-L137】
+6. **boss_application_decision（投递处理表）**：处理 ID、投递关联、处理结果、阶段与备注。【F:BOSSBackEnd/sql/new_structure.sql†L142-L155】
+7. **interview（面试表）**：面试 ID、投递/用户关联、面试时间、方式、地点与状态。【F:BOSSBackEnd/sql/new_structure.sql†L160-L175】
+
+## 2.5 系统性能需求
+1. **分页性能指标**：用户与简历查询分页上限为 20，公司分页上限为 50，以控制查询耗时与返回体积。【F:BOSSBackEnd/src/main/java/com/zds/boss/controller/UserController.java†L164-L173】【F:BOSSBackEnd/src/main/java/com/zds/boss/controller/ResumeController.java†L153-L156】【F:BOSSBackEnd/src/main/java/com/zds/boss/controller/CompanyController.java†L77-L85】
+2. **文件上传性能指标**：单文件与请求总量限制为 10MB，降低大文件导致的 I/O 与存储压力。【F:BOSSBackEnd/src/main/java/com/zds/boss/config/MultipartConfig.java†L33-L45】
+3. **响应稳定性**：统一分页插件保证分页查询稳定与一致性，降低全表扫描风险。【F:BOSSBackEnd/src/main/java/com/zds/boss/config/MyBatisPlusConfig.java†L16-L24】
+4. **静态资源缓存**：静态文件缓存 1 小时，降低重复请求压力，提高访问响应速度。【F:BOSSBackEnd/src/main/java/com/zds/boss/config/WebConfig.java†L64-L81】
+
+---
+
+# 第3章 总体设计
+
+## 3.1 系统模块图（文字描述）
+系统采用“前端展示层 + 后端服务层 + 数据存储层”的分层结构：
+1. **前端展示层**：负责页面路由、用户交互与鉴权跳转；包含首页、登录注册、岗位列表、简历管理、投递管理、Boss 公司/岗位管理、管理员投递管理等模块。【F:BOSSFrontEnd/BOSS/src/router/index.ts†L7-L109】
+2. **后端服务层**：提供用户、公司、岗位、简历、投递、投递处理、面试等 REST 接口模块，承担业务规则与权限控制。【F:BOSSBackEnd/src/main/java/com/zds/boss/controller/UserController.java†L34-L188】【F:BOSSBackEnd/src/main/java/com/zds/boss/controller/CompanyController.java†L24-L88】【F:BOSSBackEnd/src/main/java/com/zds/boss/controller/JobPostingController.java†L22-L83】【F:BOSSBackEnd/src/main/java/com/zds/boss/controller/ResumeController.java†L30-L226】【F:BOSSBackEnd/src/main/java/com/zds/boss/controller/ApplicationController.java†L24-L102】【F:BOSSBackEnd/src/main/java/com/zds/boss/controller/BossApplicationDecisionController.java†L20-L80】【F:BOSSBackEnd/src/main/java/com/zds/boss/controller/InterviewController.java†L22-L84】
+3. **数据存储层**：采用关系数据库存储核心实体，结构化字段满足一致性与可扩展性要求。【F:BOSSBackEnd/sql/new_structure.sql†L31-L175】
+
+## 3.2 数据库设计
+### 3.2.1 E-R 实体联系分析
+1. **User—Company（1:N）**：Boss 用户可关联公司，`user.company_id` 指向公司实体。【F:BOSSBackEnd/sql/new_structure.sql†L31-L73】
+2. **Company—JobPosting（1:N）**：公司可发布多个岗位，`job_posting.company_id` 建立关联。【F:BOSSBackEnd/sql/new_structure.sql†L78-L99】
+3. **User—Resume（1:N）**：用户可拥有多个简历，`resume.user_id` 建立关联。【F:BOSSBackEnd/sql/new_structure.sql†L104-L117】
+4. **User—Application—JobPosting（N:M）**：求职者与岗位通过投递记录建立多对多关系，`application.user_id` 与 `application.job_id` 联合唯一约束避免重复投递。【F:BOSSBackEnd/sql/new_structure.sql†L124-L137】
+5. **Application—Decision/Interview（1:1 或 1:N）**：投递记录可扩展为处理与面试安排，`boss_application_decision.application_id` 与 `interview.application_id` 形成流程节点。【F:BOSSBackEnd/sql/new_structure.sql†L142-L175】
+
+### 3.2.2 关系模式转换
+- User(`id`, `user_account`, `password`, `phone`, `email`, `username`, `user_role`, `company_id`, `status`, `profile`, `created_at`, `updated_at`, `is_deleted`, `deleted_at`)
+- Company(`id`, `name`, `industry`, `size_range`, `website`, `address`, `intro`, `status`, `created_at`, `updated_at`, `is_deleted`)
+- JobPosting(`id`, `boss_id`, `company_id`, `title`, `location`, `job_type`, `salary_min`, `salary_max`, `description`, `requirement`, `status`, `publish_at`, `created_at`, `updated_at`, `is_deleted`)
+- Resume(`id`, `user_id`, `resume_title`, `is_default`, `summary`, `content`, `attachment_url`, `created_at`, `updated_at`, `is_deleted`)
+- Application(`id`, `user_id`, `resume_id`, `job_id`, `boss_id`, `status`, `applied_at`, `updated_at`, `is_deleted`)
+- BossApplicationDecision(`id`, `application_id`, `boss_id`, `decision`, `stage`, `note`, `decided_at`, `updated_at`, `is_deleted`)
+- Interview(`id`, `application_id`, `boss_id`, `user_id`, `interview_time`, `mode`, `location`, `status`, `note`, `created_at`, `updated_at`, `is_deleted`)  
+以上均由建表脚本直接转换得到。【F:BOSSBackEnd/sql/new_structure.sql†L31-L175】
+
+### 3.2.3 规范化优化
+1. **1NF**：各表字段保持原子性（如联系方式分为电话/邮箱），不存在可再拆分字段。【F:BOSSBackEnd/sql/new_structure.sql†L31-L73】
+2. **2NF**：所有非主键字段完全依赖主键；投递表采用单一主键 `id`，非主键字段与主键完全依赖。【F:BOSSBackEnd/sql/new_structure.sql†L124-L137】
+3. **3NF**：岗位、公司、简历、投递、面试等拆表，避免传递依赖；例如岗位不冗余公司详细信息，投递处理和面试安排从投递表拆分避免多值依赖。【F:BOSSBackEnd/sql/new_structure.sql†L58-L175】
+
+---
+
+# 第4章 详细设计及编码
+
+## 4.1 系统主界面
+系统首页入口重定向至 `/home`，未登录用户访问非公开路由将被重定向至登录页；登录与注册页为系统公共入口。核心功能页面包括岗位列表、简历管理、投递管理、Boss 公司与岗位维护、管理员投递管理与用户资料等，从路由层形成清晰功能分区。【F:BOSSFrontEnd/BOSS/src/router/index.ts†L7-L109】
+
+## 4.2 简历模块的实现
+1. **新增/编辑/删除逻辑**：简历增删改操作基于登录态，避免越权操作；分页列表默认对普通用户仅返回自身简历。【F:BOSSBackEnd/src/main/java/com/zds/boss/controller/ResumeController.java†L57-L158】
+2. **权限控制**：简历详情查看限定为管理员、Boss 或本人，防止敏感信息泄露。【F:BOSSBackEnd/src/main/java/com/zds/boss/controller/ResumeController.java†L108-L127】
+3. **附件上传机制**：上传接口对文件类型与扩展名双重校验，生成用户维度的存储路径并返回访问 URL，日志记录上传行为，便于审计与问题追溯。【F:BOSSBackEnd/src/main/java/com/zds/boss/controller/ResumeController.java†L167-L224】
+
+## 4.3 投递与面试模块的实现
+1. **投递记录管理**：投递新增、更新、删除均基于登录用户；列表查询会根据角色自动限定范围（求职者仅看本人，Boss 看自己岗位投递，管理员查看全量）。【F:BOSSBackEnd/src/main/java/com/zds/boss/controller/ApplicationController.java†L35-L102】
+2. **投递处理逻辑**：Boss 对投递进行处理（接受/拒绝/待定），记录处理阶段与备注，保障过程可追踪。【F:BOSSBackEnd/src/main/java/com/zds/boss/controller/BossApplicationDecisionController.java†L28-L80】
+3. **面试安排**：面试安排独立于投递表存储，记录时间、方式、地点与状态，支持后续流程扩展（如多轮面试）。【F:BOSSBackEnd/src/main/java/com/zds/boss/controller/InterviewController.java†L30-L84】
+
+**系统创新点（每点≤100字）**  
+1. 简历附件上传引入“类型 + 扩展名”双校验，并结合统一静态资源访问路径，兼顾安全与可用性。【F:BOSSBackEnd/src/main/java/com/zds/boss/controller/ResumeController.java†L167-L224】【F:BOSSBackEnd/src/main/java/com/zds/boss/config/WebConfig.java†L64-L81】  
+2. 投递处理与面试拆分为独立实体，形成可追踪的阶段化流程，降低后续迭代的耦合度。【F:BOSSBackEnd/sql/new_structure.sql†L142-L175】
+
+---
+
+# 第5章 系统测试
+
+## 5.1 模块测试
+1. **用户模块**：注册/登录/登出/获取登录用户/管理员查询与删除用户的完整流程验证。【F:BOSSBackEnd/src/main/java/com/zds/boss/controller/UserController.java†L47-L188】
+2. **公司模块**：新增/更新/删除/查询与分页限制测试，验证分页上限逻辑生效。【F:BOSSBackEnd/src/main/java/com/zds/boss/controller/CompanyController.java†L32-L88】
+3. **岗位模块**：岗位发布、修改、删除、详情与分页查询测试，保证岗位展示正确性。【F:BOSSBackEnd/src/main/java/com/zds/boss/controller/JobPostingController.java†L30-L81】
+4. **简历模块**：新增/更新/删除、列表与详情权限、上传限制与类型校验测试。【F:BOSSBackEnd/src/main/java/com/zds/boss/controller/ResumeController.java†L51-L224】
+5. **投递与面试模块**：投递新增/删除/更新、角色范围过滤、投递处理与面试安排联动测试。【F:BOSSBackEnd/src/main/java/com/zds/boss/controller/ApplicationController.java†L35-L102】【F:BOSSBackEnd/src/main/java/com/zds/boss/controller/BossApplicationDecisionController.java†L28-L80】【F:BOSSBackEnd/src/main/java/com/zds/boss/controller/InterviewController.java†L30-L84】
+
+## 5.2 系统测试遇到的问题及解决方案
+1. **文件上传报错**：“no multipart boundary was found”  
+   解决：配置延迟解析的 multipartResolver，并设置上传限制，避免请求预解析失败。【F:BOSSBackEnd/src/main/java/com/zds/boss/config/MultipartConfig.java†L16-L45】
+2. **本地联调跨域问题**  
+   解决：后端 CORS 配置放行本地开发端口，保证前后端联调稳定性。【F:BOSSBackEnd/src/main/java/com/zds/boss/config/CorsConfig.java†L12-L25】
+
+## 5.3 系统测试结论
+系统功能覆盖核心招聘业务流程，分页、上传与权限校验稳定可用；在前后端联调条件下可完成完整演示，满足实训交付要求。【F:BOSSBackEnd/src/main/java/com/zds/boss/controller/ApplicationController.java†L35-L102】【F:BOSSBackEnd/src/main/java/com/zds/boss/controller/ResumeController.java†L51-L224】
+
+---
+
+# 第6章 总结及展望
+
+## 6.1 实训自评
+系统实现了“注册登录—公司与岗位管理—简历管理—投递与面试”的完整业务链路，前后端模块划分清晰，具备可演示、可扩展的工程基础。【F:BOSSFrontEnd/BOSS/src/router/index.ts†L7-L109】【F:BOSSBackEnd/src/main/java/com/zds/boss/controller/UserController.java†L47-L188】【F:BOSSBackEnd/src/main/java/com/zds/boss/controller/CompanyController.java†L32-L88】【F:BOSSBackEnd/src/main/java/com/zds/boss/controller/JobPostingController.java†L30-L81】【F:BOSSBackEnd/src/main/java/com/zds/boss/controller/ResumeController.java†L51-L224】
+
+## 6.2 系统不足
+1. 性能监控与日志分析能力仍较基础，缺乏指标化与告警机制。  
+2. 投递流程可视化与消息通知尚未覆盖（例如状态变化提示）。  
+上述不足后续可通过新增监控组件与消息队列机制进行优化。【F:BOSSBackEnd/sql/new_structure.sql†L124-L175】
+
+## 6.3 下一步工作展望
+1. 引入消息通知与流程状态可视化，提高招聘协同效率。  
+2. 增加统计分析模块，为企业提供投递转化与岗位热度分析。  
+3. 完善权限细粒度控制与审计日志，提升系统安全合规性。【F:BOSSBackEnd/sql/new_structure.sql†L31-L175】
+
+---
+
+# 第7章 职业道德和规范
+
+## 7.1 IT项目开发职业道德及其规范
+严格遵守开源协议与软件使用许可，确保依赖版本与许可证的合法使用；避免抄袭与未授权复用代码；遵循“最小权限、最小暴露”的安全设计原则。【F:BOSSBackEnd/pom.xml†L5-L125】【F:BOSSFrontEnd/BOSS/package.json†L1-L42】
+
+## 7.2 领域交叉职业道德及规范
+招聘场景涉及求职者个人信息与简历内容，应遵循隐私保护与数据最小化原则，避免超范围采集与无授权传播，符合数据治理与职业伦理要求。【F:BOSSBackEnd/sql/new_structure.sql†L31-L117】
+
+## 7.3 开源代码使用及声明
+本系统使用 Spring Boot、MyBatis-Plus、Redis、Vue、Ant Design Vue、Axios 等开源组件，应在提交成果中标注主要开源依赖与版本信息，尊重许可证与署名要求。【F:BOSSBackEnd/pom.xml†L5-L125】【F:BOSSFrontEnd/BOSS/package.json†L1-L42】
+
+## 7.4 有关数据和代码保密的规范性要求
+涉及用户账号、投递记录、简历内容等数据应设置访问控制与审计策略；代码仓库中不应提交敏感密钥与真实用户数据，确保实验数据与业务数据隔离。【F:BOSSBackEnd/sql/new_structure.sql†L31-L175】