refactor: migrate monolithic crate to Cargo Workspace with Clean Architecture

Transform the single binary crate into a 9-crate workspace monorepo: - Root Cargo.toml as [workspace] manager with resolver = "2" - zesdex-entities: Domain entity types (session, settings, store, message, etc.) - zesdex-utils: Pure utility functions (error, logger, pagination, slug, clipboard) - zesdex-dto: Data Transfer Objects for LLM provider API communication - zesdex-ipc: Unix-socket IPC layer (client/server/framing/protocol) - zesdex-iam: Identity & Access Management (Clean Architecture: domain/application/infrastructure) - zesdex-cms: Content Management (Clean Architecture: domain/application/infrastructure) - zesdex-middleware: HTTP middleware (Auth, CORS, Rate Limiting) - zesdex-libs: Composition root (AppContext, DB init, JWT, Argon2) - zesdex-backend: Main binary entry point + seed/migrate binaries - DevOps: Dockerfile, docker-compose, Nix (flake/shell/default), CI/CD updates - Remove dead root src/ and src-misc/ directories All crate re-exports maintain backward compatibility with original crate::model::*, crate::dto::*, crate::ipc::* module paths. Feature crates enforce strict layer separation: domain -> application -> infrastructure with generic trait-based dependency injection.
2026-07-17 09:08:41 +07:00
parent 86cc412395
commit be0a9582bb
248 changed files with 7901 additions and 1505 deletions
@@ -0,0 +1,74 @@
+//! JSON file–backed `SettingsRepository`.
+//!
+//! Path: `<base_dir>/settings.json`
+//!
+//! Uses write-then-rename with fsync for crash safety.
+
+#![allow(
+    clippy::cast_possible_truncation,
+    clippy::cast_sign_loss,
+    clippy::cast_precision_loss,
+    clippy::cast_possible_wrap
+)]
+
+use std::io::Write;
+use std::path::Path;
+
+use anyhow::{Context, Result};
+
+use crate::domain::repository::SettingsRepository;
+use crate::domain::settings::Settings;
+
+/// Persists `Settings` as pretty-printed JSON at `<base_dir>/settings.json`.
+#[derive(Debug, Clone, Default)]
+pub struct JsonSettingsRepository;
+
+impl JsonSettingsRepository {
+    /// Create a new repository instance.
+    pub fn new() -> Self {
+        Self
+    }
+}
+
+impl SettingsRepository for JsonSettingsRepository {
+    fn load(&self, base_dir: &Path) -> Result<Settings> {
+        let path = base_dir.join("settings.json");
+        match std::fs::read_to_string(&path) {
+            Ok(s) => serde_json::from_str(&s)
+                .map_err(|e| anyhow::anyhow!("failed to parse settings.json: {e}")),
+            Err(e) if e.kind() == std::io::ErrorKind::NotFound => {
+                tracing::info!("settings.json not found, using defaults");
+                Ok(Settings::default())
+            }
+            Err(e) => Err(anyhow::anyhow!("failed to read settings.json: {e}")),
+        }
+    }
+
+    fn save(&self, base_dir: &Path, settings: &Settings) -> Result<()> {
+        std::fs::create_dir_all(base_dir)
+            .with_context(|| format!("failed to create base dir '{}'", base_dir.display()))?;
+        let path = base_dir.join("settings.json");
+        let tmp = base_dir.join("settings.json.tmp");
+        let json = serde_json::to_string_pretty(settings)
+            .context("failed to serialize settings")?;
+        {
+            let mut f = std::fs::OpenOptions::new()
+                .create(true)
+                .truncate(true)
+                .write(true)
+                .open(&tmp)
+                .with_context(|| format!("failed to write temp file '{}'", tmp.display()))?;
+            f.write_all(json.as_bytes())?;
+            f.sync_all()?;
+        }
+        std::fs::rename(&tmp, &path)
+            .with_context(|| format!("failed to rename '{}' -> '{}'", tmp.display(), path.display()))?;
+        if let Some(parent) = path.parent() {
+            if let Ok(d) = std::fs::File::open(parent) {
+                let _ = d.sync_all();
+            }
+        }
+        tracing::debug!("settings saved to '{}'", path.display());
+        Ok(())
+    }
+}