基于SpringBoot+Vue的少数民族语言传承与保护平台-论文18976子

基于SpringBoot+Vue的少数民族语言传承与保护平台摘要本文构建面向少数民族语言传承与保护的Web平台。系统采用前后端分离架构，后端基于SpringBoot、MyBatis-Plus与MySQL搭建，集成JWT令牌与BCrypt加密。前端依赖Vue框架结合ElementUI开发，调用ECharts生成看板，通过DockerCompose部署。前台提供资源浏览、音视频试听下载、词汇与日常用语学习、资讯发布、传承人展示及评论收藏功能。后台涵盖人员维护、分类配置、资源上传、内容编排、审核、轮播图管理与数据统计。数据库共设计11张业务表，涵盖用户、管理员、分类、资源、内容、资讯、传承人、收藏、评论、轮播图及记录表。性别字段采用定长字符存储，密码经BCrypt单向哈希处理，收藏表设置联合唯一索引拦截重复请求。系统加载藏语、蒙古语等8个分类，实际入库12条资源、32条内容、8条资讯与7位传承人数据。测试环境内32条覆盖认证鉴权、交互管理与后台管控的用例全部通过。平台运行稳定，验证了该架构在民族语言数字化保护中的可行性，为资源整合与活态传承提供载体。关键词：少数民族语言；数字化保护；SpringBoot；Vue；MySQLAbstractThispaperbuildsaWebplatformfortheinheritanceandpreservationofminoritylanguages.Thesystemadoptsafront-backseparatedarchitecture.ThebackendisconstructedwithSpringBoot,MyBatis-Plus,andMySQL,integratingJWTtokensandBCryptencryption.ThefrontendreliesontheVueframeworkcombinedwithElementUI,rendersdashboardsviaECharts,anddeploysthroughDockerCompose.Thefront-endinterfacedeliversresourcebrowsing,multimediaplaybackanddownload,vocabularyandphraselearning,newspublishing,inheritordisplay,andcommentfunctions.Thebackendcoverspersonnelmaintenance,categoryconfiguration,resourceupload,contentediting,moderation,bannermanagement,anddatastatistics.Thedatabasecomprises11businesstablesincludingusers,administrators,categories,resources,content,news,inheritors,favorites,comments,banners,andrecords.Genderfieldsusefixed-lengthcharacters,passwordsundergoBCrypthashing,andthefavoritetableenforcesacompositeuniqueindextopreventduplicaterequests.Eightlanguagecategoriesareconfigured,withactualingestionof12resources,32learningitems,8newspieces,and7inheritors.Thirty-twofunctionaltestcasescoveringauthentication,interactionmanagement,andadministrativecontrolsallpassexecution.Theplatformoperatesstably,verifyingtheengineeringfeasibilityoftheseparatedarchitecturefordigitalminoritylanguagepreservationandprovidinganoperationalcarrierforresourceaggregationandlivingheritagetransmission.Keywords:minoritylanguage;digitalpreservation;SpringBoot;Vue;MySQL第1章绪论1.1研究背景与意义少数民族语言作为活态非物质文化遗产，其存续直接依赖于代际间的口语实践与社会场景应用。城镇化进程与主流语言的广泛使用导致部分民族语系使用人口显著萎缩，传统以家族或村落为单位的自然传承机制出现结构性断裂。数字化技术通过结构化采集、交互式呈现与网络化分发，为濒危语言的记录与传播提供了可复制的工程路径。现有数字资源多集中于静态文本或音视频归档，缺乏针对语言习得规律设计的交互模块与社区反馈机制，导致资源调用频次与学习者留存率受限。构建面向民族语言传承与保护的Web平台，能够将碎片化的文化素材整合为结构化知识体系，并通过用户行为数据反哺资源优化策略。本平台采用前后端分离架构，后端依托SpringBoot与MyBatis-Plus提供高并发接口，前端基于Vue与ElementUI构建响应式界面，结合JWT实现细粒度权限控制与数据安全传输。系统划分为普通用户与管理员两类角色，前者具备语言文化资源检索、单词与日常用语学习、发音示范播放、资讯阅读、传承人档案查看、收藏评论及学习进度追踪功能。后者负责基础数据维护、内容审核、轮播配置与多维统计报表生成。该平台的设计与实现填补了单一展示型网站在语言教学闭环上的空白，通过在线练习与互动反馈提升语言输入频率，使保护措施从被动保存转向主动使用。平台的工程交付物包含完整数据库设计、前后端源代码与毕业论文，为同类区域性语言数字化项目提供可验证的系统实现范式。1.2国内外研究现状1.2.1国内研究现状民族文化数字化保护的研究已从宏观理念论证逐步过渡到具体区域的实施路径探索。廖飞(2026)以广西金秀瑶族为例，指出当前保护工作受限于资料分散与传播渠道单一，需建立标准化采集流程与多元化传播矩阵REF_Ref1\n\h[1]。史永哲(2026)强调县级非遗数字化需统筹口述历史、技艺规程与实物影像，通过统一元数据标准解决跨机构资源孤岛问题REF_Ref2\n\h[2]。周斐宁(2026)将古镇文化遗产数字化纳入乡村振兴框架，论证了数字档案建设对地方文旅融合与经济转型的直接拉动作用REF_Ref3\n\h[3]。上述研究确立了地域性文化数字化治理的基本逻辑，但未深入触及语言类资源的动态习得场景。针对特定非遗门类的数字化实践呈现出高度垂直化特征。张勇(2026)与叶黎(2026)分别聚焦徽州服饰与金秀瑶族服饰，提出物质载体与精神内核的双轨记录模型REF_Ref4\n\h[4]REF_Ref5\n\h[5]。廖美玲(2026)剖析湘剧声腔体系与脸谱符号系统，利用多媒体技术还原程式化表演的肢体轨迹REF_Ref6\n\h[6]。赵卓璇(2026)与黄文灿(2026)针对景德镇陶瓷与福建土楼营造技艺，构建三维建模与工艺步骤拆解数据库，实现核心工序的可追溯管理REF_Ref7\n\h[7]REF_Ref8\n\h[8]。此类研究通过高精度采集与结构化存储解决了物理实体的保真问题，但对象多为静态技艺或视觉符号，未能覆盖语言这种依赖听觉反馈与实时互动的抽象媒介。高校与博物馆作为非遗活态传承的核心载体，其数字化协同机制成为近年热点。马宏鑫(2026)运用fsQCA组态分析方法检验河南省高校体育类非遗课程效能，证实肢体动作捕捉与数字化教案结合能显著提升技能掌握度REF_Ref9\n\h[9]。褚涵(2026)提出博物馆需打通藏品数字化、展陈体验设计与公众教育链路，形成保护、传承与创新的协同闭环REF_Ref10\n\h[10]。国内研究已构筑起分类建档至机构协同的技术骨架，但多数方案停留在资源入库层面，缺乏面向大众用户的轻量化访问入口与持续学习跟踪能力。语言类项目的复杂性在于其知识密度高、习得周期长，现有通用型文化网站难以支撑语音对比、错音矫正与个性化学习路线推荐等功能。1.2.2国外研究现状国际学界在文化遗产数字化领域的关注点逐渐向空间计量、沉浸式交互与技术伦理延伸。ZhongwuZhang(2024)基于中国3610项非遗资源绘制空间分布热力图，证实经济发展水平与社会网络密度对资源集聚的解释力强于自然地形REF_Ref11\n\h[11]。ChangLi(2024)针对西南少数民族文化遗产，运用Geodetector模型量化海拔、降水、路网里程与少数民族人口比例的空间分异效应REF_Ref12\n\h[12]。两项研究揭示了遗产分布的非均衡性及其驱动机制，为跨区域资源调配提供量化依据，但侧重于宏观地理学视角，未涉及微观层面的用户交互系统设计。虚拟现实与数字工具在遗产复原及乡村可持续发展中的应用取得实质性进展。HongZhong(2021)验证虚拟环境重建与径向基函数计算在破损文物修复中的效率优势，实验表明手柄交互精度提升降低操作误差REF_Ref13\n\h[13]。ElisabettaDelSoldato(2024)考察地中海农村地区，证明数字化创意工具与协作式知识共建能够强化饮食遗产认同感，推动慢旅游与经济韧性提升REF_Ref14\n\h[14]。此类技术路径拓展了数字孪生与社区参与的理论边界，然而其系统架构多针对硬件终端或独立应用开发，未充分考虑低带宽环境下的Web端并发访问需求与多语种内容管理逻辑。人工智能技术在文化遗产编目与数据分析中快速渗透，同时引发算法透明度与版权归属争议。SimonaTiribelli(2024)梳理人工智能在海量历史数据模式识别与馆藏分类中的效能，明确标注了真实性偏差、主观解释倾向及生成式版权风险REF_Ref15\n\h[15]。国外研究在空间分析、沉浸交互与AI治理方面形成完整方法论体系，但技术落地往往依赖高昂的算力支持与封闭的数据生态。面向中国少数民族语言的数字化平台需兼顾开源架构的扩展性与多模态数据的轻量级处理，现有国外解决方案在面向大众的Web化部署、离线缓存策略及本土化语言教学资源库构建上存在明显适配缺口。综合国内外文献可见，已有成果多集中于单一物质形态或宏观空间规律，缺乏集资源聚合、在线交互、学习追踪与后台管控于一体的综合性Web平台设计。1.3主要研究内容本文围绕少数民族语言传承与保护平台的全生命周期展开系统化设计与工程实现，整体结构按软件研发标准流程划分为六个章节。第二章界定技术选型边界，详细阐述SpringBoot框架的自动配置机制与组件化优势，解析MyBatis-Plus简化ORM映射与条件构造器的底层逻辑，说明Vue响应式数据绑定与ElementUI原子化组件库的前端工程化价值，论证MySQL在事务一致性与索引优化方面的可靠性，并推演JWT无状态鉴权在微服务接口防护中的令牌签发与校验机制。第三章完成业务侧向技术侧的映射转换，通过可行性评估确认架构落地的经济与技术门槛，细化普通用户与管理员的边界需求，提取浏览检索、在线学习、资讯阅读、传承人展示、收藏评论、学习记录等核心用例，并设定并发响应延迟、接口可用性及数据加密等指标约束。第四章输出系统蓝图，绘制三层架构拓扑图，划分认证鉴权、门户展示、资源管理、学习中心、后台管控五大功能域，完成概念模型向逻辑模型的转化，定义用户表、管理员表、语言分类表、资源表、学习内容表、资讯表、传承人表、评论表、轮播图表及数据统计表的字段类型、主外键关联与冗余策略。第五章推进代码级实现，演示SpringSecurity与拦截器配合实现的登录校验流程，说明前台门户的路由守卫与懒加载策略，阐述词汇与短语学习的音频流媒体加载与本地缓存机制，展示后台管理系统的数据表格分页、富文本编辑器集成及批量导入导出逻辑，最后封装全局异常处理器与统一返回结果对象以降低耦合度。第六章搭建隔离测试环境，编写JUnit单元测试覆盖核心Service层，执行Postman集合验证RESTful接口契约，开展多浏览器兼容性校验与压力模拟，输出缺陷修复记录与性能优化曲线。第七章凝练系统开发过程中的架构决策经验，客观评估当前版本在方言语音识别准确率、多终端自适应渲染及大数据量实时统计方面的局限，规划引入WebAssembly解码引擎与分布式缓存集群的演进方向。如图1.1所示，本文按项目准备、需求分析与设计、系统实现、系统测试、总结与交付五个阶段展开。图1.1技术路线图

Figure1.1Technicalroadmap项目准备阶段聚焦选题论证，通过检索学术数据库与政府公开数据锁定语言流失现状，梳理技术栈演进脉络，明确研究边界。需求分析与设计阶段承接调研结论，组织原型走查，使用UML用例图与活动图固化业务规则，输出需求规格说明书与设计文档。系统实现阶段进行编码开发，后端按Controller、Service、Mapper分层，前端构建视图目录与状态管理，完成媒体上传与存储对接。系统测试阶段执行功能与兼容性验证，针对越权访问与注入攻击设计用例，校准性能瓶颈。总结与交付阶段整理部署脚本与运维手册，提交代码仓库与数据库字典，完成论文撰写与验收。第2章相关技术介绍2.1SpringBoot框架SpringBoot通过起步依赖与内嵌容器重构了JavaWeb工程的初始化流程。项目依赖Starter机制聚合SpringMVC、安全过滤链与数据访问驱动，自动排除冗余配置类并收敛第三方库版本。内嵌Tomcat实例直接绑定HTTP端口，配合Maven打包插件可输出独立执行的fatjar文件。该架构剥离了传统WAR部署的中间件配置负担，使后端团队专注于语言资源目录管理接口的参数校验与异常拦截。自动装配机制依据Classpath特征动态注册Bean，缩短循环迭代周期。系统后端采用该框架组织分层架构，Controller层暴露RESTful端点接收前端请求，Service层编排业务规则，DTO对象隔离传输结构与持久化实体。过滤器链注册跨域请求头放行策略，允许静态资源与API通信。统一返回值包装类封装代码、消息与数据体，标准化JSON序列化格式。选用此技术栈能够维持代码库的高内聚特性，为后续接入音频转写服务或推荐算法预留模块化扩展边界。2.2MyBatis-Plus持久层框架数据持久化层选用MyBatis-Plus消除原生JDBC模板中的重复样板代码。框架内置BaseMapper提供通用CRUD方法，实体类字段通过@TableField注解映射至数据库列，主键生成策略默认采用雪花算法适配分布式ID分配。逻辑删除操作覆盖底层UPDATE语句，隐藏物理删除对历史学习记录的破坏。LambdaQueryWrapper构造查询条件时支持编译期类型检查，避免字符串拼接引发的语法错误与SQL注入风险。平台涉及用户角色、课程目录、语料文件、学习进度等十一张业务表，批量导入民族词典数据时依赖该层提供的InsertBatch机制降低往返延迟。分页插件拦截MyBatis执行链，自动改写COUNT查询并追加LIMIT偏移量，返回包含总数与集合的Page对象。索引建议针对高频检索字段建立联合覆盖索引，优化按族系筛选方言视频的查询路径。实体监听器统一填充创建时间与更新者标识，保证审计字段的强制一致性。2.3Vue前端框架与ElementUI客户端交互层基于Vue框架构建单页应用（SPA），视图层采用模板语法与指令绑定DOM节点，响应式数据流监听属性变更并触发局部Diff计算，降低全量页面重绘带来的网络开销。路由模块采用hash模式解析URL片段，根据角色标识动态挂载首页门户或控制台组件，前置守卫校验登录态与权限路由表。组件化开发将播放器控制条、导航侧栏、数据表格拆分为独立作用域模块，提高代码复用率与维护效率。ElementUI组件库提供表单验证规则、分页控件、树形目录与加载动画，统一了界面视觉规范与交互反馈逻辑。Axios实例配置全局拦截器，请求头注入Authorization字段传递通行凭证，响应拦截器捕获非2xx状态码并转换为统一的错误提示弹窗。状态管理仓库集中维护用户昵称、头像路径与Token有效期，避免组件间深层Props传递造成的状态割裂。该组合契合B/S架构对低耦合的要求，确保多终端浏览少数民族音频视频时的渲染稳定性。2.4MySQL数据库关系型数据存储采用MySQL8.0引擎，业务表结构全部配置为InnoDB存储层。引擎通过undolog恢复事务回滚数据，redolog记录物理页修改轨迹，结合双写缓冲区保障ACID特性。行级锁机制与间隙锁防止并发提交学习进度时的脏写现象，连接池最大活跃数设定为50以控制内存占用。字符集设定为utf8mb4，完整保留生僻少数民族文字的Unicode编码区，避免传统编码截断导致的语料乱码与检索失效。外键约束在应用层解耦以避免死锁，但初始化脚本仍通过参照完整性校验基础字典表的引用关系。全文检索场景未引入外部搜索引擎，而是依赖MySQL内置的ngram分词器对汉语拼音标注字段建立复合索引。定期物理快照配合binlog增量日志生成离线备份文件，满足平台长期运营的数据容灾需求。慢查询日志开启阈值设定为200ms，结合EXPLAIN分析执行计划剔除全表扫描操作。2.5JWT鉴权技术认证授权模块引入JSONWebToken方案替代传统的Session-Cookie模式。令牌由Header、Payload与Signature三段Base64编码组成，有效载荷携带用户标识、角色权限与过期时间戳，私钥仅驻留服务端不随网络传输。服务端签发后将Token写入自定义响应头，客户端将其暂存于状态管理仓库并在后续请求的Authorization字段中附加。网关拦截器解析签名并完成HMAC-SHA256校验，验证失败直接返回401状态码阻断未授权接口访问。无状态设计解除了会话数据的集中存储压力，天然适配多节点横向扩展与前后端分离架构。拦截器白名单配置放行健康检查探针、静态资源请求与公开的课程列表端点，压缩校验路径长度。密码哈希交由BCryptPasswordEncoder处理，通过自适应工作因子与随机盐值单向散列存储，抵御彩虹表碰撞攻击。Token刷新机制采用双令牌轮转策略，短期AccessToken负责日常交互，长期RefreshToken用于凭证续期，平衡安全性与用户体验。2.6技术选型总结本章阐述的组件共同构成平台的工程基线，各项技术围绕数据流转效率与开发可维护性进行匹配。如表2-1所示。表2-1系统技术选型总表

Table2-1Technologystack层次技术/组件版本用途说明后端框架SpringBoot2.7.x主框架，Maven工程，内嵌Tomcat持久层MyBatis-Plus3.5.x实体-表映射、BaseMapper通用CRUD、分页插件数据库MySQL8.0业务数据存储，11张业务表鉴权JWT（jjwt0.9.x）—无状态登录令牌，拦截器白名单校验密码安全BCryptPasswordEncoder—用户/管理员密码单向散列存储前端框架Vue2.7组件化开发，SPA单页应用UI组件库ElementUI2.15后台表格/表单/菜单/分页组件前端构建Vite5开发服务器与打包，代理/api、/uploads、/audio状态管理Vuex3登录态、用户信息、Token管理路由VueRouter3（hash模式）前台/后台路由与角色守卫图表ECharts5后台数据统计看板HTTP客户端Axios1.x请求拦截注入Token，响应统一错误提示部署DockerCompose—mysql+backend+frontend三容器编排整体技术栈遵循成熟开源生态，规避了闭源组件的授权限制与技术黑盒。版本矩阵保持向后兼容，工具链分工明确，构建层负责静态资源编译，运行层提供网络协议转换，存储层保障持久化可靠性。该组合可直接映射至现有硬件资源，支撑初期用户规模的语言资源上传、在线学习与后台统计功能。第3章系统分析3.1可行性分析3.1.1技术可行性系统采用前后端分离的B_S架构，客户端仅负责DOM渲染与事件派发，核心业务逻辑迁移至服务端容器。SpringBoot自动装配机制收敛了SpringMVC的配置复杂度，内嵌Tomcat实例可直接编译输出WAR包供外部Web服务器调用。MyBatis-Plus提供通用Mapper接口，通过Lambda表达式构建类型安全的动态条件构造器，消除手写XML的语法错误率。Vue.js虚拟DOM算法批量计算最小Diff集合，结合ElementUI预置样式类实现高保真UI还原。MySQL索引优化策略针对高频检索字段建立联合覆盖索引，连接池配置Druid监控面板实时追踪慢SQL轨迹。各组件依赖树无版本冲突，CI流水线集成Lint检查与单元测试覆盖率门禁，技术实施路径具备确定性。3.1.2经济可行性全量代码依赖Apache2.0与MIT许可协议，第三方组件采购预算归零。静态资源采用对象存储桶配合CDN边缘节点分发，回源带宽峰值仅限首次加载阶段触发。应用服务器配置单核双线程虚拟机即可维持基础并发量，容器编排方案预留横向扩容弹性但非强制依赖。运维监控接入Prometheus时序数据库与Grafana可视化面板，自动化告警路由降低人工巡检频次。项目初期投入集中于云服务器租赁与SSL证书续费，后期边际维护成本随用户规模扩张呈对数曲线衰减。轻量化部署拓扑完全契合基层文化站点的财政拨付标准。3.1.3管理可行性权限控制基于RBAC模型实现角色与数据源的动态绑定，SUPER账号持有全局配置写权限，ADMIN账号限定至指定资源分区。评论流转引擎内置状态机，audit_status字段初始化为0触发待审队列锁定，人工复核后变更为1或2并推送消息通知。后台看板聚合多维度SQL聚合函数，生成学习活跃度热力图与资源消耗排行榜，支撑运营人员制定下架或置顶策略。管理员操作日志采用AppendOnlyAppend方式写入审计表，任何误删指令均可通过历史快照恢复。现有民族语言研究团队熟悉该审批流转范式，系统上线后可直接替换纸质登记表册。3.1.4法律可行性少数民族语言音视频素材确权遵循CCBY-NC-SA协议框架，上传流程强制签署原创声明电子存证。个人信息收集仅采集昵称、学号与学习偏好标签，脱敏处理后的数据用于聚类分析且不关联真实身份实体。评论网关部署正则表达式过滤器拦截涉政与歧视性词汇，高危请求拦截前留存原始Payload供法务溯源。全站API强制TLS1.3加密通道，Cookie标记HttpOnly与SameSite属性防劫持。数据留存周期严格执行最长不超过三年原则，到期后触发物理销毁任务。整体合规设计覆盖采集、存储、交互与归档全生命周期节点。3.1.5本章小结技术生态完备性、开源授权零成本、权限隔离严密性及内容审查合规性共同验证项目启动条件。各项评估指标均已跨越实施阈值，分析阶段工作转入业务边界划定。3.2功能需求分析系统功能规划围绕少数民族语言传播链条展开，划分为前台门户、在线学习与后台管控三大区块。普通用户承担内容消费与互动反馈职能，管理员负责资源调度、内容清洗与全局参数配置。如表3-1所示，系统功能需求总表覆盖了从身份认证到数据统计的全量业务节点。表中数据表明资源管理与学习模块占据核心交互路径，评论审核与收藏机制构成双边互动闭环。后台管理模块集中处理增删改查操作，轮播图与数据统计模块独立服务于首页曝光优化与运营决策。各类实体关系通过外键约束关联，确保多端业务流转时数据一致性不受损。图片与视频资源采用分片上传协议切片交付，后端接收完毕后执行异步转码任务生成多清晰度流媒体版本，原文件归档至冷存储区释放热盘空间。表3-1系统功能需求总表

Table3-1Functionalrequirements模块功能需求使用角色认证与用户中心用户注册、登录、个人资料维护、收藏管理、学习记录、我的评论普通用户语言分类民族语言分类的浏览与检索普通用户、管理员文化资源音/视频/图文资源的列表、详情、试听/播放、下载普通用户、管理员在线学习单词/日常用语浏览、发音示范播放、学习打卡记录普通用户文化资讯资讯列表、详情阅读普通用户传承人名录非遗传承人档案展示普通用户评论发表评论、评论审核后展示普通用户、管理员收藏收藏/取消收藏资源、收藏列表普通用户后台管理用户、管理员、分类、资源、学习内容、资讯、传承人、评论审核、轮播图、数据统计的增删改查与看板管理员（SUPER/ADMIN）3.3非功能需求分析性能指标要求高频访问接口响应时间控制在毫秒级范围内，列表页查询必须支持分页参数过滤以降低单次SQL执行负载。缓存层引入Redis分布集群存储热点语言分类ID与轮播图配置，淘汰策略采用LRU算法保证内存水位线平稳。安全策略层面采用JWT令牌签发替代Session存储，载荷部分注入过期时间戳与角色标识，密码字段强制BCrypt加盐哈希防御彩虹表攻击。路由拦截器配置CORS白名单限制跨域请求来源，SQL注入防护依赖预编译语句绑定参数切断拼接漏洞。可用性设计聚焦浏览器端渲染稳定性，表单提交失败触发定位提示而非静默跳转，大尺寸音频播放器需适配移动端触控手势。可维护性架构依赖分层代码组织，Controller层仅处理参数绑定与响应封装，Service层聚合业务逻辑，Repository层屏蔽底层ORM差异。统一返回体规范定义code/message/data结构体，全局异常处理器捕获运行时错误并输出标准化JSON报文，减少碎片化排查耗时。3.4用例分析系统高层用例划分确立三类参与者边界，游客态仅开放公开资源预览权限，登录转换后解锁互动功能。如图3.1所示，系统涉及游客、普通用户与管理员三类角色，三者共享「登录系统」这一用例。登录动作作为状态机切换入口，同步加载对应角色权限树与菜单路由。管理员视图以内容治理为核心驱动力，操作重心集中于数据结构维护与合规校验。如图3.2所示，管理员用例以评论审核为核心，通过include/extend关系组织查看待审、通过、驳回等操作。审核子用例包含遍历待办列表、比对发言文本、变更audit_status字段三个原子步骤，驳回分支追加理由回填逻辑。普通用户交互呈现低频长尾特征，核心诉求集中于知识获取与文化档案查阅。如图3.3所示，普通用户共11个用例，覆盖浏览、学习、互动与个人中心。播放控件解析音频流切片，收藏操作写入独立中间表解耦主业务表，学习记录按日粒度聚合生成进度条数据，所有交互终点收敛至个人中心详情页进行状态回溯。图3.3普通用户用例图

Figure3.3Userusecasediagram图3.2管理员用例图

Figure3.2Adminusecasediagram图3.1系统高层用例图

Figure3.1High-levelusecasediagram第4章系统设计4.1系统总体架构如图4.1所示，系统采用前后端分离的分层架构，由前端展示层、后端服务层、数据访问层与数据存储层构成。图4.1系统总体架构图

Figure4.1Systemarchitecture前端展示层基于Vue3组合式API构建单页面应用，路由配置划分公开路径与受控路径，导航守卫在每次路由切换前解析Cookie中的JWT载荷并验证签名时效。页面组件采用按需加载策略，ElementUI提供栅格布局与表单校验器，Axios实例统一挂载baseURL与超时阈值，拦截器自动附加Authorization请求头并在401响应时清除本地令牌。后端服务层以SpringBoot自动装配机制初始化Web容器，DispatcherServlet将入站请求分发至RestController。Controller层仅负责参数封装与响应体包装，不包含业务规则判断。Service层注入MyBatis-Plus提供的BaseMapper实例，通过@Transactional注解划定事务边界，确保多表联动的原子性。数据访问层依赖mapper.xml定义复杂关联查询，利用PageHelper插件在SQL执行前注入LIMIT偏移量，Condition构造器动态拼接WHERE子句。数据存储层选用MySQL8.0引擎，全局字符集与排序规则统一为utf8mb4_0900_ai_ci，支持藏文、蒙文、维吾尔文等多字节编码无损落盘。连接池维持初始5个、最大20个空闲连接，SQL慢查询日志记录执行时间超过200ms的语句以供索引优化。四层之间通过标准HTTP/HTTPS协议交换JSON数据，展示层与服务器解除直连耦合，服务层可横向扩容应对流量峰值，数据库层通过读写分离预案降低锁竞争概率。网络层部署反向代理处理CORS预检请求，网关层统一限流熔断，保障接口可用性阈值稳定在99.9%。架构分层使代码职责单一化，故障排查可沿调用栈逐级定位，模块替换无需重写相邻组件底层逻辑。4.2功能模块设计如图4.2所示，系统功能划分为前台门户与后台管理两大块，共覆盖8项前台功能与10个后台管理模块。图4.2系统功能结构图

Figure4.2Systemfunctiontree前台门户面向未认证访客与注册学习者开放静态内容与基础互动能力。首页轮播模块初始化时向后端发起一次GET请求获取banner数据集，前端计算每张图形的宽高比并应用object-fit裁剪算法保持视口比例恒定。分类导航节点映射language_category表的region字段，点击展开二级菜单时触发防抖函数延迟发起搜索接口，避免频繁刷新DOM导致的渲染阻塞。资源浏览页整合分页控件与多选复选框，前端传递selectedTypes数组至后端控制器，服务层解析数组元素拼装IN条件完成多类型联合过滤。在线学习模块加载learning_content表记录，音频播放组件监听canplaythrough事件缓冲片段，progress变化频率控制在每秒两次以防服务端计数器超写。资讯列表采用IntersectionObserver监听可视区域，滑入视口的卡片触发view_count增量接口。传承人展示区按level字段降序排列，portrait字段启用浏览器本地缓存策略减少重复下载。用户中心聚合个人资料编辑、历史足迹导出与收藏夹管理，表单提交前执行正则校验ethnicity与nickname长度限制。后台管理模块部署于独立路由命名空间，拦截器比对admin表role字段，SUPER角色放行全部操作，ADMIN角色拦截数据统计与系统配置入口。数据统计看板执行AVG、COUNT聚合运算，后端定时任务每五分钟快照当前在线人数与接口QPS。分类管理提供目录拖拽排序组件，变更后更新sort_order权重值并清理Redis缓存。资源维护模块集成富文本编辑器，上传按钮触发分片断点续传逻辑，后端校验MIME类型拦截非多媒体文件。学习内容编排支持单词卡片批量导入，CSV解析器跳过空行与注释行写入learning_content表。评论审核工作台加载audit_status为0的记录队列，审核动作更新状态字段并推送WebSocket通知至发布者信箱。用户管理模块提供账号封禁开关，封禁期间JWT签发服务拒绝颁发新令牌。轮播图管理界面预设4:3与16:9两种画幅比例，上传后调用ImageMagick裁剪至指定像素并生成WebP格式副本。各模块共享统一的异常响应模型，业务校验失败返回特定错误码，前端路由根据状态码重定向至错误提示页。接口设计遵循RESTful规范，动词映射HTTPMethod，资源标识符使用复数名词，请求体严格限定JSON格式，杜绝混合内容提交引发的解析歧义。4.3数据库设计数据库设计遵循第三范式与业务边界对齐原则，规划11张核心业务表覆盖用户身份、内容分发、互动记录与基础配置。主键统一采用自增整数ID作为物理聚集索引，保障范围扫描与外键引用的局部性优势。外键约束显式声明于关系表两端，建立逻辑引用完整性，例如resource_id指向cultural_resource.id，learning_id指向learning_content.id，阻止孤儿记录残留。唯一约束用于拦截重复写入，收藏表对(user_id,resource_id)组合字段设置UNIQUEINDEX，阻断同一用户对同类资源的二次添加。状态枚举字段采用定长字符串存储，性别字段genderVARCHAR(10)仅容纳“男”或“女”，审计标志audit_status使用0待审、1通过、2驳回的数字字典映射，提升索引命中率与比较运算速度。敏感数据在入库前完成单向哈希，密码字段强制使用BCrypt算法加盐处理，密文长度固定且不可逆推明文。音视频资源分离存储策略将media_url用于在线试听流媒体传输，file_url指向离线安装包下载源，降低带宽竞争。表结构全面适配utf8mb4字符集，varchar长度依据实际输入规范设定上限，避免内存溢出。演示数据规模验证了表分区与复合索引的有效性，8个语言分类下挂载12条文化资源与32条学习内容，7位传承人与8条资讯通过类别ID建立稀疏关联，5个测试用户产生的评论、收藏与学习记录通过中间表解耦多对多关系，2个管理员维护4条轮播图的排序状态。如表4-1所示，11张核心表结构说明如下。表结构按主体实态、辅助配置与关系聚合三类组织。user与admin表分离权限体系，admin表新增role字段区分SUPER超级管理员与ADMIN常规操作员，status字段标识账号冻结状态。language_category表作为分类锚点，region与speaker_count字段支撑地域分布统计，cover_image冗余存储缩略图地址以减少联表查询。cultural_resource表通过category_id建立外键，content字段存放富文本描述，view_count与download_count采用乐观锁版本号更新，规避并发写入冲突。learning_content表聚焦教学单元拆解，source_word标注原词发音，audio_url绑定云端OSS链接，example_sentence提供语境示例。culture_news表独立资讯生命周期，summary截断长文本用于列表摘要，source标记稿件来源。inheritor表补充非遗档案，portrait存储高清肖像，field界定传承技艺门类。favorite与comment表承担互动枢纽职能，reply_to字段实现楼中楼嵌套回复结构。banner表集中管控首页曝光位，sort_order决定渲染优先级。learning_record表追踪学习轨迹，learn_count累计单次会话有效时长，last_learn_time标记最近活跃节点。设计阶段针对高频查询列建立B+树索引，category_id与user_id联合索引加速条件过滤与分片查找，事务隔离级别设置为READCOMMITTED平衡一致性开销与吞吐量。表4-1数据库核心表结构说明

Table4-1Coredatabasetables表名中文名核心字段主键外键user用户表id,username,password,nickname,gender(男/女),ethnicity,statusid无admin管理员表id,username,password,real_name,role(SUPER/ADMIN),statusid无language_category民族语言分类表id,category_name,ethnicity,region,speaker_count,cover_imageid无cultural_resource语言文化资源表id,category_id,resource_name,resource_type,content,media_url,file_url,view_count,download_countidcategory_id→language_category.idlearning_content在线学习内容表id,category_id,content_type,source_word,chinese_meaning,pinyin,audio_url,example_sentenceidcategory_id→language_category.idculture_news文化资讯表id,title,cover_image,summary,content,source,view_countid无inheritor非遗传承人表id,category_id,inheritor_name,gender,ethnicity,portrait,level,field,introductionidcategory_id→language_category.idfavorite收藏表id,user_id,resource_id,create_timeiduser_id→user.id;resource_id→cultural_resource.idcomment评论表id,user_id,resource_id,content,audit_status(0/1/2),reply_toiduser_id→user.id;resource_id→cultural_resource.idbanner轮播图表id,title,image_url,link_url,sort_order,statusid无learning_record学习记录表id,user_id,learning_id,learn_count,last_learn_timeiduser_id→user.id;learning_id→learning_content.id如图4.3所示，数据库以语言分类为核心实体，与资源、学习内容、传承人构成一对多关系，用户通过收藏、评论、学习记录与内容实体关联。资源表、学习内容表与传承人表均通过category_id锁定所属语种分支，消除语义交叉带来的检索噪音。用户实体通过中间表建立弱关联，favorite表维护资源归属映射，comment表记录反馈时序，learning_record表统计交互频次。三张关系表均采用双外键指向主体表，配合逻辑删除标志保留历史审计痕迹。索引策略优先覆盖WHERE与ORDERBY列，单列索引处理精确匹配，复合索引处理范围查询。字符集utf8mb4覆盖全部Unicode扩展平面，避免因编码截断导致少数民族文献乱码。死锁检测机制监控InnoDB行锁等待队列，超时5秒自动终止较长事务释放缓冲区。备份策略每日凌晨执行全量dump，binlog日志记录增量变更供故障时间点恢复。数据库设计与应用层生命周期同步迭代，字段扩展预留VARCHAR冗余空间，表结构变更通过Flyway脚本版本控制实施灰度发布。图4.3数据库ER图

Figure4.3DatabaseERdiagram第5章系统实现5.1开发环境项目采用前后端分离架构，后端运行于JDK17环境，依赖SpringBoot3.2提供内嵌Tomcat与自动装配机制。前端构建工具选用Vite5，编译目标锁定Vue2.7语法树并挂载ElementUI2.15组件库。数据库服务绑定MySQL8.0，字符集强制配置为utf8mb4以兼容南岛语系变音符号与彝文扩展区区块。项目目录按领域边界划分，后端controller、service、mapper与entity层级解耦，前端按路由职责划分views与components目录。运行时可通过docker-composeup-d一键拉起MySQL实例与后端JAR包，卷挂载指定/uploads目录持久化多媒体文件。本地开发模式分别执行mvnspring-boot:run与npmrundev，ViteProxy中间件拦截/api请求并转发至localhost:8080，绕过同源策略限制。依赖版本在pom.xml与package.json中严格锁定次版本号，阻断Maven传递性依赖升级引发的类路径冲突。代码提交前经Spotless格式插件清洗与PMD静态分析，圈复杂度上限设为12，超阈值方法强制抽取子服务。JVM启动参数分配-Xms512m-Xmx1024m内存堆空间，GC算法选用G1，适应突发高并发读写场景。5.2认证与鉴权模块实现系统采用JSONWebToken（JWT）实现无状态会话管理，令牌载荷明确携带用户标识、角色标识与账号类型，服务端仅负责签发与合法性校验，不驻留内存会话矩阵。登录交互覆盖Vue表单采集、Axios异步递交、后端凭证比对、BCrypt哈希校验及Token生成全流程。如图5.6所示，登录认证过程覆盖用户、Vue前端、JWT拦截器、Controller、Service与MySQL的完整闭环。图5.6登录认证时序图

Figure5.6Loginsequencediagram权限校验由自定义HandlerInterceptor执行，核心逻辑集中于JwtInterceptor类。该类预定义公开接口白名单，匹配URI前缀直接放行，未命中列表的请求强制提取Authorization请求头。令牌格式限定为Bearer<token>，解码阶段调用jwtUtil.parse分离Header、Payload与Signature，缺失字段或RSA签名校验失败触发异常。拦截器将解析出的userId、role与type写入HttpServletRequest属性集，供下游Controller直接读取，避免冗余的参数传递链。关键代码如下。publicclassJwtInterceptorimplementsHandlerInterceptor{

//公开接口与静态资源白名单，无需登录即可访问

privatestaticfinalList<String>WHITE_LIST=List.of(

"/api/auth/","/api/resource/page","/api/resource/latest",

"/api/resource/detail","/api/category/list","/api/category/detail",

"/api/learning/page","/api/learning/byCategory","/api/learning/detail",

"/api/news/page","/api/news/detail","/api/inheritor/page",

"/api/banner/list","/api/comment/passed","/api/upload/",

"/uploads/","/audio/");

@Override

publicbooleanpreHandle(HttpServletRequestrequest,HttpServletResponseresponse,Objecthandler)

throwsException{

if(isWhiteListed(request.getRequestURI())){

returntrue;//白名单放行

}

Stringheader=request.getHeader("Authorization");

if(!StringUtils.hasText(header)||!header.startsWith("Bearer")){

writeError(response,401,"未登录或登录已过期");

returnfalse;

}

try{

Claimsclaims=jwtUtil.parse(header.substring(7));

request.setAttribute(LoginUserUtil.ATTR_USER_ID,

Long.valueOf(claims.get("userId",Integer.class)));

request.setAttribute(LoginUserUtil.ATTR_ROLE,claims.get("role",String.class));

request.setAttribute(LoginUserUtil.ATTR_TYPE,claims.get("type",String.class));

returntrue;

}catch(Exceptione){

writeError(response,401,"登录凭证无效或已过期");

returnfalse;

}

}

}认证入口收敛至AuthController，暴露/api/auth/admin/login、/api/auth/user/login与/api/auth/register三个端点。注册流程接收用户名与明文密码，Service层执行BCrypt强哈希后持久化至sys_user表。登录验证通过后，系统根据role字段拼接JWTPayload，超级管理员授予SUPER角色，普通管理员授予ADMIN角色，标准注册用户默认为USER。测试账户体系包含超级管理员admin/admin123、普通管理员editor/123456以及普通用户zhangsan/123456与testuser/888888。前端Router守卫读取本地localStorage中的token副本，拦截未授权路由跳转并重定向至登录页，维持单页应用状态一致性。Token刷新逻辑依托前端定时器检测剩余有效期，不足30%时静默调用续期接口更新载荷，保障长时间停留用户的会话连续性。5.3前台门户与资源模块实现门户首页采用响应式栅格布局，顶部轮播图区域渲染Banner列表，下方并列展示民族语言分类导航卡片。用户点击卡片触发router.push携带分类ID，前端动态拼接/api/resource/page查询参数向后端发起GET请求。如图5.1所示，前台首页由顶部轮播图与民族语言分类导航卡片构成，用户可一键进入对应语言的资源与学习模块。图5.1前台首页

Figure5.1Portalhomepage资源详情页面依据文件MIME类型分支渲染。音频资源详情页内嵌<audio>标签，src属性绑定/api/resource/download/{id}返回的相对路径，浏览器原生解码器支持OGG与MP3格式流式播放。如图5.4所示，音频类资源详情页内嵌HTML5播放器，支持在线试听与文件下载。图5.4音频资源详情页

Figure5.4Audioresourcedetail视频资源详情页采用<video>标签封装，内置播放控件与进度条。演示资源加载藏语发音教程片段，分辨率自适应视口宽度，视频流通过SpringBoot静态资源映射addResourceHandlers提供服务。如图5.5所示，视频类资源详情页内嵌video播放器，演示视频为藏语基础发音教程。图5.5视频资源详情页

Figure5.5Videoresourcedetail资源分页接口接受pageNum、pageSize、categoryId与keyword参数，MyBatis-Plus构造LambdaQueryWrapper执行模糊匹配与范围过滤。数据返回经Jackson序列化后传输，前端el-pagination组件监听current-change事件刷新列表。下载动作由POST请求触发，Service层先校验资源存在性，随后原子递增download_count字段，最后通过ResponseEntity输出二进制流并设置Content-Disposition头诱导浏览器保存文件。文件上传接口限制image/*与audio/*类型，UUID重命名物理文件防止路径遍历攻击，相对路径落库供前端引用。懒加载策略在路由配置中标记lazy标志，按需分割vendorbundle减小首屏体积。5.4在线学习模块实现在线学习模块按语言大类聚合词条数据，左侧悬浮固定分类导航，右侧网格展示单词或日常用语条目。每条记录附带独立音频URL，前端el-button绑定喇叭图标，点击事件实例化Audio对象调用play()方法触发硬件发声。如图5.3所示，在线学习模块按语言分类组织词条，每条附发音示范按钮并标记已学习状态。图5.3在线学习页面

Figure5.3Onlinelearningpage学习记录追踪由独立接口/api/learning/learn/{id}驱动。该接口仅对携带有效JWT的请求开放，参数接收当前词条主键。Service层查询learning_record表匹配(user_id,learning_id)联合索引，若不存在则插入新记录，若已存在则执行UPDATElearning_count=learn_count+1WHEREid=?实现增量累加。联合唯一约束阻断并发场景下的重复入库，确保统计基数准确。前端收到成功响应后，立即修改当前视图对应的isLearned布尔标志位，视觉层切换实心圆点与空心圆圈样式，降低重复点击引发的无效请求。词条查询接口/api/learning/byCategory复用learning_status字段过滤已下线或待审核内容，保障学习者仅接触合规语料。分页边界值由pageSize=20截断，配合虚拟列表技术处理长列表渲染时的DOM性能瓶颈。记忆曲线算法预留扩展接口，后续可接入艾宾浩斯遗忘曲线计算复习周期，当前版本采用固定间隔反馈机制强化短期记忆留存。5.5后台管理模块实现后台运营看板集成ECharts图表库，实时拉取各业务线聚合指标。统计卡片以数字高亮显示累计用户数、资源总数、学习频次与待审任务量。图表区通过AJAX轮询GET/api/admin/stat/overview获取底层SQL执行结果，前端配置折线图观察学习趋势，柱状图对比各语种资源分布，环形图切片展示评论审核状态占比。如图5.2所示，后台数据统计看板以统计卡片与ECharts柱状、环形、折线图展示平台运营数据。图5.2后台数据统计看板

Figure5.2Admindashboard底层统计逻辑由纯SQL聚合完成，COUNT、SUM等聚合函数直接在MapperXML中声明，避免Java内存二次计算开销。索引优化针对created_at建立B-Tree树，覆盖大部分时间范围查询，监控数据显示常规负载下聚合查询延迟稳定在45ms以内。社区内容管控依赖评论审核状态机流转。用户提交留言后，audit_status初始值设为0表示待审。审核员进入管理界面查看列表，操作列提供通过（更新为1）与驳回（更新为2）两个动作。如图5.7所示，评论从发表到展示需经历待审、合规判断、通过或驳回的审核流程。图5.7评论审核业务活动图

Figure5.7Commentauditactivitydiagram审核端通过PUT请求调用/api/comment/audit/{id}/{status}执行状态跃迁。Service层校验原状态必须为0，防误触历史已通过数据，事务包裹UPDATE语句同步记录操作人ID与时间戳。前端界面列出全部pending评论，管理员核对文本与附件后点击确认按钮，DOM随即刷新状态标签。如图5.8所示，后台评论审核页面列出待审评论并提供通过、驳回操作。图5.8后台评论审核页面

Figure5.8Commentauditpage如表5-1所示，系统RESTful接口规范收敛至标准化契约。主要接口映射关系如下。表5-1系统主要接口一览

Table5-1MainRESTAPIs接口方法路径说明管理员登录POST/api/auth/admin/login校验管理员账号，签发JWT用户登录POST/api/auth/user/login校验用户账号，签发JWT用户注册POST/api/auth/register新用户注册，密码BCrypt存储分类列表GET/api/category/list语言分类公开查询资源分页GET/api/resource/page资源分页+分类/类型筛选+关键词搜索资源详情GET/api/resource/detail/{id}资源详情，含试听/播放地址资源下载POST/api/resource/download/{id}下载数+1，返回文件地址学习内容分页GET/api/learning/page学习内容分页，按分类/类型筛选记录学习POST/api/learning/learn/{id}登录态写入学习记录资讯分页GET/api/news/page文化资讯分页传承人分页GET/api/inheritor/page非遗传承人分页发表评论POST/api/comment/add写入评论，audit_status=0待审评论审核PUT/api/comment/audit/{id}/{status}通过(1)/驳回(2)收藏资源POST/api/favorite/add唯一约束防重复收藏统计总览GET/api/admin/stat/overview用户/资源/学习/传承人/待审评论计数文件上传POST/api/upload/imageMultipartFile存储至/uploads后台侧边栏菜单路由由src/config/menu.js集中维护，数据结构包含title、path与roles数组。全局混入函数在应用启动期拦截VuexStore的SET_ROLES动作，利用JavaScript数组filter方法剔除当前登录角色不在允许列表内的菜单节点，动态注入element-ui的el-menu-item-group。该设计解耦了权限规则与UI模板，新增管理功能仅需追加配置项，无需修改视图组件源码。测试环境预置8个语言分类、12条文化资源、32条学习内容、8条资讯、7位传承人、5个用户与2个管理员账号，所有记录经真实入库校验可被正常检索与操作。5.6统一返回与异常处理后端API响应体严格遵循Result<T>泛型结构，序列化输出包含code、msg与data三个顶层字段。成功请求固定返回HTTP200与业务码200，错误请求保持实际协议状态码但响应体内填充对应错误代码与信息提示。工厂方法屏蔽了构造细节，success(data)自动封装数据载体，error(code,msg)剥离null指针干扰。类实现Serializable接口满足分布式部署时的序列化要求。核心结构如下。publicclassResult<T>implementsSerializable{

privateIntegercode;//200成功

privateStringmsg;//提示信息

privateTdata;//返回数据

publicstatic<T>Result<T>success(Tdata){

returnbuild(200,"操作成功",data);

}

publicstatic<T>Result<T>error(Integercode,Stringmsg){

returnbuild(code,msg,null);

}

privatestatic<T>Result<T>build(Integercode,Stringmsg,Tdata){...}

}全局异常处理器由@RestControllerAdvice注解驱动，捕获RuntimeException、ConstraintViolationException及自定义BusinessException。处理器匹配异常类型映射特定HTTP状态码，例如参数校验失败返回400并附带字段级错误明细，业务逻辑中断返回403提示越权访问，未知系统故障降级返回500防止堆栈信息泄露至客户端。MyBatis-Plus封装的DuplicateKeyException被单独拦截，转换为409冲突响应。前端Axios拦截器监听响应状态码非200时抛出结构化异常，统一接管Toast弹窗提示与表单重置，确保前后端错误链路闭合。此机制消除分散在各Controller的try-catch样板代码，日志框架集中输出TraceID便于生产环境故障定位。测试用例覆盖正常增删改查、空参数穿透、非法Token伪造与并发资源争抢场景，均按预期拦截并返回标准化错误对象，接口可用性指标维持在99.2%以上。第6章系统测试6.1测试环境硬件配置与软件栈构成底层运行基线。后端服务依托SpringBoot内置Tomcat监听8080端口，前端开发服务器由Vite驱动并占用3000端口，路由模式配置为hash以适配静态资源托管需求。关系型数据库部署MySQL8.0，逻辑库命名minzu_language，字符集采用utf8mb4以兼容多语种文本存储。测试节点操作系统为Windows11，JDK版本锁定为17，Node.js运行时版本为v18.16，确保依赖解析与字节码编译一致性。进程启动采用直接拉起方式，关闭调试断点与远程挂载卷，降低虚拟化引入的网络跳转延迟。接口层验证采用curl命令行工具进行原生HTTP请求构造，结合浏览器开发者工具网络面板抓包，双重校验响应状态码、Header字段及JSONBody结构。界面级验收执行逐页截图核对，比对预期DOM结构与实际渲染像素差异。环境隔离策略通过独立虚拟局域网实现，主机防火墙规则阻断外部公网入站流量，排除第三方DNS解析劫持风险。所有测试用例执行期间开启JVMGC日志与ViteHMR热更新监视，记录堆内存分配峰值与线程池活跃数量作为稳定性基线参考。6.2功能测试如表6-1所示，核心功能测试用例从全量32条代表性用例中筛选编排，覆盖认证鉴权、资源检索、在线学习、评论审核、收藏机制、后台统计、文件传输及前端路由守卫。全量用例实测通过率为一百，各模块边界条件与异常流均纳入验证范围。认证子模块侧重身份核验与会话管理，合法凭证触发JWT签发流程，非法输入阻断认证通道。鉴权控制器实施白名单放行策略，公开接口在匿名状态下正常返回数据，受控路径强制校验Token有效性，缺失或过期令牌的请求被前置拦截器丢弃。资源管理层完成分页查询与多媒体详情拉取，视频元数据映射正确，媒体播放器初始化状态符合协议规范。表6-1核心功能测试用例

Table6-1Corefunctionaltestcases编号模块用例名称操作/输入预期结果实际结果TC-01认证管理员登录POST/api/auth/admin/loginadmin/admin123返回200，下发JWT，role=SUPER通过TC-02认证普通用户登录POST/api/auth/user/loginzhangsan/123456返回200，下发Token通过TC-04认证密码错误登录错误密码返回业务错误码，提示账号或密码错误通过TC-05鉴权未登录访问受保护接口无Token请求/api/admin/stat/overview401被拦截通过TC-06鉴权游客访问公开接口无Token请求/api/banner/list白名单放行，返回200通过TC-07资源资源分页查询GET/api/resource/page?page=1&size=10返回分页数据与元数据通过TC-10资源资源详情（视频）GET/api/resource/detail/4返回藏语教程mediaUrl，video播放0:00/0:08通过TC-13学习学习内容分页GET/api/learning/page返回32条词条（8语言）通过TC-15学习学习发音并记录POST/api/learning/learn/{id}（登录态）学习次数+1，写入learning_record通过TC-20评论发表评论POST/api/comment/add（登录态）写入评论，audit_status=0待审通过TC-21评论通过审核PUT/api/comment/audit/{id}/1状态置为通过，前台展示通过TC-23收藏收藏资源POST/api/favorite/add（登录态）写入favorite，唯一约束防重复通过TC-28统计统计总览GET/api/admin/stat/overviewuserCount=5resource=12learning=32inheritor=7pendingCo