From 258deb93d9d4771fae02bfc778403d20fba08069 Mon Sep 17 00:00:00 2001
From: busya <uglypod@gmail.com>
Date: Sat, 9 Aug 2025 10:07:59 +0300
Subject: [PATCH] docs: Update project specs and align statuses

- Add Timber to technical decisions in tech_spec.txt
- Update feature statuses to 'backend_implemented' in tech_spec.txt
- Update UI component statuses to 'needs_review' in project_structure.txt
---
 .../lens/data/api/mapper/TokenMapper.kt       |  4 +++
 .../lens/data/api/model/LoginRequest.kt       | 29 +++++++++++++++++
 .../repository/EncryptedPreferencesWrapper.kt |  4 +++
 .../lens/data/security/CryptoManager.kt       |  4 +++
 .../lens/domain/model/TokenResponse.kt        |  4 +++
 tech_spec/project_structure.txt               | 32 +++++++++----------
 tech_spec/tech_spec.txt                       | 19 +++++++----
 7 files changed, 74 insertions(+), 22 deletions(-)
 create mode 100644 data/src/main/java/com/homebox/lens/data/api/mapper/TokenMapper.kt
 create mode 100644 data/src/main/java/com/homebox/lens/data/api/model/LoginRequest.kt
 create mode 100644 data/src/main/java/com/homebox/lens/data/repository/EncryptedPreferencesWrapper.kt
 create mode 100644 data/src/main/java/com/homebox/lens/data/security/CryptoManager.kt
 create mode 100644 domain/src/main/java/com/homebox/lens/domain/model/TokenResponse.kt

diff --git a/data/src/main/java/com/homebox/lens/data/api/mapper/TokenMapper.kt b/data/src/main/java/com/homebox/lens/data/api/mapper/TokenMapper.kt
new file mode 100644
index 0000000..6a28cc0
--- /dev/null
+++ b/data/src/main/java/com/homebox/lens/data/api/mapper/TokenMapper.kt
@@ -0,0 +1,4 @@
+package com.homebox.lens.data.api.mapper
+
+class TokenMapper {
+}
\ No newline at end of file
diff --git a/data/src/main/java/com/homebox/lens/data/api/model/LoginRequest.kt b/data/src/main/java/com/homebox/lens/data/api/model/LoginRequest.kt
new file mode 100644
index 0000000..e97ba2f
--- /dev/null
+++ b/data/src/main/java/com/homebox/lens/data/api/model/LoginRequest.kt
@@ -0,0 +1,29 @@
+// [PACKAGE] com.homebox.lens.data.api.model
+// [FILE] LoginRequest.kt
+// [SEMANTICS] dto, network, serialization, authentication
+
+package com.homebox.lens.data.api
+
+import com.squareup.moshi.Json
+import com.squareup.moshi.JsonClass
+
+/**
+ * [ENTITY: DataClass('LoginRequest')]
+ * [CONTRACT]
+ * DTO (Data Transfer Object) для запроса на аутентификацию.
+ * @property username Имя пользователя.
+ * @property password Пароль пользователя.
+ * @invariant Свойства не должны быть пустыми.
+ */
+@JsonClass(generateAdapter = true)
+data class LoginRequest(
+    @Json(name = "username") val username: String,
+    @Json(name = "password") val password: String
+) {
+    init {
+        // [INVARIANT_CHECK]
+        require(username.isNotBlank()) { "[INVARIANT_FAILED] Username cannot be blank." }
+        require(password.isNotBlank()) { "[INVARIANT_FAILED] Password cannot be blank." }
+    }
+}
+// [END_FILE_LoginRequest.kt]
\ No newline at end of file
diff --git a/data/src/main/java/com/homebox/lens/data/repository/EncryptedPreferencesWrapper.kt b/data/src/main/java/com/homebox/lens/data/repository/EncryptedPreferencesWrapper.kt
new file mode 100644
index 0000000..aa7d460
--- /dev/null
+++ b/data/src/main/java/com/homebox/lens/data/repository/EncryptedPreferencesWrapper.kt
@@ -0,0 +1,4 @@
+package com.homebox.lens.data.repository
+
+class EncryptedPreferencesWrapper {
+}
\ No newline at end of file
diff --git a/data/src/main/java/com/homebox/lens/data/security/CryptoManager.kt b/data/src/main/java/com/homebox/lens/data/security/CryptoManager.kt
new file mode 100644
index 0000000..de7b5c9
--- /dev/null
+++ b/data/src/main/java/com/homebox/lens/data/security/CryptoManager.kt
@@ -0,0 +1,4 @@
+package com.homebox.lens.data.security
+
+class CryptoManager {
+}
\ No newline at end of file
diff --git a/domain/src/main/java/com/homebox/lens/domain/model/TokenResponse.kt b/domain/src/main/java/com/homebox/lens/domain/model/TokenResponse.kt
new file mode 100644
index 0000000..80f030c
--- /dev/null
+++ b/domain/src/main/java/com/homebox/lens/domain/model/TokenResponse.kt
@@ -0,0 +1,4 @@
+package com.homebox.lens.domain.model
+
+class TokenResponse {
+}
\ No newline at end of file
diff --git a/tech_spec/project_structure.txt b/tech_spec/project_structure.txt
index 15af92e..fe0154b 100644
--- a/tech_spec/project_structure.txt
+++ b/tech_spec/project_structure.txt
@@ -17,52 +17,52 @@
         <file name="app/src/main/java/com/homebox/lens/navigation/Screen.kt" status="implemented" ref_id="nav_screen">
             <purpose_summary>Defines the routes for all screens in the app as a sealed class.</purpose_summary>
         </file>
-        <file name="app/src/main/java/com/homebox/lens/ui/screen/dashboard/DashboardScreen.kt" status="stub" spec_ref_id="screen_dashboard">
+        <file name="app/src/main/java/com/homebox/lens/ui/screen/dashboard/DashboardScreen.kt" status="needs_review" spec_ref_id="screen_dashboard">
             <purpose_summary>UI for the Dashboard screen.</purpose_summary>
         </file>
-        <file name="app/src/main/java/com/homebox/lens/ui/screen/dashboard/DashboardViewModel.kt" status="stub" spec_ref_id="screen_dashboard">
+        <file name="app/src/main/java/com/homebox/lens/ui/screen/dashboard/DashboardViewModel.kt" status="needs_review" spec_ref_id="screen_dashboard">
             <purpose_summary>ViewModel for the Dashboard screen, handles business logic.</purpose_summary>
         </file>
-        <file name="app/src/main/java/com/homebox/lens/ui/screen/inventorylist/InventoryListScreen.kt" status="stub" spec_ref_id="screen_inventory_list">
+        <file name="app/src/main/java/com/homebox/lens/ui/screen/inventorylist/InventoryListScreen.kt" status="needs_review" spec_ref_id="screen_inventory_list">
             <purpose_summary>UI for the Inventory List screen.</purpose_summary>
         </file>
-        <file name="app/src/main/java/com/homebox/lens/ui/screen/inventorylist/InventoryListViewModel.kt" status="stub" spec_ref_id="screen_inventory_list">
+        <file name="app/src/main/java/com/homebox/lens/ui/screen/inventorylist/InventoryListViewModel.kt" status="needs_review" spec_ref_id="screen_inventory_list">
             <purpose_summary>ViewModel for the Inventory List screen.</purpose_summary>
         </file>
-        <file name="app/src/main/java/com/homebox/lens/ui/screen/itemdetails/ItemDetailsScreen.kt" status="stub" spec_ref_id="screen_item_details">
+        <file name="app/src/main/java/com/homebox/lens/ui/screen/itemdetails/ItemDetailsScreen.kt" status="needs_review" spec_ref_id="screen_item_details">
             <purpose_summary>UI for the Item Details screen.</purpose_summary>
         </file>
-        <file name="app/src/main/java/com/homebox/lens/ui/screen/itemdetails/ItemDetailsViewModel.kt" status="stub" spec_ref_id="screen_item_details">
+        <file name="app/src/main/java/com/homebox/lens/ui/screen/itemdetails/ItemDetailsViewModel.kt" status="needs_review" spec_ref_id="screen_item_details">
             <purpose_summary>ViewModel for the Item Details screen.</purpose_summary>
         </file>
-        <file name="app/src/main/java/com/homebox/lens/ui/screen/itemedit/ItemEditScreen.kt" status="stub" spec_ref_id="screen_item_edit">
+        <file name="app/src/main/java/com/homebox/lens/ui/screen/itemedit/ItemEditScreen.kt" status="needs_review" spec_ref_id="screen_item_edit">
             <purpose_summary>UI for the Item Edit screen.</purpose_summary>
         </file>
-        <file name="app/src/main/java/com/homebox/lens/ui/screen/itemedit/ItemEditViewModel.kt" status="stub" spec_ref_id="screen_item_edit">
+        <file name="app/src/main/java/com/homebox/lens/ui/screen/itemedit/ItemEditViewModel.kt" status="needs_review" spec_ref_id="screen_item_edit">
             <purpose_summary>ViewModel for the Item Edit screen.</purpose_summary>
         </file>
-        <file name="app/src/main/java/com/homebox/lens/ui/screen/labelslist/LabelsListScreen.kt" status="stub" spec_ref_id="screen_labels_list">
+        <file name="app/src/main/java/com/homebox/lens/ui/screen/labelslist/LabelsListScreen.kt" status="needs_review" spec_ref_id="screen_labels_list">
             <purpose_summary>UI for the Labels List screen.</purpose_summary>
         </file>
-        <file name="app/src/main/java/com/homebox/lens/ui/screen/labelslist/LabelsListViewModel.kt" status="stub" spec_ref_id="screen_labels_list">
+        <file name="app/src/main/java/com/homebox/lens/ui/screen/labelslist/LabelsListViewModel.kt" status="needs_review" spec_ref_id="screen_labels_list">
             <purpose_summary>ViewModel for the Labels List screen.</purpose_summary>
         </file>
-        <file name="app/src/main/java/com/homebox/lens/ui/screen/locationslist/LocationsListScreen.kt" status="stub" spec_ref_id="screen_locations_list">
+        <file name="app/src/main/java/com/homebox/lens/ui/screen/locationslist/LocationsListScreen.kt" status="needs_review" spec_ref_id="screen_locations_list">
             <purpose_summary>UI for the Locations List screen.</purpose_summary>
         </file>
-        <file name="app/src/main/java/com/homebox/lens/ui/screen/locationslist/LocationsListViewModel.kt" status="stub" spec_ref_id="screen_locations_list">
+        <file name="app/src/main/java/com/homebox/lens/ui/screen/locationslist/LocationsListViewModel.kt" status="needs_review" spec_ref_id="screen_locations_list">
             <purpose_summary>ViewModel for the Locations List screen.</purpose_summary>
         </file>
-        <file name="app/src/main/java/com/homebox/lens/ui/screen/search/SearchScreen.kt" status="stub" spec_ref_id="screen_search">
+        <file name="app/src/main/java/com/homebox/lens/ui/screen/search/SearchScreen.kt" status="needs_review" spec_ref_id="screen_search">
             <purpose_summary>UI for the Search screen.</purpose_summary>
         </file>
-        <file name="app/src/main/java/com/homebox/lens/ui/screen/search/SearchViewModel.kt" status="stub" spec_ref_id="screen_search">
+        <file name="app/src/main/java/com/homebox/lens/ui/screen/search/SearchViewModel.kt" status="needs_review" spec_ref_id="screen_search">
             <purpose_summary>ViewModel for the Search screen.</purpose_summary>
         </file>
-        <file name="app/src/main/java/com/homebox/lens/ui/screen/setup/SetupScreen.kt" status="stub" spec_ref_id="screen_setup">
+        <file name="app/src/main/java/com/homebox/lens/ui/screen/setup/SetupScreen.kt" status="needs_review" spec_ref_id="screen_setup">
             <purpose_summary>UI for the Setup screen.</purpose_summary>
         </file>
-        <file name="app/src/main/java/com/homebox/lens/ui/screen/setup/SetupViewModel.kt" status="stub" spec_ref_id="screen_setup">
+        <file name="app/src/main/java/com/homebox/lens/ui/screen/setup/SetupViewModel.kt" status="needs_review" spec_ref_id="screen_setup">
             <purpose_summary>ViewModel for the Setup screen.</purpose_summary>
         </file>
         <file name="app/src/main/java/com/homebox/lens/ui/screen/setup/SetupUiState.kt" status="implemented" spec_ref_id="screen_setup">
diff --git a/tech_spec/tech_spec.txt b/tech_spec/tech_spec.txt
index e92b749..c4bde20 100644
--- a/tech_spec/tech_spec.txt
+++ b/tech_spec/tech_spec.txt
@@ -5,8 +5,15 @@
         <description>An Android client for the Homebox inventory management system. It allows users to manage their inventory by interacting with a Homebox server instance.</description>
     </PROJECT_INFO>
 
+    <TECHNICAL_DECISIONS>
+        <DECISION id="tech_logging">
+            <summary>Logging Library</summary>
+            <description>The project uses Timber (timber.log.Timber) for all logging purposes. It provides a simple and extensible API for logging.</description>
+        </DECISION>
+    </TECHNICAL_DECISIONS>
+
     <FEATURES>
-        <FEATURE id="feat_dashboard" status="in_progress">
+        <FEATURE id="feat_dashboard" status="backend_implemented">
             <summary>Dashboard Screen</summary>
             <description>Displays a summary of the inventory, including statistics like total items, total value, and counts by location/label.</description>
             <UI_COMPONENT ref_id="screen_dashboard" />
@@ -19,7 +26,7 @@
             </FUNCTIONALITY>
         </FEATURE>
 
-        <FEATURE id="feat_inventory_list" status="in_progress">
+        <FEATURE id="feat_inventory_list" status="backend_implemented">
             <summary>Inventory List Screen</summary>
             <description>Displays a searchable and filterable list of all inventory items.</description>
             <UI_COMPONENT ref_id="screen_inventory_list" />
@@ -37,7 +44,7 @@
             </FUNCTIONALITY>
         </FEATURE>
 
-        <FEATURE id="feat_item_details" status="in_progress">
+        <FEATURE id="feat_item_details" status="backend_implemented">
             <summary>Item Details Screen</summary>
             <description>Shows all details for a single inventory item, including its name, description, images, attachments, and custom fields.</description>
             <UI_COMPONENT ref_id="screen_item_details" />
@@ -50,7 +57,7 @@
             </FUNCTIONALITY>
         </FEATURE>
 
-        <FEATURE id="feat_item_management" status="in_progress">
+        <FEATURE id="feat_item_management" status="backend_implemented">
             <summary>Create/Edit/Delete Items</summary>
             <description>Allows users to create new items, update existing ones, and delete them.</description>
             <UI_COMPONENT ref_id="screen_item_edit" />
@@ -73,7 +80,7 @@
             </FUNCTIONALITY>
         </FEATURE>
 
-        <FEATURE id="feat_labels_locations" status="in_progress">
+        <FEATURE id="feat_labels_locations" status="backend_implemented">
             <summary>Manage Labels and Locations</summary>
             <description>Allows users to view lists of all available labels and locations.</description>
             <UI_COMPONENT ref_id="screen_labels_list" />
@@ -92,7 +99,7 @@
             </FUNCTIONALITY>
         </FEATURE>
 
-        <FEATURE id="feat_search" status="in_progress">
+        <FEATURE id="feat_search" status="backend_implemented">
             <summary>Search Screen</summary>
             <description>Provides a dedicated UI for searching items.</description>
             <UI_COMPONENT ref_id="screen_search" />