init with react+axum+spacetimedb

server-rs/crates/shared-contracts/src/admin.rs

@@ -0,0 +1,107 @@
+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>,
+}