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, 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, pub owner_identity: Option, pub host_type: Option, pub schema_table_names: Vec, pub table_stats: Vec, pub fetch_errors: Vec, } // 单表统计允许成功和失败并存,避免某张表失败导致整页概览不可用。 #[derive(Clone, Debug, Serialize, Deserialize, PartialEq, Eq)] #[serde(rename_all = "camelCase")] pub struct AdminDatabaseTableStatPayload { pub table_name: String, pub row_count: Option, pub error_message: Option, } // 调试请求只允许同源路径、受控请求头和有限请求体。 #[derive(Clone, Debug, Serialize, Deserialize, PartialEq)] #[serde(rename_all = "camelCase")] pub struct AdminDebugHttpRequest { pub method: String, pub path: String, pub headers: Option>, pub body: Option, } // 调试请求头使用显式结构,避免页面直接塞任意对象。 #[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, pub body_text: String, pub body_json: Option, }