108 lines
3.6 KiB
Rust
108 lines
3.6 KiB
Rust
use serde::{Deserialize, Serialize};
|
|
use serde_json::Value;
|
|
|
|
// 管理后台协议统一收口在 shared-contracts，避免页面脚本和 Rust handler 各自手拼字段。
|
|
#[derive(Clone, Debug, Serialize, Deserialize, PartialEq, Eq)]
|
|
#[serde(rename_all = "camelCase")]
|
|
pub struct AdminLoginRequest {
|
|
pub username: String,
|
|
pub password: String,
|
|
}
|
|
|
|
// 登录成功后返回管理员访问令牌与基础会话信息。
|
|
#[derive(Clone, Debug, Serialize, Deserialize, PartialEq, Eq)]
|
|
#[serde(rename_all = "camelCase")]
|
|
pub struct AdminLoginResponse {
|
|
pub token: String,
|
|
pub admin: AdminSessionPayload,
|
|
}
|
|
|
|
// 管理员会话只暴露页面展示和鉴权调试所需的最小字段。
|
|
#[derive(Clone, Debug, Serialize, Deserialize, PartialEq, Eq)]
|
|
#[serde(rename_all = "camelCase")]
|
|
pub struct AdminSessionPayload {
|
|
pub subject: String,
|
|
pub username: String,
|
|
pub display_name: String,
|
|
pub roles: Vec<String>,
|
|
pub issued_at: String,
|
|
pub expires_at: String,
|
|
}
|
|
|
|
// 页面恢复登录态时读取当前管理员会话。
|
|
#[derive(Clone, Debug, Serialize, Deserialize, PartialEq, Eq)]
|
|
#[serde(rename_all = "camelCase")]
|
|
pub struct AdminMeResponse {
|
|
pub admin: AdminSessionPayload,
|
|
}
|
|
|
|
// 后台概览统一返回服务信息与数据库信息两块，前端不再额外拼装。
|
|
#[derive(Clone, Debug, Serialize, Deserialize, PartialEq)]
|
|
#[serde(rename_all = "camelCase")]
|
|
pub struct AdminOverviewResponse {
|
|
pub service: AdminServiceOverviewPayload,
|
|
pub database: AdminDatabaseOverviewPayload,
|
|
}
|
|
|
|
// 服务概览描述当前 api-server 与 SpacetimeDB 连接配置。
|
|
#[derive(Clone, Debug, Serialize, Deserialize, PartialEq, Eq)]
|
|
#[serde(rename_all = "camelCase")]
|
|
pub struct AdminServiceOverviewPayload {
|
|
pub bind_host: String,
|
|
pub bind_port: u16,
|
|
pub jwt_issuer: String,
|
|
pub admin_enabled: bool,
|
|
pub spacetime_server_url: String,
|
|
pub spacetime_database: String,
|
|
}
|
|
|
|
// 数据库概览返回真实数据库元信息、表清单与统计错误。
|
|
#[derive(Clone, Debug, Serialize, Deserialize, PartialEq, Eq)]
|
|
#[serde(rename_all = "camelCase")]
|
|
pub struct AdminDatabaseOverviewPayload {
|
|
pub database_identity: Option<String>,
|
|
pub owner_identity: Option<String>,
|
|
pub host_type: Option<String>,
|
|
pub schema_table_names: Vec<String>,
|
|
pub table_stats: Vec<AdminDatabaseTableStatPayload>,
|
|
pub fetch_errors: Vec<String>,
|
|
}
|
|
|
|
// 单表统计允许成功和失败并存，避免某张表失败导致整页概览不可用。
|
|
#[derive(Clone, Debug, Serialize, Deserialize, PartialEq, Eq)]
|
|
#[serde(rename_all = "camelCase")]
|
|
pub struct AdminDatabaseTableStatPayload {
|
|
pub table_name: String,
|
|
pub row_count: Option<u64>,
|
|
pub error_message: Option<String>,
|
|
}
|
|
|
|
// 调试请求只允许同源路径、受控请求头和有限请求体。
|
|
#[derive(Clone, Debug, Serialize, Deserialize, PartialEq)]
|
|
#[serde(rename_all = "camelCase")]
|
|
pub struct AdminDebugHttpRequest {
|
|
pub method: String,
|
|
pub path: String,
|
|
pub headers: Option<Vec<AdminDebugHeaderInput>>,
|
|
pub body: Option<String>,
|
|
}
|
|
|
|
// 调试请求头使用显式结构，避免页面直接塞任意对象。
|
|
#[derive(Clone, Debug, Serialize, Deserialize, PartialEq, Eq)]
|
|
#[serde(rename_all = "camelCase")]
|
|
pub struct AdminDebugHeaderInput {
|
|
pub name: String,
|
|
pub value: String,
|
|
}
|
|
|
|
// 调试响应回显状态、响应头与文本/JSON 预览，便于后台排查接口问题。
|
|
#[derive(Clone, Debug, Serialize, Deserialize, PartialEq)]
|
|
#[serde(rename_all = "camelCase")]
|
|
pub struct AdminDebugHttpResponse {
|
|
pub status: u16,
|
|
pub status_text: String,
|
|
pub headers: Vec<AdminDebugHeaderInput>,
|
|
pub body_text: String,
|
|
pub body_json: Option<Value>,
|
|
}
|