温馨提示本人主页置顶文章(点我)开头有 CSDN 平台官方提供的学长联系名片一、项目背景与意义睡眠质量直接影响人的精神状态、免疫力和慢性病风险。然而很多人对自己的睡眠状况缺乏量化认知入睡时间不规律、夜间频繁醒来、白天嗜睡等问题往往被忽视。传统的健康记录方式依赖纸质日记或零散的手机备忘录数据难以统计也无法形成可执行的改善建议。本项目基于Spring Boot Vue3技术栈构建一个面向普通用户的睡眠健康记录与改善平台。平台以「记录—分析—改善」为主线帮助用户低成本地采集睡眠数据通过可视化图表呈现睡眠规律并结合睡眠卫生知识给出个性化改善建议。项目的主要价值体现在以下几个方面数据化把主观的「睡得好不好」转化为可量化的入睡时间、睡眠时长、夜醒次数、睡眠效率等指标。可视化通过趋势图、日历热力图等方式直观呈现长期睡眠规律。可执行基于规则引擎输出作息调整、睡前习惯、环境优化等改善建议。工程实践完整覆盖前后端分离、权限认证、定时任务、数据统计等企业级开发场景适合作为毕业设计或全栈练手项目。二、需求分析2.1 用户角色角色核心职责普通用户记录每日睡眠、查看统计报表、接收改善建议、管理个人资料管理员管理用户账号、维护睡眠知识库与建议规则、查看平台运营数据2.2 功能性需求账号模块注册、登录、JWT 鉴权、个人信息维护、密码修改。睡眠记录模块新增/编辑/删除睡眠记录字段包括入睡时间、起床时间、夜醒次数、入睡耗时、主观评分、备注等。统计分析模块按日/周/月统计平均睡眠时长、平均入睡时间、睡眠效率、睡眠规律性评分。改善建议模块根据统计结果匹配规则输出针对性建议支持用户对建议进行收藏与反馈。知识库模块管理员维护睡眠科普文章用户可浏览、搜索。提醒模块定时提醒用户记录睡眠、按时就寝。2.3 非功能性需求接口响应时间在常规数据量下控制在 500ms 以内。用户数据按用户维度隔离敏感信息加密存储。前端适配 PC 与移动端浏览器。系统具备良好的可扩展性统计规则与建议规则可配置。三、技术选型层次技术说明前端框架Vue 3 Vite组合式 API构建速度快UI 组件库Element Plus后台管理风格组件齐全状态管理Pinia替代 Vuex类型友好路由Vue Router 4支持路由守卫做权限控制图表ECharts趋势图、热力图、雷达图HTTP 客户端Axios统一封装请求与拦截器后端框架Spring Boot 3.x快速构建 RESTful 服务持久层MyBatis-Plus简化 CRUD 与分页数据库MySQL 8.0存储业务数据缓存Redis存储 Token、热点统计数据认证Spring Security JWT无状态鉴权定时任务Spring Task / Quartz睡眠提醒与统计预计算四、系统架构设计系统采用前后端分离架构前端通过 Nginx 部署静态资源后端以 RESTful API 提供服务整体分为表现层、接口层、业务层、数据层四层。flowchart TD A[Vue3 前端应用] --|Axios / HTTPS| B[Nginx 反向代理] B -- C[Spring Boot 应用] C -- D[Controller 接口层] D -- E[Service 业务层] E -- F[Mapper 数据访问层] F -- G[(MySQL)] E -- H[(Redis)] C -- I[定时任务模块] I -- E各层职责说明表现层负责页面渲染、表单校验、图表展示通过 Axios 调用后端接口。接口层参数校验、权限拦截、统一响应封装。业务层睡眠记录计算、统计聚合、建议规则匹配等核心逻辑。数据层MyBatis-Plus 完成对象与表的映射Redis 承担缓存与 Token 存储。五、数据库设计核心表包括用户表、睡眠记录表、建议规则表、知识库文章表、用户建议反馈表。CREATE TABLE sys_user ( id BIGINT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(50) NOT NULL UNIQUE, password VARCHAR(100) NOT NULL, nickname VARCHAR(50), gender TINYINT DEFAULT 0, birth_year INT, create_time DATETIME DEFAULT CURRENT_TIMESTAMP ); CREATE TABLE sleep_record ( id BIGINT PRIMARY KEY AUTO_INCREMENT, user_id BIGINT NOT NULL, sleep_date DATE NOT NULL COMMENT 所属日期, bed_time DATETIME NOT NULL COMMENT 入睡时间, wake_time DATETIME NOT NULL COMMENT 起床时间, fall_asleep_minutes INT DEFAULT 0 COMMENT 入睡耗时(分钟), wake_count INT DEFAULT 0 COMMENT 夜醒次数, quality_score TINYINT COMMENT 主观评分 1-5, remark VARCHAR(255), create_time DATETIME DEFAULT CURRENT_TIMESTAMP, UNIQUE KEY uk_user_date (user_id, sleep_date) ); CREATE TABLE advice_rule ( id BIGINT PRIMARY KEY AUTO_INCREMENT, rule_name VARCHAR(100) NOT NULL, condition_expr VARCHAR(255) NOT NULL COMMENT 触发条件表达式, advice_content TEXT NOT NULL, priority INT DEFAULT 0, enabled TINYINT DEFAULT 1 ); CREATE TABLE knowledge_article ( id BIGINT PRIMARY KEY AUTO_INCREMENT, title VARCHAR(200) NOT NULL, content LONGTEXT, tags VARCHAR(200), publish_time DATETIME );设计要点sleep_record通过(user_id, sleep_date)唯一索引保证每人每天只有一条记录避免重复录入。睡眠时长不落库由wake_time - bed_time实时计算减少数据冗余与不一致风险。advice_rule将建议逻辑外置为配置便于运营人员调整而无需发版。六、后端核心实现6.1 统一响应与全局异常处理Data public class ResultT { private Integer code; private String message; private T data; public static lt;Tgt; Resultlt;Tgt; success(T data) { Resultlt;Tgt; r new Resultlt;gt;(); r.setCode(200); r.setMessage(success); r.setData(data); return r; } public static lt;Tgt; Resultlt;Tgt; fail(String message) { Resultlt;Tgt; r new Resultlt;gt;(); r.setCode(500); r.setMessage(message); return r; } }6.2 睡眠记录新增接口RestController RequestMapping(/api/sleep) RequiredArgsConstructor public class SleepRecordController { private final SleepRecordService sleepRecordService; PostMapping public Resultlt;Longgt; save(RequestBody Valid SleepRecordDTO dto, RequestAttribute(userId) Long userId) { return Result.success(sleepRecordService.saveRecord(userId, dto)); } GetMapping(/page) public Resultlt;Pagelt;SleepRecordVOgt;gt; page(RequestParam(defaultValue 1) long current, RequestParam(defaultValue 10) long size, RequestAttribute(userId) Long userId) { return Result.success(sleepRecordService.pageByUser(userId, current, size)); } }6.3 睡眠时长与效率计算public class SleepCalculator { /** * 计算睡眠时长小时跨天场景自动处理 */ public static double durationHours(LocalDateTime bedTime, LocalDateTime wakeTime) { Duration d Duration.between(bedTime, wakeTime); if (d.isNegative()) { d d.plusDays(1); } return d.toMinutes() / 60.0; } /** 睡眠效率 实际睡眠时长 / 卧床时长 */ public static double efficiency(LocalDateTime bedTime, LocalDateTime wakeTime, int fallAsleepMinutes) { double total durationHours(bedTime, wakeTime); if (total lt; 0) { return 0; } double actual total - fallAsleepMinutes / 60.0; return Math.max(0, Math.min(1, actual / total)); } }6.4 改善建议规则匹配Service RequiredArgsConstructor public class AdviceService { private final AdviceRuleMapper adviceRuleMapper; public Listlt;Stringgt; generateAdvice(SleepSummary summary) { Listlt;AdviceRulegt; rules adviceRuleMapper.selectEnabledOrderByPriority(); Listlt;Stringgt; result new ArrayListlt;gt;(); for (AdviceRule rule : rules) { if (match(rule, summary)) { result.add(rule.getAdviceContent()); } } return result; } private boolean match(AdviceRule rule, SleepSummary s) { // 简化示例按规则名匹配常见场景 switch (rule.getRuleName()) { case 睡眠不足: return s.getAvgDuration() lt; 6.5; case 入睡困难: return s.getAvgFallAsleepMinutes() gt; 30; case 作息不规律: return s.getBedTimeStdMinutes() gt; 60; case 夜醒频繁: return s.getAvgWakeCount() gt; 2; default: return false; } } }6.5 JWT 鉴权拦截器Component RequiredArgsConstructor public class JwtInterceptor implements HandlerInterceptor { private final JwtUtil jwtUtil; Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) { if (OPTIONS.equalsIgnoreCase(request.getMethod())) { return true; } String token request.getHeader(Authorization); if (token null || !token.startsWith(Bearer )) { throw new BizException(401, 未登录); } Claims claims jwtUtil.parse(token.substring(7)); request.setAttribute(userId, Long.valueOf(claims.getSubject())); return true; } }七、前端核心实现7.1 请求封装与拦截器import axios from axios import { ElMessage } from element-plus import router from /router const request axios.create({ baseURL: /api, timeout: 10000 }) request.interceptors.request.use(config { const token localStorage.getItem(token) if (token) { config.headers.Authorization Bearer ${token} } return config }) request.interceptors.response.use( res { const { code, message, data } res.data if (code 200) return data ElMessage.error(message || 请求失败) return Promise.reject(new Error(message)) }, err { if (err.response?.status 401) { localStorage.removeItem(token) router.push(/login) } ElMessage.error(err.message) return Promise.reject(err) } ) export default request7.2 睡眠记录表单组件template el-form :modelform :rulesrules refformRef label-width100px el-form-item label睡眠日期 propsleepDate el-date-picker v-modelform.sleepDate typedate value-formatYYYY-MM-DD / /el-form-item el-form-item label入睡时间 propbedTime el-date-picker v-modelform.bedTime typedatetime / /el-form-item el-form-item label起床时间 propwakeTime el-date-picker v-modelform.wakeTime typedatetime / /el-form-item el-form-item label入睡耗时 el-input-number v-modelform.fallAsleepMinutes :min0 :max300 / /el-form-item el-form-item label夜醒次数 el-input-number v-modelform.wakeCount :min0 :max20 / /el-form-item el-form-item label主观评分 el-rate v-modelform.qualityScore / /el-form-item el-form-item el-button typeprimary clicksubmit保存/el-button /el-form-item /el-form /template script setup import { ref, reactive } from vue import { ElMessage } from element-plus import request from /utils/request const formRef ref() const form reactive({ sleepDate: , bedTime: , wakeTime: , fallAsleepMinutes: 0, wakeCount: 0, qualityScore: 3 }) const rules { sleepDate: [{ required: true, message: 请选择日期, trigger: change }], bedTime: [{ required: true, message: 请选择入睡时间, trigger: change }], wakeTime: [{ required: true, message: 请选择起床时间, trigger: change }] } const submit async () { await formRef.value.validate() await request.post(/sleep, form) ElMessage.success(记录成功) } /script7.3 睡眠趋势图表template div refchartRef stylewidth: 100%; height: 360px;/div /template script setup import { ref, onMounted, watch } from vue import * as echarts from echarts const props defineProps({ data: { type: Array, default: () [] } }) const chartRef ref() let chart const render () { if (!chart) chart echarts.init(chartRef.value) chart.setOption({ tooltip: { trigger: axis }, xAxis: { type: category, data: props.data.map(i i.date) }, yAxis: { type: value, name: 小时 }, series: [{ type: line, smooth: true, areaStyle: {}, data: props.data.map(i i.duration) }] }) } onMounted(render) watch(() props.data, render, { deep: true }) /script八、关键功能实现要点8.1 睡眠规律性评分规律性评分用于衡量用户入睡时间是否稳定。实现思路是取最近 7 天入睡时间统一换算为当日分钟数计算标准差标准差越小说明作息越规律。public static double regularityScore(ListInteger bedMinutes) { if (bedMinutes null || bedMinutes.size() 2) { return 100; } double avg bedMinutes.stream().mapToInt(Integer::intValue).average().orElse(0); double variance bedMinutes.stream() .mapToDouble(v - Math.pow(v - avg, 2)) .average().orElse(0); double std Math.sqrt(variance); // 标准差 0 分钟得 100 分120 分钟及以上得 0 分 return Math.max(0, 100 - std / 120 * 100); }8.2 定时提醒Component RequiredArgsConstructor public class SleepReminderTask { private final UserMapper userMapper; private final MessageService messageService; Scheduled(cron 0 0 22 * * ?) public void remind() { Listlt;Usergt; users userMapper.selectReminderEnabled(); for (User user : users) { messageService.send(user.getId(), 该记录今天的睡眠情况啦); } } }8.3 数据权限隔离所有涉及用户数据的查询都必须在 SQL 条件中带上user_id禁止仅凭前端传入的 id 直接查询。推荐在 Service 层统一从RequestContext获取当前用户 id避免越权访问。九、系统测试与部署9.1 测试要点单元测试重点覆盖睡眠时长计算、效率计算、规律性评分等纯函数逻辑。接口测试使用 Postman 或 Apifox 验证鉴权、参数校验、分页查询。边界测试跨天入睡如 23:30 入睡、次日 07:00 起床、起床时间早于入睡时间等异常输入。9.2 部署方案# 前端构建 npm run build # 将 dist 目录部署到 Nginx nginx -s reload 后端打包 mvn clean package -DskipTests java -jar sleep-platform.jar --spring.profiles.activeprodNginx 需配置/api反向代理到后端服务并开启 gzip 压缩以提升首屏加载速度。十、总结与展望本文围绕 Spring Boot Vue3 技术栈完成了睡眠健康记录与改善平台的需求分析、架构设计、数据库设计与核心代码实现。项目以「记录—分析—改善」为主线既解决了用户对睡眠状况缺乏量化认知的实际问题也覆盖了前后端分离开发中的鉴权、统计、定时任务等典型工程场景。后续可以从以下方向继续演进接入智能手环或手机健康数据实现睡眠数据自动同步降低记录成本。引入机器学习模型基于历史数据预测睡眠质量并给出更精细的个性化建议。增加社交与打卡功能通过同伴激励提升用户坚持记录的动力。完善数据导出与隐私合规能力支持用户下载和删除个人数据。
企业数字化 ERP 产品动态
相关推荐
Java学生成绩管理系统进阶:从CRUD到高并发实战 简介:这份资源是学生成绩管理系统的进阶版完整Java源码,面向具备一定Java Web基础、希望深入理解企业级分层架构的开发者与课程设计者,可用于二次开发、毕业设计参考或框架整合练习。项目采用SpringSpringMVCMyBatis作为后台核心,… · 2026/11/15 22:53:28
校园拍卖系统Spring Boot+MySQL源码部署与核心逻辑详解 简介:基于 Spring Boot 与 MySQL 的校园在线拍卖系统,面向高校毕业设计、课程设计及需要快速搭建拍卖类项目的开发者。压缩包共含 839 个文件,其中既包括 131 个 Java 后端类、49 个 Vue 组件、164 个 JavaScript 脚本,也包含 53 … · 2026/11/16 1:35:58
Linux系统稳定性验证:stress压力测试原理与实战指南 简介:本资源为Linux系统级压力测试工具stress的源码发布包,面向Linux系统管理员、运维工程师及性能调优学习者,用于快速部署、编译与定制化使用该轻量级稳定性验证工具。资源共32个文件,涵盖configure构建脚本、Makefile系列&… · 2026/11/15 21:51:52
乐至在哪里办理电工证?郑州报考避坑指南全解析 乐至在哪里办理电工证?郑州报考避坑指南全解析 不知道去哪报名怕被中介坑?乐至电工证到底该去哪里办?不少电工朋友在报考过程中,最容易踩的坑就是被中间人忽悠,交了钱却拿不到证,或者拿到的证不被认可。今天我就从郑州金水区市政公用工程从业者的角度,… · 2026/11/16 15:57:39
35岁没学历也能考建筑局发电工证?内部消息全在这了 35岁没学历也能考建筑局发电工证?内部消息全在这了 学历不高怕报不上名?别被那些“门槛高”的传言骗了,我去年在河南商丘帮3个初中毕业的学员顺利拿下 建筑局发电工证 ,现在他们每月工资都上万了。这不是我吹, 内部消息… · 2026/11/16 15:57:39
唐山特种作业操作证多少钱?证书过期了不知道怎么复审延期 唐山特种作业操作证多少钱?证书过期了不知道怎么复审延期 证书过期了不知道怎么复审延期,这是很多在唐山从事特种作业的人员最头疼的问题。尤其是像低压电工、焊工、高处作业等工种,特种作业操作证的有效期一般为三年,过期后如果不能及时复审,不仅影响正… · 2026/11/16 15:57:39
铜仁沿河电工证丢了怎么补办?电子证书怎么查?工地太忙根本没时间复习考试 铜仁沿河电工证丢了怎么补办?电子证书怎么查?工地太忙根本没时间复习考试 工地太忙根本没时间复习考试,谁懂?尤其在铜仁沿河这种工程项目集中的地方,电工证一旦丢了,不仅影响工作,还可能耽误项目进度。很多人不知道的是,现在的电工证已经全面实行电子… · 2026/11/16 15:57:39
昆山考电工证焊工证网上查询怎么查?实操考试心里没底怕挂科 昆山考电工证焊工证网上查询怎么查?实操考试心里没底怕挂科 实操考试心里没底怕挂科?你不是一个人。昆山考电工证焊工证的备考路上,很多人都被实操环节卡住,尤其是对焊工证和电工证这种需要动手操作的工种,更需要提前准备,否则很容易掉链子。今天,我就… · 2026/11/16 15:57:39
5电工证报名学历不高怕报不上名?值不值得考要看这几点 5电工证报名学历不高怕报不上名?值不值得考要看这几点 学历不高怕报不上名?别急,5电工证报名真的不难,关键是搞清楚报考条件和自身适配度。很多人觉得学历不够、年龄偏大,就放弃报考特种作业证书,其实不然。5电工证不仅门槛不高,而且值不值得考,得… · 2026/11/16 15:56:38
长春初级电工证怎么考?通过率揭秘全在这里 长春初级电工证怎么考?通过率揭秘全在这里 之前考的证在外省能不能转过来?这几乎是每个想从事电工工作的人都会问的问题。特别是那些在外地打拼多年、手里握着一张“外地电工证”的人,到了长春想继续干这一行,第一反应就是“我的证能用吗?”。今天我们就… · 2026/11/16 3:21:55
国内电工证报考条件与考试时间 低压电工证怎么考?学历不高也能报名,官方报名入口全在这 你是不是经常听说“电工证是入行门槛”,但又担心自己学历不够、经验不足,根本报不了名?别急,今天就带你从零了解【国内电工证】的报考流程、考试内容,还有怎么在 官方报名入口… · 2026/11/16 3:01:18
电工作业时如何断电?电子证书到底能不能全国通用? 电工作业时如何断电?电子证书到底能不能全国通用? 实操考试心里没底怕挂科,特别是电工作业时如何断电这一操作,不仅关系到你能不能拿到证书,更关系到以后能不能顺利上岗。很多人觉得这不过就是“断个电”,但其实这里面的门道可不少,稍有不慎就可能出错… · 2026/11/16 8:30:17
电工证培训的通知在哪考?别再被中介骗了 电工证培训的通知在哪考?别再被中介骗了 你是不是还在为 电工证培训的通知在哪考 发愁?网上搜了一堆信息,结果要么是挂羊头卖狗肉的培训机构,要么就是打着“包过”旗号的骗子?别急,今天我来给你讲讲, 电工证培训的通知… · 2026/11/16 0:00:34
电工证去哪个部门考核值不值得考 信阳转岗人真实经历分享 电工证去哪个部门考核值不值得考 信阳转岗人真实经历分享 怕考不过白交培训费?你不是一个人,信阳的李师傅去年刚转岗做电工,就因为没搞清楚电工证去哪个部门考核,差点交了8000块的培训费。别急,下面这份实操考试全攻略,告诉你电工证到底值不值得考… · 2026/11/16 0:00:34
双极步进电机控制实战:DRV8818PWPR与PIC18F86K22驱动调试 /* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/15 1:51:20
STM32F207ZG + DRV8818PWPR 步进电机驱动实战解析 /* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/15 4:02:19
DRV8818PWPR+dsPIC30F4013工业级双极步进电机控制方案 /* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/15 3:02:05