feat: Add local data management modules (WIP)

- cached_sheet.rs: Cached sheet data management
- local_sheet.rs: Local sheet mapping structure
- member_held.rs: Member file holding status tracking
- NOTE: These modules are still under development

1 files changed, 50 insertions, 0 deletions

diff --git a/crates/vcs_data/src/data/local/cached_sheet.rs b/crates/vcs_data/src/data/local/cached_sheet.rs
new file mode 100644
index 0000000..7ca1f2f
--- /dev/null
+++ b/crates/vcs_data/src/data/local/cached_sheet.rs
@@ -0,0 +1,50 @@
+use std::{io::Error, path::PathBuf};
+
+use cfg_file::config::ConfigFile;
+use string_proc::snake_case;
+
+use crate::{
+    constants::CLIENT_FILE_CACHED_SHEET,
+    current::current_local_path,
+    data::{
+        member::MemberId,
+        sheet::{SheetData, SheetName},
+    },
+};
+
+const SHEET_NAME: &str = "{sheet_name}";
+const ACCOUNT_NAME: &str = "{account}";
+
+pub struct CachedSheet;
+
+impl CachedSheet {
+    /// Read the cached sheet data.
+    pub async fn cached_sheet_data(
+        account_name: MemberId,
+        sheet_name: SheetName,
+    ) -> Result<SheetData, std::io::Error> {
+        let account_name = snake_case!(account_name);
+        let sheet_name = snake_case!(sheet_name);
+
+        let Some(path) = Self::cached_sheet_path(account_name, sheet_name) else {
+            return Err(Error::new(
+                std::io::ErrorKind::NotFound,
+                "Local workspace not found!",
+            ));
+        };
+        let data = SheetData::read_from(path).await?;
+        Ok(data)
+    }
+
+    /// Get the path to the cached sheet file.
+    pub fn cached_sheet_path(account_name: MemberId, sheet_name: SheetName) -> Option<PathBuf> {
+        let current_workspace = current_local_path()?;
+        Some(
+            current_workspace.join(
+                CLIENT_FILE_CACHED_SHEET
+                    .replace(SHEET_NAME, &sheet_name.to_string())
+                    .replace(ACCOUNT_NAME, &account_name.to_string()),
+            ),
+        )
+    }
+}