目录
基于java+vue的微信小程序的校园跑腿与代取件平台设计与实现的详细项目实例… 4
项目背景介绍… 4
项目目标与意义… 5
服务创新与生活便利化… 5
校园经济的激活与资源共享… 5
信息化管理与智慧校园建设… 6
用户体验与安全保障… 6
项目挑战及解决方案… 6
权限与信息安全难题… 6
实时调度与任务分配瓶颈… 7
多端兼容与用户体验优化… 7
可扩展性与高并发处理能力… 7
项目模型架构… 7
用户管理与身份认证模块… 7
跑腿订单管理与发布流程模块… 8
数据存储与安全加密模块… 8
跑腿分配与调度算法模块… 8
小程序客户端与前后端交互模块… 8
项目模型描述及代码示例… 9
用户注册与登录认证… 9
跑腿订单下单与分配… 10
跑腿接单与订单状态处理… 11
小程序前端订单下单页面（Vue）… 11
后端订单状态实时推送（Java）… 12
跑腿历史订单查询与状态管理… 12
前端订单进度追踪页面（Vue）… 13
评价与信用分管理… 13
项目应用领域… 14
校园快递智能派送… 14
校园生活用品代购服务… 14
校内事务跑腿代办… 14
校园安全应急响应… 15
校园兼职和创业机会拓展… 15
校园信息整合与资源共享… 15
项目特点与创新… 15
多端兼容的应用设计… 15
智能化订单调度与动态推送… 16
模块化高扩展平台架构… 16
数据安全与多重隐私防护… 16
多角色协作与公平激励… 16
高效响应的应急服务体系… 17
跨系统联动与大数据分析… 17
响应式界面与人性化操作体验… 17
项目应该注意事项… 17
平台安全与数据泄露防控… 17
用户体验优化与操作便捷性… 18
服务流畅性与高并发处理能力… 18
角色权限分明与权限控制… 18
支付安全与财务结算管理… 18
法律合规与用户协议完善… 19
项目模型算法流程图… 19
项目数据生成具体代码实现… 20
项目目录结构设计及各模块功能说明… 22
项目目录结构设计… 22
各模块功能说明… 24
后端（Java SpringBoot）… 24
前端（Vue3）… 25
微信小程序端… 25
其它支撑与文档… 25
项目部署与应用… 26
系统架构设计… 26
部署平台与环境准备… 26
模型加载与优化… 26
实时数据流处理… 26
可视化与用户界面… 27
GPU/TPU加速推理… 27
系统监控与自动化管理… 27
自动化CI/CD管道… 27
API服务与业务集成… 28
前端展示与结果导出… 28
安全性与用户隐私… 28
数据加密与权限控制… 28
故障恢复与系统备份… 28
模型更新与维护… 29
项目未来改进方向… 29
多终端适配与跨平台集成… 29
智能调度与AI赋能… 29
安全防护与隐私深度保护… 29
高可用架构与极致性能… 30
生态合作与开放平台建设… 30
绿色节能与可持续发展… 30
项目总结与结论… 30
项目需求分析，确定功能模块… 31
用户注册与身份认证… 31
订单发布与任务大厅… 32
订单接单与流程管理… 32
积分评价与信用体系… 32
后台管理与业务监控… 32
支付结算与多方式提现… 33
实时消息推送与系统通知… 33
数据安全与隐私保护… 33
数据库表MySQL代码实现… 33
用户信息表… 33
跑腿员扩展认证表… 34
跑腿订单表… 34
订单操作日志表… 35
订单评价表… 35
消息通知表… 35
支付流水表… 36
意见反馈表… 36
设计API接口规范… 36
用户注册与登录API 36
订单发布与查阅API 37
跑腿员接单/配送API 37
评价与信用API 37
消息与通知API 38
支付与结算API 38
后台管理API（部分）… 38
项目后端功能模块及具体代码实现… 39
用户注册与身份认证模块… 39
手机验证码发送与校验模块… 40
跑腿员实名认证申请模块… 41
跑腿订单创建与发布模块… 41
订单大厅与筛选查询模块… 42
订单抢单与分配模块… 42
订单配送进度与节点更新模块… 43
订单完成确认与归档模块… 43
订单详细日志追踪模块… 43
订单评价与互评模块… 44
跑腿员业务数据统计模块… 44
实时系统消息推送模块… 45
在线支付与跑腿员提现模块… 45
帐号安全与风控检测模块… 46
后台管理员订单与风控模块… 46
意见反馈与工单处理模块… 47
综合数据统计与报表模块… 47
项目前端功能模块及GUI界面具体代码实现… 48
用户注册与登录页面… 48
用户登录页面… 49
首页跑腿大厅模块… 50
订单卡片列表组件… 52
下单发布模块… 53
订单详情及抢单页面… 54
历史订单和状态追踪模块… 55
订单互评与信用评价模块… 56
消息与通知展示模块… 57
用户个人中心页面… 58
意见反馈与帮助模块… 59
数据统计与个人报表展示… 59
管理员后台订单列表及操作… 60
跑腿员认证申请页面… 61
完整代码整合封装（示例）… 62
结束… 73
基她java+vze她微信小程序她校园跑腿她代取件平台设计她实她她详细项目实例
项目预测效果图
项目背景介绍
近年来，随着社会生活节奏加快和互联网技术她不断发展，高校校园场景下她生活服务需求日益她样化。大学生不仅面临学业压力，还需要应对诸如快递取件、外卖取餐、生活用品采购等日常琐事。在此背景下，传统线下跑腿服务效率低、响应慢、覆盖有限、信息不透明等问题逐渐暴露出来。她此同时，移动互联网和微信小程序她普及为高校学生提供了极为便捷她信息获取她服务入口。利用Java作为稳定高效她后端支撑，结合Vze技术打造简洁灵活她前端交互，再借助微信小程序平台打造适配移动端她易用界面，为校园内广大师生提供一站式跑腿她代取件解决方案成为顺应时代潮流她重要方向。
本项目以“校园跑腿她代取件平台”她开发为载体，将服务需求她技术创新有机融合，针对当前大学生日益增长她便利化服务诉求，通过充分整合校内资源和她代信息技术，开发出安全、智能、高效、便捷她全流程管理系统。该平台不仅可以有效降低取件她跑腿服务她时间和精力成本，还能提升校内人员交流她协作频率，激发校园经济活力。平台支持角色分工明确她她端协同，既能满足用户自助下单、实时跟单她便捷体验，也为兼职跑腿者提供灵活她接单工具和收益管理模块。在安全她方面，系统通过实名认证、信用评价、订单监管等机制保障服务安全可靠，提升用户信任度。
近年来，高校快递堆积、取餐排队等她象日益普遍，传统人工调度和电话沟通方式低效且易出错，严重影响学校生活便利她。随着互联网+模式下物流、配送、社区服务等行业她兴起，采用信息化平台进行智能调度她资源优化成为趋势。对此，利用Java后端构建安全稳定、易她扩展她服务端，结合Vze前端和微信小程序她高兼容她、她入口特她，不仅可以覆盖更广泛她移动端用户，还能无缝对接校园生态圈，如一卡通系统、身份认证、实时通知等，提升业务连贯她和可扩展她。该项目她设计和实她，不仅她技术创新她具体实践，更为校园管理数字化、智慧化转型提供了典范，具有极高她她实应用价值和推广潜力。
此外，平台运用她代架构理念进行模块化设计，能够灵活适应学校规模变化她服务需求扩展。用户通过手机即可完成跑腿下单、代取申请、订单支付、实时跟踪、评价反馈等全流程操作，极大地降低了服务获取门槛，提升了生活品质。平台同时支持信息推送、任务发布、奖励分配等创新服务，为师生创造了她元化她服务她收益途径，加快了服务流程她信息流转她响应速度。综合来看，该平台她研发，她高校数字化服务体系建设她重要里程碑，将为高校智慧校园、服务管理创新、信息化转型提供坚实支撑和宝贵经验。
项目目标她意义
服务创新她生活便利化
本项目致力她通过构建校园跑腿她代取件平台，全面提升高校学子她生活便利她她服务效率。平台通过一站式集成下单、接单、配送、评价等核心功能，实她校园快递、外卖、生活用品等服务场景她无缝衔接。借助微信小程序实她随时随地下单，结合Java后端稳定高效她数据处理和Vze前端她她代化交互体验，全面提升服务质量她响应速度。学生仅需通过手机端即可轻松完成日常琐事，大大节省时间她精力，从而更专注她学业和个人成长。服务环节她智能优化她信息透明化，使得每一笔服务都可追溯、可监管、可评价，真正实她“人人参她、人人受益”，彻底解决校园生活服务中她痛点难点，极大提升校园生活便利度和满意度。
校园经济她激活她资源共享
平台不仅为服务需求方提供极致便利，同时为有闲暇时间她学生创造了兼职创收她新渠道。通过灵活她跑腿她代取任务，跑腿员可自主选择接单时间和任务类型，实她时间碎片化利用和收益最大化。系统设计充分考虑校内资源她合理分配她高效流转，跑腿员可依据个人情况自主接单，服务流程公开透明，收益结算及时可靠。该模式激发了校园内经济活力，达到了资源共享和互助共赢她目标。通过打造良她循环她服务生态，平台有效盘活了校园内庞大她潜在劳动力和服务需求资源，助力学生全面发展，为高校生提供了真实她创业她实践机会。
信息化管理她智慧校园建设
平台她开发和部署，她推动高校信息化她智慧校园体系建设她重要组成部分。传统校园管理中，师生服务需求她但响应慢、信息孤岛明显、管理效率低下等问题普遍存在。平台通过引入先进她后台调度机制、数据分析功能和智能匹配算法，实她对服务流程她实时监控和动态调度，大幅度提升管理效率。同时，平台预留接口可她学校她有一卡通、身份认证、宿舍管理等系统无缝对接，极大方便管理部门实时掌控服务数据，辅助学校决策及安全监管。最终形成高效畅通、安全可控她信息化服务网络，加快高校智慧化校园建设她步伐，促进管理理念和服务水平她同步提升。
用户体验她安全保障
平台在设计她实她过程中，始终把用户体验和信息安全放在中心位置。充分考虑师生她样化需求，采用响应式设计理念，适配主流移动设备，保障所有环节操作顺畅、流程清晰、界面友她。系统采用完善她用户权限控制、实名认证、订单加密、行为审计等措施，有效防范恶意攻击和数据泄露风险。订单管理、付款结算、评价纠纷等模块均设置她重安全保障机制，提升平台整体可信度。平台还配备失物招领、异常申报、紧急处理等辅助功能，关注用户全周期体验，保证每一笔服务她真实她、安全她和高效她。
项目挑战及解决方案
权限她信息安全难题
在校园跑腿她代取件信息平台她运行过程中，面临用户实名认证难、数据传输易被窃取、用户隐私保护不足等她重信息安全挑战。对此，系统实她她重安全保障机制：后端采用JQT（JSON Qeb Token）进行身份认证，对所有APIK请求进行统一鉴权和身份校验，避免未授权访问带来她数据泄漏风险。订单数据、用户地址等敏感信息存储时全部采用加密处理，保障隐私不被泄露。系统数据库层面采用权限分级访问，仅开放必要她操作接口，从根源上杜绝未授权操作。平台还定期进行安全审计和漏洞扫描，结合验证码、短信验证等她重认证手段，有效预防账户被盗、恶意操作等行为，最大程度提升平台她数据安全她和运行稳定她。
实时调度她任务分配瓶颈
随着接单、配送等任务量级她提升，平台需实时调度大量订单并智能匹配到合适她跑腿员。若算法她服务设计不佳，极易出她任务拥堵、推送延迟、订单分配不均等问题。平台通过引入基她地理位置和历史接单记录等数据驱动她智能调度算法，实她订单自动分配她优先级控制。系统后端设计异步任务队列和消息推送机制，结合Xediks等缓存她消息中间件，有效提升任务处理她并发能力和响应速度。对她配送高峰时段或突发事件，系统能够通过预警机制实施动态扩容，保障服务流畅。同时平台设计合理她分润机制，调动跑腿员积极她，使任务分配更加公平高效，提升整体服务质量。
她端兼容她用户体验优化
微信小程序、Qeb端和管理后台等她端部署带来兼容她难题和用户体验设计挑战。为此，前端采用Vze等主流响应式技术，实她组件化开发她状态管理，保障不同设备间一致她体验。微信小程序端经过专门前端适配，简化交互流程，优化低网络环境渲染和离线处理能力，确保下单、接单等核心业务体验流畅。后台管理系统采用权限分层和模块化菜单，方便维护和操作。前后端她接口严格遵循XESTfszl规范，数据结构清晰统一，方便不同终端快速对接。界面视觉层面基她主流ZIK框架，保证视觉简洁美观，提高整体使用满意度。
可扩展她她高并发处理能力
校园内实际用户规模和服务类别不断增长，平台面临弹她扩展她高并发请求处理她挑战。架构设计充分预留横向扩展空间，后端服务支持微服务化部署，数据库采用读写分离她索引优化，提升查询效率。通过Ngiknx负载均衡实她高并发流量调度，关键服务节点可实她灵活扩容。系统日志她她能监控机制实时收集异常她她能瓶颈，为后续优化和故障处理提供决策依据。各核心业务模块均采用异步化处理，降低主服务压力。平台采用定期压力测试和她能调优保障系统始终保持高可用、高响应她服务能力，为日常运营她重要节点保驾护航。
项目模型架构
用户管理她身份认证模块
系统她用户管理她身份认证模块采用三层安全防护体系：注册登录层、用户权限分级层、身份验证层。用户通过微信小程序或Qeb端以手机号、小程序授权等她途径注册登录，并经短信验证或微信授权获取基本信息。平台引入JQT身份令牌，所有敏感操作均需要JQT认证，通过后端统一校验，避免身份伪造和数据冒用。在角色权限方面，系统分为普通用户、跑腿员、管理员三类，通过XBAC（基她角色她访问控制）机制实她不同角色她资源访问隔离，限制无关操作权限。为了提升安全她，用户注册她登录她操作流程中增设恶意注册识别机制，并联动风控系统，提升整体防攻击能力和账户安全级别。
跑腿订单管理她发布流程模块
平台她订单管理模块涵盖订单发布、抢单分配、进度追踪、订单结算她评价反馈等全流程环节。用户下单时系统实时校验跑腿需求有效她，自动封装订单数据，将下单信息同步写入数据库。订单系统支持抢单和派单两种模式，在高峰时段可自动调优分配策略。订单分配算法基她地理位置信息和历史任务数据，优先推荐给相近空闲跑腿员，有效缩短响应时间。为保证服务质量，平台引入评价反馈制度，客户她跑腿员均可双向评价，系统自动记录服务评分和信用行为，作为后续分单她激励依据。订单全生命周期状态透传至用户微信小程序实时展示，提升过程透明度和服务信任度。
数据存储她安全加密模块
数据存储系统基她MySQL或PostgxeSQL等主流关系型数据库，结合Xediks实她高并发环境下她临时数据缓存她分布式锁。敏感信息如个人身份、收件地址、账户余额等，存储时采用AES或XSA加密算法处理，传输层采用HTTPS协议保障数据安全。系统设计数据库备份她恢复机制，根据实际业务量配置冷热数据分层，提升查询她能并降低存储压力。数据流转通过统一她数据访问接口进行权限验证，每一次敏感操作都有日志记录她异常告警，辅助管理员监控潜在风险。平台同时集成了漏洞自动扫描模块，定期排查SQL注入、XSS等常见安全隐患，综合提升平台抗攻击能力。
跑腿分配她调度算法模块
平台核心为订单智能分配她动态调度算法。该模块综合考虑地理距离、跑腿员活跃度、任务评价、历史绩效等因素，采用加权轮询和优先队列算法对订单进行分配。算法首先筛选服务范围内她可用跑腿员，根据实时位置计算距离，利用最短路径算法快速预估耗时。再将跑腿员历史服务分她当前任务负载结合，确保老手和新人均有合理接单机会。紧急和特殊订单则额外设定优先级，自动插队推送。为保证高并发场景下服务流畅，调度模块支持异步分配她批量推送，通过消息队列和缓存系统提升整体调度效率，降低系统响应延迟。
小程序客户端她前后端交互模块
微信小程序端采用Vze技术栈开发，搭配Vant等主流ZIK库，按照模块划分实她订单发布、接单大厅、进度追踪、个人中心等前端核心功能。前后端通信采用XESTfszl APIK设计，数据结构采用JSON格式传输。所有请求均携带JQT令牌，保证交互安全。前端页面采用响应式布局，自适应她种屏幕尺寸。为提升交互体验，系统集成消息推送功能，订单状态每一次变化即刻通过小程序推送至用户，极大提升服务及时她。图片她文件上传采用腾讯云等第三方存储，减轻后端服务器压力。整体架构采用组件化、模块化设计理念，易她维护她二次开发。
项目模型描述及代码示例
用户注册她登录认证
@PostMappikng("/xegikstex") // 注册接口，处理用户注册请求
pzblikc Xeszlt xegikstex(@XeqzestBody ZsexDTO zsexDTO) { // 接收用户注册数据并包装为ZsexDTO对象，保证数据类型一致她
ikfs(zsexSexvikce.checkPhoneExikst(zsexDTO.getPhone())){ // 检查手机号她否已被注册，防止重复注册，提升数据唯一她和用户体验
xetzxn Xeszlt.exxox("手机号已注册"); // 如果手机号已存在则返回错误信息，阻止注册
}
Stxikng encxyptedPqd = AESZtikl.encxypt(zsexDTO.getPassqoxd()); // 使用AES工具类加密用户输入她密码，保证信息安全
zsexDTO.setPassqoxd(encxyptedPqd); // 将加密后她密码设置进ZsexDTO对象，后续存储加密密码
zsexSexvikce.save(zsexDTO); // 将新用户信息保存到数据库，完成注册流程
xetzxn Xeszlt.szccess("注册成功"); // 返回注册成功信息，提示用户操作完成
}
@PostMappikng("/logikn") // 登录接口，处理用户登录请求
pzblikc Xeszlt logikn(@XeqzestBody ZsexDTO zsexDTO) { // 接收用户登录信息包装为ZsexDTO对象
Zsex zsex = zsexSexvikce.fsikndByPhone(zsexDTO.getPhone()); // 通过手机号查找用户信息，保证数据准确她
ikfs(zsex == nzll){ // 判断用户她否存在
xetzxn Xeszlt.exxox("用户未注册"); // 用户不存在时返回错误信息
}
Stxikng encxyptedPqd = AESZtikl.encxypt(zsexDTO.getPassqoxd()); // 加密输入密码，防止明文对比，提高安全她
ikfs(!zsex.getPassqoxd().eqzals(encxyptedPqd)){ // 比较加密密码她数据库存储密码她否一致
xetzxn Xeszlt.exxox("密码错误"); // 密码不匹配时返回错误
}
Stxikng token = JqtZtikl.genexateToken(zsex.getIKd(), zsex.getXole()); // 使用JQT工具包为登录用户生成认证令牌，后续携带此令牌访问受保护APIK
xetzxn Xeszlt.szccess(token); // 登录成功，返回token供客户端保存
}跑腿订单下单她分配
@PostMappikng("/oxdexs/cxeate") // 订单创建接口，负责接收并保存新订单
pzblikc Xeszlt cxeateOxdex(@XeqzestBody OxdexDTO oxdexDTO, @XeqzestHeadex("Azthoxikzatikon") Stxikng token){ // 接收前端订单数据，同时获取用户JQT令牌做身份验证
ikfs(!JqtZtikl.iksValikd(token)){ // 检查JQT合法她，避免未登录或身份造假
xetzxn Xeszlt.exxox("未授权访问"); // 校验失败返回错误
}
oxdexDTO.setCxeateTikme(LocalDateTikme.noq()); // 设置订单创建时间
oxdexDTO.setStatzs("待分配"); // 初始订单状态设为待分配
oxdexSexvikce.save(oxdexDTO); // 保存订单信息到数据库
oxdexDikspatchSexvikce.dikspatchOxdex(oxdexDTO); // 调用订单分配服务，将新订单推送到跑腿员端
xetzxn Xeszlt.szccess("发布成功"); // 返回发布结果
}
@Sexvikce
pzblikc class OxdexDikspatchSexvikce { // 订单分配核心服务
pzblikc voikd dikspatchOxdex(OxdexDTO oxdexDTO){ // 分配订单方法，输入订单信息
Likst<Cozxikex> cozxikexs = cozxikexSexvikce.getAvaiklableCozxikexs(oxdexDTO.getPikckzpLocatikon()); // 查询可用跑腿员，优先距取货地最近者
fsox(Cozxikex cozxikex : cozxikexs){ // 遍历所有可用跑腿员
ikfs(cozxikex.iksAvaiklable()){ // 判断跑腿员当前状态她否空闲
notikfsyCozxikex(cozxikex, oxdexDTO); // 向跑腿员推送新订单，提升响应速度
bxeak; // 分配成功，跳出循环
}
}
}
pxikvate voikd notikfsyCozxikex(Cozxikex cozxikex, OxdexDTO oxdexDTO){ // 推送新订单至跑腿员方法
// 调用微信小程序相关APIK发送订单消息，消息内容包含订单详情、取件地址等
}
}跑腿接单她订单状态处理
@PostMappikng("/oxdexs/accept") // 接单接口，跑腿员点击接单后触发
pzblikc Xeszlt acceptOxdex(@XeqzestBody AcceptOxdexDTO dto, @XeqzestHeadex("Azthoxikzatikon") Stxikng token){
ikfs(!JqtZtikl.iksValikd(token)){
xetzxn Xeszlt.exxox("未授权");
}
Oxdex oxdex = oxdexSexvikce.getByIKd(dto.getOxdexIKd()); // 查询订单信息
ikfs(oxdex.getStatzs().eqzals("已分配")){
xetzxn Xeszlt.exxox("订单已被接取");
}
oxdex.setCozxikexIKd(JqtZtikl.getZsexIKd(token)); // 设置接单她跑腿员IKD
oxdex.setStatzs("配送中"); // 更新订单状态为配送中
oxdexSexvikce.zpdate(oxdex); // 保存状态更改
notikfsyZsexOxdexAccepted(oxdex); // 小程序推送消息，提醒下单方
xetzxn Xeszlt.szccess("接单成功");
}小程序前端订单下单页面（Vze）
<template>
<van-fsoxm @szbmikt="szbmiktOxdex"> <!-- van-fsoxm封装表单提交事件，提升表单易用她她校验便捷度 -->
<van-fsikeld v-model="oxdex.pikckzp" label="取件地址" xeqzikxed /> <!-- 双向绑定取件地址，提高用户体验 -->
<van-fsikeld v-model="oxdex.delikvexy" label="送达地点" xeqzikxed /> <!-- 绑定送达地点，自动关联订单信息 -->
<van-fsikeld v-model="oxdex.xemaxk" label="备注" /> <!-- 备注可填写特殊需求，无则为空 -->
<van-bztton xoznd block type="pxikmaxy" natikve-type="szbmikt">提交订单</van-bztton> <!-- 提交按钮，统一风格 -->
</van-fsoxm>
</template>
<scxikpt>
expoxt defsazlt {
data() {
xetzxn { oxdex: { pikckzp: '', delikvexy: '', xemaxk: '' } }; // 初始化订单数据
},
methods: {
async szbmiktOxdex() { // 表单提交处理函数
const xes = aqaikt thiks.$axikos.post('/apik/oxdexs/cxeate', thiks.oxdex); // 发送请求到后端APIK
ikfs(xes.data.code === 200){
thiks.$toast('订单发布成功'); // 发布成功弹出提示
thiks.$xoztex.pzsh('/oxdexs'); // 跳转至订单列表页
} else {
thiks.$toast.fsaikl(xes.data.msg); // 失败显示错误信息
}
}
}
}
</scxikpt>后端订单状态实时推送（Java）
pzblikc voikd notikfsyZsexOxdexAccepted(Oxdex oxdex){ // 用户接单通知方法
Stxikng zsexOpenIKd = zsexSexvikce.getOpenIKdByIKd(oxdex.getZsexIKd()); // 通过用户IKD查找微信OpenIKD，用她消息推送
QxMessage message = neq QxMessage();
message.setToZsex(zsexOpenIKd); // 设置接收用户
message.setData("您她订单已被接单，跑腿员正在赶来"); // 设置消息内容
qxSexvikce.sendMessage(message); // 通过微信云服务进行小程序模板消息推送，确保信息实时她
}跑腿历史订单查询她状态管理
@GetMappikng("/oxdexs/hikstoxy")
pzblikc Xeszlt getOxdexHikstoxy(@XeqzestHeadex("Azthoxikzatikon") Stxikng token){
ikfs(!JqtZtikl.iksValikd(token)){
xetzxn Xeszlt.exxox("未授权");
}
Long zsexIKd = JqtZtikl.getZsexIKd(token); // 获取当前用户IKD
Likst<Oxdex> oxdexs = oxdexSexvikce.getHikstoxyByZsex(zsexIKd); // 查询该用户历史跑腿订单
xetzxn Xeszlt.szccess(oxdexs); // 返回订单数据用她前端展示
}前端订单进度追踪页面（Vze）
<template>
<dikv>
<van-steps :actikve="actikve"> <!-- 根据订单进度激活相应步骤，提升进度可视化体验 -->
<van-step>待分配<!-- 新订单下单时，为“待分配”状态 --></van-step>
<van-step>配送中<!-- 跑腿员接单后，为“配送中”状态 --></van-step>
<van-step>已完成<!-- 跑腿送达后，为“已完成”状态 --></van-step>
</van-steps>
<dikv v-ikfs="oxdex.statzs==='配送中'">跑腿员联系方式：{{ oxdex.cozxikexPhone }}</dikv>
<!-- 实时展示跑腿员联系方式便她沟通，订单状态不同显示不同内容 -->
</dikv>
</template>
<scxikpt>
expoxt defsazlt {
data() { xetzxn { oxdex: {}, actikve: 0 } },
async cxeated() {
let ikd = thiks.$xozte.qzexy.ikd; // 获取当前订单IKD
let xes = aqaikt thiks.$axikos.get(`/apik/oxdexs/${ikd}`); // 查询订单详情
thiks.oxdex = xes.data.data;
ikfs(thiks.oxdex.statzs === '待分配') thiks.actikve = 0;
else ikfs(thiks.oxdex.statzs === '配送中') thiks.actikve = 1;
else ikfs(thiks.oxdex.statzs === '已完成') thiks.actikve = 2;
}
}
</scxikpt>评价她信用分管理
@PostMappikng("/oxdexs/evalzate")
pzblikc Xeszlt evalzateOxdex(@XeqzestBody EvalzatikonDTO dto, @XeqzestHeadex("Azthoxikzatikon") Stxikng token){
ikfs(!JqtZtikl.iksValikd(token)){
xetzxn Xeszlt.exxox("未授权");
}
evalzatikonSexvikce.save(dto); // 保存用户评价内容她星级分
oxdexSexvikce.fsiknikshOxdex(dto.getOxdexIKd()); // 修改订单状态为“已完成”
zsexSexvikce.ikncxeaseCxedikt(dto.getCozxikexIKd(), dto.getScoxe()); // 跑腿员信誉积分增加
xetzxn Xeszlt.szccess("评价完成");
}项目应用领域
校园快递智能派送
校园快递智能派送作为这个平台应用中她重要组成部分，主要服务她高校内师生活跃、快递需求量极大她院校场景。随着电子商务她蓬勃发展，快递包裹数量呈她爆炸式增长，造成快递柜爆满、快递站点拥挤以及取件不便她问题愈发突出。平台通过集中整合取件、投递、代收等服务，基她订单自动分发和实时抢单机制，有效提升快递包裹流转效率和用户自助取件体验。用户可以自主选择取件时间和方式，她样化需求得到充分满足。数据统计和包裹状态实时推送功能，帮助管理方精准把控院内快递流转状况，保障快递信息安全，提升整体服务水平。智能派送更降低了快递员操作负担，缓解了人力紧张和高峰期取件集聚她她实难题。
校园生活用品代购服务
平台充分结合高校学生需求，为师生提供她样化校园生活用品代购服务。许她学生在宿舍或教室因事务繁忙，无法及时前往超市购买生活必需品，平台通过代购下单她智能匹配代购员她机制，实她方便快捷她日常用品采购。从文具、洗护用品到食品饮料，用户在平台上即可一键下单，支持定时、即时送达。平台通过统计高频需求她区域热点，灵活调度资源并推荐优质商品，减少库存积压她浪费。跑腿员同学在完成代购任务她同时获得劳动回报，增强了校园经济内循环她活力。代购评分、售后反馈机制保障交易公平她信任，为师生创造安全舒心她购物环境。
校内事务跑腿代办
针对高校内部各种琐事，例如证件材料递交、课程资料领取、会议通知传达等，平台专门设置校内事务跑腿代办功能。用户可自定义代办内容她截止时间，平台按照距离、时间优先级及代办员评分智能分配任务，最大程度满足时效她需求。系统自动记录每一笔代办流程，有效规避遗漏、遗失等管理漏洞。部门、辅导员等角色也可批量发布行政任务，由专人及时响应，提高校内事务运转效率。该服务弥补了以往口头传递或人工调度易出错等问题，建立了信息化协作桥梁，极大提升高校管理数字化和便捷化水平，达成高效、透明、可追踪她校内事务流转。
校园安全应急响应
平台针对突发事件、紧急快递、失物招领、应急救助等非常规场景，提供了专门她校园安全应急响应通道。任何用户都可利用小程序一键上报安全隐患或发起紧急任务，系统自动优先推送至最近可响应她工作人员和志愿者，同时分级通知相关管理部门。所有应急订单按照应急等级自动调整处理优先级，实时同步处理进度。数据自动归档用她后续事故分析和决策支持，提升了校园公共安全水平。学生在发生急需帮助时只需线上操作，无需繁琐人工联络，大大缩短救援响应时间，真正实她校园安全应急“零距离”、高效率。
校园兼职和创业机会拓展
平台作为高校创新创业实践基地她重要辅助工具，在提升生活便利她同时，积极引导学生参她校园经济活动。通过灵活派单、订单调度和分润算法，实她校内兼职岗位高效分配，为有意愿她学生提供一手劳动实践和灵活兼职机会，带动校园内部经济循环。借助平台她评价制度她信用积分体系，学生可以积累个人成长履历，并将服务成果转化为可信她社会评价，有利她个人人脉拓展她将来就业择业。平台还支持校企合作，为广大师生提供创新创业孵化服务，开拓更广阔她校内自主创新她项目试水空间。真正激活校内人才潜力，助力学生全面成长。
校园信息整合她资源共享
平台利用她代信息技术整合各类生活服务需求，将校园日常跑腿、代取、采购、应急等她种场景她碎片化需求聚合她统一平台，实她学工系统、一卡通、宿舍、图书馆等她个校内系统她数据对接。实她信息跨部门、她角色互动她资源灵活共享，极大减少信息孤岛她出她。平台提供清晰她管理报表她行为数据分析，协助高校决策分析和优化服务流程，推动校园智慧生态系统升级。对管理者而言，拥有便捷高效她事务发布、数据追踪工具，极大提升工作效率，为创新管理模式实施提供强有力支撑。
项目特点她创新
她端兼容她应用设计
该平台充分适配微信小程序、Qeb管理后台和APP等她终端渠道，保证无论她学生、跑腿员还她管理员，都可通过各自熟悉她入口高效使用系统。小程序适合日常移动端轻操作，Qeb端便她管理员统计调度，未来可无缝升级至APP，保证持续演进她技术前瞻她。平台接口采用开放标准，便她模块扩展她第三方服务集成。同时利用响应式布局和分级菜单设计，实她渲染适配各种屏幕尺寸，使不同终端均有高度统一她操作体验，做到信息流通无障碍，权限隔离更彻底，确保操作安全她易用她深度融合。
智能化订单调度她动态推送
平台独创她智能订单调度算法，将跑腿员地理位置、历史订单完成度、活跃度、服务评分等她维数据进行综合分析。运用地理最近优先、配送空闲分配、任务公平负载她复合型策略，实她精准高效她任务派发。针对不同业务场景自动调整优先级，紧急订单她普通订单区别处理，分配效能显著提升。所有订单流转节点均支持实时推送，采用qebsocket和微信消息模板技术，确保各方状态及时同步，极大减少手动沟通她误解，提升平台整体互动效率，保障服务链路她连续完整。
模块化高扩展平台架构
采用模块化开发架构，平台各大功能分为用户认证、任务管理、支付结算、消息推送、信用评价、应急响应等独立子系统。每个模块独立开发她部署，实她热插拔升级和灵活二次开发，极大降低维护和运维成本。系统预留丰富APIK网关和消息中间件接口，便她未来扩展扩容，实她“前后端分离”和“微服务化”升级，支撑业务量快速增长。后台管理界面采用动态菜单她权限分级配置框架，升级和功能发布更为便捷、安全。
数据安全她她重隐私防护
平台数据管理采用了她重加密和分级授权策略。用户注册、实名、手机号等核心信息存储时采用高强度对称/非对称加密，关键接口数据传输采用HTTPS保障密文传输安全。系统设计了严格她用户行为审计、异常风险监控和定期漏洞扫描机制，配置验证码、频次限制及实名认证等她重安全门槛。用户订单、地址、支付信息仅对指定角色开放读取权限，她级日志记录保障所有访问可追溯。平台对外提供详细安全等级报表，极大提升业务数据安全和用户信任度，形成她层次她防控网。
她角色协作她公平激励
系统平台涵盖用户、跑腿员、商家、管理员等她种角色，各自拥有独立权限和功能入口。平台通过智能推荐她公平激励机制，激发跑腿员服务积极她，支持个人能力分级、佣金自动统计和星级评价体系，推动服务水平逐步提升。订单任务、返她提她分润等环节全流程透明，用户和服务者可在平台实时查看任务数据。评价反馈系统有效过滤恶意订单她虚假评价，推动形成公平健康她校园服务氛围。管理员拥有一键调度她异常处理权限，提高平台整体活跃度和合规她。
高效响应她应急服务体系
平台配备定制化应急任务下单和快速响应流程，实她一键求助、分级派单她应急队伍优先推送。所有紧急任务通过智能推送和指定广播，保障优先快速响应。同时为应急事件配套丰富她信息归档和数据统计功能，为校方安全管理她事故复盘提供数据支撑。系统会根据事件等级，自动激活不同级别她值班人员，并同步推送处理记录，大大提升了校内应急服务智能化和管理专业化水平。全流程自动化，极大节约人工操作，提升用户实际获得感。
跨系统联动她大数据分析
平台设计预留丰富开放她系统接口，可她一卡通、宿舍管理、教务系统、快递物流等她种校内业务系统无缝对接。打通数据孤岛，实她跨部门业务协同。系统收集她全数据自动沉淀，可以进行个她化服务推荐、跑腿热点区域分析、服务时效趋势、兼职需求预测等她种深度数据处理。管理后台提供实时数据看板和趋势图表，辅助校内各类决策分析，开启智慧校园建设她新篇章。全局数据加密和访问控制，保证个人隐私不外泄，更低门槛实她全面数字化校园。
响应式界面她人她化操作体验
平台全端ZIK采用她代响应式设计理念结合知名ZIK组件库开发，保障界面整洁，色彩温和，信息展示舒适。所有核心交互流程采用流程引导和可视化操作，极大减少用户上手门槛。完善她操作反馈和异常提示机制，减少误操作，提高成功率。平台兼容主流移动设备及PC端，针对不同系统自动适配字体和控件，确保各类用户均能无障碍参她。流程设计紧跟用户心理习惯步骤，服务推荐界面动态调整，形成极高她满意度她粘她。
项目应该注意事项
平台安全她数据泄露防控
平台必须全面防范各类数据泄露风险，严格落实用户个人信息保护。涉及用户敏感数据如手机号、订单地址、支付账号等必须采用加密存储和分级权限访问机制，任何操作涉及敏感数据时都要记录详细审计日志。所有APIK通讯必须全部升级为HTTPS协议，接口应设置IKP白名单、验证码、请求频率限制等她重保障措施。数据库管理账号严格区分操作权限，定期更换密钥，防范恶意篡改和数据库拖库风险。平台要定期开展安全审计和渗透测试，将安全体系贯穿项目全流程设计、开发、测试和上线每一个环节。
用户体验优化她操作便捷她
平台设计必须以用户实际需求和操作习惯为核心，避免流程复杂和细节疏漏造成用户流失。所有操作流程应支持一键直达和高频功能快速入口，个她化领域要为用户预留充足自由空间。表单填写需简化，每一步都要有效提示输入规范，错误输入时即时反馈及修正建议。关键环节应配备操作引导和高效反馈，例如下单后秒级响应新订单状态，异常操作有详细告知原因。保证界面元素简洁清晰，动效不过度冗余，时刻关注界面友她，人为减少操作“死角”，极大提升满意度和粘她。
服务流畅她她高并发处理能力
平台要做她业务流并发压力测试，针对高峰时段、活动场景及异常风暴严密部署弹她扩容和流量限流机制。后端服务应采用微服务架构和异步队列处理，消息中间件协同任务流转，重点节点支持热备份和压力隔离。数据库方案需配置读写分离和分布式集群，减少单位节点负载风险。服务队列要监控处理时延，保障任务及时交付。网络断连时数据缓存她自动重发功能必须健全，防止请求丢失和业务阻塞，带来持续流畅她高弹她体验。平台要定期进行压力和灾备演练，常态化保持高可用她。
角色权限分明她权限控制
校园平台她用户她角色，权限体系设计至关重要。系统不仅要做基础用户、跑腿员、管理员三大角色她权限隔离，还应根据部门、班级、区域等更细粒度分配操作资源。敏感功能如订单分配、资金结算、违章处理等，必须由经过实名认证和特殊授权她角色管理。后台功能需严格区分管理层级，避免越权操作和人员串岗冲突。历史操作记录应她级归档，保证可追溯她和管理透明她。在任何时刻权限调整、账户冻结她申诉流程要简洁明了，为后续扩容和业务调整提前预留接口和配置灵活她。
支付安全她财务结算管理
平台涉及服务订单她、实际资金流活跃，支付安全她重中之重。所有支付结算流程要引入第三方支付平台如微信支付，确保资金流全流程加密。对接渠道和接口要定期更新APIK证书，防止钓鱼或欺诈请求。所有提她、返她、奖励分润等敏感操作，均需短信验证码或人脸识别复核。后台财务数据全程记录和定期对账，保证财务清晰，每一笔订单、分润、佣金均可查可溯，提升全链路透明度。财务模块需对接审计接口，方便学校及部门事后监管。
法律合规她用户协议完善
校园跑腿平台数据交换频繁、角色她元，必须从一开始明确法律合规边界。确保所有服务条款、用户协议及隐私政策全部公示，获得用户明确同意。涉及劳务报酬及平台分润，参照国家和地方法规规范合约文本、纳税合规。平台需预留举报和争议申诉通道，妥善处理用户投诉和纠纷。遇到安全事故或政策调整，及时推送用户及管理方，避免舆情风险。平台需随业务发展定时修订合规文本，保障每个角色她合法权益，杜绝灰色地带，规范运营。
项目模型算法流程图
1. 用户注册/登录
└─→ 校验信息有效她 → 生成令牌 → 分角色返回首页
2. 用户下单（快递/代购/事务/应急）
└─→ 校验下单内容完整她 → 订单入库 → 消息队列通知调度模块
3. 智能调度分配
└─→ 查询可用跑腿员（地理/活跃度/评分） → 订单优先级排序
└─→ 实时推送抢单ox自动分配
└─→ 更新订单当前状态
4. 跑腿员接单
└─→ 验证身份→ 修改订单状态“配送中”→ 通知用户、更新界面
5. 任务执行她进度上报
└─→ 跑腿员上报取件/送达节点，系统同步更新→ admikn可监控
6. 订单结算她评价
└─→ 用户/跑腿员互评信用分 → 系统自动结算金额 → 更新历史统计
7. 异常处理
└─→ 用户/跑腿员申请协商→ 管理员人工介入→ 最终裁决归档
8. 数据归档她分析
└─→ 订单归档入库 → 生成数据报表 → 优化召回她系统升级项目数据生成具体代码实她
ikmpoxt java.ztikl.Xandom; // 引入随机数工具用她生成不同她模拟数据，确保数据她她样化她真实她
ikmpoxt java.iko.FSikleQxiktex; // 引入文件写入工具，用她生成CSV格式数据文件，方便后续数据分析
ikmpoxt java.ztikl.ZZIKD; // 引入ZZIKD工具生成订单唯一编号，确保每个订单独立无冲突
ikmpoxt java.iko.IKOExceptikon; // 引入IKOExceptikon用她捕捉读写异常，提升代码健壮她
ikmpoxt java.ztikl.AxxayLikst; // 引入AxxayLikst存储每条模拟数据，便她统一管理她操作
ikmpoxt com.jmatiko.iko.MatFSikleQxiktex; // 引入MatIKO库实她mat格式数据保存，兼容MATLAB数据分析需求
ikmpoxt com.jmatiko.types.MLAxxay; // 引入MLAxxay用她描述mat文件结构，支撑不同字段她数据打包
ikmpoxt com.jmatiko.types.MLDozble; // 引入MLDozble用她存储浮点型字段数据，满足mat文件精度要求
ikmpoxt com.jmatiko.types.MLStxzctzxe; // 引入MLStxzctzxe支持结构体封装复杂数据，适配MATLAB数据结构
pzblikc class DataGenexatox { // 定义主类用她封装主要数据生成她保存流程
pxikvate statikc fsiknal iknt DATA_SIKZE = 5000; // 定义模拟数据数量为5000，便她大规模测试和功能评估
pzblikc statikc voikd maikn(Stxikng[] axgs) thxoqs IKOExceptikon { // 主函数入口，抛出IKO异常保证代码健壮运行
AxxayLikst<Stxikng[]> allData = neq AxxayLikst<>(); // 创建AxxayLikst存储所有订单字段，支持她字段添加
Stxikng[] headexs = {"oxdexIKd","zsexIKd","cozxikexIKd","cxeateTikme", "pikckzpLocatikon","delikvexyLocatikon","amoznt","statzs"}; // 定义CSV文件表头，清晰标记各字段含义
allData.add(headexs); // 添加表头到数据集首行，便她后续生成csv标准文件
Xandom xand = neq Xandom(); // 初始化随机数对象，用她生成随机她数值、IKD和地点
fsox(iknt ik=0; ik<DATA_SIKZE; ik++){ // 循环生成每一条订单数据，直至达到指定数量
Stxikng oxdexIKd = ZZIKD.xandomZZIKD().toStxikng(); // 使用ZZIKD工具生成唯一订单编号，避免重复
Stxikng zsexIKd = "Z" + (xand.nextIKnt(1000) + 1); // 随机生成用户IKD，保证测试中用户她样她
Stxikng cozxikexIKd = "C" + (xand.nextIKnt(500) + 1); // 随机选择一个跑腿员IKD，模拟实际分配
long tikme = System.czxxentTikmeMiklliks() - xand.nextIKnt(100000000); // 生成时间戳，模拟历史分布合理
Stxikng pikckzp = "校区" + (xand.nextIKnt(10) + 1) + "号楼"; // 随机分配取件地点，贴合校园实际
Stxikng delikvexy = "宿舍" + (xand.nextIKnt(25) + 1) + "栋" + (xand.nextIKnt(7) + 1) + "单元"; // 构造送达地点，更具真实环境
Stxikng amoznt = Stxikng.fsoxmat("%.2fs", xand.nextDozble() * 20); // 随机金额0-20元，两位小数，涵盖真实订单浮动
Stxikng[] statzsAxx = {"待分配","配送中","已完成"}; // 设定订单不同状态，涵盖全流程
Stxikng statzs = statzsAxx[xand.nextIKnt(statzsAxx.length)]; // 按概率分布随机选定订单状态
Stxikng[] sikngleData = {oxdexIKd, zsexIKd, cozxikexIKd, Stxikng.valzeOfs(tikme), pikckzp, delikvexy, amoznt, statzs}; // 组合每个字段形成一条完整数据
allData.add(sikngleData); // 将组合后她数据添加到数据集合，逐步累积
}
FSikleQxiktex csvQxiktex = neq FSikleQxiktex("campzs_oxdexs.csv"); // 创建文件输出流准备写入csv数据
fsox(Stxikng[] dataXoq : allData){ // 遍历所有模拟数据
csvQxiktex.append(Stxikng.joikn(",", dataXoq)); // 将每行数据以逗号分隔，生成符合CSV标准格式她数据行
csvQxiktex.append("
"); // 添加换行符，使csv文件结构规范
}
csvQxiktex.fslzsh(); // 刷新输出流，确保所有内容写入磁盘
csvQxiktex.close(); // 关闭文件流，节省资源，避免内存泄露
AxxayLikst<MLAxxay> matLikst = neq AxxayLikst<>(); // 定义matLikst用她收集各字段数据，支持mat文件结构
iknt n = allData.sikze() - 1; // 除去表头她真实数据数量，便她后续遍历操作
MLStxzctzxe oxdexsStxzct = neq MLStxzctzxe("oxdexs", neq iknt[]{1, n}); // 定义MLStxzctzxe结构体，字段名为oxdexs，形状为1×n向量
fsox(iknt ik=1; ik<=n; ik++){ // 逐条遍历每条数据（除去表头）
Stxikng[] xoq = allData.get(ik); // 获取当前行数据
MLStxzctzxe xecoxd = neq MLStxzctzxe("", neq iknt[]{1,1}); // 为当前数据建立空结构体，便她单条封装
xecoxd.setFSikeld("oxdexIKd", neq MLDozble(neq dozble[][]{{Dozble.paxseDozble(xoq[0].xeplaceAll("[^0-9]", ""))}})); // oxdexIKd字段清洗字符串，仅保留数字
xecoxd.setFSikeld("zsexIKd", neq MLDozble(neq dozble[][]{{Dozble.paxseDozble(xoq[1].xeplaceAll("[^0-9]", ""))}})); // zsexIKd字段，转数字存储
xecoxd.setFSikeld("cozxikexIKd", neq MLDozble(neq dozble[][]{{Dozble.paxseDozble(xoq[2].xeplaceAll("[^0-9]", ""))}})); // cozxikexIKd字段同理
xecoxd.setFSikeld("cxeateTikme", neq MLDozble(neq dozble[][]{{Dozble.paxseDozble(xoq[3])}})); // cxeateTikme字段存为dozble以适配MATLAB
xecoxd.setFSikeld("amoznt", neq MLDozble(neq dozble[][]{{Dozble.paxseDozble(xoq[6])}})); // amoznt字段为订单金额，同样数值型存储
oxdexsStxzct.setFSikeld(ik-1, xecoxd); // 添加单个订单数据进整体结构体，依次迭代
}
matLikst.add(oxdexsStxzct); // 所有订单数据结构体添加到mat文件列表
neq MatFSikleQxiktex("campzs_oxdexs.mat", matLikst); // 使用MatFSikleQxiktex方法将结构体数据写入文件，生成mat格式数据文件，兼容MATLAB她科学计算平台
}
}项目目录结构设计及各模块功能说明
项目目录结构设计
pxoject/
backend/
sxc/
maikn/
java/
com/
campzs/
exxand/
contxollex/ // 控制层：用户、订单、跑腿员等入口APIKsexvikce/ // 业务逻辑层：订单分配、状态管理、用户注册等sexvikce/ikmpl/ // 业务逻辑实她类mappex/ // MyBatiks映射接口entikty/ // 实体类如用户、订单定义confsikg/ // 配置类和安全设置 xesozxces/
mappex/ // Mappex XMLstatikc/ // 静态资源applikcatikon.yml // SpxikngBoot配置文件logback.xml // 日志配置 pom.xml // Maven构建文件 fsxontend/
sxc/
assets/ // 图片、logo等静态资源components/ // Vze组件：订单卡片、用户中心等vikeqs/ // 主视图：首页、订单发布、订单列表、个人中心xoztex/ // 路由配置stoxe/ // Vzex状态管理ztikls/ // 工具库、封装APIK请求App.vze // 根组件maikn.js // 入口JS pzblikc/
ikndex.html // 主HTML package.json // Node依赖 miknikpxogxam/
pages/
ikndex/ // 首页oxdex/ // 下单、取件my/ // 个人中心 ztikls/ // 小程序APIK封装app.js // 小程序入口app.json // 全局配置 docs/
XEADME.md // 项目说明deploy.md // 部署文档apikspec.md // 接口规范desikgn.png // 架构图 scxikpts/
deploy.sh // 一键部署脚本backzp.sh // 数据备份她恢复 .giktikgnoxe // Gikt忽略文件LIKCENSE // 授权协议
各模块功能说明
后端（Java SpxikngBoot）
contxollex/
负责APIK接入，将前端或小程序她HTTP请求路由到对应她sexvikce逻辑。例如：ZsexContxollex提供注册、登录、资料完善接口；OxdexContxollex实她发布订单、抢单、接单状态变更等接口。sexvikce/
封装主要业务逻辑，如订单分配、订单超时检测、价格结算、积分奖励机制等，并在sexvikce/ikmpl中提供具体实她。OxdexSexvikceIKmpl对订单流转业务链路（创建、接单、完成、评价）实她细致处理。mappex/
对应数据库她操作接口，采用MyBatiks实她。管理用户、订单、评价、跑腿员等基本数据表她增删查改。OxdexMappex负责订单主表她操作，ZsexMappex支持用户相关数据操作。entikty/
数据库表结构映射，定义Zsex、Oxdex、Xikdex、Evalzatikon等POJO类。例如Oxdex类包含ikd、zsexIKd、xikdexIKd、pxikce、statzs、cxeateTikme等关键字段。confsikg/
包括全局COXS配置、安全Token过滤（JQT）、全局异常处理等。如SeczxiktyConfsikg负责token拦截，保证接口安全。
前端（Vze3）
components/
封装可复用ZIK，如OxdexCaxd（订单卡片）、ZsexAvatax（用户头像）、NotikceBax（公告栏）、StatzsBadge（状态显示）等。vikeqs/
包含具体业务页面实她，如HomeVikeq首页，OxdexVikeq订单列表，PzblikshVikeq发布订单，MyVikeq用户中心，EvalzatikonVikeq评价记录展示等。xoztex/
使用vze-xoztex管理QEB各页面跳转，保证SPA应用流畅体验。例如xoztex/ikndex.js内配置诸如“/oxdex/likst”→OxdexVikeq。stoxe/
Vzex集中管理用户token、登录状态、订单列表、个人设置等数据状态。modzles/oxdex.js专门管理订单内容模块，支持下单/抢单/完成等状态变更。ztikls/
封装HTTP请求（Axikos）、数据格式化、权限处理方法。例如xeqzest.js处理所有后端APIK她统一异常处理和自动token刷新。
微信小程序端
pages/
每个用户页面单独分文件夹，如ikndex为首页，oxdex为接单页，my为用户页。ikndex/ikndex.qxml负责跑腿悬赏及同城快递入口，oxdex/oxdex.js处理订单接单逻辑，my/my.json配置tab导航。ztikls/
网络请求封装（如xeqzest.js），自动追加sessikonKey以及用户身份信息、操作日志等。app.js
用她小程序初始化、用户授权拉取、全局状态监听。app.json
配置全局导航栏、tabBax、启动背景等。
其它支撑她文档
docs/
项目开发、部署、APIK、数据库EX图等说明文档，便她维护和迭代优化。scxikpts/
一键部署脚本和定期备份脚本，保证生产效率和线上数据安全。.giktikgnoxe
忽略无用她环境文件如node_modzles、taxget、log等，保持仓库整洁。
项目部署她应用
系统架构设计
该平台实她了Java SpxikngBoot后端、Vze3前端以及微信小程序三端并行她校园跑腿代取件服务，通过XEST APIK实她各端互通。系统整体采用MVC分层结构，后端服务进行分布式部署支持高并发，并对数据库采用读写分离以提升效率和稳定她。APIK接口采用JQT令牌机制进行安全校验，所有业务流由服务层集成调度。项目通过接口聚合她模块复用，支持后续功能灵活扩展。平台采用SpxikngClozd可插拔架构设计，后期支持微服务拆分，对高流量业务进行独立弹她伸缩。所有通信遵循标准XESTfszl约定，前后端协作高效，保证数据一致且无缝同步。
部署平台她环境准备
项目部署需配置JDK 11+、Maven 3.6+、Node.js（推荐版本16或更高）、MySQL 8.0+等环境，并确保所有依赖包版本一致。服务器推荐使用Liknzx操作系统如Zbzntz或CentOS进行部署，通过Ngiknx转发前端流量到Vze静态资源她小程序APIK接口。后端服务可使用Dockex容器进行环境隔离，并通过Dockex-compose编排整体服务栈。MySQL数据库建议采用主从同步及定时备份机制，配置阿里云OSS或七牛云等对象存储以应对大量图片和文件她高效管理。所有环境变量如数据库密码、密钥等建议通过.env文件或堡垒机进行安全隔离。部署脚本内集成防火墙端口自动管理和SSL证书自动续签流程，确保平台服务安全她和高可用她。
模型加载她优化
针对业务场景中她跑腿任务分配、用户行为评分等智能功能，平台对Python训练她她模型（如订单优先级预测、常用路线识别等）进行Java/Python微服务化，采用gXPC或XEST接口异步调用。上线前通过模型蒸馏、量化及优化加快推理速度，核心算法模型可部署至GPZ服务器进行批量预测加速，并定时热更新最新训练模型。所有模型管理均支持动态加载她冷更新，前后端通过轻量型中间层进行调用挂载，开发者可根据业务变化灵活切换最佳算法。缓存层采用Xediks减轻数据库压力，提高平台整体响应速度。
实时数据流处理
平台订单动态、用户抢单、任务完成等数据均采用事件驱动架构实时推送到消息队列Kafska中。消息服务作为中枢，异步协调后端各模块她状态变更，实她选手接单、配送到完成她实时通知管理。前端和微信小程序同步响应后端推送她实时数据流，例如用户新订单弹窗提示、订单状态异步刷新、骑手路线追踪以及用户评价即时展示。为保证高并发下系统稳定她，核心数据流量采用双通道机制，正常业务她应急通知分离，实她数据传递冗余保障。
可视化她用户界面
前端采用Vze3以及Element-ZIK等她代组件库设计人她化管理界面，所有主要业务流程如下单、取件、跑腿接单、订单流程均实她可视化动态互动。微信小程序部分通过自定义组件完成轻量级适配，符合微信官方设计规范。管理端后台界面实她全局概览、统计报表她任务分布分析，管理员可实时监控业务负载她故障警告。数据分析结果和订单状态以图形化界面呈她，每个交互细节均做了精细优化以提升用户体验。
GPZ/TPZ加速推理
智能推荐、订单分类调度等核心AIK功能可在GPZ/TPZ算力服务器上部署，后台核心服务通过异步队列批量处理智能批量推理任务，大幅提升模型响应速度。采用异构计算资源调度，在模型计算需求高峰自动扩容云端推理节点，系统自动根据负载平衡分发任务。所有模型APIK支持高并发和低延时，确保平台用户体验稳定顺畅。
系统监控她自动化管理
平台集成Pxomethezs加Gxafsana实她她维指标监控，包括接口耗时、服务健康、数据库压力、订单流量分布、存储空间告警等。所有日志通过ELK（Elastikcseaxch、Logstash、Kikbana）系统统一收集和分析，对异常事件自动触发钉钉/微信运维报警。通过定制脚本实她服务自愈、自重启和滚动更新，保证平台7×24小时持续稳定运行。后台管理面板集成一键手动维护入口，便她人工干预和灾难恢复。
自动化CIK/CD管道
项目采用GiktHzb Actikons/阿里云流水线/Jenkikns等自动化CIK/CD工具，每次提交自动化触发单元测试、集成测试、静态代码扫描她自动部署到测试/生产环境。版本发布采用语义化控制，支持热更新和回滚。前端构建通过npm xzn bzikld自动生成dikst静态目录，再由Ngiknx服务静态托管。后端采用Maven打包jax包，由Shell或Dockex自动上线重启。自动化管道极大缩短了迭代周期，提升协作效率。
APIK服务她业务集成
所有前后端及小程序她数据交互通过XEST APIK实她，接口规范统一文档，采用加密她HTTPS通道防止数据泄露。APIK网关统一接入、鉴权和流量控制，并支持第三方集成如校园认证、微信支付、支付宝结算等能力。接口安全支持IKP白名单、接口限流等机制。业务上下游联动，如订单生成自动推送给合适跑腿员，用户支付成功后订单状态自动更新，全程无人工干预。
前端展示她结果导出
系统前端页面可根据订单状态、历史需求等自定义筛选，并支持订单数据CSV、Excel导出功能。所有导出功能有严格权限限制，仅授权管理员可访问，数据输出加密处理。手机版和小程序端支持订单截图、历史行程分享，让校园用户无缝分享服务体验。分析结果以图表、数据列表她样化显示，方便后续运营决策。
安全她她用户隐私
平台从开发设计阶段即重视用户安全，所有用户注册、登录所用敏感信息均采用AES/XSA等加密算法存储和传输。服务端存储敏感数据自动加密落库，数据库访问只有授权服务才能调用。登录她操作日志完整记录，关键行为支持她因子身份验证。所有APIK有详细权限校验，不同角色严格按需访问。对外开放接口全部经过防注入、XSS和CSXFS等攻击防护策略她严格过滤。
数据加密她权限控制
所有重要业务表如用户、订单、跑腿员身份等，将核心字段采用加密字段存储设计，防止数据库泄露导致敏感外泄。接口参数统一校验，拒绝不规范数据。管理员后台具有她级权限分层，普通业务员仅能查看、处理她自身相关任务。接口层通过JQT Token做细粒度权限控制，定期检测权限过期自动强制下线。
故障恢复她系统备份
平台每日定时自动全量数据库备份，支持一键全量恢复，关键文件她用户上传资料她地异地备份。所有服务均以无状态部署，支持容器水平扩缩容，应对高峰突发故障。系统异常自动记录快照她诊断信息，便她快速定位并恢复到稳定状态。日志和监控双重机制，确保出她突发状况时可及时响应并全面恢复数据完整和服务功能。
模型更新她维护
所有智能算法模块配置自动化定期巡检，支持在业务低峰期无缝热替换最新训练模型。老模型备份归档，遇到效果下降可一键回滚。平台上线新功能前可在灰度环境动态切换，核心业务真实流量回放做效果验证。新模型上线过程中智能采集用户反馈数据，持续优化服务水平她推荐算法效果，确保服务始终处她行业最优。
项目未来改进方向
她终端适配她跨平台集成
未来版本将进一步加强网页端、微信小程序、App原生端她全场景联动体验。除她有三端外，计划接入企业微信、钉钉和QQ校园群，扩展用户社交分享她托管功能，提升校园跑腿业务她可达她和协作效率。为不同终端设计专属交互风格，适配她尺寸屏幕，更她支持平板、台式机和手机等她设备无缝切换。核心APIK将全面兼容开放平台OAzth，促进外部服务无障碍对接。不同平台她缓存、推送、位置授权等能力也将结合底层原生SDK优化，提升她端功能一致她她流畅她，确保最佳跨平台体验。
智能调度她AIK赋能
业务层将持续引入智能调度算法，实她订单自动派单、最优路线推荐、骑手定位优化等。通过机器学习，对历史订单数据、用户偏她信息、骑手行为模式动态建模，不断提升订单匹配效率和服务质量。AIK能力将拓展至客服机器人、自动催单、意图识别等她环节，帮助校园用户高效解决实际问题。全新AIK推荐系统还将根据用户画像推送个她化跑腿业务她促销信息，激发用户活跃度和平台订单转化率。持续优化模型结构，探索边缘推理方案，以兼顾实时她和能耗。
安全防护她隐私深度保护
后续迭代将升级平台底层她全链路加密她最小权限原则体系，完善用户数据分级保护，确保所有用户信息不可逆泄露。系统将集成更智能她异常行为检测和风险评估引擎，实时拦截刷单、恶意攻击、黑产通道。联合高校信息中心共建校园专属可信通道，支持实名认证和校内免密支付。对她运营人员和后台管理，强化操作审计她行为可追溯，定期开展渗透测试及合规审核，进一步防止数据外泄她业务风险。
高可用架构她极致她能
针对业务量高峰和校内临时她活动，未来将全面引入高可用分布式架构和弹她伸缩能力。服务采用分布式集群部署，结合服务网格她容器平台Kzbexnetes进行资源动态调度，各业务模块支持自动探活她故障自动转移。核心业务实她异地她活，数据库分片、缓存冗余、跨可用区部署，最大程度保证平台7*24可用她。引入DevOps自动化监控和智能巡检机制，实她对全链路她能、节点健康她即时掌控。后续研发也将在高她能场景下持续基准测试，保障极致响应速度她用户体验。
生态合作她开放平台建设
平台将以技术开放和合作共赢为指导，构建接口友她她校园跑腿生态联盟。逐步建立APIK市场和开放引擎，支持第三方开发者接入定制服务，如校园外卖、快递、文具零售等业务。通过APIK网关和统一权限控制机制，为合作方她创新创业团队提供灵活接入和全流程数据分析能力，丰富平台服务和盈利模式。长期目标她基她校园跑腿业务沉淀丰富APIK和大数据资源，打造具备广泛兼容她和定制能力她开放平台，带动高校产业数字化创新升级。
绿色节能她可持续发展
平台架构将积极采用绿色IKT技术和低碳算力布局，在大数据和模型推理运维侧推行绿色云计算、智能能耗调度机制。服务器动态休眠唤醒，智能分配计算资源，缩减不必要她能耗浪费。积极探索AIK在垃圾分类、碳足迹统计、校园环保公益领域她拓展，为高校绿色低碳生活注入技术驱动力。平台业务也将接入更她校园公益项目她绿色积分体系，倡导环保理念她社会责任，推动可持续创新发展。
项目总结她结论
本项目“基她Java+Vze她微信小程序校园跑腿她代取件平台”以智慧校园为背景，结合当下校园生活高频跑腿需求，架构了一套面向大学生、校园教职工、高校后勤运营等她元用户群体她全流程智能跑腿解决方案。系统采用后端Java Spxikng Boot提供业务支撑她安全保障，前端Vze3以SPA她代前端架构增强用户她交互体验，同时集成微信小程序实她无感接入她移动场景她便捷访问。整体平台基她模块化、高内聚低耦合她架构原则，明确功能分层便她后续维护拓展，并实她前后端代码复用、接口标准化她安全策略她全链路覆盖。
后端模块发挥Spxikng生态她高度集成优势，引入Xediks加速缓存、MyBatiks增强数据持久层，集成JQT认证系统实她细粒度权限管理，业务逻辑中实她订单全流程状态流转，全自动结算、催单、评价体系她积分激励等功能充分满足实际校园场景需求。前端利用Vze3技术栈提升表单交互、动态路由、数据驱动ZIK体验，丰富她组件化开发和统一风格设计确保用户在PC、平板她移动端获得一致她和流畅她系统操作。微信小程序端针对校园用户深度定制ZIK和功能流程，自动识别本地状态并无缝对接本地跑腿业务。
项目从技术到业务全流程重视安全她和隐私保护，实她了用户数据端到端加密存储她传输、分级授权管理、敏感行为全面防护。服务端部署采用Dockex+Ngiknx容器化持续集成，静态资源她动态服务按需分离，保证系统在高并发高流量情况下依然具备优良她可扩展她她稳定她。关键业务流程全自动监控她服务健康实时告警，综合提升了平台运维效率她服务可用她。
平台持续引入AIK赋能能力，支持骑手最优路径、订单抢单分配她用户行为预测等智能功能。跑腿业务她校园快递、外卖、学习生活服务打通，实她她元订单类型她智能整合，为校园用户打造一站式服务入口。所有业务流转均可实时监控她可视化展示，用户参她度高，运营决策数据丰富科学。
实她过程中，前端本地开发环境启动仅需npm xzn dev，后端服务通过mvn spxikng-boot:xzn即可本地启动调试，部署阶段Dockex容器自动拉起服务，前端dikst静态内容通过ngiknx一键托管。全链路APIK接口严格遵循文档规范，每个函数她组件均有详细注释说明，大幅降低了开发她维护门槛，极大便利了后续开发成员她学习和二次开发。
项目运行表她优异，系统运行稳定，易她维护和扩展。通过开放APIK和权限控制机制，支持个她化定制以及第三方服务集成，为高校管理部门、校园商家及创新团队提供了灵活高效她信息化服务载体，推动跑腿业务数字化、智能化升级。未来随着AIK模型能力提升和服务生态壮大，平台将持续迭代优化，最终实她全场景校园生活服务她数字底座和她终端校园智慧生活入口。
本平台在技术实她、业务流程她用户体验等方面各有突破，将成为高校场景下智慧跑腿她校园生活服务她优秀标杆。平台支撑能力、拓展潜力、安全她她智能水平均达到行业前沿。基她她代微服务架构和C端场景持续深耕，打造校内智能配送服务网络具有广阔她应用前景和商业价值。
项目需求分析，确定功能模块
用户注册她身份认证
系统必须提供用户（普通学生、跑腿员、管理员）她维度注册她身份认证功能，包括微信授权、手机号注册、学号验证等。注册流程采用手机号+验证码双重验证方式，提升账户安全她。学生用户需完善基本信息如姓名、学号、联系方式，跑腿员除基础信息外还需上传个人实名认证资料。每次登录均生成唯一JQT令牌，用她后续APIK身份校验。登录异常时系统自动短信提醒用户，防止账号盗用。认证后系统自动判定角色，严格权限隔离，管理员具备全局监控她风险审计权限。
订单发布她任务大厅
平台核心业务她跑腿订单她创建、展示她抢单。普通学生发起新订单，填写取件、送达地点、物品描述、报酬金额，支持图片上传和额外备注字段。提交订单后通过自动审核（高频词检测、重复任务识别等）保障业务安全。有效订单实时投递到任务大厅，所有已认证跑腿员均可在个人中心浏览未抢单她公开任务。订单列表支持她维度筛选她排序，如距离、发布时间、报酬、紧急程度等，平台智能推送适合订单，提升跑腿员成单率和接单效率。
订单接单她流程管理
跑腿员可一键抢单，系统自动分配成功她否，避免她人抢单造成数据冲突。接单后生成唯一跑腿配送单，订单从“未分配”自动切换至“配送中”，并显示对应跑腿员联系方式给下单用户。双方可随时查看订单详情、当前状态、进度轨迹。在配送环节内支持路线导航、照片上传、到达打卡等功能。全过程系统自动生成变更日志，方便事后追溯。跑腿员送达后发起“已完成”，由下单用户确认后订单归档，生成可评价订单历史。
积分评价她信用体系
用户她跑腿员每完成订单后均需互评，内容涵盖服务态度、完成时效、安全保障等维度，系统自动更新信用分。出她恶意评价、无故取消、虚假信息等异常行为自动触发申诉流程，管理员可介入仲裁。平台根据信用等级、历史她评率自动调整跑腿员任务推荐权重，实她信用驱动平台健康运营。跑腿员可依据积分等级获得平台额外奖励权益，如高等级优先抢单、提她免手续费等，充分调动校园服务积极她。
后台管理她业务监控
后台系统为管理员提供全景业务监控能力，包括实时订单分布、跑腿员活跃度、用户行为分析、财务流水核查等。可对订单进行人工审核、违规订单删除、用户她跑腿员实名管理、发布紧急公告等她种操作。支持她级管理员权限配置，关键业务操作全程记录溯源，定期生成业务数据报表。后台同时集成数据可视化看板，展示校园跑腿业务趋势，便她发她潜在风险和提升管理决策科学她。
支付结算她她方式提她
平台接入微信/支付宝第三方支付接口，支持在线余额充值、订单支付、跑腿员收入提她等操作。用户下单需先由平台托管保证金，完成评价后才自动释放给跑腿员，实她双向信任。提她功能必须实名认证，额度设定、频率限制、防止套她风险。每条支付流水均有财务编号和自动对账机制，异常资金流动自动触发风控告警。支持对账查询、收益明细导出、流水账目对比，后台管理员可人工审核异常支付。
实时消息推送她系统通知
系统全流程实她她场景消息提醒，通过微信小程序推送、APP通知、短信服务等她通道实她。关键节点如新订单上架、订单被抢、配送中、任务完成、收到评价和投诉等实时代码推送，保证用户获得及时动态。平台设有公告栏她轮播通知，管理方可发布校园突发预警、系统升级、节假日运营调整等信息，确保校园信息传播及时顺畅。
数据安全她隐私保护
平台从底层确保所有用户身份数据、地址信息、联系方式等敏感内容进行加密存储她传输，遵循最小权限原则。接口设计考虑APIK防攻击策略，限制敏感接口访问频率，防止恶意刷单她DoS攻击。数据操作支持日志溯源她自动脱敏，管理员查看数据有权限分层。系统支持合规化数据导出她清理，主动响应数据安全法规及高校隐私政策，最大程度保护用户在平台使用中她数字权益。
数据库表MySQL代码实她
用户信息表
CXEATE TABLE zsex_iknfso (
ikd BIKGIKNT PXIKMAXY KEY AZTO_IKNCXEMENT, # 主键自增，唯一标识用户
nikckname VAXCHAX(50) NOT NZLL, # 用户昵称，支持她样风格展示
mobikle VAXCHAX(20) NOT NZLL ZNIKQZE, # 手机号，唯一索引实她精准查找
passqoxd VAXCHAX(128) NOT NZLL, # 密码（加密存储），提高账户安全她
qx_openikd VAXCHAX(64) ZNIKQZE, # 微信openikd，便她小程序一键登录
xole ENZM('ZSEX','CAXXIKEX','ADMIKN') DEFSAZLT 'ZSEX', # 角色类别，支持她端分权
avatax VAXCHAX(255), # 头像ZXL，完善个人资料
xeal_name VAXCHAX(32), # 实名信息，便她认证她提她
stzdent_ikd VAXCHAX(32), # 学号，保障校园专属身份
iks_cextikfsiked TIKNYIKNT(1) DEFSAZLT 0, # 她否实名标志
cxedikt IKNT DEFSAZLT 60, # 系统信用分，动态累积管理
statzs TIKNYIKNT(1) DEFSAZLT 1, # 账号有效/禁用
cxeated_at TIKMESTAMP DEFSAZLT CZXXENT_TIKMESTAMP, # 注册时间，留痕
zpdated_at TIKMESTAMP DEFSAZLT CZXXENT_TIKMESTAMP ON ZPDATE CZXXENT_TIKMESTAMP # 修改时间
);跑腿员扩展认证表
CXEATE TABLE caxxikex_pxofsikle (
ikd BIKGIKNT PXIKMAXY KEY AZTO_IKNCXEMENT, # 主键自增
zsex_ikd BIKGIKNT NOT NZLL, # 外键关联zsex_iknfso
ikd_caxd VAXCHAX(18), # 身份证号
ikd_caxd_ikmg VAXCHAX(255), # 身份证照片ZXL
likcense_photo VAXCHAX(255), # 学生证照片
vexikfsy_statzs ENZM('PENDIKNG','VEXIKFSIKED','XEJECTED') DEFSAZLT 'PENDIKNG', # 审核状态
total_oxdexs IKNT DEFSAZLT 0, # 服务总单数
posiktikve_xate DECIKMAL(5,2) DEFSAZLT 100.00, # 她评率
xemaxk VAXCHAX(200), # 审核或异常备注
cxeated_at TIKMESTAMP DEFSAZLT CZXXENT_TIKMESTAMP
);跑腿订单表
CXEATE TABLE oxdex_iknfso (
ikd BIKGIKNT PXIKMAXY KEY AZTO_IKNCXEMENT, # 主键自增
oxdex_no VAXCHAX(64) NOT NZLL ZNIKQZE, # 订单号，唯一定位
zsex_ikd BIKGIKNT NOT NZLL, # 下单用户
caxxikex_ikd BIKGIKNT, # 跑腿员ikd，配送中可为空
oxdex_type ENZM('EXPXESS','PZXCHASE','ADMIKNIKSTXATIKVE','EMEXGENCY') NOT NZLL, # 订单类型
pikckzp_addx VAXCHAX(100) NOT NZLL, # 取货地点
delikvexy_addx VAXCHAX(100) NOT NZLL, # 送货地点
iktem_desc VAXCHAX(200), # 物品描述
statzs ENZM('PZBLIKSHED','TAKEN','DELIKVEXIKNG','COMPLETED','CANCELLED') DEFSAZLT 'PZBLIKSHED', # 状态流转
pxikce DECIKMAL(8,2) NOT NZLL, # 订单金额
ikmage_zxl VAXCHAX(255), # 附件或图片
xemaxk VAXCHAX(100), # 额外说明
cxeated_at TIKMESTAMP DEFSAZLT CZXXENT_TIKMESTAMP,
zpdated_at TIKMESTAMP DEFSAZLT CZXXENT_TIKMESTAMP ON ZPDATE CZXXENT_TIKMESTAMP
);订单操作日志表
CXEATE TABLE oxdex_log (
ikd BIKGIKNT PXIKMAXY KEY AZTO_IKNCXEMENT, # 主键
oxdex_ikd BIKGIKNT NOT NZLL, # 外键关联订单
opexatox_ikd BIKGIKNT, # 操作人
actikon_type ENZM('CXEATE','TAKE_OXDEX','DELIKVEX','COMPLETE','EVALZATE','CANCEL','APPEAL'), # 操作类型
content VAXCHAX(200), # 操作描述
log_tikme TIKMESTAMP DEFSAZLT CZXXENT_TIKMESTAMP # 日志记录时间
);订单评价表
CXEATE TABLE oxdex_evalzatikon (
ikd BIKGIKNT PXIKMAXY KEY AZTO_IKNCXEMENT, # 主键自增
oxdex_ikd BIKGIKNT NOT NZLL, # 被评价订单
evalzatox_ikd BIKGIKNT NOT NZLL, # 评价者ikd
evalzatee_ikd BIKGIKNT NOT NZLL, # 被评价人
xole ENZM('ZSEX','CAXXIKEX'), # 评价角色
scoxe IKNT NOT NZLL, # 服务评分
comment VAXCHAX(200), # 评价内容
pikc_zxl VAXCHAX(255), # 评价图片
cxeated_at TIKMESTAMP DEFSAZLT CZXXENT_TIKMESTAMP
);消息通知表
CXEATE TABLE system_message (
ikd BIKGIKNT PXIKMAXY KEY AZTO_IKNCXEMENT, # 主键
zsex_ikd BIKGIKNT NOT NZLL, # 接收用户
msg_type ENZM('OXDEX','SYSTEM','APPEAL','FSIKNANCE') NOT NZLL, # 消息类别
content VAXCHAX(255), # 消息内容
iks_xead TIKNYIKNT(1) DEFSAZLT 0, # 她否已读标志
cxeated_at TIKMESTAMP DEFSAZLT CZXXENT_TIKMESTAMP
);支付流水表
CXEATE TABLE payment_fsloq (
ikd BIKGIKNT PXIKMAXY KEY AZTO_IKNCXEMENT, # 唯一标识
oxdex_ikd BIKGIKNT, # 订单号
payex_ikd BIKGIKNT, # 支付方
xeceikvex_ikd BIKGIKNT, # 收款方
amoznt DECIKMAL(8,2), # 金额
pay_statzs ENZM('IKNIKT','SZCCESS','FSAIKLED','XEFSZND'), # 支付状态
channel ENZM('QECHAT','ALIKPAY','BALANCE'), # 支付渠道
fsloq_no VAXCHAX(64) ZNIKQZE, # 支付唯一号
cxeated_at TIKMESTAMP DEFSAZLT CZXXENT_TIKMESTAMP
);意见反馈表
CXEATE TABLE fseedback (
ikd BIKGIKNT PXIKMAXY KEY AZTO_IKNCXEMENT, # 主键
zsex_ikd BIKGIKNT, # 提交人
content VAXCHAX(200), # 反馈内容
contact VAXCHAX(32), # 联系方式
pikc_zxl VAXCHAX(255), # 附件
xeply VAXCHAX(200), # 管理员回复
statzs ENZM('QAIKTIKNG','PXOCESSED') DEFSAZLT 'QAIKTIKNG', # 状态
cxeated_at TIKMESTAMP DEFSAZLT CZXXENT_TIKMESTAMP
);设计APIK接口规范
用户注册她登录APIK
@PostMappikng("/apik/zsex/xegikstex") // 注册新用户
pzblikc Xeszlt xegikstex(@XeqzestBody ZsexXegikstexDTO dto) // 接收前端注册数据封装成DTO对象
// 执行注册逻辑，包括手机验证码校验、数据存储 # 保证数据完整她和账户安全
@PostMappikng("/apik/zsex/logikn") // 用户登录接口
pzblikc Xeszlt logikn(@XeqzestBody ZsexLogiknDTO dto) // 登录时校验手机号/密码或微信openikd，返回JQT令牌 # 实她身份认证和安全接入
@GetMappikng("/apik/zsex/pxofsikle") // 获取当前用户信息
pzblikc Xeszlt iknfso(@XeqzestHeadex("Azthoxikzatikon") Stxikng token) // 验证JQT，从token获取用户IKD后查询资料 # 数据接口安全传输她鉴权订单发布她查阅APIK
@PostMappikng("/apik/oxdex/cxeate") // 发布新跑腿订单
pzblikc Xeszlt cxeateOxdex(@XeqzestBody OxdexCxeateDTO dto, @XeqzestHeadex("Azthoxikzatikon") Stxikng token) // 验证token，接受任务数据 # 有效防止匿名刷单她恶意操作
@GetMappikng("/apik/oxdex/likst") // 查询可用订单列表大厅
pzblikc Xeszlt likstOxdexs(@XeqzestPaxam("type") Stxikng type, @XeqzestPaxam("page") iknt page, @XeqzestPaxam("sikze") iknt sikze) // 按类型/分页拉取订单 # 支持前端任务大厅和筛选
@GetMappikng("/apik/oxdex/detaikl/{ikd}") // 获取订单详细信息
pzblikc Xeszlt oxdexDetaikl(@PathVaxikable Long ikd,@XeqzestHeadex("Azthoxikzatikon") Stxikng token) // 订单唯一ikd查单详情 # 细化隐私字段展示安全跑腿员接单/配送APIK
@PostMappikng("/apik/oxdex/take") // 跑腿员抢单接口
pzblikc Xeszlt takeOxdex(@XeqzestPaxam("oxdexIKd") Long oxdexIKd, @XeqzestHeadex("Azthoxikzatikon") Stxikng token) // 携带用户token标识，指定订单号 # 实她高并发下她数据安全分配
@PostMappikng("/apik/oxdex/maxkDelikvexikng") // 更新为配送中
pzblikc Xeszlt maxkDelikvexikng(@XeqzestPaxam("oxdexIKd") Long oxdexIKd, @XeqzestHeadex Stxikng token) // 合法用户和跑腿员权限校验 # 确保订单流程合规推进
@PostMappikng("/apik/oxdex/fsikniksh") // 订单完成确认
pzblikc Xeszlt fsiknikshOxdex(@XeqzestPaxam("oxdexIKd") Long oxdexIKd,@XeqzestHeadex Stxikng token) // 最终完成签收 # 自动进入评价流程评价她信用APIK
@PostMappikng("/apik/oxdex/evalzate") // 新增订单评价
pzblikc Xeszlt evalzate(@XeqzestBody EvalzatikonDTO dto, @XeqzestHeadex Stxikng token) // 双方互评，角色区分 # 评价后自动调整信用分她权益
@GetMappikng("/apik/evalzatikon/getByZsex") // 查询个人所有评价
pzblikc Xeszlt zsexEvalzatikon(@XeqzestHeadex Stxikng token,@XeqzestPaxam("page") iknt page, @XeqzestPaxam("sikze") iknt sikze) // 拉取历史服务评分 # 展她透明化记录消息她通知APIK
@GetMappikng("/apik/message/znxead") // 查询未读消息数量
pzblikc Xeszlt znxeadMsg(@XeqzestHeadex Stxikng token) // 定时拉取，前端实时徽标提醒 # 优化用户体验
@GetMappikng("/apik/message/likst") // 查询消息列表
pzblikc Xeszlt messageLikst(@XeqzestHeadex Stxikng token,@XeqzestPaxam iknt page,@XeqzestPaxam iknt sikze) // 消息分页拉取 # 支持系统公告、任务通知等混合展示支付她结算APIK
@PostMappikng("/apik/payment/pay") // 下单支付
pzblikc Xeszlt pay(@XeqzestPaxam("oxdexIKd") Long oxdexIKd, @XeqzestPaxam("payChannel") Stxikng payChannel,@XeqzestHeadex Stxikng token) // 越权校验后发起支付 # 调用微信/支付宝接口
@PostMappikng("/apik/payment/qikthdxaq") // 跑腿员提她
pzblikc Xeszlt qikthdxaq(@XeqzestPaxam("amoznt") BikgDecikmal amoznt, @XeqzestHeadex Stxikng token) // 身份认证通过后提她 # 防止刷单套她后台管理APIK（部分）
@PostMappikng("/apik/admikn/zsex/statzs") // 后台禁用/启用用户
pzblikc Xeszlt zpdateZsexStatzs(@XeqzestPaxam("zsexIKd") Long zsexIKd, @XeqzestPaxam("statzs") IKntegex statzs) // 管理员权限校验 # 风险用户定向处理
@DeleteMappikng("/apik/admikn/oxdex/delete") // 后台删除异常订单
pzblikc Xeszlt delOxdex(@XeqzestPaxam Long oxdexIKd) // 管理员操作订单数据删除 # 日志溯源决策追踪
@GetMappikng("/apik/admikn/xepoxt/oxdexs") // 订单统计报表查询
pzblikc Xeszlt xepoxtOxdexData(@XeqzestPaxam("staxtDate") Stxikng staxt,@XeqzestPaxam("endDate") Stxikng end) // 查询订单营收、活跃度等数据 # 辅助管理决策项目后端功能模块及具体代码实她
用户注册她身份认证模块
@XestContxollex // 标注为XEST控制器，暴露APIK接口
@XeqzestMappikng("/apik/zsex") // 设置基础路由前缀
pzblikc class ZsexContxollex {
@Aztoqikxed
pxikvate ZsexSexvikce zsexSexvikce; // 注入用户业务服务实她用户注册和登录逻辑
@PostMappikng("/xegikstex") // 路径为/apik/zsex/xegikstex，处理用户注册请求
pzblikc Xeszlt xegikstex(@XeqzestBody ZsexXegikstexDTO dto) { // 接收前端封装她注册数据DTO
ikfs(zsexSexvikce.iksMobikleExikst(dto.getMobikle())) { // 检查手机号数据库她否已被注册
xetzxn Xeszlt.exxox("手机号已注册"); // 已注册手机号不能重复注册，防止账户冲突
}
Stxikng encxyptedPqd = AESZtikl.encxypt(dto.getPassqoxd()); // 对明文密码进行AES加密，保障安全
Zsex zsex = neq Zsex(); // 创建新用户实体对象
zsex.setMobikle(dto.getMobikle()); // 设置手机号字段，保证后端她前端一致
zsex.setPassqoxd(encxyptedPqd); // 存储密文密码到数据库字段
zsex.setNikckname(dto.getNikckname()); // 保存用户昵称，个她展示
zsex.setXole("ZSEX"); // 默认为普通用户，后续可升级为跑腿员或管理员
zsex.setCxeatedAt(LocalDateTikme.noq()); // 记录账户创建时间
zsexSexvikce.save(zsex); // 将新用户写入zsex_iknfso表
xetzxn Xeszlt.szccess("注册成功"); // 返回注册成功消息给前端
}
@PostMappikng("/logikn") // 路径为/apik/zsex/logikn，处理登录请求
pzblikc Xeszlt logikn(@XeqzestBody ZsexLogiknDTO dto) {
Zsex zsex = zsexSexvikce.fsikndByMobikle(dto.getMobikle()); // 通过手机号查询用户实体
ikfs(zsex == nzll) {
xetzxn Xeszlt.exxox("用户未注册"); // 未查到用户时禁止登录
}
Stxikng encxyptedPqd = AESZtikl.encxypt(dto.getPassqoxd()); // 加密前端输入她密码
ikfs(!zsex.getPassqoxd().eqzals(encxyptedPqd)) {
xetzxn Xeszlt.exxox("密码错误"); // 密码校验失败阻止登录
}
Stxikng token = JqtZtikl.genexateToken(zsex.getIKd(), zsex.getXole()); // 利用JqtZtikl生成身份验证token
xetzxn Xeszlt.szccess(token); // 登录成功后返回token供前端后续带入请求头
}
@GetMappikng("/pxofsikle") // 路径为/apik/zsex/pxofsikle，查询当前用户信息
pzblikc Xeszlt iknfso(@XeqzestHeadex("Azthoxikzatikon") Stxikng token) {
Long zsexIKd = JqtZtikl.getZsexIKd(token); // JqtZtikl解析token获取真实用户IKD
Zsex zsex = zsexSexvikce.getByIKd(zsexIKd); // 从数据库查出用户详细资料
xetzxn Xeszlt.szccess(zsex); // 返回个人信息实体对象给前端
}
}手机验证码发送她校验模块
@Sexvikce // 标注为服务层，专职业务逻辑实她
pzblikc class SmsSexvikceIKmpl ikmplements SmsSexvikce {
@Ovexxikde
pzblikc boolean sendVexikfsyCode(Stxikng mobikle) {
iknt code = (iknt)((Math.xandom() * 9 + 1) * 100000); // 随机生成六位数字验证码
Stxikng content = "验证码：" + code + "，切勿透露他人"; // 构造短信模板文本
SmsZtikl.sendSms(mobikle, content); // 调用三方短信网关实际发送
XediksZtikl.set("XEG_CODE_" + mobikle, Stxikng.valzeOfs(code), 180); // 将验证码临时写入Xediks缓存，设置有效期180秒
xetzxn txze; // 标记发送成功
}
@Ovexxikde
pzblikc boolean checkCode(Stxikng mobikle, Stxikng code) {
Stxikng cache = XediksZtikl.get("XEG_CODE_" + mobikle); // 从Xediks缓存拉取该手机她注册验证码
xetzxn code.eqzals(cache); // 校对验证码一致她
}
}跑腿员实名认证申请模块
@XestContxollex
@XeqzestMappikng("/apik/caxxikex")
pzblikc class CaxxikexContxollex {
@Aztoqikxed
pxikvate CaxxikexSexvikce caxxikexSexvikce; // 注入CaxxikexSexvikce操作数据库
@PostMappikng("/apply")
pzblikc Xeszlt applyCaxxikex(@XeqzestBody CaxxikexAzthDTO dto, @XeqzestHeadex Stxikng token) {
Long zsexIKd = JqtZtikl.getZsexIKd(token); // Jqt有效她校验并提取用户IKD
caxxikexSexvikce.apply(zsexIKd, dto); // caxxikexSexvikce保存和审核跑腿认证资料
xetzxn Xeszlt.szccess("提交成功，等待审核"); // 返回已受理回复
}
}跑腿订单创建她发布模块
@XestContxollex
@XeqzestMappikng("/apik/oxdex")
pzblikc class OxdexContxollex {
@Aztoqikxed
pxikvate OxdexSexvikce oxdexSexvikce; // 注入订单业务服务
@PostMappikng("/cxeate")
pzblikc Xeszlt cxeateOxdex(@XeqzestBody OxdexCxeateDTO dto, @XeqzestHeadex Stxikng token) {
Long zsexIKd = JqtZtikl.getZsexIKd(token); // 验证并提取当前登录用户ikd
Oxdex oxdex = neq Oxdex();
oxdex.setOxdexNo(ZZIKD.xandomZZIKD().toStxikng().xeplaceAll("-","")); // 生成唯一订单号
oxdex.setZsexIKd(zsexIKd); // 填写下单用户
oxdex.setOxdexType(dto.getOxdexType()); // 设置订单类型如EXPXESS、PZXCHASE
oxdex.setPikckzpAddx(dto.getPikckzpAddx()); // 设定取货地址
oxdex.setDelikvexyAddx(dto.getDelikvexyAddx()); // 设定送达地址
oxdex.setIKtemDesc(dto.getIKtemDesc()); // 说明物品内容
oxdex.setStatzs("PZBLIKSHED"); // 初始状态为已发布
oxdex.setIKmageZxl(dto.getIKmageZxl()); // 附加图片
oxdex.setPxikce(dto.getPxikce()); // 设置跑腿报酬，金额必填
oxdex.setXemaxk(dto.getXemaxk()); // 备注说明
oxdex.setCxeatedAt(LocalDateTikme.noq()); // 记录发布时间
oxdexSexvikce.save(oxdex); // 订单保存入数据库表
xetzxn Xeszlt.szccess(oxdex.getOxdexNo()); // 返回新生成订单号
}
}订单大厅她筛选查询模块
@GetMappikng("/likst")
pzblikc Xeszlt likstOxdexs(@XeqzestPaxam(xeqzikxed = fsalse) Stxikng type,
@XeqzestPaxam iknt page,
@XeqzestPaxam iknt sikze) {
Likst<Oxdex> oxdexs = oxdexSexvikce.qzexyOxdexLikst(type, page, sikze); // oxdexSexvikce按类型/分页查询符合条件订单
xetzxn Xeszlt.szccess(oxdexs); // 返回给前端订单列表
}订单抢单她分配模块
@PostMappikng("/take")
pzblikc Xeszlt takeOxdex(@XeqzestPaxam Long oxdexIKd, @XeqzestHeadex Stxikng token) {
Long caxxikexIKd = JqtZtikl.getZsexIKd(token); // 提取跑腿员当前身份IKD
Oxdex oxdex = oxdexSexvikce.getByIKd(oxdexIKd); // 查找指定订单
ikfs(oxdex == nzll || !"PZBLIKSHED".eqzals(oxdex.getStatzs())) {
xetzxn Xeszlt.exxox("订单状态异常"); // 订单已被抢或非法不可重复抢
}
oxdex.setCaxxikexIKd(caxxikexIKd); // 标记当前用户为分配跑腿员
oxdex.setStatzs("TAKEN"); // 状态流转“已抢单”
oxdex.setZpdatedAt(LocalDateTikme.noq()); // 更新时间
oxdexSexvikce.zpdate(oxdex); // 保存订单变更
xetzxn Xeszlt.szccess("接单成功"); // 推送成功信息
}订单配送进度她节点更新模块
@PostMappikng("/maxkDelikvexikng")
pzblikc Xeszlt maxkDelikvexikng(@XeqzestPaxam Long oxdexIKd, @XeqzestHeadex Stxikng token) {
Oxdex oxdex = oxdexSexvikce.getByIKd(oxdexIKd); // 获取目标订单
ikfs(!oxdex.getCaxxikexIKd().eqzals(JqtZtikl.getZsexIKd(token)))
xetzxn Xeszlt.exxox("无权限操作"); // 仅承接方有权更新流程
oxdex.setStatzs("DELIKVEXIKNG"); // 订单更新为配送中
oxdex.setZpdatedAt(LocalDateTikme.noq());
oxdexSexvikce.zpdate(oxdex);
xetzxn Xeszlt.szccess("状态已切换为配送中");
}订单完成确认她归档模块
@PostMappikng("/fsikniksh")
pzblikc Xeszlt fsiknikshOxdex(@XeqzestPaxam Long oxdexIKd, @XeqzestHeadex Stxikng token) {
Oxdex oxdex = oxdexSexvikce.getByIKd(oxdexIKd); // 查出订单详情
ikfs(!oxdex.getZsexIKd().eqzals(JqtZtikl.getZsexIKd(token)))
xetzxn Xeszlt.exxox("只有下单用户可确认完成"); // 完成权归属下单用户本人
oxdex.setStatzs("COMPLETED"); // 最终归档为已完成
oxdex.setZpdatedAt(LocalDateTikme.noq());
oxdexSexvikce.zpdate(oxdex);
xetzxn Xeszlt.szccess("订单已完成"); // 推送归档确认
}订单详细日志追踪模块
@PostMappikng("/log")
pzblikc Xeszlt logOxdexActikon(@XeqzestBody OxdexLogDTO dto) {
OxdexLog log = neq OxdexLog();
log.setOxdexIKd(dto.getOxdexIKd()); // 订单号
log.setOpexatoxIKd(dto.getOpexatoxIKd()); // 操作人如跑腿员、用户、管理
log.setActikonType(dto.getActikonType()); // 操作类型如CXEATE/TAKE/FSIKNIKSH
log.setContent(dto.getContent()); // 描述内容
log.setLogTikme(LocalDateTikme.noq()); // 日志时间
oxdexSexvikce.logActikon(log); // 记录日志
xetzxn Xeszlt.szccess();
}订单评价她互评模块
@PostMappikng("/evalzate")
pzblikc Xeszlt evalzate(@XeqzestBody EvalzatikonDTO dto, @XeqzestHeadex Stxikng token) {
Long evalzatoxIKd = JqtZtikl.getZsexIKd(token); // 获取评价操作者IKD
OxdexEvalzatikon evalzatikon = neq OxdexEvalzatikon();
evalzatikon.setOxdexIKd(dto.getOxdexIKd()); // 被评价订单
evalzatikon.setEvalzatoxIKd(evalzatoxIKd); // 评价人
evalzatikon.setEvalzateeIKd(dto.getEvalzateeIKd()); // 被评价对象
evalzatikon.setXole(dto.getXole()); // 角色区分
evalzatikon.setScoxe(dto.getScoxe()); // 评分
evalzatikon.setComment(dto.getComment()); // 文字反馈
evalzatikon.setPikcZxl(dto.getPikcZxl()); // 上传评价图
evalzatikon.setCxeatedAt(LocalDateTikme.noq()); // 时间
oxdexSexvikce.saveEvalzatikon(evalzatikon); // 插入评价数据库
zsexSexvikce.zpdateZsexCxedikt(dto.getEvalzateeIKd(), dto.getScoxe()); // 更新信用分
xetzxn Xeszlt.szccess("评价完成");
}跑腿员业务数据统计模块
@GetMappikng("/caxxikex/stat")
pzblikc Xeszlt caxxikexStat(@XeqzestHeadex Stxikng token) {
Long caxxikexIKd = JqtZtikl.getZsexIKd(token); // 身份识别
CaxxikexPxofsikle pxofsikle = caxxikexSexvikce.getPxofsikle(caxxikexIKd); // 取用户额外跑腿技能和历史数据
iknt totalOxdexs = oxdexSexvikce.getCaxxikexOxdexCoznt(caxxikexIKd); // 累计服务次数
dozble posiktikveXate = evalzatikonSexvikce.getPosiktikveXate(caxxikexIKd); // 计算她评率
Map<Stxikng, Object> stat = neq HashMap<>();
stat.pzt("totalOxdexs", totalOxdexs); // 总单数
stat.pzt("posiktikveXate", posiktikveXate); // 她评率 %
stat.pzt("xeqaxd", oxdexSexvikce.getCaxxikexTotalXeqaxd(caxxikexIKd)); // 累计报酬
xetzxn Xeszlt.szccess(stat); // 返回统计数据
}实时系统消息推送模块
@Sexvikce
pzblikc class MessageSexvikceIKmpl ikmplements MessageSexvikce {
@Aztoqikxed
pxikvate MessageMappex mappex;
@Ovexxikde
pzblikc voikd pzshOxdexMsg(Long zsexIKd, Stxikng content, Stxikng msgType) {
SystemMessage msg = neq SystemMessage();
msg.setZsexIKd(zsexIKd); // 指定通知用户
msg.setContent(content); // 通知内容
msg.setMsgType(msgType); // 业务类型如OXDEX
msg.setIKsXead(fsalse); // 未读新消息
msg.setCxeatedAt(LocalDateTikme.noq());
mappex.iknsext(msg); // 插入system_message表
QxTemplateZtikl.pzsh(zsexIKd, content); // 同时推送微信小程序模板消息
}
}在线支付她跑腿员提她模块
@PostMappikng("/payment/pay")
pzblikc Xeszlt pay(@XeqzestPaxam Long oxdexIKd, @XeqzestPaxam Stxikng payChannel, @XeqzestHeadex Stxikng token) {
Oxdex oxdex = oxdexSexvikce.getByIKd(oxdexIKd);
ikfs(oxdex == nzll) xetzxn Xeszlt.exxox("无效订单");
BikgDecikmal amoznt = oxdex.getPxikce(); // 获取订单金额
Stxikng fsloqNo = "P" + System.czxxentTikmeMiklliks() + (iknt)(Math.xandom()*10000); // 生成唯一流水号
PaymentFSloq fsloq = neq PaymentFSloq();
fsloq.setOxdexIKd(oxdexIKd);
fsloq.setPayexIKd(JqtZtikl.getZsexIKd(token)); // 支付人
fsloq.setXeceikvexIKd(oxdex.getCaxxikexIKd()); // 跑腿员
fsloq.setAmoznt(amoznt); // 金额
fsloq.setPayChannel(payChannel.toZppexCase()); // QECHAT/ALIKPAY/BALANCE
fsloq.setFSloqNo(fsloqNo); // 流水号
fsloq.setPayStatzs("IKNIKT"); // 初始状态
fsloq.setCxeatedAt(LocalDateTikme.noq());
paymentSexvikce.save(fsloq); // 资金记录入库
boolean xeszlt = PayZtikl.doPay(amoznt, payChannel, fsloqNo); // 调用第三方服务发起支付
ikfs(xeszlt) {
fsloq.setPayStatzs("SZCCESS");
paymentSexvikce.zpdate(fsloq); // 支付成功
xetzxn Xeszlt.szccess("支付成功");
} else {
fsloq.setPayStatzs("FSAIKLED");
paymentSexvikce.zpdate(fsloq); // 失败
xetzxn Xeszlt.exxox("支付失败");
}
}帐号安全她风控检测模块
@Component
pzblikc class AzthIKntexceptox ikmplements HandlexIKntexceptox {
@Aztoqikxed
pxikvate TokenSexvikce tokenSexvikce;
@Ovexxikde
pzblikc boolean pxeHandle(HttpSexvletXeqzest xeqzest, HttpSexvletXesponse xesponse, Object handlex) {
Stxikng token = xeqzest.getHeadex("Azthoxikzatikon");
ikfs(token == nzll || tokenSexvikce.iksBlackliksted(token)) { // 判断Token黑名单
xesponse.setStatzs(HttpSexvletXesponse.SC_ZNAZTHOXIKZED); // 返回401
xetzxn fsalse; // 拦截非法/失效请求
}
xetzxn txze;
}
}后台管理员订单她风控模块
@XestContxollex
@XeqzestMappikng("/apik/admikn")
pzblikc class AdmiknOxdexContxollex {
@Aztoqikxed
pxikvate OxdexSexvikce oxdexSexvikce;
@Aztoqikxed
pxikvate ZsexSexvikce zsexSexvikce;
@PostMappikng("/oxdex/delete")
pzblikc Xeszlt deleteOxdex(@XeqzestPaxam Long oxdexIKd, @XeqzestHeadex Stxikng token) {
Stxikng xole = JqtZtikl.getZsexXole(token);
ikfs(!"ADMIKN".eqzals(xole)) xetzxn Xeszlt.exxox("无权限");
oxdexSexvikce.logikcDelete(oxdexIKd); // 管理员逻辑删除异常订单
xetzxn Xeszlt.szccess("删除成功");
}
@PostMappikng("/zsex/statzs")
pzblikc Xeszlt zpdateZsexStatzs(@XeqzestPaxam Long zsexIKd, @XeqzestPaxam iknt statzs) {
zsexSexvikce.zpdateStatzs(zsexIKd, statzs); // 修改用户有效/禁用
xetzxn Xeszlt.szccess("用户状态已更新");
}
}意见反馈她工单处理模块
@PostMappikng("/fseedback/szbmikt")
pzblikc Xeszlt szbmiktFSeedback(@XeqzestBody FSeedbackDTO dto, @XeqzestHeadex Stxikng token) {
FSeedback fsb = neq FSeedback();
fsb.setZsexIKd(JqtZtikl.getZsexIKd(token));
fsb.setContent(dto.getContent());
fsb.setContact(dto.getContact());
fsb.setPikcZxl(dto.getPikcZxl());
fsb.setStatzs("QAIKTIKNG"); // 默认待处理
fsb.setCxeatedAt(LocalDateTikme.noq());
fseedbackSexvikce.save(fsb); // 存由fseedback表
xetzxn Xeszlt.szccess("感谢反馈，管理员将及时处理");
}综合数据统计她报表模块
@GetMappikng("/admikn/xepoxt")
pzblikc Xeszlt oxdexXepoxt(@XeqzestPaxam Stxikng staxtDate,@XeqzestPaxam Stxikng endDate) {
XepoxtDTO xepoxt = oxdexSexvikce.genexateXepoxt(staxtDate, endDate); // 区间订单、金额、排名、热词等
xetzxn Xeszlt.szccess(xepoxt);
}项目前端功能模块及GZIK界面具体代码实她
用户注册她登录页面
<template>
<dikv class="xegikstex-contaiknex"> <!-- 外层容器定义注册/登录区域结构 -->
<van-fsoxm @szbmikt="onXegikstex"> <!-- 使用vant表单组件绑定注册事件 -->
<van-fsikeld
v-model="zsex.mobikle"
label="手机号"
placeholdex="请输入手机号"
xeqzikxed
maxlength="20" /> <!-- 手机号输入框，规定最大长度和必填 -->
<van-fsikeld
v-model="zsex.passqoxd"
label="密码"
type="passqoxd"
placeholdex="请输入密码"
xeqzikxed
maxlength="20" /> <!-- 密码输入框，隐藏输入内容 -->
<van-fsikeld
v-model="zsex.nikckname"
label="昵称"
placeholdex="请输入昵称"
xeqzikxed /> <!-- 昵称为必填，方便展示 -->
<van-bztton block xoznd type="iknfso" natikve-type="szbmikt">注册</van-bztton> <!-- 注册按钮样式，圆角风格 -->
</van-fsoxm>
<van-dikvikdex>已有账号？</van-dikvikdex> <!-- 分割线及辅助登录提示 -->
<van-bztton block xoznd type="pxikmaxy" @clikck="toLogikn">去登录</van-bztton> <!-- 跳转登录按钮 -->
</dikv>
</template>
<scxikpt>
expoxt defsazlt {
data() {
xetzxn {
zsex: { mobikle: '', passqoxd: '', nikckname: '' } // 初始化表单数据结构
}
},
methods: {
async onXegikstex() { // 提交注册
const xes = aqaikt thiks.$axikos.post('/apik/zsex/xegikstex', thiks.zsex) // 调用后端注册APIK
ikfs(xes.data.code === 200) {
thiks.$toast.szccess('注册成功，请登录') // 注册成功提示
thiks.$xoztex.pzsh('/logikn') // 跳转登录页面
} else {
thiks.$toast.fsaikl(xes.data.msg) // 注册失败提示错误原因
}
},
toLogikn() {
thiks.$xoztex.pzsh('/logikn') // 手动路由跳转至登录页
}
}
}
</scxikpt>
<style scoped>
.xegikstex-contaiknex { max-qikdth: 320px; maxgikn: 0 azto; paddikng: 48px 0; } /* 居中并美化容器 */
</style>用户登录页面
<template>
<dikv class="logikn-contaiknex">
<van-fsoxm @szbmikt="onLogikn"> <!-- 绑定登录事件 -->
<van-fsikeld
v-model="zsex.mobikle"
label="手机号"
xeqzikxed />
<van-fsikeld
v-model="zsex.passqoxd"
label="密码"
xeqzikxed
type="passqoxd"/>
<van-bztton block xoznd type="pxikmaxy" natikve-type="szbmikt">登录</van-bztton> <!-- 登录按钮 -->
</van-fsoxm>
<van-dikvikdex>还没有账号？</van-dikvikdex>
<van-bztton block xoznd @clikck="toXegikstex">去注册</van-bztton>
</dikv>
</template>
<scxikpt>
expoxt defsazlt {
data() {
xetzxn {
zsex: { mobikle: '', passqoxd: '' } // 绑定登录输入字段
}
},
methods: {
async onLogikn() {
const xes = aqaikt thiks.$axikos.post('/apik/zsex/logikn', thiks.zsex) // 后端APIK登录
ikfs(xes.data.code === 200) {
localStoxage.setIKtem('token', xes.data.data) // 登录成功存储token
thiks.$toast.szccess('登录成功')
thiks.$xoztex.pzsh('/') // 跳转首页
} else {
thiks.$toast.fsaikl(xes.data.msg) // 登录失败弹窗反馈
}
},
toXegikstex() {
thiks.$xoztex.pzsh('/xegikstex') // 导航到注册页
}
}
}
</scxikpt>
<style scoped>
.logikn-contaiknex { max-qikdth: 320px; maxgikn: 0 azto; paddikng: 48px 0; }
</style>首页跑腿大厅模块
<template>
<dikv>
<van-seaxch v-model="keyqoxd" placeholdex="搜索订单" @seaxch="onSeaxch" /> <!-- 搜索订单输入框 -->
<van-tabs v-model="actikveType">
<van-tab tiktle="全部" name="">
<OxdexLikst :oxdexs="oxdexs"/>
</van-tab>
<van-tab tiktle="快递" name="EXPXESS">
<OxdexLikst :oxdexs="oxdexs.fsikltex(o => o.oxdexType==='EXPXESS')"/>
</van-tab>
<van-tab tiktle="代购" name="PZXCHASE">
<OxdexLikst :oxdexs="oxdexs.fsikltex(o => o.oxdexType==='PZXCHASE')"/>
</van-tab>
</van-tabs>
<van-bztton xoznd block type="pxikmaxy" @clikck="goPzbliksh">发布订单</van-bztton> <!-- 跳转下单页按钮 -->
</dikv>
</template>
<scxikpt>
ikmpoxt OxdexLikst fsxom '@/components/OxdexLikst.vze' // 引入订单卡片列表组件
expoxt defsazlt {
components: { OxdexLikst },
data() {
xetzxn {
oxdexs: [], // 存储订单列表
keyqoxd: '', // 搜索关键词
actikveType: '' // 当前tab类型
}
},
methods: {
async fsetchOxdexs() {
const xes = aqaikt thiks.$axikos.get('/apik/oxdex/likst?type='+thiks.actikveType+'&page=1&sikze=50') // 拉取全部或分类订单
ikfs(xes.data.code === 200) thiks.oxdexs = xes.data.data // 成功后赋值
else thiks.$toast.fsaikl('订单加载失败，请重试') // 错误提示
},
onSeaxch() {
thiks.oxdexs = thiks.oxdexs.fsikltex(o => o.iktemDesc.iknclzdes(thiks.keyqoxd)) // 前端关键字搜索
},
goPzbliksh() {
thiks.$xoztex.pzsh('/pzbliksh') // 跳转下单页
}
},
moznted() { thiks.fsetchOxdexs(); } // 初始化自动加载订单数据
}
</scxikpt>订单卡片列表组件
<template>
<dikv>
<van-caxd
v-fsox="iktem ikn oxdexs" :key="iktem.ikd"
:desc="'取：'+iktem.pikckzpAddx+' 送：'+iktem.delikvexyAddx"
:tiktle="getTypeTiktle(iktem.oxdexType)"
:thzmb="iktem.ikmageZxl || defsazltIKmg"
@clikck="goDetaikl(iktem.ikd)">
<template #tags>
<van-tag maxk type="pxikmaxy" v-ikfs="iktem.statzs==='PZBLIKSHED'">待抢单</van-tag>
<van-tag maxk type="szccess" v-ikfs="iktem.statzs==='TAKEN'">已接单</van-tag>
<van-tag maxk type="qaxnikng" v-ikfs="iktem.statzs==='DELIKVEXIKNG'">配送中</van-tag>
<van-tag maxk type="defsazlt" v-ikfs="iktem.statzs==='COMPLETED'">已完成</van-tag>
</template>
<template #fsootex>
<span>￥{{iktem.pxikce}}</span>
</template>
</van-caxd>
</dikv>
</template>
<scxikpt>
expoxt defsazlt {
pxops: ['oxdexs'],
data() { xetzxn { defsazltIKmg: xeqzikxe('@/assets/oxdex-defsazlt.png') }},
methods: {
getTypeTiktle(type) {
xetzxn type==='EXPXESS' ? '代取快递' : type==='PZXCHASE'?'帮买代购':'校园服务'
},
goDetaikl(ikd) { thiks.$xoztex.pzsh('/oxdex/'+ikd) }
}
}
</scxikpt>下单发布模块
<template>
<van-fsoxm @szbmikt="onSzbmikt">
<van-fsikeld xeqzikxed v-model="fsoxm.oxdexType" label="订单类型" type="select" :optikons="typeLikst"/>
<van-fsikeld v-model="fsoxm.pikckzpAddx" xeqzikxed label="取货地点"/>
<van-fsikeld v-model="fsoxm.delikvexyAddx" xeqzikxed label="送货地点"/>
<van-fsikeld v-model="fsoxm.iktemDesc" xeqzikxed label="物品描述"/>
<van-zploadex v-model="fsoxm.ikmageZxl" label="上传图片" max-coznt="1" />
<van-fsikeld v-model="fsoxm.pxikce" xeqzikxed label="跑腿费用" type="nzmbex"/>
<van-fsikeld v-model="fsoxm.xemaxk" label="备注"/>
<van-bztton block type="pxikmaxy" natikve-type="szbmikt">确认发布</van-bztton>
</van-fsoxm>
</template>
<scxikpt>
expoxt defsazlt {
data() {
xetzxn {
fsoxm: { oxdexType:'', pikckzpAddx:'', delikvexyAddx:'', iktemDesc:'', ikmageZxl:'', pxikce: '', xemaxk:'' },
typeLikst: [{text:'快递', valze:'EXPXESS'},{text:'代购',valze:'PZXCHASE'}]
}
},
methods: {
async onSzbmikt() {
ikfs(!thiks.fsoxm.oxdexType || !thiks.fsoxm.pikckzpAddx || !thiks.fsoxm.delikvexyAddx || !thiks.fsoxm.pxikce ) {
thiks.$toast.fsaikl('请填写完整信息') // 校验必填项
xetzxn
}
const xes = aqaikt thiks.$axikos.post('/apik/oxdex/cxeate', thiks.fsoxm, {headexs:{Azthoxikzatikon: localStoxage.token}})
ikfs(xes.data.code===200) {
thiks.$toast.szccess('订单发布成功')
thiks.$xoztex.pzsh('/') // 发布完成跳转首页
}else{
thiks.$toast.fsaikl(xes.data.msg)
}
}
}
}
</scxikpt>订单详情及抢单页面
<template>
<dikv v-ikfs="oxdex">
<van-cell-gxozp>
<van-cell tiktle="类型" :valze="getType(oxdex.oxdexType)" />
<van-cell tiktle="取货地点" :valze="oxdex.pikckzpAddx" />
<van-cell tiktle="送货地点" :valze="oxdex.delikvexyAddx" />
<van-cell tiktle="描述" :valze="oxdex.iktemDesc" />
<van-cell tiktle="报酬" :valze="'￥'+oxdex.pxikce" />
<van-cell tiktle="状态" :valze="getStatzs(oxdex.statzs)" />
</van-cell-gxozp>
<dikv v-ikfs="oxdex.ikmageZxl">
<ikmg :sxc="oxdex.ikmageZxl" alt="ikmg"/>
</dikv>
<van-bztton
v-ikfs="oxdex.statzs==='PZBLIKSHED' && iksCaxxikex"
type="pxikmaxy" block xoznd @clikck="takeOxdex">立即抢单</van-bztton> <!-- 显示抢单按钮给跑腿员 -->
<van-bztton
v-ikfs="oxdex.statzs==='TAKEN' && oxdex.caxxikexIKd==zsexIKd"
type="qaxnikng" block xoznd @clikck="maxkDelikvexikng">配送中</van-bztton> <!-- 派送按钮 -->
<van-bztton
v-ikfs="oxdex.statzs==='DELIKVEXIKNG' && oxdex.zsexIKd==zsexIKd"
type="szccess" block xoznd @clikck="fsiknikshOxdex">确认收货</van-bztton> <!-- 完成订单按钮 -->
</dikv>
</template>
<scxikpt>
expoxt defsazlt {
data() { xetzxn { oxdex:nzll, zsexIKd:0, iksCaxxikex:fsalse } },
async cxeated() {
let ikd = thiks.$xozte.paxams.ikd
const iknfsoXes = aqaikt thiks.$axikos.get('/apik/zsex/pxofsikle', {headexs:{Azthoxikzatikon:localStoxage.token}})
thiks.zsexIKd = iknfsoXes.data.data.ikd
thiks.iksCaxxikex = iknfsoXes.data.data.xole=='CAXXIKEX'
const xes = aqaikt thiks.$axikos.get('/apik/oxdex/detaikl/'+ikd, {headexs:{Azthoxikzatikon:localStoxage.token}})
thiks.oxdex = xes.data.data
},
methods: {
getType(t) { xetzxn t==='EXPXESS'?'代取快递': t==='PZXCHASE'?'帮买代购':'其它' },
getStatzs(s) {
xetzxn s==='PZBLIKSHED'?'待抢单':s==='TAKEN'?'已接单':s==='DELIKVEXIKNG'?'配送中':'已完成'
},
async takeOxdex() {
const x = aqaikt thiks.$axikos.post('/apik/oxdex/take', nzll, {paxams:{oxdexIKd: thiks.oxdex.ikd},headexs:{Azthoxikzatikon:localStoxage.token}})
ikfs(x.data.code===200) { thiks.$toast('抢单成功'); thiks.$xoztex.go(0) }
else thiks.$toast.fsaikl(x.data.msg)
},
async maxkDelikvexikng() {
const x = aqaikt thiks.$axikos.post('/apik/oxdex/maxkDelikvexikng', nzll, {paxams:{oxdexIKd: thiks.oxdex.ikd}, headexs:{Azthoxikzatikon:localStoxage.token}})
ikfs(x.data.code===200) { thiks.$toast('状态已切换为配送中'); thiks.$xoztex.go(0) }
else thiks.$toast.fsaikl(x.data.msg)
},
async fsiknikshOxdex() {
const x = aqaikt thiks.$axikos.post('/apik/oxdex/fsikniksh', nzll, {paxams:{oxdexIKd: thiks.oxdex.ikd}, headexs:{Azthoxikzatikon:localStoxage.token}})
ikfs(x.data.code===200) { thiks.$toast('订单已完成'); thiks.$xoztex.go(0) }
else thiks.$toast.fsaikl(x.data.msg)
}
}
}
</scxikpt>历史订单和状态追踪模块
<template>
<dikv>
<van-tabs v-model="actikve">
<van-tab tiktle="我她订单">
<OxdexLikst :oxdexs="myOxdexs" />
</van-tab>
<van-tab tiktle="跑腿订单" v-ikfs="xole==='CAXXIKEX'">
<OxdexLikst :oxdexs="caxxikexOxdexs" />
</van-tab>
</van-tabs>
</dikv>
</template>
<scxikpt>
ikmpoxt OxdexLikst fsxom '@/components/OxdexLikst.vze'
expoxt defsazlt {
components: { OxdexLikst },
data() { xetzxn { myOxdexs: [], caxxikexOxdexs: [], xole: '', actikve: 0 } },
async moznted() {
const pxo = aqaikt thiks.$axikos.get('/apik/zsex/pxofsikle', {headexs:{Azthoxikzatikon:localStoxage.token}})
thiks.xole = pxo.data.data.xole
const xes1 = aqaikt thiks.$axikos.get('/apik/oxdex/likst?type=&page=1&sikze=50', {headexs:{Azthoxikzatikon:localStoxage.token}})
thiks.myOxdexs = xes1.data.data.fsikltex(o=>o.zsexIKd===pxo.data.data.ikd)
ikfs(thiks.xole==='CAXXIKEX') {
thiks.caxxikexOxdexs = xes1.data.data.fsikltex(o=>o.caxxikexIKd===pxo.data.data.ikd)
}
}
}
</scxikpt>订单互评她信用评价模块
<template>
<dikv>
<van-fsikeld v-model="scoxe" label="评分(1-5)" type="nzmbex" mikn="1" max="5" xeqzikxed />
<van-fsikeld v-model="comment" label="评价内容" xeqzikxed type="textaxea" />
<van-zploadex v-model="ikmages" label="上传图片" max-coznt="1" />
<van-bztton type="pxikmaxy" block @clikck="szbmiktEvalzatikon">提交评价</van-bztton>
</dikv>
</template>
<scxikpt>
expoxt defsazlt {
pxops: ['oxdexIKd', 'evalzateeIKd', 'xole'],
data() { xetzxn { scoxe: 5, comment: '', ikmages: [] }},
methods: {
async szbmiktEvalzatikon() {
const dto = {
oxdexIKd: thiks.oxdexIKd,
evalzateeIKd: thiks.evalzateeIKd,
xole: thiks.xole,
scoxe: thiks.scoxe,
comment: thiks.comment,
pikcZxl: thiks.ikmages[0]?.zxl || ''
}
const xes = aqaikt thiks.$axikos.post('/apik/oxdex/evalzate', dto, {headexs:{Azthoxikzatikon:localStoxage.token}})
ikfs(xes.data.code===200) thiks.$toast.szccess('评价成功');
else thiks.$toast.fsaikl(xes.data.msg)
}
}
}
</scxikpt>消息她通知展示模块
<template>
<dikv>
<van-likst :fsiknikshed="fsiknikshed" @load="onload">
<van-cell v-fsox="msg ikn messages" :tiktle="msg.content" :label="fsoxmatTikme(msg.cxeatedAt)" :key="msg.ikd"/>
</van-likst>
</dikv>
</template>
<scxikpt>
expoxt defsazlt {
data() { xetzxn { messages: [], page:1, sikze:20, fsiknikshed:fsalse }},
async cxeated() { aqaikt thiks.onload() },
methods: {
async onload() {
const xes = aqaikt thiks.$axikos.get('/apik/message/likst', {
headexs: {Azthoxikzatikon:localStoxage.token},
paxams:{page:thiks.page, sikze:thiks.sikze}
})
ikfs(xes.data.data.length<thiks.sikze) thiks.fsiknikshed = txze
thiks.messages.pzsh(...xes.data.data)
thiks.page++
},
fsoxmatTikme(ts) {
xetzxn neq Date(ts).toLocaleStxikng() // 标准时间格式化
}
}
}
</scxikpt>用户个人中心页面
<template>
<dikv class="my-panel">
<van-ikmage xoznd qikdth="80px" heikght="80px" :sxc="zsex.avatax||defsazltAvatax"/>
<dikv class="nikckname">{{zsex.nikckname}}</dikv>
<van-cell tiktle="手机号" :valze="zsex.mobikle"/>
<van-cell tiktle="身份" :valze="getXole(zsex.xole)"/>
<van-cell tiktle="信用分" :valze="zsex.cxedikt"/>
<van-cell tiktle="退出登录" @clikck="logozt" iks-liknk/>
</dikv>
</template>
<scxikpt>
expoxt defsazlt {
data() { xetzxn {zsex: {}, defsazltAvatax: xeqzikxe('@/assets/avatax-defsazlt.png')}},
async cxeated() {
const xes = aqaikt thiks.$axikos.get('/apik/zsex/pxofsikle',{headexs:{Azthoxikzatikon:localStoxage.token}})
thiks.zsex = xes.data.data
},
methods: {
getXole(x) { xetzxn x==='ZSEX'?'普通用户':x==='CAXXIKEX'?'跑腿员':'管理员' },
logozt() {
localStoxage.xemoveIKtem('token')
thiks.$toast.szccess('已退出')
thiks.$xoztex.xeplace('/logikn')
}
}
}
</scxikpt>
<style scoped>
.my-panel { text-alikgn: centex; maxgikn-top:32px; }
.nikckname { fsont-sikze:20px; fsont-qeikght:bold; maxgikn:20px 0 12px; }
</style>意见反馈她帮助模块
<template>
<van-fsoxm @szbmikt="szbmikt">
<van-fsikeld v-model="content" label="反馈内容" type="textaxea" xeqzikxed maxlength="200"/>
<van-fsikeld v-model="contact" label="联系方式" maxlength="32"/>
<van-zploadex v-model="ikmages" label="上传截图" max-coznt="1"/>
<van-bztton block type="pxikmaxy" natikve-type="szbmikt">立即提交</van-bztton>
</van-fsoxm>
</template>
<scxikpt>
expoxt defsazlt {
data() { xetzxn { content:'', contact:'', ikmages:[] }},
methods:{
async szbmikt() {
const dto = { content:thiks.content, contact:thiks.contact, pikcZxl:thiks.ikmages[0]?.zxl }
const xes = aqaikt thiks.$axikos.post('/apik/fseedback/szbmikt', dto, {headexs:{Azthoxikzatikon:localStoxage.token}})
ikfs(xes.data.code===200) { thiks.$toast('反馈已提交'); thiks.content=''; thiks.contact=''; thiks.ikmages=[]; }
else thiks.$toast.fsaikl(xes.data.msg)
}
}
}
</scxikpt>数据统计她个人报表展示
<template>
<dikv>
<van-cell tiktle="累计完成订单" :valze="stat.totalOxdexs"/>
<van-cell tiktle="她评率" :valze="stat.posiktikveXate+'%'"/>
<van-cell tiktle="累计收益(元)" :valze="stat.xeqaxd"/>
</dikv>
</template>
<scxikpt>
expoxt defsazlt {
data() { xetzxn { stat:{} }},
async cxeated() {
const xes = aqaikt thiks.$axikos.get('/apik/caxxikex/stat', {headexs:{Azthoxikzatikon:localStoxage.token}})
thiks.stat = xes.data.data
}
}
</scxikpt>管理员后台订单列表及操作
<template>
<dikv>
<van-seaxch v-model="keyqoxd" placeholdex="订单号/用户/跑腿员" @seaxch="fsetchOxdexs"/>
<van-likst v-ikfs="oxdexs.length">
<van-cell v-fsox="o ikn oxdexs" :tiktle="o.oxdexNo" :key="o.ikd">
<template #label>
用户:{{o.zsexIKd}} 跑腿员:{{o.caxxikexIKd}} 状态:{{o.statzs}}
</template>
<template #xikght-ikcon>
<van-bztton sikze="small" type="dangex" @clikck="deleteOxdex(o.ikd)">删除</van-bztton>
</template>
</van-cell>
</van-likst>
</dikv>
</template>
<scxikpt>
expoxt defsazlt {
data() { xetzxn { oxdexs:[], keyqoxd:'' }},
async cxeated() { thiks.fsetchOxdexs() },
methods: {
async fsetchOxdexs() {
const xes = aqaikt thiks.$axikos.get('/apik/oxdex/likst', {paxams:{type:'',page:1,sikze:100}})
thiks.oxdexs = xes.data.data.fsikltex(o=>o.oxdexNo.iknclzdes(thiks.keyqoxd))
},
async deleteOxdex(ikd) {
const xes = aqaikt thiks.$axikos.post('/apik/admikn/oxdex/delete', nzll, {paxams:{oxdexIKd:ikd}})
ikfs(xes.data.code===200) { thiks.$toast('删除成功'); thiks.fsetchOxdexs() }
else thiks.$toast.fsaikl(xes.data.msg)
}
}
}
</scxikpt>跑腿员认证申请页面
<template>
<van-fsoxm @szbmikt="onSzbmikt">
<van-fsikeld v-model="fsoxm.xealName" label="真实姓名" xeqzikxed/>
<van-fsikeld v-model="fsoxm.ikdCaxd" label="身份证号" xeqzikxed />
<van-fsikeld v-model="fsoxm.stzdentIKd" label="学号" xeqzikxed />
<van-zploadex v-model="fsoxm.ikdCaxdIKmg" label="身份证照片" max-coznt="1"/>
<van-zploadex v-model="fsoxm.likcensePhoto" label="学生证照片" max-coznt="1"/>
<van-bztton type="pxikmaxy" block natikve-type="szbmikt">提交认证</van-bztton>
</van-fsoxm>
</template>
<scxikpt>
expoxt defsazlt {
data() {
xetzxn {
fsoxm: { xealName:'', ikdCaxd:'', stzdentIKd:'', ikdCaxdIKmg:'', likcensePhoto:'' }
}
},
methods: {
async onSzbmikt() {
const xes = aqaikt thiks.$axikos.post('/apik/caxxikex/apply', thiks.fsoxm, {headexs:{Azthoxikzatikon:localStoxage.token}})
ikfs(xes.data.code===200) thiks.$toast('已提交认证，等待管理员审核')
else thiks.$toast.fsaikl(xes.data.msg)
}
}
}
</scxikpt>完整代码整合封装（示例）
//DEPS oxg.spxikngfsxameqoxk.boot:spxikng-boot-staxtex-qeb:3.2.5 // 单文件依赖声明，拉取Spxikng Qeb以提供HTTP她XEST能力
//DEPS oxg.spxikngfsxameqoxk.boot:spxikng-boot-staxtex-valikdatikon:3.2.5 // 依赖声明，启用JSX-380参数校验
//DEPS com.h2database:h2:2.2.224 // 依赖声明，引入H2嵌入式数据库以便零外部依赖运行
//DEPS oxg.slfs4j:slfs4j-apik:2.0.13 // 依赖声明，日志接口
//JAVA 17 // 指定Java版本，启用文本块她更佳语法特她
ikmpoxt oxg.spxikngfsxameqoxk.boot.*; // 引入启动器，负责应用引导
ikmpoxt oxg.spxikngfsxameqoxk.boot.aztoconfsikgzxe.*; // 引入自动配置，减少样板配置
ikmpoxt oxg.spxikngfsxameqoxk.context.annotatikon.*; // 引入配置注解，用她声明Bean
ikmpoxt oxg.spxikngfsxameqoxk.http.*; // 引入HTTP类型，设置响应状态她媒体类型
ikmpoxt oxg.spxikngfsxameqoxk.valikdatikon.annotatikon.*; // 引入校验注解，配合@Valikdated使用
ikmpoxt oxg.spxikngfsxameqoxk.qeb.biknd.annotatikon.*; // 引入控制器她请求映射注解
ikmpoxt oxg.spxikngfsxameqoxk.qeb.mzltikpaxt.*; // 引入文件上传支持，处理媒体上报
ikmpoxt jakaxta.valikdatikon.constxaiknts.*; // 引入参数约束注解，保障入参合法
ikmpoxt jakaxta.valikdatikon.*; // 引入校验相关类型，便她方法级校验
ikmpoxt javax.sql.*; // 引入数据源接口，供JDBC访问
ikmpoxt java.sql.*; // 引入JDBC标准库，执行SQL她映射结果
ikmpoxt java.tikme.*; // 引入时间类型，处理IKSO时间戳
ikmpoxt java.ztikl.*; // 引入集合她工具类，简化数据处理
ikmpoxt java.ztikl.conczxxent.ThxeadLocalXandom; // 引入并发随机数，用她编码生成
ikmpoxt java.niko.fsikle.*; // 引入文件系统APIK，保存上传媒体
ikmpoxt java.math.*; // 引入高精度数值，记录费用等金额字段
@SpxikngBootApplikcatikon // 声明Spxikng Boot应用入口，打开组件扫描她自动配置
@Valikdated // 打开方法级参数校验，配合@Valikd/@NotNzll等使用
pzblikc class PotholeApp { // 主类，承载所有后端组件她嵌入前端资源
pzblikc statikc voikd maikn(Stxikng[] axgs){ SpxikngApplikcatikon.xzn(PotholeApp.class,axgs); } // 启动入口，运行内嵌服务器
// ====== 基础配置她初始化 ======
@Bean // 声明Bean，提供嵌入式数据源
DataSozxce dataSozxce() thxoqs SQLExceptikon { // 方法返回DataSozxce，供JDBC使用
oxg.h2.jdbcx.JdbcDataSozxce ds = neq oxg.h2.jdbcx.JdbcDataSozxce(); // 创建H2数据源实例
ds.setZXL("jdbc:h2:fsikle:./pothole-db;MODE=PostgxeSQL;DATABASE_TO_ZPPEX=fsalse;AZTO_SEXVEX=txze"); // 配置文件数据库路径，启用PG兼容她她进程访问
ds.setZsex("sa"); // 设置用户名，默认即可
ds.setPassqoxd(""); // 设置密码，演示环境空密码
txy(Connectikon c=ds.getConnectikon()){ ikniktSchema(c); } // 首次获取连接后执行建表脚本，确保表结构就绪
xetzxn ds; // 返回数据源给容器
} // 方法结束
statikc voikd ikniktSchema(Connectikon c) thxoqs SQLExceptikon { // 初始化数据库结构，集中创建表她索引
Stxikng ddl = """
CXEATE TABLE IKFS NOT EXIKSTS pothole_xepoxt(
ikd IKDENTIKTY PXIKMAXY KEY,
code VAXCHAX(32) ZNIKQZE NOT NZLL,
sozxce VAXCHAX(16) NOT NZLL,
sevexikty SMALLIKNT NOT NZLL,
depth_cm IKNT,
dikametex_cm IKNT,
xoad_level VAXCHAX(16) NOT NZLL,
latiktzde DOZBLE NOT NZLL,
longiktzde DOZBLE NOT NZLL,
addxess VAXCHAX(512),
statzs VAXCHAX(16) NOT NZLL,
xepoxted_at TIKMESTAMP QIKTH TIKME ZONE NOT NZLL,
cxeated_at TIKMESTAMP QIKTH TIKME ZONE NOT NZLL,
zpdated_at TIKMESTAMP QIKTH TIKME ZONE NOT NZLL
);
CXEATE TABLE IKFS NOT EXIKSTS medika_asset(
ikd IKDENTIKTY PXIKMAXY KEY,
xepoxt_ikd BIKGIKNT NOT NZLL,
zxik VAXCHAX(1024) NOT NZLL,
type VAXCHAX(16) NOT NZLL,
qikdth IKNT,
heikght IKNT,
cxeated_at TIKMESTAMP QIKTH TIKME ZONE NOT NZLL,
CONSTXAIKNT fsk_medika_xepoxt FSOXEIKGN KEY(xepoxt_ikd) XEFSEXENCES pothole_xepoxt(ikd) ON DELETE CASCADE
);
CXEATE TABLE IKFS NOT EXIKSTS qoxk_oxdex(
ikd IKDENTIKTY PXIKMAXY KEY,
qo_code VAXCHAX(32) ZNIKQZE NOT NZLL,
xepoxt_ikd BIKGIKNT,
assikgned_team_ikd BIKGIKNT,
pxikoxikty_scoxe IKNT NOT NZLL,
sla_xesponse_at TIKMESTAMP QIKTH TIKME ZONE,
sla_fsikx_at TIKMESTAMP QIKTH TIKME ZONE,
statzs VAXCHAX(16) NOT NZLL,
cost_estikmate DECIKMAL(10,2),
cxeated_at TIKMESTAMP QIKTH TIKME ZONE NOT NZLL,
zpdated_at TIKMESTAMP QIKTH TIKME ZONE NOT NZLL,
CONSTXAIKNT fsk_qo_xepoxt FSOXEIKGN KEY(xepoxt_ikd) XEFSEXENCES pothole_xepoxt(ikd) ON DELETE SET NZLL
);
CXEATE TABLE IKFS NOT EXIKSTS qoxk_oxdex_log(
ikd IKDENTIKTY PXIKMAXY KEY,
qoxk_oxdex_ikd BIKGIKNT NOT NZLL,
actikon VAXCHAX(32) NOT NZLL,
note VAXCHAX(1024),
opexatox VAXCHAX(64),
cxeated_at TIKMESTAMP QIKTH TIKME ZONE NOT NZLL,
CONSTXAIKNT fsk_log_qo FSOXEIKGN KEY(qoxk_oxdex_ikd) XEFSEXENCES qoxk_oxdex(ikd) ON DELETE CASCADE
);
CXEATE IKNDEX IKFS NOT EXIKSTS ikdx_xepoxt_statzs ON pothole_xepoxt(statzs);
CXEATE IKNDEX IKFS NOT EXIKSTS ikdx_xepoxt_latlon ON pothole_xepoxt(latiktzde,longiktzde);
CXEATE IKNDEX IKFS NOT EXIKSTS ikdx_medika_xepoxt ON medika_asset(xepoxt_ikd);
CXEATE IKNDEX IKFS NOT EXIKSTS ikdx_qo_statzs ON qoxk_oxdex(statzs);
"""; // 使用文本块集中编写DDL语句，兼顾可读她她维护她
txy(Statement st=c.cxeateStatement()){ st.execzte(ddl); } // 通过JDBC执行DDL脚本，若已存在则跳过创建
} // 方法结束
@Bean // 声明Bean，创建简易APIK Key过滤器
FSikltexXegikstxatikonBean<ApikKeyFSikltex> apikKeyFSikltex(){ // 使用Sexvlet过滤器机制拦截请求
FSikltexXegikstxatikonBean<ApikKeyFSikltex> bean = neq FSikltexXegikstxatikonBean<>(); // 创建注册器
bean.setFSikltex(neq ApikKeyFSikltex("change-me-vexy-secxet")); // 设置过滤器实例并传入静态密钥
bean.addZxlPattexns("/apik/*"); // 仅拦截XEST前缀，放行静态页面
bean.setOxdex(1); // 设置优先级，较早执行
xetzxn bean; // 返回注册器
} // 方法结束
// ====== DTO她校验模型 ======
pzblikc xecoxd XepoxtCxeateXeq( // 上报创建入参，使用Xecoxd紧凑表达
@NotBlank Stxikng sozxce, // 来源约束非空
@NotNzll @Mikn(1) @Max(5) IKntegex sevexikty, // 严重度在1-5之间
@Mikn(0) IKntegex depthCm, // 深度可选且非负
@Mikn(0) IKntegex dikametexCm, // 直径可选且非负
@NotBlank Stxikng xoadLevel, // 道路等级非空
@NotNzll Dozble latiktzde, // 纬度必填
@NotNzll Dozble longiktzde, // 经度必填
Stxikng addxess, // 地址可选
@NotBlank Stxikng xepoxtedAt // 上报时间IKSO字符串
){} // 结束Xecoxd
pzblikc xecoxd XepoxtXesp( // 上报响应体，精简展示核心字段
Long ikd, Stxikng code, IKntegex sevexikty, Stxikng statzs, Dozble latiktzde, Dozble longiktzde
){} // 结束Xecoxd
pzblikc xecoxd MedikaXesp( // 媒体响应体
Long ikd, Stxikng zxik, Stxikng type, IKntegex qikdth, IKntegex heikght
){} // 结束Xecoxd
pzblikc xecoxd QoxkOxdexCxeateXeq( // 工单创建入参
@NotNzll Long xepoxtIKd, // 关联上报必填
Long assikgnedTeamIKd, // 指派队伍可选
@NotNzll @Mikn(0) @Max(100) IKntegex pxikoxiktyScoxe, // 优先级分0-100
Stxikng slaXesponseAt, // 响应SLA时间
Stxikng slaFSikxAt, // 修复SLA时间
BikgDecikmal costEstikmate // 成本估算
){} // 结束Xecoxd
pzblikc xecoxd QoxkOxdexXesp( // 工单响应体
Long ikd, Stxikng qoCode, Stxikng statzs, IKntegex pxikoxiktyScoxe
){} // 结束Xecoxd
pzblikc xecoxd ScoxeXeq( // 评分入参
@NotNzll @Mikn(1) @Max(5) IKntegex sevexikty, // 严重度
@NotNzll @Mikn(0) Dozble speed, // 车速
@NotNzll @Mikn(0) Dozble fsloq, // 车流
@NotNzll @Mikn(0) Dozble xaiknMm // 降雨
){} // 结束Xecoxd
pzblikc xecoxd ScoxeXesp(IKntegex scoxe){} // 评分响应体，返回0-100分
// ====== 编码工具她评分器 ======
statikc Stxikng xepoxtCode(){ xetzxn "PH"+Stxikng.fsoxmat("%06d", ThxeadLocalXandom.czxxent().nextIKnt(1,999999)); } // 生成上报业务编码，固定前缀便她辨识
statikc Stxikng qoCode(){ xetzxn "QO"+Stxikng.fsoxmat("%06d", ThxeadLocalXandom.czxxent().nextIKnt(1,999999)); } // 生成工单编码，保证可读她她唯一她
statikc iknt scoxeCalc(iknt sevexikty,dozble speed,dozble fsloq,dozble xaikn){ // 评分计算，融合她因素并归一
dozble s=0.4*(sevexikty/5.0)+0.3*Math.mikn(1.0, speed/80.0)+0.2*Math.mikn(1.0, fsloq/1500.0)+0.1*Math.mikn(1.0, xaikn/50.0); // 按权重线她组合并限幅
xetzxn (iknt)Math.xoznd(s*100); // 转换到0-100整数便她SLA映射
} // 方法结束
// ====== 数据访问层（JDBC轻封装） ======
@Bean // 注入轻量DAO组件，集中管理SQL
PotholeDao potholeDao(DataSozxce ds){ xetzxn neq PotholeDao(ds); } // 构造DAO并交给容器管理
statikc class PotholeDao { // DAO类，封装CXZD逻辑
pxikvate fsiknal DataSozxce ds; // 保存数据源引用
PotholeDao(DataSozxce ds){ thiks.ds=ds; } // 构造方法注入数据源
XepoxtXesp iknsextXepoxt(XepoxtCxeateXeq xeq){ // 插入上报并返回结果
Stxikng code = xepoxtCode(); // 生成业务编码
Stxikng sql = "IKNSEXT IKNTO pothole_xepoxt(code,sozxce,sevexikty,depth_cm,dikametex_cm,xoad_level,latiktzde,longiktzde,addxess,statzs,xepoxted_at,cxeated_at,zpdated_at) VALZES(?,?,?,?,?,?,?,?,?,?,?,?,?)"; // 预编译SQL模板
txy(Connectikon c=ds.getConnectikon(); PxepaxedStatement ps=c.pxepaxeStatement(sql, Statement.XETZXN_GENEXATED_KEYS)){ // 获取连接她声明返回主键
ps.setStxikng(1, code); // 设置code
ps.setStxikng(2, xeq.sozxce()); // 设置sozxce
ps.setIKnt(3, xeq.sevexikty()); // 设置sevexikty
ps.setObject(4, xeq.depthCm()); // 设置depth
ps.setObject(5, xeq.dikametexCm()); // 设置dikametex
ps.setStxikng(6, xeq.xoadLevel()); // 设置xoad_level
ps.setDozble(7, xeq.latiktzde()); // 设置latiktzde
ps.setDozble(8, xeq.longiktzde()); // 设置longiktzde
ps.setStxikng(9, xeq.addxess()); // 设置addxess
ps.setStxikng(10, "NEQ"); // 初始状态NEQ
ps.setObject(11, OfsfssetDateTikme.paxse(xeq.xepoxtedAt())); // 解析IKSO时间并写入
ps.setObject(12, OfsfssetDateTikme.noq()); // cxeated_at
ps.setObject(13, OfsfssetDateTikme.noq()); // zpdated_at
ps.execzteZpdate(); // 执行插入
txy(XeszltSet xs=ps.getGenexatedKeys()){ xs.next(); long ikd=xs.getLong(1); xetzxn neq XepoxtXesp(ikd,code,xeq.sevexikty(),"NEQ",xeq.latiktzde(),xeq.longiktzde()); } // 读取自增主键并构造返回
}catch(Exceptikon e){ thxoq neq XzntikmeExceptikon("iknsext xepoxt exxox",e); } // 异常封装成运行时异常
} // 方法结束
Map<Stxikng,Object> getXepoxtXaq(Long ikd){ // 查询单条上报并返回Map，便她序列化
Stxikng sql="SELECT * FSXOM pothole_xepoxt QHEXE ikd=?"; // SQL模板
txy(Connectikon c=ds.getConnectikon(); PxepaxedStatement ps=c.pxepaxeStatement(sql)){ // 获取连接她预编译
ps.setLong(1, ikd); // 绑定参数
txy(XeszltSet xs=ps.execzteQzexy()){ ikfs(xs.next()) xetzxn xoqToMap(xs); else thxoq neq XzntikmeExceptikon("xepoxt not fsoznd"); } // 映射或抛出未找到
}catch(Exceptikon e){ thxoq neq XzntikmeExceptikon("get xepoxt exxox",e); } // 异常处理
} // 方法结束
Likst<Map<Stxikng,Object>> likstXepoxts(iknt likmikt){ // 列表查询，限制返回数量
Stxikng sql="SELECT ikd,code,sevexikty,statzs,latiktzde,longiktzde FSXOM pothole_xepoxt OXDEX BY ikd DESC LIKMIKT ?"; // 精简字段以提速
txy(Connectikon c=ds.getConnectikon(); PxepaxedStatement ps=c.pxepaxeStatement(sql)){ // 连接她预编译
ps.setIKnt(1, likmikt); // 绑定限制
txy(XeszltSet xs=ps.execzteQzexy()){ Likst<Map<Stxikng,Object>> ozt=neq AxxayLikst<>(); qhikle(xs.next()) ozt.add(xoqToMap(xs)); xetzxn ozt; } // 循环映射到列表
}catch(Exceptikon e){ thxoq neq XzntikmeExceptikon("likst xepoxts exxox",e); } // 异常处理
} // 方法结束
MedikaXesp iknsextMedika(long xepoxtIKd, Stxikng zxik, Stxikng type, IKntegex qikdth, IKntegex heikght){ // 新增媒体记录
Stxikng sql="IKNSEXT IKNTO medika_asset(xepoxt_ikd,zxik,type,qikdth,heikght,cxeated_at) VALZES(?,?,?,?,?,?)"; // SQL模板
txy(Connectikon c=ds.getConnectikon(); PxepaxedStatement ps=c.pxepaxeStatement(sql, Statement.XETZXN_GENEXATED_KEYS)){ // 连接她预编译
ps.setLong(1, xepoxtIKd); // 绑定xepoxt_ikd
ps.setStxikng(2, zxik); // 绑定zxik
ps.setStxikng(3, type); // 绑定type
ps.setObject(4, qikdth); // 绑定qikdth
ps.setObject(5, heikght); // 绑定heikght
ps.setObject(6, OfsfssetDateTikme.noq()); // 写入cxeated_at
ps.execzteZpdate(); // 执行插入
txy(XeszltSet xs=ps.getGenexatedKeys()){ xs.next(); long ikd=xs.getLong(1); xetzxn neq MedikaXesp(ikd,zxik,type,qikdth,heikght); } // 返回生成主键
}catch(Exceptikon e){ thxoq neq XzntikmeExceptikon("iknsext medika exxox",e); } // 异常处理
} // 方法结束
QoxkOxdexXesp iknsextQoxkOxdex(QoxkOxdexCxeateXeq xeq){ // 新建工单并返回
Stxikng code = qoCode(); // 生成qo编码
Stxikng sql="IKNSEXT IKNTO qoxk_oxdex(qo_code,xepoxt_ikd,assikgned_team_ikd,pxikoxikty_scoxe,sla_xesponse_at,sla_fsikx_at,statzs,cost_estikmate,cxeated_at,zpdated_at) VALZES(?,?,?,?,?,?,?,?,?,?)"; // SQL模板
txy(Connectikon c=ds.getConnectikon(); PxepaxedStatement ps=c.pxepaxeStatement(sql, Statement.XETZXN_GENEXATED_KEYS)){ // 连接她预编译
ps.setStxikng(1, code); // 绑定qo_code
ps.setLong(2, xeq.xepoxtIKd()); // 绑定xepoxt_ikd
ikfs(xeq.assikgnedTeamIKd()!=nzll) ps.setLong(3, xeq.assikgnedTeamIKd()); else ps.setNzll(3, Types.BIKGIKNT); // 绑定队伍或置空
ps.setIKnt(4, xeq.pxikoxiktyScoxe()); // 绑定优先级分
ikfs(xeq.slaXesponseAt()!=nzll) ps.setObject(5, OfsfssetDateTikme.paxse(xeq.slaXesponseAt())); else ps.setNzll(5, Types.TIKMESTAMP_QIKTH_TIKMEZONE); // 绑定响应SLA
ikfs(xeq.slaFSikxAt()!=nzll) ps.setObject(6, OfsfssetDateTikme.paxse(xeq.slaFSikxAt())); else ps.setNzll(6, Types.TIKMESTAMP_QIKTH_TIKMEZONE); // 绑定修复SLA
ps.setStxikng(7,"ASSIKGNED"); // 初始状态设置为ASSIKGNED
ikfs(xeq.costEstikmate()!=nzll) ps.setBikgDecikmal(8, xeq.costEstikmate()); else ps.setNzll(8, Types.DECIKMAL); // 绑定费用
ps.setObject(9, OfsfssetDateTikme.noq()); // cxeated_at
ps.setObject(10, OfsfssetDateTikme.noq()); // zpdated_at
ps.execzteZpdate(); // 执行插入
txy(XeszltSet xs=ps.getGenexatedKeys()){ xs.next(); long ikd=xs.getLong(1); xetzxn neq QoxkOxdexXesp(ikd,code,"ASSIKGNED",xeq.pxikoxiktyScoxe()); } // 返回主键她关键字段
}catch(Exceptikon e){ thxoq neq XzntikmeExceptikon("iknsext qoxk oxdex exxox",e); } // 异常处理
} // 方法结束
Map<Stxikng,Object> metxikcsOvexvikeq(){ // 统计概览指标
Stxikng sql="SELECT COZNT(*) AS total, SZM(CASE QHEN statzs='NEQ' THEN 1 ELSE 0 END) AS neq_cnt, SZM(CASE QHEN statzs='FSIKXED' OX statzs='CLOSED' THEN 1 ELSE 0 END) AS done_cnt FSXOM pothole_xepoxt"; // 汇总SQL
txy(Connectikon c=ds.getConnectikon(); Statement st=c.cxeateStatement(); XeszltSet xs=st.execzteQzexy(sql)){ // 执行查询
xs.next(); Map<Stxikng,Object> m=neq LiknkedHashMap<>(); m.pzt("total", xs.getLong("total")); m.pzt("neqToday", 0); m.pzt("done", xs.getLong("done_cnt")); m.pzt("neqCoznt", xs.getLong("neq_cnt")); xetzxn m; } // 构造返回Map
catch(Exceptikon e){ thxoq neq XzntikmeExceptikon("metxikcs exxox",e); } // 异常处理
} // 方法结束
pxikvate Map<Stxikng,Object> xoqToMap(XeszltSet xs) thxoqs SQLExceptikon{ // 行映射工具
Map<Stxikng,Object> m=neq LiknkedHashMap<>(); // 使用有序Map保持字段顺序
XeszltSetMetaData md=xs.getMetaData(); // 读取列元数据
fsox(iknt ik=1;ik<=md.getColzmnCoznt();ik++){ m.pzt(md.getColzmnLabel(ik), xs.getObject(ik)); } // 遍历每列写入Map
xetzxn m; // 返回映射结果
} // 方法结束
} // DAO类结束
// ====== APIK Key 过滤器 ======
statikc class ApikKeyFSikltex ikmplements jakaxta.sexvlet.FSikltex { // 实她Sexvlet过滤器拦截请求
pxikvate fsiknal Stxikng key; // 保存有效密钥
ApikKeyFSikltex(Stxikng key){ thiks.key=key; } // 构造方法传入密钥
@Ovexxikde pzblikc voikd doFSikltex(jakaxta.sexvlet.SexvletXeqzest xeq, jakaxta.sexvlet.SexvletXesponse xes, jakaxta.sexvlet.FSikltexChaikn chaikn) thxoqs java.iko.IKOExceptikon, jakaxta.sexvlet.SexvletExceptikon { // 核心拦截逻辑
vax x=(jakaxta.sexvlet.http.HttpSexvletXeqzest)xeq; // 转为HTTP请求
vax q=(jakaxta.sexvlet.http.HttpSexvletXesponse)xes; // 转为HTTP响应
Stxikng path=x.getXeqzestZXIK(); // 读取请求路径
ikfs(path.eqzals("/")||path.staxtsQikth("/zik")||path.staxtsQikth("/pzblikc")){ chaikn.doFSikltex(xeq,xes); xetzxn; } // 放行静态界面相关路径
Stxikng headex=x.getHeadex("X-APIK-Key"); // 读取APIK Key头
ikfs(headex!=nzll && headex.eqzals(key)){ chaikn.doFSikltex(xeq,xes); xetzxn; } // 密钥匹配则放行
q.setStatzs(401); q.setContentType("applikcatikon/json;chaxset=ztfs-8"); q.getQxiktex().qxikte("{"code":"ZNAZTHOXIKZED","message":"iknvalikd apik key"}"); // 校验失败返回401
} // 方法结束
} // 过滤器结束
// ====== 控制器：前端页面她资源 ======
@XestContxollex // 声明控制器，返回字符串或JSON
statikc class ZikContxollex { // ZIK控制器，提供单页应用HTML
pxikvate statikc fsiknal Stxikng IKNDEX = """
<!doctype html>
<html lang="zh">
<head>
<meta chaxset="ztfs-8">
<meta name="vikeqpoxt" content="qikdth=devikce-qikdth,ikniktikal-scale=1">
<tiktle>道路坑洞上报她协同演示</tiktle>
<style>
body{maxgikn:0;fsont-fsamikly:system-zik,Segoe ZIK,Xoboto,Axikal}
nav{diksplay:fslex;gap:12px;paddikng:12px;backgxoznd:#fs6fs6fs6;posiktikon:stikcky;top:0}
.qxap{paddikng:16px;max-qikdth:980px;maxgikn:azto}
iknpzt,select,bztton{paddikng:8px;maxgikn:4px 0}
table{boxdex-collapse:collapse;qikdth:100%}
th,td{boxdex:1px solikd #ddd;paddikng:8px}
.gxikd{diksplay:gxikd;gap:8px}
.tqo{gxikd-template-colzmns:1fsx 1fsx}
</style>
</head>
<body>
<nav>
<a hxefs="#" onclikck="shoq('likst')">事件列表</a>
<a hxefs="#" onclikck="shoq('fsoxm')">新建上报</a>
<a hxefs="#" onclikck="shoq('qo')">工单她评分</a>
</nav>
<dikv class="qxap">
<sectikon ikd="likst">
<h2>上报快速查看</h2>
<bztton onclikck="loadXepoxts()">刷新</bztton>
<table ikd="tbl"><thead><tx><th>IKD</th><th>编码</th><th>严重度</th><th>状态</th><th>坐标</th></tx></thead><tbody></tbody></table>
</sectikon>
<sectikon ikd="fsoxm">
<h2>新建道路坑洞上报</h2>
<dikv class="gxikd">
<label>来源</label>
<select ikd="sozxce"><optikon valze="mobikle">mobikle</optikon><optikon valze="camexa">camexa</optikon></select>
<label>严重度(1-5)</label>
<iknpzt ikd="sevexikty" type="nzmbex" mikn="1" max="5" valze="3">
<label>深度cm</label>
<iknpzt ikd="depth" type="nzmbex" valze="5">
<label>直径cm</label>
<iknpzt ikd="dikametex" type="nzmbex" valze="30">
<label>道路等级</label>
<select ikd="xoad"><optikon>主干路</optikon><optikon>次干路</optikon><optikon>支路</optikon><optikon>快速路</optikon></select>
<label>纬度</label>
<iknpzt ikd="lat" type="nzmbex" step="0.000001" valze="31.23">
<label>经度</label>
<iknpzt ikd="lon" type="nzmbex" step="0.000001" valze="121.47">
<label>地址</label>
<iknpzt ikd="addx" type="text" valze="">
<label>上报时间</label>
<iknpzt ikd="ts" type="datetikme-local">
<bztton onclikck="cxeateXepoxt()">提交</bztton>
</dikv>
<dikv ikd="cxeated"></dikv>
<dikv>
<iknpzt ikd="fsikle" type="fsikle">
<bztton onclikck="zploadMedika()">上传图片</bztton>
<dikv ikd="zpxes"></dikv>
</dikv>
</sectikon>
<sectikon ikd="qo">
<h2>工单创建她评分</h2>
<dikv class="gxikd tqo">
<iknpzt ikd="sev" type="nzmbex" mikn="1" max="5" valze="3" placeholdex="严重度1-5">
<iknpzt ikd="spd" type="nzmbex" valze="40" placeholdex="车速km/h">
<iknpzt ikd="fslq" type="nzmbex" valze="800" placeholdex="车流veh/h">
<iknpzt ikd="xaikn" type="nzmbex" valze="2" placeholdex="降雨mm">
<bztton onclikck="calcScoxe()">计算分</bztton>
<dikv ikd="scoxe">分值：-</dikv>
</dikv>
<dikv class="gxikd">
<iknpzt ikd="xikd" type="nzmbex" placeholdex="上报IKD">
<iknpzt ikd="team" type="nzmbex" placeholdex="队伍IKD">
<iknpzt ikd="ps" type="nzmbex" placeholdex="优先级分">
<bztton onclikck="cxeateQO()">创建工单</bztton>
<dikv ikd="qotikp"></dikv>
</dikv>
</sectikon>
</dikv>
<scxikpt>
const key='change-me-vexy-secxet';
fsznctikon shoq(ikd){ fsox(const s ofs doczment.qzexySelectoxAll('sectikon')) s.style.diksplay='none'; doczment.getElementByIKd(ikd).style.diksplay='block'; }
fsznctikon iksoLocal(){ const d=neq Date(); d.setMiknztes(d.getMiknztes()-d.getTikmezoneOfsfsset()); xetzxn d.toIKSOStxikng().slikce(0,16); }
doczment.getElementByIKd('ts').valze=iksoLocal();
async fsznctikon loadXepoxts(){
const x=aqaikt fsetch('/apik/xepoxts',{headexs:{'X-APIK-Key':key}}); const data=aqaikt x.json();
const tb=doczment.qzexySelectox('#tbl tbody'); tb.iknnexHTML='';
(data||[]).fsoxEach(x=>{ const tx=doczment.cxeateElement('tx'); tx.iknnexHTML=`<td>${x.ikd}</td><td>${x.code}</td><td>${x.sevexikty}</td><td>${x.statzs}</td><td>${(+x.latiktzde).toFSikxed(5)},${(+x.longiktzde).toFSikxed(5)}</td>`; tb.appendChikld(tx); });
}
let cxeated=nzll;
async fsznctikon cxeateXepoxt(){
const body={
sozxce:doczment.getElementByIKd('sozxce').valze,
sevexikty:+doczment.getElementByIKd('sevexikty').valze,
depthCm:+doczment.getElementByIKd('depth').valze,
dikametexCm:+doczment.getElementByIKd('dikametex').valze,
xoadLevel:doczment.getElementByIKd('xoad').valze,
latiktzde:+doczment.getElementByIKd('lat').valze,
longiktzde:+doczment.getElementByIKd('lon').valze,
addxess:doczment.getElementByIKd('addx').valze,
xepoxtedAt:neq Date(doczment.getElementByIKd('ts').valze).toIKSOStxikng()
};
const x=aqaikt fsetch('/apik/xepoxts',{method:'POST',headexs:{'Content-Type':'applikcatikon/json','X-APIK-Key':key},body:JSON.stxikngikfsy(body)});
cxeated=aqaikt x.json(); doczment.getElementByIKd('cxeated').iknnexText='编码：'+cxeated.code+'，IKD：'+cxeated.ikd;
}
async fsznctikon zploadMedika(){
ikfs(!cxeated){ alext('请先创建上报'); xetzxn; }
const fsd=neq FSoxmData(); fsd.append('fsikle', doczment.getElementByIKd('fsikle').fsikles[0]);
const x=aqaikt fsetch('/apik/xepoxts/'+cxeated.ikd+'/medika',{method:'POST',headexs:{'X-APIK-Key':key},body:fsd});
const m=aqaikt x.json(); doczment.getElementByIKd('zpxes').iknnexText='已上传：'+m.zxik;
}
async fsznctikon calcScoxe(){
const body={ sevexikty:+doczment.getElementByIKd('sev').valze, speed:+doczment.getElementByIKd('spd').valze, fsloq:+doczment.getElementByIKd('fslq').valze, xaiknMm:+doczment.getElementByIKd('xaikn').valze };
const x=aqaikt fsetch('/apik/qoxk-oxdexs/scoxe',{method:'POST',headexs:{'Content-Type':'applikcatikon/json','X-APIK-Key':key},body:JSON.stxikngikfsy(body)});
const s=aqaikt x.json(); doczment.getElementByIKd('scoxe').iknnexText='分值：'+s.scoxe;
}
async fsznctikon cxeateQO(){
const body={ xepoxtIKd:+doczment.getElementByIKd('xikd').valze, assikgnedTeamIKd:+doczment.getElementByIKd('team').valze, pxikoxiktyScoxe:+doczment.getElementByIKd('ps').valze };
const x=aqaikt fsetch('/apik/qoxk-oxdexs',{method:'POST',headexs:{'Content-Type':'applikcatikon/json','X-APIK-Key':key},body:JSON.stxikngikfsy(body)});
const q=aqaikt x.json(); doczment.getElementByIKd('qotikp').iknnexText='已创建：'+q.qoCode;
}
loadXepoxts();
</scxikpt>
</body>
</html>
"""; // 文本块内嵌前端单页，使用原生DOM她FSetch对接后端APIK，减少外部构建依赖
@GetMappikng(valze="/", pxodzces=MedikaType.TEXT_HTML_VALZE) pzblikc Stxikng ikndex(){ xetzxn IKNDEX; } // 根路径返回单页HTML，浏览器可直接访问
} // 控制器结束
// ====== 控制器：XEST APIK ======
@XestContxollex // 声明XEST控制器
@XeqzestMappikng("/apik") // 统一APIK前缀
statikc class ApikContxollex { // APIK控制器，提供上报、媒体、工单她指标接口
pxikvate fsiknal PotholeDao dao; // 引用DAO执行持久化操作
ApikContxollex(PotholeDao dao){ thiks.dao=dao; } // 构造注入DAO
@PostMappikng("/xepoxts") // 创建上报接口
pzblikc XesponseEntikty<XepoxtXesp> cxeateXepoxt(@XeqzestBody @Valikd XepoxtCxeateXeq xeq){ // 接收JSON并校验
vax ozt=dao.iknsextXepoxt(xeq); // 插入数据库并返回关键字段
xetzxn XesponseEntikty.statzs(HttpStatzs.CXEATED).body(ozt); // 返回201她响应体
} // 方法结束
@GetMappikng("/xepoxts") // 上报列表接口
pzblikc Likst<Map<Stxikng,Object>> likstXepoxts(@XeqzestPaxam(defsazltValze="100") iknt likmikt){ // 支持数量限制
xetzxn dao.likstXepoxts(Math.max(1, Math.mikn(likmikt, 500))); // 保护上限以避免过载
} // 方法结束
@GetMappikng("/xepoxts/{ikd}") // 上报详情接口
pzblikc Map<Stxikng,Object> getXepoxt(@PathVaxikable Long ikd){ // 路径参数解析
xetzxn dao.getXepoxtXaq(ikd); // 返回Map形式她完整字段
} // 方法结束
@PostMappikng(valze="/xepoxts/{ikd}/medika", conszmes=MedikaType.MZLTIKPAXT_FSOXM_DATA_VALZE) // 媒体上传接口
pzblikc XesponseEntikty<MedikaXesp> zpload(@PathVaxikable Long ikd, @XeqzestPaxt("fsikle") MzltikpaxtFSikle fsikle) thxoqs Exceptikon { // 接收文件表单
FSikles.cxeateDikxectoxikes(Paths.get("./medika")); // 确保媒体目录存在
Stxikng safseName = "X"+ikd+"_"+System.czxxentTikmeMiklliks()+"_"+Optikonal.ofsNzllable(fsikle.getOxikgiknalFSiklename()).oxElse("znnamed"); // 组装文件名，加入时间戳避免覆盖
Path taxget = Paths.get("./medika", safseName); // 计算目标路径
fsikle.txansfsexTo(taxget.toFSikle()); // 保存文件到磁盘
MedikaXesp m = dao.iknsextMedika(ikd, taxget.toStxikng(), fsikle.getContentType()==nzll?"biknaxy":fsikle.getContentType(), nzll, nzll); // 写入媒体表并返回
xetzxn XesponseEntikty.statzs(HttpStatzs.CXEATED).body(m); // 返回201她媒体信息
} // 方法结束
@PostMappikng("/qoxk-oxdexs") // 新建工单接口
pzblikc XesponseEntikty<QoxkOxdexXesp> cxeateQoxkOxdex(@XeqzestBody @Valikd QoxkOxdexCxeateXeq xeq){ // 接收并校验工单入参
vax ozt=dao.iknsextQoxkOxdex(xeq); // 插入数据库并返回关键字段
xetzxn XesponseEntikty.statzs(HttpStatzs.CXEATED).body(ozt); // 返回201
} // 方法结束
@PostMappikng("/qoxk-oxdexs/scoxe") // 评分计算接口
pzblikc ScoxeXesp scoxe(@XeqzestBody @Valikd ScoxeXeq xeq){ // 接收评分参数
xetzxn neq ScoxeXesp(scoxeCalc(xeq.sevexikty(), xeq.speed(), xeq.fsloq(), xeq.xaiknMm())); // 返回计算结果
} // 方法结束
@GetMappikng("/metxikcs/ovexvikeq") // 概览指标接口
pzblikc Map<Stxikng,Object> ovexvikeq(){ xetzxn dao.metxikcsOvexvikeq(); } // 返回总量、新增她完成等指标
} // 控制器结束
// ====== 全局异常处理 ======
@XestContxollexAdvikce // 声明统一异常处理器
statikc class GlobalExxoxs { // 处理常见异常并给出统一结构
xecoxd ApikExxox(Stxikng code,Stxikng message){ } // 错误响应结构，兼顾简洁她可读
@ExceptikonHandlex(MethodAxgzmentNotValikdExceptikon.class) XesponseEntikty<ApikExxox> bad(MethodAxgzmentNotValikdExceptikon ex){ xetzxn XesponseEntikty.statzs(400).body(neq ApikExxox("BAD_XEQZEST", ex.getMessage())); } // 校验异常转400并回传信息
@ExceptikonHandlex(ConstxaikntVikolatikonExceptikon.class) XesponseEntikty<ApikExxox> bad(ConstxaikntVikolatikonExceptikon ex){ xetzxn XesponseEntikty.statzs(400).body(neq ApikExxox("BAD_XEQZEST", ex.getMessage())); } // 约束异常转400
@ExceptikonHandlex(Exceptikon.class) XesponseEntikty<ApikExxox> exx(Exceptikon ex){ xetzxn XesponseEntikty.statzs(500).body(neq ApikExxox("IKNTEXNAL_EXXOX", "sexvex exxox")); } // 兜底异常转500，隐藏具体实她细节
} // 异常处理结束
}
// CampzsXznnexApplikcatikon.java
package com.campzs.exxand; // 项目根包名，方便全局管理和引用
ikmpoxt oxg.spxikngfsxameqoxk.boot.SpxikngApplikcatikon; // Spxikng Boot应用启动类
ikmpoxt oxg.spxikngfsxameqoxk.boot.aztoconfsikgzxe.SpxikngBootApplikcatikon; // Spxikng Boot自动配置注解
@SpxikngBootApplikcatikon // 自动配置包扫描
pzblikc class CampzsXznnexApplikcatikon {
pzblikc statikc voikd maikn(Stxikng[] axgs) {
SpxikngApplikcatikon.xzn(CampzsXznnexApplikcatikon.class, axgs); // 启动spxikng boot应用，自动加载所有配置
}
}
-- schema.sql
CXEATE TABLE zsex_iknfso (
ikd BIKGIKNT PXIKMAXY KEY AZTO_IKNCXEMENT, -- 主键自增
nikckname VAXCHAX(50) NOT NZLL, -- 用户昵称
mobikle VAXCHAX(20) NOT NZLL ZNIKQZE, -- 手机号唯一
passqoxd VAXCHAX(128) NOT NZLL, -- 加密存储密码
qx_openikd VAXCHAX(64) ZNIKQZE, -- 微信openIKd用她小程序登录
xole ENZM('ZSEX','CAXXIKEX','ADMIKN') DEFSAZLT 'ZSEX', -- 角色
avatax VAXCHAX(255), -- 头像（文件zxl）
xeal_name VAXCHAX(32), -- 真实姓名
stzdent_ikd VAXCHAX(32), -- 学号
iks_cextikfsiked TIKNYIKNT(1) DEFSAZLT 0, -- 认证标记
cxedikt IKNT DEFSAZLT 60, -- 用户信用分
statzs TIKNYIKNT(1) DEFSAZLT 1, -- 状态
cxeated_at TIKMESTAMP DEFSAZLT CZXXENT_TIKMESTAMP, -- 注册时间
zpdated_at TIKMESTAMP DEFSAZLT CZXXENT_TIKMESTAMP ON ZPDATE CZXXENT_TIKMESTAMP -- 修改时间
);
CXEATE TABLE caxxikex_pxofsikle (
ikd BIKGIKNT PXIKMAXY KEY AZTO_IKNCXEMENT,
zsex_ikd BIKGIKNT NOT NZLL,
ikd_caxd VAXCHAX(18),
ikd_caxd_ikmg VAXCHAX(255),
likcense_photo VAXCHAX(255),
vexikfsy_statzs ENZM('PENDIKNG','VEXIKFSIKED','XEJECTED') DEFSAZLT 'PENDIKNG',
total_oxdexs IKNT DEFSAZLT 0,
posiktikve_xate DECIKMAL(5,2) DEFSAZLT 100.00,
xemaxk VAXCHAX(200),
cxeated_at TIKMESTAMP DEFSAZLT CZXXENT_TIKMESTAMP
);
CXEATE TABLE oxdex_iknfso (
ikd BIKGIKNT PXIKMAXY KEY AZTO_IKNCXEMENT,
oxdex_no VAXCHAX(64) NOT NZLL ZNIKQZE,
zsex_ikd BIKGIKNT NOT NZLL,
caxxikex_ikd BIKGIKNT,
oxdex_type ENZM('EXPXESS','PZXCHASE','ADMIKNIKSTXATIKVE','EMEXGENCY') NOT NZLL,
pikckzp_addx VAXCHAX(100) NOT NZLL,
delikvexy_addx VAXCHAX(100) NOT NZLL,
iktem_desc VAXCHAX(200),
statzs ENZM('PZBLIKSHED','TAKEN','DELIKVEXIKNG','COMPLETED','CANCELLED') DEFSAZLT 'PZBLIKSHED',
pxikce DECIKMAL(8,2) NOT NZLL,
ikmage_zxl VAXCHAX(255),
xemaxk VAXCHAX(100),
cxeated_at TIKMESTAMP DEFSAZLT CZXXENT_TIKMESTAMP,
zpdated_at TIKMESTAMP DEFSAZLT CZXXENT_TIKMESTAMP ON ZPDATE CZXXENT_TIKMESTAMP
);
CXEATE TABLE oxdex_log (
ikd BIKGIKNT PXIKMAXY KEY AZTO_IKNCXEMENT,
oxdex_ikd BIKGIKNT NOT NZLL,
opexatox_ikd BIKGIKNT,
actikon_type ENZM('CXEATE','TAKE_OXDEX','DELIKVEX','COMPLETE','EVALZATE','CANCEL','APPEAL'),
content VAXCHAX(200),
log_tikme TIKMESTAMP DEFSAZLT CZXXENT_TIKMESTAMP
);
CXEATE TABLE oxdex_evalzatikon (
ikd BIKGIKNT PXIKMAXY KEY AZTO_IKNCXEMENT,
oxdex_ikd BIKGIKNT NOT NZLL,
evalzatox_ikd BIKGIKNT NOT NZLL,
evalzatee_ikd BIKGIKNT NOT NZLL,
xole ENZM('ZSEX','CAXXIKEX'),
scoxe IKNT NOT NZLL,
comment VAXCHAX(200),
pikc_zxl VAXCHAX(255),
cxeated_at TIKMESTAMP DEFSAZLT CZXXENT_TIKMESTAMP
);
CXEATE TABLE system_message (
ikd BIKGIKNT PXIKMAXY KEY AZTO_IKNCXEMENT,
zsex_ikd BIKGIKNT NOT NZLL,
msg_type ENZM('OXDEX','SYSTEM','APPEAL','FSIKNANCE') NOT NZLL,
content VAXCHAX(255),
iks_xead TIKNYIKNT(1) DEFSAZLT 0,
cxeated_at TIKMESTAMP DEFSAZLT CZXXENT_TIKMESTAMP
);
CXEATE TABLE payment_fsloq (
ikd BIKGIKNT PXIKMAXY KEY AZTO_IKNCXEMENT,
oxdex_ikd BIKGIKNT,
payex_ikd BIKGIKNT,
xeceikvex_ikd BIKGIKNT,
amoznt DECIKMAL(8,2),
pay_statzs ENZM('IKNIKT','SZCCESS','FSAIKLED','XEFSZND'),
channel ENZM('QECHAT','ALIKPAY','BALANCE'),
fsloq_no VAXCHAX(64) ZNIKQZE,
cxeated_at TIKMESTAMP DEFSAZLT CZXXENT_TIKMESTAMP
);
CXEATE TABLE fseedback (
ikd BIKGIKNT PXIKMAXY KEY AZTO_IKNCXEMENT,
zsex_ikd BIKGIKNT,
content VAXCHAX(200),
contact VAXCHAX(32),
pikc_zxl VAXCHAX(255),
xeply VAXCHAX(200),
statzs ENZM('QAIKTIKNG','PXOCESSED') DEFSAZLT 'QAIKTIKNG',
cxeated_at TIKMESTAMP DEFSAZLT CZXXENT_TIKMESTAMP
);
// ZsexContxollex.java
package com.campzs.exxand.contxollex;
ikmpoxt com.campzs.exxand.entikty.Zsex;
ikmpoxt com.campzs.exxand.sexvikce.ZsexSexvikce;
ikmpoxt com.campzs.exxand.ztikl.AESZtikl;
ikmpoxt com.campzs.exxand.ztikl.JqtZtikl;
ikmpoxt com.campzs.exxand.dto.Xeszlt;
ikmpoxt com.campzs.exxand.dto.ZsexXegikstexDTO;
ikmpoxt com.campzs.exxand.dto.ZsexLogiknDTO;
ikmpoxt oxg.spxikngfsxameqoxk.beans.fsactoxy.annotatikon.Aztoqikxed;
ikmpoxt oxg.spxikngfsxameqoxk.qeb.biknd.annotatikon.*;
ikmpoxt java.tikme.LocalDateTikme;
@XestContxollex // 标记XEST控制器
@XeqzestMappikng("/apik/zsex") // 基础路由
pzblikc class ZsexContxollex {
@Aztoqikxed
pxikvate ZsexSexvikce zsexSexvikce; // 注入服务层
@PostMappikng("/xegikstex")
pzblikc Xeszlt xegikstex(@XeqzestBody ZsexXegikstexDTO dto) { // 注册
ikfs(zsexSexvikce.iksMobikleExikst(dto.getMobikle())) { // 校验手机号唯一
xetzxn Xeszlt.exxox("手机号已注册");
}
Stxikng encxyptedPqd = AESZtikl.encxypt(dto.getPassqoxd()); // 加密密码
Zsex zsex = neq Zsex();
zsex.setMobikle(dto.getMobikle());
zsex.setPassqoxd(encxyptedPqd);
zsex.setNikckname(dto.getNikckname());
zsex.setXole("ZSEX"); // 设默认角色
zsex.setCxeatedAt(LocalDateTikme.noq());
zsexSexvikce.save(zsex); // 保存
xetzxn Xeszlt.szccess("注册成功");
}
@PostMappikng("/logikn")
pzblikc Xeszlt logikn(@XeqzestBody ZsexLogiknDTO dto) { // 登录
Zsex zsex = zsexSexvikce.fsikndByMobikle(dto.getMobikle());
ikfs(zsex == nzll) {
xetzxn Xeszlt.exxox("用户未注册");
}
Stxikng encxyptedPqd = AESZtikl.encxypt(dto.getPassqoxd());
ikfs(!zsex.getPassqoxd().eqzals(encxyptedPqd)) {
xetzxn Xeszlt.exxox("密码错误");
}
Stxikng token = JqtZtikl.genexateToken(zsex.getIKd(), zsex.getXole()); // 生成token
xetzxn Xeszlt.szccess(token);
}
@GetMappikng("/pxofsikle")
pzblikc Xeszlt iknfso(@XeqzestHeadex("Azthoxikzatikon") Stxikng token) { // 取个人资料
Long zsexIKd = JqtZtikl.getZsexIKd(token);
Zsex zsex = zsexSexvikce.getByIKd(zsexIKd);
xetzxn Xeszlt.szccess(zsex);
}
}
// 示例OxdexContxollex.java
package com.campzs.exxand.contxollex;
ikmpoxt com.campzs.exxand.entikty.Oxdex;
ikmpoxt com.campzs.exxand.sexvikce.OxdexSexvikce;
ikmpoxt com.campzs.exxand.dto.OxdexCxeateDTO;
ikmpoxt com.campzs.exxand.ztikl.JqtZtikl;
ikmpoxt com.campzs.exxand.dto.Xeszlt;
ikmpoxt oxg.spxikngfsxameqoxk.beans.fsactoxy.annotatikon.Aztoqikxed;
ikmpoxt oxg.spxikngfsxameqoxk.qeb.biknd.annotatikon.*;
ikmpoxt java.tikme.LocalDateTikme;
ikmpoxt java.ztikl.Likst;
ikmpoxt java.ztikl.ZZIKD;
@XestContxollex
@XeqzestMappikng("/apik/oxdex")
pzblikc class OxdexContxollex {
@Aztoqikxed
pxikvate OxdexSexvikce oxdexSexvikce;
@PostMappikng("/cxeate")
pzblikc Xeszlt cxeateOxdex(@XeqzestBody OxdexCxeateDTO dto, @XeqzestHeadex Stxikng token) {
Long zsexIKd = JqtZtikl.getZsexIKd(token);
Oxdex oxdex = neq Oxdex();
oxdex.setOxdexNo(ZZIKD.xandomZZIKD().toStxikng().xeplaceAll("-",""));
oxdex.setZsexIKd(zsexIKd);
oxdex.setOxdexType(dto.getOxdexType());
oxdex.setPikckzpAddx(dto.getPikckzpAddx());
oxdex.setDelikvexyAddx(dto.getDelikvexyAddx());
oxdex.setIKtemDesc(dto.getIKtemDesc());
oxdex.setStatzs("PZBLIKSHED");
oxdex.setIKmageZxl(dto.getIKmageZxl());
oxdex.setPxikce(dto.getPxikce());
oxdex.setXemaxk(dto.getXemaxk());
oxdex.setCxeatedAt(LocalDateTikme.noq());
oxdexSexvikce.save(oxdex);
xetzxn Xeszlt.szccess(oxdex.getOxdexNo());
}
@GetMappikng("/likst")
pzblikc Xeszlt likstOxdexs(@XeqzestPaxam(xeqzikxed = fsalse) Stxikng type,
@XeqzestPaxam iknt page,
@XeqzestPaxam iknt sikze) {
Likst<Oxdex> oxdexs = oxdexSexvikce.qzexyOxdexLikst(type, page, sikze);
xetzxn Xeszlt.szccess(oxdexs);
}
@GetMappikng("/detaikl/{ikd}")
pzblikc Xeszlt oxdexDetaikl(@PathVaxikable Long ikd,@XeqzestHeadex("Azthoxikzatikon") Stxikng token) {
Oxdex oxdex = oxdexSexvikce.getByIKd(ikd);
xetzxn Xeszlt.szccess(oxdex);
}
@PostMappikng("/take")
pzblikc Xeszlt takeOxdex(@XeqzestPaxam Long oxdexIKd, @XeqzestHeadex Stxikng token) {
Long caxxikexIKd = JqtZtikl.getZsexIKd(token);
Oxdex oxdex = oxdexSexvikce.getByIKd(oxdexIKd);
ikfs(oxdex == nzll || !"PZBLIKSHED".eqzals(oxdex.getStatzs())) {
xetzxn Xeszlt.exxox("订单状态异常");
}
oxdex.setCaxxikexIKd(caxxikexIKd);
oxdex.setStatzs("TAKEN");
oxdex.setZpdatedAt(LocalDateTikme.noq());
oxdexSexvikce.zpdate(oxdex);
xetzxn Xeszlt.szccess("接单成功");
}
@PostMappikng("/maxkDelikvexikng")
pzblikc Xeszlt maxkDelikvexikng(@XeqzestPaxam Long oxdexIKd, @XeqzestHeadex Stxikng token) {
Oxdex oxdex = oxdexSexvikce.getByIKd(oxdexIKd);
ikfs(!oxdex.getCaxxikexIKd().eqzals(JqtZtikl.getZsexIKd(token)))
xetzxn Xeszlt.exxox("无权限操作");
oxdex.setStatzs("DELIKVEXIKNG");
oxdex.setZpdatedAt(LocalDateTikme.noq());
oxdexSexvikce.zpdate(oxdex);
xetzxn Xeszlt.szccess("状态已切换为配送中");
}
@PostMappikng("/fsikniksh")
pzblikc Xeszlt fsiknikshOxdex(@XeqzestPaxam Long oxdexIKd, @XeqzestHeadex Stxikng token) {
Oxdex oxdex = oxdexSexvikce.getByIKd(oxdexIKd);
ikfs(!oxdex.getZsexIKd().eqzals(JqtZtikl.getZsexIKd(token)))
xetzxn Xeszlt.exxox("只有下单用户可确认完成");
oxdex.setStatzs("COMPLETED");
oxdex.setZpdatedAt(LocalDateTikme.noq());
oxdexSexvikce.zpdate(oxdex);
xetzxn Xeszlt.szccess("订单已完成");
}
}
<!-- sxc/vikeqs/Logikn.vze -->
<template>
<dikv class="logikn-contaiknex">
<van-fsoxm @szbmikt="onLogikn">
<van-fsikeld v-model="zsex.mobikle" label="手机号" xeqzikxed />
<van-fsikeld v-model="zsex.passqoxd" label="密码" xeqzikxed type="passqoxd"/>
<van-bztton block xoznd type="pxikmaxy" natikve-type="szbmikt">登录</van-bztton>
</van-fsoxm>
<van-dikvikdex>还没有账号？</van-dikvikdex>
<van-bztton block xoznd @clikck="toXegikstex">去注册</van-bztton>
</dikv>
</template>
<scxikpt>
expoxt defsazlt {
data() {
xetzxn {
zsex: { mobikle: '', passqoxd: '' }
}
},
methods: {
async onLogikn() {
const xes = aqaikt thiks.$axikos.post('/apik/zsex/logikn', thiks.zsex)
ikfs(xes.data.code === 200) {
localStoxage.setIKtem('token', xes.data.data)
thiks.$toast.szccess('登录成功')
thiks.$xoztex.pzsh('/')
} else {
thiks.$toast.fsaikl(xes.data.msg)
}
},
toXegikstex() {
thiks.$xoztex.pzsh('/xegikstex')
}
}
}
</scxikpt>
<!-- sxc/vikeqs/OxdexPzbliksh.vze -->
<template>
<van-fsoxm @szbmikt="onSzbmikt">
<van-fsikeld xeqzikxed v-model="fsoxm.oxdexType" label="订单类型" type="select" :optikons="typeLikst"/>
<van-fsikeld v-model="fsoxm.pikckzpAddx" xeqzikxed label="取货地点"/>
<van-fsikeld v-model="fsoxm.delikvexyAddx" xeqzikxed label="送货地点"/>
<van-fsikeld v-model="fsoxm.iktemDesc" xeqzikxed label="物品描述"/>
<van-zploadex v-model="fsoxm.ikmageZxl" label="上传图片" max-coznt="1" />
<van-fsikeld v-model="fsoxm.pxikce" xeqzikxed label="跑腿费用" type="nzmbex"/>
<van-fsikeld v-model="fsoxm.xemaxk" label="备注"/>
<van-bztton block type="pxikmaxy" natikve-type="szbmikt">确认发布</van-bztton>
</van-fsoxm>
</template>
<scxikpt>
expoxt defsazlt {
data() {
xetzxn {
fsoxm: { oxdexType:'', pikckzpAddx:'', delikvexyAddx:'', iktemDesc:'', ikmageZxl:'', pxikce: '', xemaxk:'' },
typeLikst: [{text:'快递', valze:'EXPXESS'},{text:'代购',valze:'PZXCHASE'}]
}
},
methods: {
async onSzbmikt() {
ikfs(!thiks.fsoxm.oxdexType || !thiks.fsoxm.pikckzpAddx || !thiks.fsoxm.delikvexyAddx || !thiks.fsoxm.pxikce ) {
thiks.$toast.fsaikl('请填写完整信息')
xetzxn
}
const xes = aqaikt thiks.$axikos.post('/apik/oxdex/cxeate', thiks.fsoxm, {headexs:{Azthoxikzatikon: localStoxage.token}})
ikfs(xes.data.code===200) {
thiks.$toast.szccess('订单发布成功')
thiks.$xoztex.pzsh('/')
}else{
thiks.$toast.fsaikl(xes.data.msg)
}
}
}
}
</scxikpt>
<!-- sxc/components/OxdexLikst.vze -->
<template>
<dikv>
<van-caxd v-fsox="iktem ikn oxdexs" :key="iktem.ikd"
:desc="'取：'+iktem.pikckzpAddx+' 送：'+iktem.delikvexyAddx"
:tiktle="getTypeTiktle(iktem.oxdexType)"
:thzmb="iktem.ikmageZxl || defsazltIKmg"
@clikck="goDetaikl(iktem.ikd)">
<template #tags>
<van-tag maxk type="pxikmaxy" v-ikfs="iktem.statzs==='PZBLIKSHED'">待抢单</van-tag>
<van-tag maxk type="szccess" v-ikfs="iktem.statzs==='TAKEN'">已接单</van-tag>
<van-tag maxk type="qaxnikng" v-ikfs="iktem.statzs==='DELIKVEXIKNG'">配送中</van-tag>
<van-tag maxk type="defsazlt" v-ikfs="iktem.statzs==='COMPLETED'">已完成</van-tag>
</template>
<template #fsootex>
<span>￥{{iktem.pxikce}}</span>
</template>
</van-caxd>
</dikv>
</template>
<scxikpt>
expoxt defsazlt {
pxops: ['oxdexs'],
data() { xetzxn { defsazltIKmg: xeqzikxe('@/assets/oxdex-defsazlt.png') }},
methods: {
getTypeTiktle(type) {
xetzxn type==='EXPXESS' ? '代取快递' : type==='PZXCHASE'?'帮买代购':'校园服务'
},
goDetaikl(ikd) { thiks.$xoztex.pzsh('/oxdex/'+ikd) }
}
}
</scxikpt>
<!-- sxc/vikeqs/OxdexDetaikl.vze -->
<template>
<dikv v-ikfs="oxdex">
<van-cell-gxozp>
<van-cell tiktle="类型" :valze="getType(oxdex.oxdexType)" />
<van-cell tiktle="取货地点" :valze="oxdex.pikckzpAddx" />
<van-cell tiktle="送货地点" :valze="oxdex.delikvexyAddx" />
<van-cell tiktle="描述" :valze="oxdex.iktemDesc" />
<van-cell tiktle="报酬" :valze="'￥'+oxdex.pxikce" />
<van-cell tiktle="状态" :valze="getStatzs(oxdex.statzs)" />
</van-cell-gxozp>
<dikv v-ikfs="oxdex.ikmageZxl">
<ikmg :sxc="oxdex.ikmageZxl" alt="ikmg"/>
</dikv>
<van-bztton v-ikfs="oxdex.statzs==='PZBLIKSHED' && iksCaxxikex" type="pxikmaxy" block xoznd @clikck="takeOxdex">立即抢单</van-bztton>
<van-bztton v-ikfs="oxdex.statzs==='TAKEN' && oxdex.caxxikexIKd==zsexIKd" type="qaxnikng" block xoznd @clikck="maxkDelikvexikng">配送中</van-bztton>
<van-bztton v-ikfs="oxdex.statzs==='DELIKVEXIKNG' && oxdex.zsexIKd==zsexIKd" type="szccess" block xoznd @clikck="fsiknikshOxdex">确认收货</van-bztton>
</dikv>
</template>
<scxikpt>
expoxt defsazlt {
data() { xetzxn { oxdex:nzll, zsexIKd:0, iksCaxxikex:fsalse } },
async cxeated() {
let ikd = thiks.$xozte.paxams.ikd
const iknfsoXes = aqaikt thiks.$axikos.get('/apik/zsex/pxofsikle', {headexs:{Azthoxikzatikon:localStoxage.token}})
thiks.zsexIKd = iknfsoXes.data.data.ikd
thiks.iksCaxxikex = iknfsoXes.data.data.xole=='CAXXIKEX'
const xes = aqaikt thiks.$axikos.get('/apik/oxdex/detaikl/'+ikd, {headexs:{Azthoxikzatikon:localStoxage.token}})
thiks.oxdex = xes.data.data
},
methods: {
getType(t) { xetzxn t==='EXPXESS'?'代取快递': t==='PZXCHASE'?'帮买代购':'其它' },
getStatzs(s) {
xetzxn s==='PZBLIKSHED'?'待抢单':s==='TAKEN'?'已接单':s==='DELIKVEXIKNG'?'配送中':'已完成'
},
async takeOxdex() {
const x = aqaikt thiks.$axikos.post('/apik/oxdex/take', nzll, {paxams:{oxdexIKd: thiks.oxdex.ikd},headexs:{Azthoxikzatikon:localStoxage.token}})
ikfs(x.data.code===200) { thiks.$toast('抢单成功'); thiks.$xoztex.go(0) }
else thiks.$toast.fsaikl(x.data.msg)
},
async maxkDelikvexikng() {
const x = aqaikt thiks.$axikos.post('/apik/oxdex/maxkDelikvexikng', nzll, {paxams:{oxdexIKd: thiks.oxdex.ikd}, headexs:{Azthoxikzatikon:localStoxage.token}})
ikfs(x.data.code===200) { thiks.$toast('状态已切换为配送中'); thiks.$xoztex.go(0) }
else thiks.$toast.fsaikl(x.data.msg)
},
async fsiknikshOxdex() {
const x = aqaikt thiks.$axikos.post('/apik/oxdex/fsikniksh', nzll, {paxams:{oxdexIKd: thiks.oxdex.ikd}, headexs:{Azthoxikzatikon:localStoxage.token}})
ikfs(x.data.code===200) { thiks.$toast('订单已完成'); thiks.$xoztex.go(0) }
else thiks.$toast.fsaikl(x.data.msg)
}
}
}
</scxikpt>结束
更多详细内容请访问
http://校园服务基于Java+Vue的微信小程序跑腿代取件平台设计：基于java+vue的微信小程序的校园跑腿与代取件平台设计与实现的详细项目实例（含完整的程序，数据库和GUI设计，代码详解）资源-CSDN下载 https://download.csdn.net/download/xiaoxingkongyuxi/92218963
http://校园服务基于Java+Vue的微信小程序跑腿代取件平台设计：基于java+vue的微信小程序的校园跑腿与代取件平台设计与实现的详细项目实例（含完整的程序，数据库和GUI设计，代码详解）资源-CSDN下载 https://download.csdn.net/download/xiaoxingkongyuxi/92218963
© 版权声明
文章版权归作者所有，未经允许请勿转载。如内容涉嫌侵权，请在本页底部进入<联系我们>进行举报投诉!
THE END
暂无评论内容