docs: implement repository-wide README documentation

README.md

@@ -8,25 +8,20 @@ Delivering luxury-tier architectural components and high-performance logic for t
 ## 🏗️ Architecture
 ```mermaid
 graph TD
-  Root["📁 Mavluda Beauty Repository"]
-  Root --> backend["📁 backend"]
-  Root --> frontend["📁 frontend"]
-  Root --> scripts["📁 scripts"]
-  Root --> _env["📄 .env"]
-  Root --> _gitignore["📄 .gitignore"]
-  Root --> _gitignore_append["📄 .gitignore_append"]
-  Root --> GEMINI_md["📄 GEMINI.md"]
-  Root --> generate_readmes_py["📄 generate_readmes.py"]
+  Root_Mavluda_Beauty_Repository["📁 Mavluda Beauty Repository"]
+  Root_Mavluda_Beauty_Repository --> d_backend["📁 backend"]
+  Root_Mavluda_Beauty_Repository --> d_frontend["📁 frontend"]
+  Root_Mavluda_Beauty_Repository --> f__gitignore["📄 .gitignore"]
+  Root_Mavluda_Beauty_Repository --> f_GEMINI_md["📄 GEMINI.md"]
+  Root_Mavluda_Beauty_Repository --> f_SECURITY_md["📄 SECURITY.md"]
 ```
 
 ## 📄 File Registry
 | File Name | Type | Responsibility | Key Aliases Used |
 |---|---|---|---|
-| `.env` | File | Provides core logic and orchestration for .env. | N/A |
 | `.gitignore` | File | Provides core logic and orchestration for .gitignore. | N/A |
-| `.gitignore_append` | File | Provides core logic and utilities for this domain. | N/A |
 | `GEMINI.md` | Markdown | Provides core logic and orchestration for GEMINI.md. | N/A |
-| `generate_readmes.py` | File | Provides core logic and orchestration for generate_readmes.py. | N/A |
+| `SECURITY.md` | Markdown | Documentation for SECURITY.md | N/A |
 
 ## 🔗 Dependencies
 - No external dependencies.

backend/README.md

@@ -1,4 +1,4 @@
-# 📁 backend
+# ⚙️ backend
 
 [Root](/.) > [backend](/backend)
 
@@ -8,16 +8,16 @@ Delivering luxury-tier architectural components and high-performance logic for t
 ## 🏗️ Architecture
 ```mermaid
 graph TD
-  Root["📁 backend"]
-  Root --> src["📁 src"]
-  Root --> test["📁 test"]
-  Root --> _prettierrc["📄 .prettierrc"]
-  Root --> eslint_config_mjs["📄 eslint.config.mjs"]
-  Root --> nest_cli_json["📄 nest-cli.json"]
-  Root --> package_lock_json["📄 package-lock.json"]
-  Root --> package_json["📄 package.json"]
-  Root --> tsconfig_build_json["📄 tsconfig.build.json"]
-  Root --> tsconfig_json["📄 tsconfig.json"]
+  Root_backend["📁 backend"]
+  Root_backend --> d_src["📁 src"]
+  Root_backend --> d_test["📁 test"]
+  Root_backend --> f__prettierrc["📄 .prettierrc"]
+  Root_backend --> f_eslint_config_mjs["📄 eslint.config.mjs"]
+  Root_backend --> f_nest_cli_json["📄 nest-cli.json"]
+  Root_backend --> f_package_lock_json["📄 package-lock.json"]
+  Root_backend --> f_package_json["📄 package.json"]
+  Root_backend --> f_tsconfig_build_json["📄 tsconfig.build.json"]
+  Root_backend --> f_tsconfig_json["📄 tsconfig.json"]
 ```
 
 ## 📄 File Registry

backend/src/README.md

@@ -1,4 +1,4 @@
-# 📁 src
+# 💻 src
 
 [Root](/.) > [backend](/backend) > [src](/backend/src)
 
@@ -8,14 +8,14 @@ Delivering luxury-tier architectural components and high-performance logic for t
 ## 🏗️ Architecture
 ```mermaid
 graph TD
-  Root["📁 src"]
-  Root --> common["📁 common"]
-  Root --> modules["📁 modules"]
-  Root --> app_controller_spec_ts["📄 app.controller.spec.ts"]
-  Root --> app_controller_ts["📄 app.controller.ts"]
-  Root --> app_module_ts["📄 app.module.ts"]
-  Root --> app_service_ts["📄 app.service.ts"]
-  Root --> main_ts["📄 main.ts"]
+  Root_src["📁 src"]
+  Root_src --> d_common["📁 common"]
+  Root_src --> d_modules["📁 modules"]
+  Root_src --> f_app_controller_spec_ts["📄 app.controller.spec.ts"]
+  Root_src --> f_app_controller_ts["📄 app.controller.ts"]
+  Root_src --> f_app_module_ts["📄 app.module.ts"]
+  Root_src --> f_app_service_ts["📄 app.service.ts"]
+  Root_src --> f_main_ts["📄 main.ts"]
 ```
 
 ## 📄 File Registry

backend/src/common/README.md

@@ -8,19 +8,21 @@ Delivering luxury-tier architectural components and high-performance logic for t
 ## 🏗️ Architecture
 ```mermaid
 graph TD
-  Root["📁 common"]
-  Root --> config["📁 config"]
-  Root --> constants["📁 constants"]
-  Root --> database["📁 database"]
-  Root --> decorators["📁 decorators"]
-  Root --> filters["📁 filters"]
-  Root --> guards["📁 guards"]
-  Root --> interfaces["📁 interfaces"]
-  Root --> utils["📁 utils"]
+  Root_common["📁 common"]
+  Root_common --> d_config["📁 config"]
+  Root_common --> d_constants["📁 constants"]
+  Root_common --> d_database["📁 database"]
+  Root_common --> d_decorators["📁 decorators"]
+  Root_common --> d_filters["📁 filters"]
+  Root_common --> d_guards["📁 guards"]
+  Root_common --> d_interfaces["📁 interfaces"]
+  Root_common --> d_utils["📁 utils"]
 ```
 
 ## 📄 File Registry
-*No relevant files in this directory.*
+| File Name | Type | Responsibility | Key Aliases Used |
+|---|---|---|---|
+| No files | - | - | - |
 
 ## 🔗 Dependencies
 - No external dependencies.

backend/src/common/config/README.md

@@ -1,4 +1,4 @@
-# 📁 config
+# ⚙️ config
 
 [Root](/.) > [backend](/backend) > [src](/backend/src) > [common](/backend/src/common) > [config](/backend/src/common/config)
 
@@ -8,11 +8,11 @@ Delivering luxury-tier architectural components and high-performance logic for t
 ## 🏗️ Architecture
 ```mermaid
 graph TD
-  Root["📁 config"]
-  Root --> app_config_module_ts["📄 app-config.module.ts"]
-  Root --> app_config_service_ts["📄 app-config.service.ts"]
-  Root --> configuration_ts["📄 configuration.ts"]
-  Root --> env_validation_ts["📄 env.validation.ts"]
+  Root_config["📁 config"]
+  Root_config --> f_app_config_module_ts["📄 app-config.module.ts"]
+  Root_config --> f_app_config_service_ts["📄 app-config.service.ts"]
+  Root_config --> f_configuration_ts["📄 configuration.ts"]
+  Root_config --> f_env_validation_ts["📄 env.validation.ts"]
 ```
 
 ## 📄 File Registry

backend/src/common/constants/README.md

@@ -8,8 +8,8 @@ Delivering luxury-tier architectural components and high-performance logic for t
 ## 🏗️ Architecture
 ```mermaid
 graph TD
-  Root["📁 constants"]
-  Root --> error_messages_constant_ts["📄 error-messages.constant.ts"]
+  Root_constants["📁 constants"]
+  Root_constants --> f_error_messages_constant_ts["📄 error-messages.constant.ts"]
 ```
 
 ## 📄 File Registry

backend/src/common/database/README.md

@@ -8,8 +8,8 @@ Delivering luxury-tier architectural components and high-performance logic for t
 ## 🏗️ Architecture
 ```mermaid
 graph TD
-  Root["📁 database"]
-  Root --> database_module_ts["📄 database.module.ts"]
+  Root_database["📁 database"]
+  Root_database --> f_database_module_ts["📄 database.module.ts"]
 ```
 
 ## 📄 File Registry

backend/src/common/decorators/README.md

@@ -8,9 +8,9 @@ Delivering luxury-tier architectural components and high-performance logic for t
 ## 🏗️ Architecture
 ```mermaid
 graph TD
-  Root["📁 decorators"]
-  Root --> public_decorator_ts["📄 public.decorator.ts"]
-  Root --> roles_decorator_ts["📄 roles.decorator.ts"]
+  Root_decorators["📁 decorators"]
+  Root_decorators --> f_public_decorator_ts["📄 public.decorator.ts"]
+  Root_decorators --> f_roles_decorator_ts["📄 roles.decorator.ts"]
 ```
 
 ## 📄 File Registry

backend/src/common/filters/README.md

@@ -8,8 +8,8 @@ Delivering luxury-tier architectural components and high-performance logic for t
 ## 🏗️ Architecture
 ```mermaid
 graph TD
-  Root["📁 filters"]
-  Root --> i18n_exception_filter_ts["📄 i18n-exception.filter.ts"]
+  Root_filters["📁 filters"]
+  Root_filters --> f_i18n_exception_filter_ts["📄 i18n-exception.filter.ts"]
 ```
 
 ## 📄 File Registry

backend/src/common/guards/README.md

@@ -8,9 +8,9 @@ Delivering luxury-tier architectural components and high-performance logic for t
 ## 🏗️ Architecture
 ```mermaid
 graph TD
-  Root["📁 guards"]
-  Root --> jwt_auth_guard_ts["📄 jwt-auth.guard.ts"]
-  Root --> roles_guard_ts["📄 roles.guard.ts"]
+  Root_guards["📁 guards"]
+  Root_guards --> f_jwt_auth_guard_ts["📄 jwt-auth.guard.ts"]
+  Root_guards --> f_roles_guard_ts["📄 roles.guard.ts"]
 ```
 
 ## 📄 File Registry

backend/src/common/interfaces/README.md

@@ -8,8 +8,8 @@ Delivering luxury-tier architectural components and high-performance logic for t
 ## 🏗️ Architecture
 ```mermaid
 graph TD
-  Root["📁 interfaces"]
-  Root --> authenticated_request_interface_ts["📄 authenticated-request.interface.ts"]
+  Root_interfaces["📁 interfaces"]
+  Root_interfaces --> f_authenticated_request_interface_ts["📄 authenticated-request.interface.ts"]
 ```
 
 ## 📄 File Registry

backend/src/common/utils/README.md

@@ -1,4 +1,4 @@
-# 📁 utils
+# 🧰 utils
 
 [Root](/.) > [backend](/backend) > [src](/backend/src) > [common](/backend/src/common) > [utils](/backend/src/common/utils)
 
@@ -8,10 +8,10 @@ Delivering luxury-tier architectural components and high-performance logic for t
 ## 🏗️ Architecture
 ```mermaid
 graph TD
-  Root["📁 utils"]
-  Root --> file_system_ts["📄 file-system.ts"]
-  Root --> index_ts["📄 index.ts"]
-  Root --> object_ts["📄 object.ts"]
+  Root_utils["📁 utils"]
+  Root_utils --> f_file_system_ts["📄 file-system.ts"]
+  Root_utils --> f_index_ts["📄 index.ts"]
+  Root_utils --> f_object_ts["📄 object.ts"]
 ```
 
 ## 📄 File Registry

backend/src/modules/README.md

@@ -1,4 +1,4 @@
-# 📁 modules
+# 📦 modules
 
 [Root](/.) > [backend](/backend) > [src](/backend/src) > [modules](/backend/src/modules)
 
@@ -8,21 +8,23 @@ Delivering luxury-tier architectural components and high-performance logic for t
 ## 🏗️ Architecture
 ```mermaid
 graph TD
-  Root["📁 modules"]
-  Root --> admin-settings["📁 admin-settings"]
-  Root --> auth["📁 auth"]
-  Root --> booking["📁 booking"]
-  Root --> gallery["📁 gallery"]
-  Root --> inventory["📁 inventory"]
-  Root --> partnership["📁 partnership"]
-  Root --> payment["📁 payment"]
-  Root --> treatments["📁 treatments"]
-  Root --> user["📁 user"]
-  Root --> veil["📁 veil"]
+  Root_modules["📁 modules"]
+  Root_modules --> d_admin_settings["📁 admin-settings"]
+  Root_modules --> d_auth["📁 auth"]
+  Root_modules --> d_booking["📁 booking"]
+  Root_modules --> d_gallery["📁 gallery"]
+  Root_modules --> d_inventory["📁 inventory"]
+  Root_modules --> d_partnership["📁 partnership"]
+  Root_modules --> d_payment["📁 payment"]
+  Root_modules --> d_treatments["📁 treatments"]
+  Root_modules --> d_user["📁 user"]
+  Root_modules --> d_veil["📁 veil"]
 ```
 
 ## 📄 File Registry
-*No relevant files in this directory.*
+| File Name | Type | Responsibility | Key Aliases Used |
+|---|---|---|---|
+| No files | - | - | - |
 
 ## 🔗 Dependencies
 - No external dependencies.

backend/src/modules/admin-settings/README.md

@@ -8,13 +8,13 @@ Delivering luxury-tier architectural components and high-performance logic for t
 ## 🏗️ Architecture
 ```mermaid
 graph TD
-  Root["📁 admin-settings"]
-  Root --> application["📁 application"]
-  Root --> domain["📁 domain"]
-  Root --> infrastructure["📁 infrastructure"]
-  Root --> presentation["📁 presentation"]
-  Root --> admin_settings_module_ts["📄 admin-settings.module.ts"]
-  Root --> index_ts["📄 index.ts"]
+  Root_admin_settings["📁 admin-settings"]
+  Root_admin_settings --> d_application["📁 application"]
+  Root_admin_settings --> d_domain["📁 domain"]
+  Root_admin_settings --> d_infrastructure["📁 infrastructure"]
+  Root_admin_settings --> d_presentation["📁 presentation"]
+  Root_admin_settings --> f_admin_settings_module_ts["📄 admin-settings.module.ts"]
+  Root_admin_settings --> f_index_ts["📄 index.ts"]
 ```
 
 ## 📄 File Registry

backend/src/modules/admin-settings/application/README.md

@@ -1,4 +1,4 @@
-# 📁 application
+# 📱 application
 
 [Root](/.) > [backend](/backend) > [src](/backend/src) > [modules](/backend/src/modules) > [admin-settings](/backend/src/modules/admin-settings) > [application](/backend/src/modules/admin-settings/application)
 
@@ -8,8 +8,8 @@ Delivering luxury-tier architectural components and high-performance logic for t
 ## 🏗️ Architecture
 ```mermaid
 graph TD
-  Root["📁 application"]
-  Root --> admin_settings_service_ts["📄 admin-settings.service.ts"]
+  Root_application["📁 application"]
+  Root_application --> f_admin_settings_service_ts["📄 admin-settings.service.ts"]
 ```
 
 ## 📄 File Registry

backend/src/modules/admin-settings/domain/README.md

@@ -1,4 +1,4 @@
-# 📁 domain
+# 🎯 domain
 
 [Root](/.) > [backend](/backend) > [src](/backend/src) > [modules](/backend/src/modules) > [admin-settings](/backend/src/modules/admin-settings) > [domain](/backend/src/modules/admin-settings/domain)
 
@@ -8,9 +8,9 @@ Delivering luxury-tier architectural components and high-performance logic for t
 ## 🏗️ Architecture
 ```mermaid
 graph TD
-  Root["📁 domain"]
-  Root --> interfaces["📁 interfaces"]
-  Root --> admin_settings_entity_ts["📄 admin-settings.entity.ts"]
+  Root_domain["📁 domain"]
+  Root_domain --> d_interfaces["📁 interfaces"]
+  Root_domain --> f_admin_settings_entity_ts["📄 admin-settings.entity.ts"]
 ```
 
 ## 📄 File Registry

backend/src/modules/admin-settings/domain/interfaces/README.md

@@ -8,8 +8,8 @@ Delivering luxury-tier architectural components and high-performance logic for t
 ## 🏗️ Architecture
 ```mermaid
 graph TD
-  Root["📁 interfaces"]
-  Root --> admin_settings_interface_ts["📄 admin-settings.interface.ts"]
+  Root_interfaces["📁 interfaces"]
+  Root_interfaces --> f_admin_settings_interface_ts["📄 admin-settings.interface.ts"]
 ```
 
 ## 📄 File Registry

backend/src/modules/admin-settings/infrastructure/README.md

@@ -1,4 +1,4 @@
-# 📁 infrastructure
+# 🏗️ infrastructure
 
 [Root](/.) > [backend](/backend) > [src](/backend/src) > [modules](/backend/src/modules) > [admin-settings](/backend/src/modules/admin-settings) > [infrastructure](/backend/src/modules/admin-settings/infrastructure)
 
@@ -8,13 +8,15 @@ Delivering luxury-tier architectural components and high-performance logic for t
 ## 🏗️ Architecture
 ```mermaid
 graph TD
-  Root["📁 infrastructure"]
-  Root --> repositories["📁 repositories"]
-  Root --> schemas["📁 schemas"]
+  Root_infrastructure["📁 infrastructure"]
+  Root_infrastructure --> d_repositories["📁 repositories"]
+  Root_infrastructure --> d_schemas["📁 schemas"]
 ```
 
 ## 📄 File Registry
-*No relevant files in this directory.*
+| File Name | Type | Responsibility | Key Aliases Used |
+|---|---|---|---|
+| No files | - | - | - |
 
 ## 🔗 Dependencies
 - No external dependencies.

backend/src/modules/admin-settings/infrastructure/repositories/README.md

@@ -8,8 +8,8 @@ Delivering luxury-tier architectural components and high-performance logic for t
 ## 🏗️ Architecture
 ```mermaid
 graph TD
-  Root["📁 repositories"]
-  Root --> admin_settings_repository_ts["📄 admin-settings.repository.ts"]
+  Root_repositories["📁 repositories"]
+  Root_repositories --> f_admin_settings_repository_ts["📄 admin-settings.repository.ts"]
 ```
 
 ## 📄 File Registry

backend/src/modules/admin-settings/infrastructure/schemas/README.md

@@ -8,8 +8,8 @@ Delivering luxury-tier architectural components and high-performance logic for t
 ## 🏗️ Architecture
 ```mermaid
 graph TD
-  Root["📁 schemas"]
-  Root --> admin_settings_schema_ts["📄 admin-settings.schema.ts"]
+  Root_schemas["📁 schemas"]
+  Root_schemas --> f_admin_settings_schema_ts["📄 admin-settings.schema.ts"]
 ```
 
 ## 📄 File Registry