MyUCSpace Documentation Center

Welcome to the MyUCSpace documentation center. Please use the sections below to browse by topic.

Working with the development team

• Using Sphinx for building documentation
  • Installation
  • Building the documentation
• Django Backend Development & Design Documentation
  • Document Scope
  • Reading Order
  • Core Roles
  • Module Collaboration
  • Key Flows
  • Documentation Index
  • Module Map
  • Maintenance Principles
• Classroom Manager - Web Admin Panel
  • Architecture & Tech Stack
  • Project Structure
  • Feature Modules
  • Quick Start
  • Development Configuration
  • Development Conventions
• Classroom digital signage
  • Overview
  • Repository layout
  • How it works
  • Backend API
  • Important behavior changes
  • Building and running
  • Operational notes

API manuals

• Backend API Design
  • API Documentation Index
  • 0. Unified Response Format
  • Common Data Structures
• Authentication and User Accounts API
  • 1. Login
  • 2. Invite a Foreign Teacher to Register (Admin)
  • 3. Email Registration (Foreign Teacher)
  • 4. Get Current User Information
  • 5. User List (Admin)
  • 6. Create User (superadmin / secretary)
  • 7. Update User Information (superadmin / secretary)
  • 8. Change Role (superadmin)
  • 9. Disable or Enable Account (superadmin / secretary)
  • 10. Import Users from Excel (superadmin / secretary)
  • 11. Refresh Token
  • 12. Logout
  • 13. Bind WeChat
  • 14. Unbind WeChat
  • 15. Get SM2 Public Key
• Classroom Management API
  • 1. Get Classroom List (Authenticated)
  • 2. Classroom Details
  • 3. Create Classroom (superadmin)
  • 4. Update Classroom Information (superadmin / assistant)
  • 5. Delete Classroom (superadmin)
  • 6. Import Classrooms from Excel (superadmin)
  • 7. Classroom Schedule
  • 8. Get Available Classrooms for the Same Time Slot
• Signage Device API
  • 1. Activate a Signage Device (Public, One-Time Activation Code)
  • 2. Current Signage Device Information (Device Authentication)
  • 3. Current Signage Device Schedule (Device Authentication)
  • 4. Generate Signage Binding QR-Code Data (Admin)
  • 5. Admin-Side Signage Configuration APIs (Admin)
• Courses API
  • 1. Course List (Authenticated)
  • 2. Import Timetable from Excel (superadmin / secretary)
  • 3. Export Timetable (superadmin / secretary)
  • 4. Reschedule a Course Session
• Classroom Borrowing Workflow API
  • 1. Create a Borrowing Request
  • 2. Borrowing Request List (Role-Based)
  • 3. Application Details
  • 4. Review an Application
  • 5. Applicant Cancels an Application
  • 6. Reschedule a Course Borrowing (Applicant or Admin)
• Repair Workflow API
  • Work-Order Status Flow
  • 1. Standard Repair Request (All Authenticated Users)
  • 2. Emergency Repair
  • 3. Work-Order List
  • 4. Update Work Order (assistant / superadmin / counselor)
  • 5. Requester Confirms Repair Completion
• Abuse Report API
  • 1. Submit a Report (All Authenticated Users)
  • 2. Report List
  • 3. Handle a Report (superadmin Only)
• Class Check-in API
  • 1. Manually Create a Check-in Session
  • 2. Check-in Session List
  • 3. Get Today’s Check-in Sessions
  • 4. Open a Check-in Session
  • 5. Get Roster
  • 6. Update Student Check-in Status in Real Time
  • 7. Check-in Record List
  • 8. Student View of Daily Courses and Check-in Status
  • 9. Manual Check-in by Teacher
• Audit Log API
  • 1. Get Log List
  • 2. Export CSV
• Common Utilities API
  • 1. Attachment Upload
  • 2. Get System Configuration
  • 3. Set Seasonal Schedule (superadmin Only)
• Guides for using the SUST API
  • How to Read Information via SUST API
  • How to Write Information via SUST API
  • How to SSO via SUST API
  • How to Log In by Scanning a QR Code via SUST API

Deployment and maintenance

• Development environment deployment
  • Prerequisites
  • Quick start
  • Access endpoints
  • Development vs production comparison
  • Common commands
  • Reset the environment (remove data volumes)
  • Troubleshooting tips
• Deployment in the production environment
  • Step 1: Configure environment variables
  • Step 2: Build and run
  • Step 3: Initialize the database and create a user
  • Step 4: Configure HTTPS (optional but recommended)
  • Production access endpoints
  • Domestic (China) image mirror configuration
• TLS (HTTPS) deployment guide
  • Architecture Overview
  • Files and Paths
  • Prerequisites
  • Certificate Provisioning
  • Nginx TLS Configuration (Current Behavior)
  • Hardening and Production Recommendations
  • Operational Checklist

Release notes

• MyUCSpace release notes
  • MyUCSpace 0.1.0 release notes
  • MyUCSpace 0.1.1 release notes
  • MyUCSpace 0.2.0 release notes