mirror of
https://github.com/ZeroCatDev/ClassworksKV.git
synced 2025-12-07 13:03:09 +00:00
bb61e6e6f5
- Introduced AutoAuth model to manage automatic authorization configurations for devices. - Added new endpoint to obtain token via namespace and password for automatic authorization. - Implemented functionality to set student names for student-type tokens. - Enhanced AppInstall model to include deviceType and isReadOnly fields. - Updated device creation to allow custom namespaces and ensure uniqueness. - Added routes for managing AutoAuth configurations, including CRUD operations. - Implemented checks for read-only tokens in KV operations. - Created detailed API documentation for AutoAuth and new Apps API endpoints. - Added migration scripts to accommodate new database schema changes.
Classworks KV
Classworks用于班级大屏的作业板小工具
ClassworksKV 是 Classworks 的后端实现，这是一个KV存储服务，用于存储和查询数据信息，如作业、花名册等，也可以用于其他用途。
此项目由厚浪云提供，访问公开实例零配置使用 Classworks
文档
许可证
This project is licensed under the GNU AGPL v3.0.
Copyright (C) 2025 Sunwuyuan (https://wuyuan.dev) See LICENSE for details.
配置（OAuth / JWT）
在根目录创建或编辑 .env：
-
基础地址（用于回调）：
BASE_URL:http://localhost:3030FRONTEND_URL:http://localhost:5173
-
STCN（Casdoor）OIDC：
STCN_CLIENT_ID:53e65cfd81232e729730STCN_CLIENT_SECRET:e1b1277f8906e5df162b1d2f2eb3692182dd2920- 回调地址：
${BASE_URL}/accounts/oauth/stcn/callback
-
其他可选提供者：GitHub、ZeroCat、厚浪云（Logto）
-
JWT：
- 默认 HS256（提供
JWT_SECRET） - 如需 RS256，请设置：
JWT_ALG=RS256JWT_PRIVATE_KEY（PEM，\n 转义）JWT_PUBLIC_KEY（PEM，\n 转义）JWT_EXPIRES_IN=7d
- 默认 HS256（提供
完成后启动服务并访问：
- GET /accounts/oauth/providers 列出可用登录方式
- 浏览器打开 /accounts/oauth/stcn 发起 STCN 登录