docs: generate localized readmes for architectural transparency

README.md

@@ -1,16 +1,20 @@
-# 👑 Mavluda Beauty Root
+# 📁 Mavluda_Beauty_Root
 
 [Root](/.)
 
 ## 🎯 Purpose
-Delivering luxury-tier architectural components and high-performance logic for the **Mavluda Beauty Root** domain. This directory is a crucial part of the Mavluda Beauty full-stack ecosystem, ensuring seamless scalability, robust performance, and an elite digital experience.
+Delivering luxury-tier architectural components and high-performance logic for the **Mavluda_Beauty_Root** domain. This directory is a crucial part of the Mavluda Beauty full-stack ecosystem, ensuring seamless scalability, robust performance, and an elite digital experience.
 
 ## 🏗️ Architecture
 ```mermaid
 graph TD
-  Mavluda_Beauty_Root["👑 Mavluda Beauty Root"]
-  Mavluda_Beauty_Root --> backend["📁 backend"]
-  Mavluda_Beauty_Root --> frontend["📁 frontend"]
+  Mavluda_Beauty_Root["📁 Mavluda_Beauty_Root"]
+  Mavluda_Beauty_Root --> Mavluda_Beauty_Root_backend["📁 backend"]
+  Mavluda_Beauty_Root --> Mavluda_Beauty_Root_frontend["📁 frontend"]
+  Mavluda_Beauty_Root --> Mavluda_Beauty_Root__env["📄 .env"]
+  Mavluda_Beauty_Root --> Mavluda_Beauty_Root__gitignore["📄 .gitignore"]
+  Mavluda_Beauty_Root --> Mavluda_Beauty_Root__gitignore_append["📄 .gitignore_append"]
+  Mavluda_Beauty_Root --> Mavluda_Beauty_Root_GEMINI_md["📄 GEMINI.md"]
 ```
 
 ## 📄 File Registry
@@ -19,8 +23,8 @@ graph TD
 | `.env` | File | Core logic and utilities for this domain. | N/A |
 | `.gitignore` | File | Core logic and utilities for this domain. | N/A |
 | `.gitignore_append` | File | Core logic and utilities for this domain. | N/A |
-| `GEMINI.md` | Documentation | Core logic and utilities for this domain. | N/A |
-| `generate_readmes.js` | JavaScript | Core logic and utilities for this domain. | N/A |
+| `GEMINI.md` | Markdown | Core logic and utilities for this domain. | N/A |
+
 
 ## 🔗 Dependencies
 *No internal path aliases detected in this directory.*

backend/README.md

@@ -1,31 +1,40 @@
-# ⚙️ backend
+# ⚙️ Backend
 
-[Root](/.) / [backend](.)
+[Root](../) > [backend](./)
 
 ## 🎯 Purpose
-Delivering luxury-tier architectural components and high-performance logic for the **backend** domain. This directory orchestrates precise operations within the Mavluda Beauty ecosystem, maintaining our elite standards of digital excellence.
+Delivering luxury-tier architectural components and high-performance logic for the **Backend** domain. This directory is a crucial part of the Mavluda Beauty full-stack ecosystem, ensuring seamless scalability, robust performance, and an elite digital experience.
+
+**Architecture Layer:** Backend Infrastructure (Feature Sliced Design / Layered Architecture)
 
 ## 🏗️ Architecture
 ```mermaid
 graph TD
   backend["⚙️ backend"]
-  backend --> src["📁 src"]
-  backend --> test["📁 test"]
+  backend --> backend_src["📁 src"]
+  backend --> backend_test["📁 test"]
+  backend --> backend__prettierrc["📄 .prettierrc"]
+  backend --> backend_eslint_config_mjs["📄 eslint.config.mjs"]
+  backend --> backend_nest_cli_json["📄 nest-cli.json"]
+  backend --> backend_package_lock_json["📄 package-lock.json"]
+  backend --> backend_package_json["📄 package.json"]
+  backend --> backend_more_files["...and 2 more files"]
 ```
 
 ## 📄 File Registry
 | File Name | Type | Responsibility | Key Aliases Used |
 |---|---|---|---|
 | `.prettierrc` | File | Core logic and utilities for this domain. | N/A |
-| `eslint.config.mjs` | JavaScript | Core logic and utilities for this domain. | N/A |
-| `nest-cli.json` | Configuration | Configuration and environment settings. | N/A |
-| `package-lock.json` | Configuration | Configuration and environment settings. | N/A |
-| `package.json` | Configuration | Configuration and environment settings. | N/A |
-| `tsconfig.build.json` | Configuration | Configuration and environment settings. | N/A |
-| `tsconfig.json` | Configuration | Configuration and environment settings. | N/A |
+| `eslint.config.mjs` | File | Core logic and utilities for this domain. | @eslint/js |
+| `nest-cli.json` | JSON Config | Core logic and utilities for this domain. | N/A |
+| `package-lock.json` | JSON Config | Core logic and utilities for this domain. | N/A |
+| `package.json` | JSON Config | Core logic and utilities for this domain. | N/A |
+| `tsconfig.build.json` | JSON Config | Core logic and utilities for this domain. | N/A |
+| `tsconfig.json` | JSON Config | Core logic and utilities for this domain. | N/A |
+
 
 ## 🔗 Dependencies
-*No internal path aliases detected in this directory.*
+- `@eslint/js`
 
 ## 🛠️ Usage
 ```markdown

backend/src/README.md

@@ -1,30 +1,51 @@
-# 📁 src
+# 💻 Src
 
-[Root](/.) / [backend](..) / [src](.)
+[Root](../../) > [backend](../) > [src](./)
 
 ## 🎯 Purpose
-Delivering luxury-tier architectural components and high-performance logic for the **src** domain. This directory orchestrates precise operations within the Mavluda Beauty ecosystem, maintaining our elite standards of digital excellence.
+Delivering luxury-tier architectural components and high-performance logic for the **Src** domain. This directory is a crucial part of the Mavluda Beauty full-stack ecosystem, ensuring seamless scalability, robust performance, and an elite digital experience.
+
+**Architecture Layer:** Backend Infrastructure (Feature Sliced Design / Layered Architecture)
 
 ## 🏗️ Architecture
 ```mermaid
 graph TD
-  src["📁 src"]
-  src --> common["📁 common"]
-  src --> modules["📁 modules"]
+  src["💻 src"]
+  src --> src_common["📁 common"]
+  src --> src_modules["📁 modules"]
+  src --> src_app_controller_spec_ts["📄 app.controller.spec.ts"]
+  src --> src_app_controller_ts["📄 app.controller.ts"]
+  src --> src_app_module_ts["📄 app.module.ts"]
+  src --> src_app_service_ts["📄 app.service.ts"]
+  src --> src_main_ts["📄 main.ts"]
 ```
 
 ## 📄 File Registry
 | File Name | Type | Responsibility | Key Aliases Used |
 |---|---|---|---|
-| `app.controller.spec.ts` | TypeScript | Testing and quality assurance validation. | @nestjs |
-| `app.controller.ts` | TypeScript | API routing and request handling. | @nestjs |
-| `app.module.ts` | TypeScript | Dependency injection and module orchestration. | @nestjs, @modules |
-| `app.service.ts` | TypeScript | Business logic execution and state management. | @nestjs |
-| `main.ts` | TypeScript | Core logic and utilities for this domain. | @nestjs |
+| `app.controller.spec.ts` | TypeScript | Core logic and utilities for this domain. | @nestjs/testing |
+| `app.controller.ts` | TypeScript | Core logic and utilities for this domain. | @nestjs/common |
+| `app.module.ts` | TypeScript | Core logic and utilities for this domain. | @modules/auth, @modules/payment, @modules/booking, @modules/admin-settings, @modules/veil, @nestjs/common, @modules/inventory, @modules/user, @nestjs/serve-static, @modules/partnership, @modules/treatments, @modules/gallery |
+| `app.service.ts` | TypeScript | Core logic and utilities for this domain. | @nestjs/common |
+| `main.ts` | TypeScript | Core logic and utilities for this domain. | @nestjs/config, @nestjs/core, @nestjs/common |
+
 
 ## 🔗 Dependencies
-- `@nestjs`
-- `@modules`
+- `@modules/admin-settings`
+- `@modules/auth`
+- `@modules/booking`
+- `@modules/gallery`
+- `@modules/inventory`
+- `@modules/partnership`
+- `@modules/payment`
+- `@modules/treatments`
+- `@modules/user`
+- `@modules/veil`
+- `@nestjs/common`
+- `@nestjs/config`
+- `@nestjs/core`
+- `@nestjs/serve-static`
+- `@nestjs/testing`
 
 ## 🛠️ Usage
 ```markdown

backend/src/common/README.md

@@ -1,28 +1,29 @@
-# 📁 common
+# 📁 Common
 
-[Root](/.) / [backend](../..) / [src](..) / [common](.)
+[Root](../../../) > [backend](../../) > [src](../) > [common](./)
 
 ## 🎯 Purpose
-Delivering luxury-tier architectural components and high-performance logic for the **common** domain. This directory orchestrates precise operations within the Mavluda Beauty ecosystem, maintaining our elite standards of digital excellence.
+Delivering luxury-tier architectural components and high-performance logic for the **Common** domain. This directory is a crucial part of the Mavluda Beauty full-stack ecosystem, ensuring seamless scalability, robust performance, and an elite digital experience.
+
+**Architecture Layer:** Backend Infrastructure (Feature Sliced Design / Layered Architecture)
 
 ## 🏗️ Architecture
 ```mermaid
 graph TD
   common["📁 common"]
-  common --> config["📁 config"]
-  common --> constants["📁 constants"]
-  common --> database["📁 database"]
-  common --> decorators["📁 decorators"]
-  common --> filters["📁 filters"]
-  common --> guards["📁 guards"]
-  common --> interfaces["📁 interfaces"]
-  common --> utils["📁 utils"]
+  common --> common_config["📁 config"]
+  common --> common_constants["📁 constants"]
+  common --> common_database["📁 database"]
+  common --> common_decorators["📁 decorators"]
+  common --> common_filters["📁 filters"]
+  common --> common_guards["📁 guards"]
+  common --> common_interfaces["📁 interfaces"]
+  common --> common_utils["📁 utils"]
 ```
 
 ## 📄 File Registry
-| File Name | Type | Responsibility | Key Aliases Used |
-|---|---|---|---|
-| *No files* | - | - | - |
+*No files directly in this directory.*
+
 
 ## 🔗 Dependencies
 *No internal path aliases detected in this directory.*

backend/src/common/config/README.md

@@ -1,26 +1,34 @@
-# 📁 config
+# 🔧 Config
 
-[Root](/.) / [backend](../../..) / [src](../..) / [common](..) / [config](.)
+[Root](../../../../) > [backend](../../../) > [src](../../) > [common](../) > [config](./)
 
 ## 🎯 Purpose
-Delivering luxury-tier architectural components and high-performance logic for the **config** domain. This directory orchestrates precise operations within the Mavluda Beauty ecosystem, maintaining our elite standards of digital excellence.
+Delivering luxury-tier architectural components and high-performance logic for the **Config** domain. This directory is a crucial part of the Mavluda Beauty full-stack ecosystem, ensuring seamless scalability, robust performance, and an elite digital experience.
+
+**Architecture Layer:** Backend Infrastructure (Feature Sliced Design / Layered Architecture)
 
 ## 🏗️ Architecture
 ```mermaid
 graph TD
-  config["📁 config"]
+  config["🔧 config"]
+  config --> config_app_config_module_ts["📄 app-config.module.ts"]
+  config --> config_app_config_service_ts["📄 app-config.service.ts"]
+  config --> config_configuration_ts["📄 configuration.ts"]
+  config --> config_env_validation_ts["📄 env.validation.ts"]
 ```
 
 ## 📄 File Registry
 | File Name | Type | Responsibility | Key Aliases Used |
 |---|---|---|---|
-| `app-config.module.ts` | TypeScript | Dependency injection and module orchestration. | @nestjs |
-| `app-config.service.ts` | TypeScript | Business logic execution and state management. | @nestjs |
+| `app-config.module.ts` | TypeScript | Core logic and utilities for this domain. | @nestjs/config, @nestjs/common |
+| `app-config.service.ts` | TypeScript | Core logic and utilities for this domain. | @nestjs/config, @nestjs/common |
 | `configuration.ts` | TypeScript | Core logic and utilities for this domain. | N/A |
 | `env.validation.ts` | TypeScript | Core logic and utilities for this domain. | N/A |
 
+
 ## 🔗 Dependencies
-- `@nestjs`
+- `@nestjs/common`
+- `@nestjs/config`
 
 ## 🛠️ Usage
 ```markdown

backend/src/common/constants/README.md

@@ -1,21 +1,25 @@
-# 📁 constants
+# 📁 Constants
 
-[Root](/.) / [backend](../../..) / [src](../..) / [common](..) / [constants](.)
+[Root](../../../../) > [backend](../../../) > [src](../../) > [common](../) > [constants](./)
 
 ## 🎯 Purpose
-Delivering luxury-tier architectural components and high-performance logic for the **constants** domain. This directory orchestrates precise operations within the Mavluda Beauty ecosystem, maintaining our elite standards of digital excellence.
+Delivering luxury-tier architectural components and high-performance logic for the **Constants** domain. This directory is a crucial part of the Mavluda Beauty full-stack ecosystem, ensuring seamless scalability, robust performance, and an elite digital experience.
+
+**Architecture Layer:** Backend Infrastructure (Feature Sliced Design / Layered Architecture)
 
 ## 🏗️ Architecture
 ```mermaid
 graph TD
   constants["📁 constants"]
+  constants --> constants_error_messages_constant_ts["📄 error-messages.constant.ts"]
 ```
 
 ## 📄 File Registry
 | File Name | Type | Responsibility | Key Aliases Used |
 |---|---|---|---|
 | `error-messages.constant.ts` | TypeScript | Core logic and utilities for this domain. | N/A |
 
+
 ## 🔗 Dependencies
 *No internal path aliases detected in this directory.*
 

backend/src/common/database/README.md

@@ -1,23 +1,29 @@
-# 📁 database
+# 📁 Database
 
-[Root](/.) / [backend](../../..) / [src](../..) / [common](..) / [database](.)
+[Root](../../../../) > [backend](../../../) > [src](../../) > [common](../) > [database](./)
 
 ## 🎯 Purpose
-Delivering luxury-tier architectural components and high-performance logic for the **database** domain. This directory orchestrates precise operations within the Mavluda Beauty ecosystem, maintaining our elite standards of digital excellence.
+Delivering luxury-tier architectural components and high-performance logic for the **Database** domain. This directory is a crucial part of the Mavluda Beauty full-stack ecosystem, ensuring seamless scalability, robust performance, and an elite digital experience.
+
+**Architecture Layer:** Backend Infrastructure (Feature Sliced Design / Layered Architecture)
 
 ## 🏗️ Architecture
 ```mermaid
 graph TD
   database["📁 database"]
+  database --> database_database_module_ts["📄 database.module.ts"]
 ```
 
 ## 📄 File Registry
 | File Name | Type | Responsibility | Key Aliases Used |
 |---|---|---|---|
-| `database.module.ts` | TypeScript | Dependency injection and module orchestration. | @nestjs |
+| `database.module.ts` | TypeScript | Core logic and utilities for this domain. | @nestjs/config, @nestjs/common, @nestjs/mongoose |
+
 
 ## 🔗 Dependencies
-- `@nestjs`
+- `@nestjs/common`
+- `@nestjs/config`
+- `@nestjs/mongoose`
 
 ## 🛠️ Usage
 ```markdown

backend/src/common/decorators/README.md

@@ -1,24 +1,29 @@
-# 📁 decorators
+# 📁 Decorators
 
-[Root](/.) / [backend](../../..) / [src](../..) / [common](..) / [decorators](.)
+[Root](../../../../) > [backend](../../../) > [src](../../) > [common](../) > [decorators](./)
 
 ## 🎯 Purpose
-Delivering luxury-tier architectural components and high-performance logic for the **decorators** domain. This directory orchestrates precise operations within the Mavluda Beauty ecosystem, maintaining our elite standards of digital excellence.
+Delivering luxury-tier architectural components and high-performance logic for the **Decorators** domain. This directory is a crucial part of the Mavluda Beauty full-stack ecosystem, ensuring seamless scalability, robust performance, and an elite digital experience.
+
+**Architecture Layer:** Backend Infrastructure (Feature Sliced Design / Layered Architecture)
 
 ## 🏗️ Architecture
 ```mermaid
 graph TD
   decorators["📁 decorators"]
+  decorators --> decorators_public_decorator_ts["📄 public.decorator.ts"]
+  decorators --> decorators_roles_decorator_ts["📄 roles.decorator.ts"]
 ```
 
 ## 📄 File Registry
 | File Name | Type | Responsibility | Key Aliases Used |
 |---|---|---|---|
-| `public.decorator.ts` | TypeScript | Core logic and utilities for this domain. | @nestjs |
-| `roles.decorator.ts` | TypeScript | Core logic and utilities for this domain. | @nestjs |
+| `public.decorator.ts` | TypeScript | Core logic and utilities for this domain. | @nestjs/common |
+| `roles.decorator.ts` | TypeScript | Core logic and utilities for this domain. | @nestjs/common |
+
 
 ## 🔗 Dependencies
-- `@nestjs`
+- `@nestjs/common`
 
 ## 🛠️ Usage
 ```markdown

backend/src/common/filters/README.md

@@ -1,23 +1,27 @@
-# 📁 filters
+# 📁 Filters
 
-[Root](/.) / [backend](../../..) / [src](../..) / [common](..) / [filters](.)
+[Root](../../../../) > [backend](../../../) > [src](../../) > [common](../) > [filters](./)
 
 ## 🎯 Purpose
-Delivering luxury-tier architectural components and high-performance logic for the **filters** domain. This directory orchestrates precise operations within the Mavluda Beauty ecosystem, maintaining our elite standards of digital excellence.
+Delivering luxury-tier architectural components and high-performance logic for the **Filters** domain. This directory is a crucial part of the Mavluda Beauty full-stack ecosystem, ensuring seamless scalability, robust performance, and an elite digital experience.
+
+**Architecture Layer:** Backend Infrastructure (Feature Sliced Design / Layered Architecture)
 
 ## 🏗️ Architecture
 ```mermaid
 graph TD
   filters["📁 filters"]
+  filters --> filters_i18n_exception_filter_ts["📄 i18n-exception.filter.ts"]
 ```
 
 ## 📄 File Registry
 | File Name | Type | Responsibility | Key Aliases Used |
 |---|---|---|---|
-| `i18n-exception.filter.ts` | TypeScript | Core logic and utilities for this domain. | @nestjs |
+| `i18n-exception.filter.ts` | TypeScript | Core logic and utilities for this domain. | @nestjs/common |
+
 
 ## 🔗 Dependencies
-- `@nestjs`
+- `@nestjs/common`
 
 ## 🛠️ Usage
 ```markdown