docs: generate architectural READMEs

.gitignore

@@ -33,14 +33,5 @@ dist-ssr
 *.njsproj
 *.sln
 *.sw?
-*.md
-!README.md
-!GEMINI.md
-!AGENTS.md
-# Stop gitignore errors
-!README.md
+
 !**/README.md
-*.md
-!README.md
-!GEMINI.md
-!AGENTS.md

README.md

@@ -1,36 +1,33 @@
-# 📁 Mavluda_Beauty_Root
+# 📁 Mavluda Beauty Repository
 
 [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 logic for the **core** domain. Ensuring seamless scalability, robust performance, and an elite digital experience in the Mavluda Beauty ecosystem.
 
 ## 🏗️ Architecture
 ```mermaid
 graph TD
-  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"]
+  Root["📁 Mavluda Beauty Repository"]
+  Root --> backend["📁 backend"]
+  Root --> frontend["📁 frontend"]
+  Root --> scripts["📁 scripts"]
+  Root --> _env["📄 .env"]
+  Root --> _gitignore["📄 .gitignore"]
+  Root --> GEMINI_md["📄 GEMINI.md"]
+  Root --> generate_readmes_py["📄 generate_readmes.py"]
 ```
 
 ## 📄 File Registry
 | File Name | Type | Responsibility | Key Aliases Used |
 |---|---|---|---|
-| `.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` | Markdown | Core logic and utilities for this domain. | N/A |
-
+| `.env` | File | Provides core logic and orchestration for .env. | N/A |
+| `.gitignore` | File | Provides core logic and orchestration for .gitignore. | N/A |
+| `GEMINI.md` | File | 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 |
 
 ## 🔗 Dependencies
-*No internal path aliases detected in this directory.*
+- No external dependencies.
 
 ## 🛠️ Usage
-```markdown
-> This directory acts primarily as a structural container or logic module.
-> To interact with its contents, import the relevant exported members from the `index.ts` or specifically targeted files.
-```
+> No specific code execution examples for this directory.

backend/README.md

@@ -1,43 +1,38 @@
-# ⚙️ Backend
+# 📁 backend
 
-[Root](../) > [backend](./)
+[Root](/.) > [backend](/backend)
 
 ## 🎯 Purpose
-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)
+Delivering luxury-tier architectural components and logic for the **backend** domain. Ensuring seamless scalability, robust performance, and an elite digital experience in the Mavluda Beauty ecosystem.
 
 ## 🏗️ Architecture
 ```mermaid
 graph TD
-  backend["⚙️ backend"]
-  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"]
+  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"]
 ```
 
 ## 📄 File Registry
 | File Name | Type | Responsibility | Key Aliases Used |
 |---|---|---|---|
-| `.prettierrc` | File | Core logic and utilities for this domain. | 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 |
-
+| `.prettierrc` | File | Provides core logic and orchestration for .prettierrc. | N/A |
+| `eslint.config.mjs` | JavaScript | Provides core logic and orchestration for eslint.config.mjs. | N/A |
+| `nest-cli.json` | JSON Configuration | Provides core logic and orchestration for nest-cli.json. | N/A |
+| `package-lock.json` | JSON Configuration | Provides core logic and orchestration for package-lock.json. | N/A |
+| `package.json` | JSON Configuration | Provides core logic and orchestration for package.json. | N/A |
+| `tsconfig.build.json` | JSON Configuration | Provides core logic and orchestration for tsconfig.build.json. | N/A |
+| `tsconfig.json` | JSON Configuration | Provides core logic and orchestration for tsconfig.json. | N/A |
 
 ## 🔗 Dependencies
-- `@eslint/js`
+- No external dependencies.
 
 ## 🛠️ Usage
-```markdown
-> This directory acts primarily as a structural container or logic module.
-> To interact with its contents, import the relevant exported members from the `index.ts` or specifically targeted files.
-```
+> No specific code execution examples for this directory.

backend/src/README.md

@@ -1,36 +1,39 @@
-# 💻 Src
+# 📁 src
 
-[Root](../../) > [backend](../) > [src](./)
+[Root](/.) > [backend](/backend) > [src](/backend/src)
 
 ## 🎯 Purpose
-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)
+Delivering luxury-tier architectural components and logic for the **src** domain. Ensuring seamless scalability, robust performance, and an elite digital experience in the Mavluda Beauty ecosystem.
 
 ## 🏗️ Architecture
 ```mermaid
 graph TD
-  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"]
+  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"]
 ```
 
 ## 📄 File Registry
 | File Name | Type | Responsibility | Key Aliases Used |
 |---|---|---|---|
-| `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 |
-
+| `app.controller.spec.ts` | TypeScript | Unit testing and quality assurance for app.controller.spec.ts. | @nestjs |
+| `app.controller.ts` | TypeScript | Handles incoming HTTP requests and routing for app.controller.ts. | @nestjs |
+| `app.module.ts` | TypeScript | Defines the architectural module boundaries for app.module.ts. | @modules, @nestjs |
+| `app.service.ts` | TypeScript | Encapsulates business logic and data access for app.service.ts. | @nestjs |
+| `main.ts` | TypeScript | Provides core logic and orchestration for main.ts. | @nestjs |
 
 ## 🔗 Dependencies
+- `./app.controller`
+- `./app.module`
+- `./app.service`
+- `./common/config/app-config.module`
+- `./common/database/database.module`
+- `./common/filters/i18n-exception.filter`
 - `@modules/admin-settings`
 - `@modules/auth`
 - `@modules/booking`
@@ -46,9 +49,10 @@ graph TD
 - `@nestjs/core`
 - `@nestjs/serve-static`
 - `@nestjs/testing`
+- `path`
 
 ## 🛠️ Usage
-```markdown
-> This directory acts primarily as a structural container or logic module.
-> To interact with its contents, import the relevant exported members from the `index.ts` or specifically targeted files.
+```typescript
+// Example usage within the Mavluda Beauty ecosystem
+import { relevantMember } from './';
 ```

backend/src/common/README.md

@@ -1,35 +1,33 @@
-# 📁 Common
+# 📁 common
 
-[Root](../../../) > [backend](../../) > [src](../) > [common](./)
+[Root](/.) > [backend](/backend) > [src](/backend/src) > [common](/backend/src/common)
 
 ## 🎯 Purpose
-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)
+Shared utility functions, helpers, and common logic applicable across multiple modules.
 
 ## 🏗️ Architecture
 ```mermaid
 graph TD
-  common["📁 common"]
-  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"]
+  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"]
 ```
 
 ## 📄 File Registry
-*No files directly in this directory.*
-
+| File Name | Type | Responsibility | Key Aliases Used |
+|---|---|---|---|
 
 ## 🔗 Dependencies
-*No internal path aliases detected in this directory.*
+- No external dependencies.
 
 ## 🛠️ Usage
-```markdown
-> This directory acts primarily as a structural container or logic module.
-> To interact with its contents, import the relevant exported members from the `index.ts` or specifically targeted files.
+```typescript
+import { specificUtility } from './utils';
+const result = specificUtility(input);
 ```

backend/src/common/config/README.md

@@ -1,37 +1,38 @@
-# 🔧 Config
+# 📁 config
 
-[Root](../../../../) > [backend](../../../) > [src](../../) > [common](../) > [config](./)
+[Root](/.) > [backend](/backend) > [src](/backend/src) > [common](/backend/src/common) > [config](/backend/src/common/config)
 
 ## 🎯 Purpose
-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)
+Shared utility functions, helpers, and common logic applicable across multiple modules.
 
 ## 🏗️ Architecture
 ```mermaid
 graph TD
-  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"]
+  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"]
 ```
 
 ## 📄 File Registry
 | File Name | Type | Responsibility | Key Aliases Used |
 |---|---|---|---|
-| `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 |
-
+| `app-config.module.ts` | TypeScript | Defines the architectural module boundaries for app-config.module.ts. | @nestjs |
+| `app-config.service.ts` | TypeScript | Encapsulates business logic and data access for app-config.service.ts. | @nestjs |
+| `configuration.ts` | TypeScript | Provides core logic and orchestration for configuration.ts. | N/A |
+| `env.validation.ts` | TypeScript | Provides core logic and orchestration for env.validation.ts. | N/A |
 
 ## 🔗 Dependencies
+- `./app-config.service`
+- `./configuration`
+- `./env.validation`
 - `@nestjs/common`
 - `@nestjs/config`
+- `class-transformer`
 
 ## 🛠️ Usage
-```markdown
-> This directory acts primarily as a structural container or logic module.
-> To interact with its contents, import the relevant exported members from the `index.ts` or specifically targeted files.
+```typescript
+import { specificUtility } from './utils';
+const result = specificUtility(input);
 ```

backend/src/common/constants/README.md

@@ -1,30 +1,27 @@
-# 📁 Constants
+# 📁 constants
 
-[Root](../../../../) > [backend](../../../) > [src](../../) > [common](../) > [constants](./)
+[Root](/.) > [backend](/backend) > [src](/backend/src) > [common](/backend/src/common) > [constants](/backend/src/common/constants)
 
 ## 🎯 Purpose
-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)
+Shared utility functions, helpers, and common logic applicable across multiple modules.
 
 ## 🏗️ Architecture
 ```mermaid
 graph TD
-  constants["📁 constants"]
-  constants --> constants_error_messages_constant_ts["📄 error-messages.constant.ts"]
+  Root["📁 constants"]
+  Root --> 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 |
-
+| `error-messages.constant.ts` | TypeScript | Provides core logic and orchestration for error-messages.constant.ts. | N/A |
 
 ## 🔗 Dependencies
-*No internal path aliases detected in this directory.*
+- No external dependencies.
 
 ## 🛠️ Usage
-```markdown
-> This directory acts primarily as a structural container or logic module.
-> To interact with its contents, import the relevant exported members from the `index.ts` or specifically targeted files.
+```typescript
+import { specificUtility } from './utils';
+const result = specificUtility(input);
 ```