Nasa 3! Documentation Site

目錄:

• hardware infra document
  • System Architecture
    • Core Components
    • High-Level Design
    • Architecture Diagram
    • Known issue
  • Network Design
    • Internal Network
    • IP Allocation
    • Important Infrastructure IPs
    • Public Network
    • how to configure pve’s IP
      • changing hostname
    • VM Network Design
      • how to configure VM statis IP
      • ubuntu
      • arch linux
      • windows(and installation guide)
    • VMs network and service
    • Known issue
  • Proxmox Cluster Setup
    • Cluster Overview
    • Cluster Creation
    • Note
    • Known Issue
  • Share storage and HA
    • working history
      • setup flow
      • install ceph
      • instal OSD
    • Purpose
    • Current Ceph Configuration
    • VM Storage Policy
    • HA Policy
    • Ceph Components
    • Failure and HA Test
  • backup
    • Deployment Notes
    • PBS Overview
    • Design Decision
    • Storage Design
      • backup policy
    • flow
    • Restore Status
  • log collection
    • Deployment Notes
      • install alloy on pve
    • Overview
    • Purpose
    • Current Scope
    • Architecture
    • logging server
    • grafana
    • Grafana Alloy
    • label
    • Example Queries
    • usage
      • trouble shooting
  • Monitoring System: Prometheus + node-exporter + Grafana
    • Deployment Notes
    • Overview
    • Purpose
    • Current Scope
    • Architecture
    • monitoring server
    • check it in grafana
  • Remote Backup
    • architecture
    • configuration
      • google api
      • pbs
      • timer
    • Known issue
• 2026 Spring NASA 3! Identity Services
  • LDAP Mock Server (系上的模擬LDAP伺服器)
    • 1. 伺服器連線資訊
    • 2. 結構
      • ou=people
      • ou=group
      • ou=Aliases
    • 3. 認證與權限規範
    • 4. HAProxy
    • 5. 查詢與操作範例
      • 查詢特定使用者資訊
      • 查詢特定群組的成員
  • 3! LDAP (內部使用的LDAP server)
    • 1. 伺服器連線資訊
    • 2. 更改預設密碼
    • 3. 綁定服務
    • 4. HAProxy
  • 防火牆 (OPNsense)
    • 共通網路配置 (正常情況都是連這個)
    • opnsense-master (vmid: 252)
    • opnsense-backup (vmid: 253)
    • 目前防火牆規則
  • HAProxy
    • 功能
    • 目前串好的 Application
  • VPN
  • Meeting Minutes
  • Discussion
• Application
  • UI/UX Design
    • NASA 3! UI/UX Document
      • 基本資訊
      • UI Library
        • 工作站
      • Midterm Demo
      • Printing
        • API
        • 需要的頁面
      • Mail
        • login 介面
        • 使用者介面：
        • Admin 介面
      • 會議記錄
  • CSpace
    • CSpace
      • Frontend Development Get Started
      • Backend Development Get Started
        • Branch Naming Rule
          • Example:
          • scope (where it happens)
          • type (what you’re doing)
          • short-description
        • After work is done on the branch, either:
    • CSpace REST API Documentation
      • Base URL
      • Authentication
        • Obtain Token (Login)
        • Refresh Token
        • Logout
      • Users
        • Get all users from User
        • Get User info
        • Get User’s Groups (user_groups)
      • Notifications
        • List All Notifications (NEW)
        • Refresh Notifications
        • Mark Notification as Viewed
        • Archive Notification
      • Groups
        • List all groups
        • Get own group’s group details (Admin or member)
        • Create group (Admin)
        • Delete group (Admin)
        • Add User to Group
      • User Groups
        • List all users from all groups (list all user_groups)
        • Get user_group
        • Update a user_group
        • Delete User from Group
      • Classrooms
        • List All Classrooms
        • Get Classroom Details
        • Create Classroom (Admin)
        • Update Classroom (Admin)
      • Registrations
        • Create Registration
        • Get Registration Details
        • Update Registration
        • Delete Registration
        • List User’s Registrations
        • Get Room Agenda
        • Check Room Availability
        • List Registrations (Admin)
        • Approve Registration (Admin)
        • Reject Registration (Admin)
      • Allocation Events
        • List Allocation Events
        • Get Allocation Event Details
        • Create Allocation Event (Admin)
        • End Allocation Event (Admin)
        • Distribute Allocations (Admin)
        • Get Unavailable Dates for Event
        • Get Room Agenda for Event
      • Allocation Registrations (User’s draw entries)
        • Register for Allocation Event
        • List User’s Allocation Registrations
        • Get Allocation Registration Result
        • Update Allocation Registration
        • Delete Allocation Registration
        • Approve Allocation Registration (Admin)
        • Reject Allocation Registration (Admin)
      • Batch Allocation (Long-term Registrations)
      • Logs
        • List Change Logs (Admin)
      • Error Responses
        • 400 Bad Request
        • 401 Unauthorized
        • 403 Forbidden
        • 404 Not Found
        • 409 Conflict
    • Backend Documentation
      • Authentication & Authorization
        • Database
        • JWT Tokens
          • Token Types
          • Token Storage
          • Token Rotation
          • Authentication Flow
      • CSpace Authorization Rules
        • Group Management
        • Registration
        • Superuser
      • Docker
        • Dev
        • Production
      • Time Related Formats
        • Date
        • Datetime
      • Cookies
        • SameSite=
      • Database Tables & Columns Descriptions
        • users
        • groups
        • user_group
        • classrooms
        • draw_events
        • draw_registrations
        • longterm_registrations
        • registrations
        • notifications
        • notification_users
        • change_logs
  • Mail Subscription
    • Mail Subscription
    • Mail Subscription API Documentation
      • Base URL
      • Authentication
        • Login
        • Check Session
        • Logout
      • User
        • Get User Setting
        • Update User Setting
      • Admin
        • Get All Aliases
        • Create Alias
        • Update Alias
        • Delete Alias
        • Get Alias Subscribers
        • Add Subscriber to Alias
        • Remove Subscriber from Alias
      • Error Responses
        • 400 Bad Request
        • 401 Unauthorized
        • 403 Forbidden
        • 404 Not Found
        • 409 Conflict
        • 429 Too Many Requests
        • 500 Internal Server Error
    • Mail Server
      • Introduction
      • Settings
        • Postfix
          • Installation
          • Usage
        • Mailpit
          • Installation
          • Run
    • Backend Documentation
    • 2026 NASA 3! Mail Subscription
      • Meetings
      • 完成事項
      • 下週事項
      • Tasks
        • Core Auth & Infra
        • APIs & Rate Limit
        • LDAP sync
      • Workflow
      • Job Distribution
        • Layout
        • Job1: Basic Structure and Utilities - Qwertypig, 4/8 due
        • Job2: Synchronization - chilfox, 4/12 due
        • Job3: Database and API - wen, 4/12 user, 4/15 setup and testing
        • suggestions
  • New Printing
    • 3/22
      • 工作分配
      • TODO
    • 3/23 with UI/UX
    • 3/30 會議
      • 進度報告
      • TODO
      • By wiwi 的列印流程（new printing）
      • TODO: API 細項
      • 下週挪到週三 16:00 ~17:00？
      • 之後還要幹嘛？
    • 4/8(? 會議
      • API 流程清單
      • TODO
      • Deadline
      • Demo 目標
      • 開會時間
    • 4/15 進度追蹤
      • Windows server
        • TODO
      • TODO
        • Gprc TODO
        • UIUX Backend
        • Windows
        • 進度規劃
    • 4/29
      • 工作整理與分配
        • 基本功能
        • HA
        • 可能不重要
      • 死線
    • 5/6 開會
      • 關於 HA
      • TODO after 機率小考
    • 5/13
      • 新的流程（refund）：
      • 新的流程（to django）
      • TODO
    • 5/20 Meeting
      • 下週之前的 TODO
    • 5/27 Meeting
      • TODO
    • Document
      • Nginx
      • Django
      • Redis
      • Scheduler
      • DB
        • Balance
        • Admin
        • Submissions
      • Windows Server
• 2026 NASA 3! CSIE Wi-Fi
  • Meetings
    • 已完成
    • TODO
    • 已完成
    • TODO
    • 已完成
    • TODO
    • 已完成
    • TODO
    • 已完成
    • TODO
    • 已完成
    • TODO
    • 已完成
    • TODO
    • 已完成
    • TODO
    • 已完成
    • TODO
    • 已完成
    • TODO
    • 已完成
    • TODO
  • Workflow
  • Job Distribution
    • Layout
  • Data
    • AP正下方
      • csie-5G
      • csie
    • 兩個AP中間
      • csie-5G
      • csie
    • 遠點
      • csie-5G
      • csie
    • AP正下方
      • csie-5G
      • csie
    • 兩個AP中間
      • csie-5G
      • csie
    • 測量時的觀察
  • API文件
    • POST /api/heatmap/measurements/create/
      • request body
      • success response
      • error response
    • GET /api/heatmap/measurements/
      • example request
    • GET /api/heatmap/
      • example request
      • response
    • Heatmap Value
    • POST api/iperf/run
      • request body
      • success response (HTTP 200 OK)
      • error response - Validation Error (HTTP 400 Bad Request)
      • error response - Service Unavailable (HTTP 503 Service Unavailable)
    • GET /api/iperf/download/
      • example request
      • response (HTTP 200 OK)
  • REST API互動基本流程