Merge branch 'main' of https://github.com/Heavrnl/nexus-terminal
This commit is contained in:
Baobhan Sith
@@ -1,108 +0,0 @@
|
||||
# 重构设置加载与存储机制计划 (Refactoring Plan for Settings Loading/Storage)
|
||||
|
||||
**目标:** 重构 `SettingsView.vue` 和 `settings.store.ts` 中的设置加载与存储机制，以明确区分登录和未登录状态，整合浏览器默认设置，使用 `localStorage` 进行未登录状态的持久化，并实现由后端驱动的首次登录同步机制。
|
||||
|
||||
**阶段 1: 后端调整 (需要后端开发协调)**
|
||||
|
||||
1. **`/settings` API (GET):**
|
||||
* 用户已登录：返回该用户保存的设置。
|
||||
* 用户未登录：返回明确表示未登录的响应（例如 401 Unauthorized，或带有特定标志的 200 OK）。
|
||||
2. **`/settings` API (PUT):**
|
||||
* 确保能接受并存储所有相关设置项，包括 `language` 和 `timezone`。
|
||||
3. **登录/认证接口:**
|
||||
* 成功登录后，响应中应包含一个标志（例如 `isFirstLogin: true/false`）来表明这是否是用户的首次登录。
|
||||
|
||||
**阶段 2: 前端 `settings.store.ts` 重构**
|
||||
|
||||
1. **状态 (State):**
|
||||
* 保留 `settings = ref<Partial<SettingsState>>({})`。
|
||||
* 添加 `isUsingLocalStorage = ref(false)` 来跟踪当前状态是否基于 localStorage（用于未登录用户）。
|
||||
2. **`loadInitialSettings` Action:**
|
||||
* 注入 `authStore`。
|
||||
* 检查 `authStore.isAuthenticated`。
|
||||
* **如果未认证:**
|
||||
* 设置 `isUsingLocalStorage.value = true`。
|
||||
* 尝试从 `localStorage` 加载设置 (键名: `nexus_guest_settings`)。
|
||||
* 如果 `localStorage` 数据存在且有效:
|
||||
* 解析数据并与必要的硬编码默认值（如 UI 相关的）合并。
|
||||
* 更新 `settings.value`。
|
||||
* 如果 `localStorage` 数据不存在或无效:
|
||||
* 检测浏览器语言 (`navigator.language`) 和时区 (`Intl.DateTimeFormat().resolvedOptions().timeZone`)。
|
||||
* 将这些值与硬编码默认值结合，形成初始的 `settings.value`。
|
||||
* 将这套初始设置保存到 `localStorage`。
|
||||
* 根据确定的语言设置 `i18n`。
|
||||
* **如果已认证:**
|
||||
* 设置 `isUsingLocalStorage.value = false`。
|
||||
* 调用后端 `/settings` API (GET)。
|
||||
* 使用响应数据更新 `settings.value`。**移除** 此处补充默认值的逻辑。
|
||||
* 根据获取的语言设置 `i18n`。
|
||||
* 清除 `localStorage` 中的访客设置 (`localStorage.removeItem('nexus_guest_settings')`)。
|
||||
3. **`syncInitialSettingsOnLogin` Action:**
|
||||
* 此 action 在用户**首次**成功登录后被外部调用。
|
||||
* 读取当前的 `settings.value`。
|
||||
* 调用 `updateMultipleSettings` 将这些设置推送到后端。
|
||||
4. **`updateSetting` & `updateMultipleSettings` Actions:**
|
||||
* 检查 `authStore.isAuthenticated`。
|
||||
* **如果已认证:**
|
||||
* 调用后端 `/settings` API (PUT)。
|
||||
* API 调用成功后更新 `settings.value`。
|
||||
* **如果未认证:**
|
||||
* 更新 `settings.value` 中的相应键值。
|
||||
* 将整个更新后的 `settings.value` 对象保存回 `localStorage`。
|
||||
* **不**调用后端 API。
|
||||
5. **Getters:** 无需大的改动。
|
||||
|
||||
**阶段 3: 前端登录/认证逻辑调整**
|
||||
|
||||
1. 登录 API 调用成功后:
|
||||
* 检查响应中的 `isFirstLogin` 标志。
|
||||
* 如果 `isFirstLogin` 为 `true`:
|
||||
* 先调用 `settingsStore.loadInitialSettings()`。
|
||||
* 然后调用 `settingsStore.syncInitialSettingsOnLogin()`。
|
||||
* 如果 `isFirstLogin` 为 `false`:
|
||||
* 仅调用 `settingsStore.loadInitialSettings()`。
|
||||
|
||||
**阶段 4: 前端 `SettingsView.vue` 简化**
|
||||
|
||||
1. 移除用于同步本地组件状态和 store 的复杂 `watch` 逻辑。直接依赖 store 状态。
|
||||
2. 确保所有保存操作都调用 `settingsStore.updateSetting` 或 `settingsStore.updateMultipleSettings`。
|
||||
|
||||
**Mermaid 流程图:**
|
||||
|
||||
```mermaid
|
||||
graph TD
|
||||
subgraph Initialization [应用初始化]
|
||||
A[应用加载] --> B{用户是否已认证?};
|
||||
B -- 是 --> C[API GET /settings 获取用户设置];
|
||||
B -- 否 --> D{从 localStorage 加载访客设置?};
|
||||
D -- 是 --> E[解析 localStorage 数据];
|
||||
D -- 否 --> F[检测浏览器语言/时区];
|
||||
F --> G[结合硬编码默认值];
|
||||
G --> H[保存初始设置到 localStorage];
|
||||
E --> I[合并 localStorage 数据与硬编码默认值];
|
||||
C --> J[更新 Pinia 状态 (来自后端)];
|
||||
I --> K[更新 Pinia 状态 (来自 localStorage)];
|
||||
H --> K;
|
||||
J --> L[设置 i18n 语言];
|
||||
K --> L;
|
||||
C --> CL[清除 localStorage 访客设置]
|
||||
end
|
||||
|
||||
subgraph Login [用户登录流程]
|
||||
M[登录成功] --> N{后端返回 isFirstLogin?};
|
||||
N -- 是 --> O[调用 settingsStore.loadInitialSettings() *];
|
||||
O --> P[调用 settingsStore.syncInitialSettingsOnLogin()];
|
||||
P --> Q[API PUT /settings (同步初始设置)];
|
||||
N -- 否 --> R[调用 settingsStore.loadInitialSettings()];
|
||||
end
|
||||
subgraph SettingsUpdate [设置更新流程]
|
||||
S[用户在 UI 修改设置] --> T{用户是否已认证?};
|
||||
T -- 是 --> U[调用 settingsStore.updateSetting/updateMultiple];
|
||||
U --> V[API PUT /settings];
|
||||
V --> W[更新 Pinia 状态];
|
||||
T -- 否 --> X[调用 settingsStore.updateSetting/updateMultiple];
|
||||
X --> Y[更新 Pinia 状态];
|
||||
Y --> Z[保存到 localStorage];
|
||||
end
|
||||
|
||||
note right of O *加载可能已修改的访客设置，准备同步
|
||||
@@ -1,54 +0,0 @@
|
||||
services:
|
||||
frontend:
|
||||
image: heavrnl/nexus-terminal-frontend
|
||||
container_name: nexus-terminal-frontend
|
||||
ports:
|
||||
- "3001:80"
|
||||
depends_on:
|
||||
- backend
|
||||
- rdp # Added rdp dependency
|
||||
networks:
|
||||
- nexus-terminal-network
|
||||
|
||||
backend:
|
||||
image: heavrnl/nexus-terminal-backend
|
||||
container_name: nexus-terminal-backend
|
||||
ports:
|
||||
- "3001:3001"
|
||||
environment:
|
||||
NODE_ENV: production
|
||||
PORT: 3001
|
||||
RDP_BACKEND_API_BASE: http://rdp:9090 # Add URL for backend to reach RDP service
|
||||
volumes:
|
||||
- ./data:/app/data
|
||||
networks:
|
||||
- nexus-terminal-network
|
||||
|
||||
rdp:
|
||||
image: heavrnl/nexus-terminal-rdp
|
||||
container_name: nexus-terminal-rdp
|
||||
environment:
|
||||
GUACD_HOST: guacd
|
||||
GUACD_PORT: 4822
|
||||
API_PORT: 9090
|
||||
GUAC_WS_PORT: 8081
|
||||
FRONTEND_URL: http://frontend
|
||||
MAIN_BACKEND_URL: http://backend:3001
|
||||
NODE_ENV: production
|
||||
networks:
|
||||
- nexus-terminal-network
|
||||
depends_on:
|
||||
- guacd
|
||||
- backend
|
||||
|
||||
guacd:
|
||||
image: guacamole/guacd:latest
|
||||
container_name: nexus-terminal-guacd
|
||||
networks:
|
||||
- nexus-terminal-network
|
||||
restart: unless-stopped
|
||||
|
||||
networks:
|
||||
nexus-terminal-network:
|
||||
driver: bridge
|
||||
name: nexus-terminal-network
|
||||
Reference in New Issue
Block a user