乐教库 · 知识管理平台

为什么要做这个项目

背景问题

传统的教学资源管理依赖本地存储与人工分类，导致优质内容孤立、检索困难、难以复用与协作。教师之间缺乏高效的资源共享渠道，大量非结构化的课件、教案、习题等数字资产无法转化为可高效利用的机构知识。

技术愿景

我们致力于构建一个现代化的教学资源中枢。通过标准化的目录系统与元数据管理，将零散的教学材料转化为结构化、可检索、可关联的知识库。平台为教学资源的长期沉淀、高效检索与安全共享提供了可靠的技术基础，助力教育工作者提升资源管理与备课效率。

我们解决了什么

核心技术架构

• 全栈应用实现：采用前后端分离架构。后端基于 Node.js + TypeScript + Express 构建高并发API；前端基于 Vue.js 生态构建了响应式、交互友好的用户界面，并通过HTTPS安全协议与后端通信。
• 稳健的数据层：使用 MySQL 存储核心业务数据，并通过合理的数据表设计与索引优化，保障复杂查询下的性能与数据一致性。
• 生产级部署与运维：运用 PM2 进行应用进程守护与管理，通过 Nginx 实现反向代理、负载均衡与静态资源服务。整个应用栈（前端与后端API）已完成 HTTPS (SSL/TLS) 安全加密部署，并通过阿里云ECS提供稳定的线上服务。

关键工程实践

• 端到端自动化CI/CD流水线：通过 GitHub Actions 实现了从代码提交到生产环境部署的全流程自动化。前后端项目均配置了独立的部署流水线，推送代码至主干分支即可自动完成构建、测试与热更新，保障了交付效率与部署可靠性。
• 标准化部署与运维结构：采用 current (当前版本代码) 与 shared (共享数据、配置、日志) 分离的目录设计，支持无缝的版本发布与快速回滚。完善了日志监控与错误追踪机制。
• 安全与可扩展性：实现了基于JWT的用户认证与细粒度的权限控制(RBAC)，确保多角色用户（教师、审核员、管理员）的安全访问。前后端架构均采用模块化设计，为未来在智能检索、个性化推荐、功能扩展等方向奠定了坚实基础。

当前阶段说明

乐教库平台已正式上线并稳定运行。用户可通过 https://lejiaoku.com 访问完整的线上服务。

目前平台核心功能已全部就绪，包括：

• 用户注册、登录与多角色权限管理
• 教学资源的上传、管理、审核与发布
• 基于教材目录体系的资源结构化组织
• 资源的搜索、浏览与基础检索
• 个人资源库与后台管理面板

项目代码已全面开源（前端 lejiaoku-web，后端 lejiaoku-backend），遵循清晰的分支策略与提交规范。团队正持续关注用户反馈，进行性能优化、体验打磨与功能迭代，致力于将乐教库打造为教育工作者真正信赖与依赖的知识管理伙伴。