基于HBuilderX与UniCloud的学生成绩管理系统实战：从Schema设计到云函数调用

1次阅读

没有评论

共计 3855 个字符，预计需要花费 10 分钟才能阅读完成。

传统的学生成绩管理系统通常采用本地数据库或传统服务器架构，存在部署复杂、维护成本高、扩展性差等问题。特别是在学校信息化建设中，经常面临以下挑战：

数据同步困难：多终端访问时，本地数据库难以实现实时数据同步
并发处理能力弱：高峰期访问容易导致系统崩溃
安全风险高：缺乏完善的权限管理体系

UniCloud 作为一站式云开发平台，提供了完整的解决方案：

免运维：无需关心服务器配置和数据库维护
弹性扩展：自动应对高并发场景
数据安全：内置完善的权限管理体系
开发高效：与 HBuilderX 深度集成，实现快速开发

UniCloud 提供了两种主要的数据操作方式，各有适用场景：

适用场景：复杂业务逻辑、敏感操作、需要事务支持
优势：
完整的 Node.js 环境
支持事务操作
更好的安全性（代码不暴露在前端）
性能考虑：每次调用有约 100-300ms 的额外网络开销

适用场景：简单 CRUD 操作、实时性要求高的场景
优势：
直接在前端操作数据库
响应速度快（本地缓存机制）
自动处理网络状态
限制：
仅支持基础增删改查
安全性依赖 schema 配置

实际项目中，我们建议：

登录、注册等安全敏感操作使用云函数
成绩查询等高频简单操作使用 ClientDB
成绩修改等需要校验的操作使用云函数

数据库设计是整个系统的核心，我们主要设计两个表：

{
  "bsonType": "object",
  "required": ["username", "password"],
  "properties": {
    "_id": {"description": "ID，系统自动生成"},
    "username": {
      "bsonType": "string",
      "description": "用户名，唯一索引"
    },
    "password": {
      "bsonType": "string",
      "description": "加密后的密码"
    },
    "role": {
      "bsonType": "array",
      "description": "用户角色",
      "items": {
        "bsonType": "string",
        "enum": ["admin", "teacher", "student"]
      }
    }
  }
}

{
  "bsonType": "object",
  "required": ["student_id", "course", "score"],
  "properties": {
    "student_id": {
      "bsonType": "string",
      "description": "学生 ID，关联用户表"
    },
    "course": {
      "bsonType": "string",
      "description": "课程名称"
    },
    "score": {
      "bsonType": "int",
      "minimum": 0,
      "maximum": 100,
      "description": "分数"
    },
    "term": {
      "bsonType": "string",
      "description": "学期"
    }
  }
}

权限设计要点：

学生只能查看自己的成绩
教师可以管理所教课程的成绩
管理员拥有全部权限

使用 HBuilderX 的 uni-app 框架快速搭建界面：

登录页面

<template>
  <view class="login-container">
    <uni-forms ref="form" :model="formData">
      <uni-forms-item label="用户名" name="username">
        <uni-easyinput v-model="formData.username" />
      </uni-forms-item>
      <uni-forms-item label="密码" name="password">
        <uni-easyinput type="password" v-model="formData.password" />
      </uni-forms-item>
      <button @click="submit"> 登录 </button>
    </uni-forms>
  </view>
</template>

<script>
export default {data() {
    return {
      formData: {
        username: '',
        password: ''
      }
    }
  },
  methods: {async submit() {
      try {
        const res = await uniCloud.callFunction({
          name: 'login',
          data: this.formData
        })
        uni.setStorageSync('token', res.result.token)
        uni.reLaunch({url: '/pages/index/index'})
      } catch (e) {uni.showToast({ title: e.message, icon: 'none'})
      }
    }
  }
}
</script>

成绩列表页面

使用 ClientDB 实现高性能查询：

const db = uniCloud.database()
// 查询当前学生的成绩
db.collection('scores')
  .where('student_id == $cloudEnv_uid')
  .orderBy('term desc, course asc')
  .get()
  .then(res => {this.scoreList = res.result.data})

'use strict';
const db = uniCloud.database()
const scoreCollection = db.collection('scores')

exports.main = async (event, context) => {
  // 获取当前用户信息
  const {uid, role} = context.auth

  // 只有教师和管理员可以添加成绩
  if (!role.includes('teacher') && !role.includes('admin')) {return { errCode: 'PERMISSION_DENIED', errMsg: '无权操作'}
  }

  // 验证数据
  const {student_id, course, score, term} = event
  if (!student_id || !course || score === undefined || !term) {return { errCode: 'INVALID_PARAM', errMsg: '缺少必要参数'}
  }

  if (score < 0 || score > 100) {return { errCode: 'INVALID_SCORE', errMsg: '分数必须在 0 -100 之间'}
  }

  try {
    // 检查是否已存在相同记录
    const existing = await scoreCollection
      .where({
        student_id,
        course,
        term
      })
      .get()

    if (existing.data.length > 0) {return { errCode: 'RECORD_EXISTS', errMsg: '该学生本课程成绩已存在'}
    }

    // 添加成绩
    const res = await scoreCollection.add({
      student_id,
      course,
      score: parseInt(score),
      term,
      created_by: uid,
      create_time: Date.now()})

    return {success: true, id: res.id}
  } catch (e) {return { errCode: 'SYSTEM_ERROR', errMsg: e.message}
  }
}

UniCloud 自动扩展的特性可以轻松应对学校场景下的并发访问：