init

docs/ai/DataPRO/Modules/InstallerCustomActions/LocalSQLDB.md

@@ -0,0 +1,49 @@
+---
+source_files:
+  - DataPRO/Modules/InstallerCustomActions/LocalSQLDB/LocalDBPreparation.cs
+  - DataPRO/Modules/InstallerCustomActions/LocalSQLDB/LocalDBPrepare.cs
+generated_at: "2026-04-17T16:45:09.055203+00:00"
+model: "zai-org/GLM-5-FP8"
+schema_version: 1
+sha256: "23d0d5081a0df6ea"
+---
+
+# Documentation: LocalSQLDB Module
+
+## 1. Purpose
+
+This module provides installer custom actions for preparing LocalDB database files during DataPRO installation. It determines whether the application will use a local or centralized database configuration, and if local, copies database files (`.mdf` and `.ldf`) from a previous installation to the new installation directory. This enables database migration during upgrades while preserving existing data.
+
+---
+
+## 2. Public Interface
+
+### `LocalDBPreparation` (Class)
+Entry point class invoked by the installer.
+
+**Method: `Main(string[] args)`**
+- **Signature:** `static void Main(string[] args)`
+- **Behavior:** Parses command-line arguments, creates a `LocalDBPrepare` instance, and invokes `PrepareDB()`. On exception, displays a message box with the error message and rethrows an empty `Exception`.
+
+**Arguments:**
+- `args[0]` — Target installation directory path (`targetDir`)
+- `args[1]` — Product version string (parsed into `Version`)
+
+---
+
+### `LocalDBPrepare` (Class)
+Core logic class for database preparation.
+
+**Constructor: `LocalDBPrepare(string targetDir, Version productVersion)`**
+- Initializes the instance with the target directory and installing version.
+
+**Method: `PrepareDB()`**
+- **Signature:** `public bool PrepareDB()`
+- **Behavior:**
+  1. Loads configuration from the newly installed executable via `GetNewConfig()`
+  2. Determines `DbType` from configuration (defaults to `DbType.Local` on parse failure)
+  3. Returns `false` if `DbType.Centralized`
+  4. Retrieves `dbName` from configuration (defaults to `Settings.Default.DataPRO`)
+  5. Returns `true` if `dbName` matches `Settings.Default.DataPRO` (case-insensitive)
+  6. Otherwise, copies `.mdf` and `.ldf` files from the most recent previous installation to the new location
+