beginwebdev2002 · beginwebdev2002 · May 21, 2026
diff --git a/README.md b/README.md
@@ -1,35 +1,33 @@
-# 📁 Mavluda Beauty Repository
+# 📁 . Directory
 
 [Root](/.)
 
 ## 🎯 Purpose
-Delivering luxury-tier architectural components and high-performance logic for the **Mavluda Beauty Repository** 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 **.** 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
-  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__["📁 ."]
+  Root__ --> f__gitignore["📄 .gitignore"]
+  Root__ --> f_GEMINI_md["📄 GEMINI.md"]
+  Root__ --> f_SECURITY_md["📄 SECURITY.md"]
+  Root__ --> d_backend["📁 backend"]
+  Root__ --> d_frontend["📁 frontend"]
 ```
 
 ## 📄 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 |
+| `GEMINI.md` | File | Provides core logic and orchestration for GEMINI.md. | N/A |
+| `SECURITY.md` | Markdown | Documentation file containing context for SECURITY.md. | N/A |
+| `backend` | Directory | Contains architectural sub-modules and layer logic for backend. | N/A |
+| `frontend` | Directory | Contains architectural sub-modules and layer logic for frontend. | N/A |
 
 ## 🔗 Dependencies
-- No external dependencies.
+- Relies on internal Mavluda Beauty architecture and designated FSD layers.
+- See 'Key Aliases Used' in the File Registry for explicit cross-domain references.
 
 ## 🛠️ Usage
 ```typescript

diff --git a/backend/README.md b/backend/README.md
@@ -1,43 +1,46 @@
-# 📁 backend
+# 📁 Backend Directory
 
-[Root](/.) > [backend](/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
 ```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 --> 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 --> d_src["📁 src"]
+  Root_backend --> d_test["📁 test"]
+  Root_backend --> f_tsconfig_build_json["📄 tsconfig.build.json"]
+  Root_backend --> f_tsconfig_json["📄 tsconfig.json"]
 ```
 
 ## 📄 File Registry
 | File Name | Type | Responsibility | Key Aliases Used |
 |---|---|---|---|
 | `.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 |
+| `eslint.config.mjs` | File | Provides core logic and orchestration for eslint.config.mjs. | N/A |
+| `nest-cli.json` | File | Provides core logic and orchestration for nest-cli.json. | N/A |
+| `package-lock.json` | File | Provides core logic and orchestration for package-lock.json. | N/A |
+| `package.json` | File | Provides core logic and orchestration for package.json. | N/A |
+| `src` | Directory | Contains architectural sub-modules and layer logic for src. | N/A |
+| `test` | Directory | Contains architectural sub-modules and layer logic for test. | N/A |
+| `tsconfig.build.json` | File | Provides core logic and orchestration for tsconfig.build.json. | N/A |
+| `tsconfig.json` | File | Provides core logic and orchestration for tsconfig.json. | N/A |
 
 ## 🔗 Dependencies
-- No external dependencies.
+- Relies on internal Mavluda Beauty architecture and designated FSD layers.
+- See 'Key Aliases Used' in the File Registry for explicit cross-domain references.
 
 ## 🛠️ Usage
 ```typescript
 // Example usage within the Mavluda Beauty ecosystem
-import { relevantMember } from './backend';
+import { relevantMember } from './core';
 
 // Integrate into the application architecture
 relevantMember.execute();

diff --git a/backend/src/README.md b/backend/src/README.md
@@ -1,60 +1,37 @@
-# 📁 src
+# 📁 Src Directory
 
-[Root](/.) > [backend](/backend) > [src](/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
 ```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"]
+classDiagram
+  class AppController
+  class AppModule
+  class AppService
 ```
 
 ## 📄 File Registry
 | File Name | Type | Responsibility | Key Aliases Used |
 |---|---|---|---|
-| `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 |
+| `app.controller.spec.ts` | File | Unit testing and quality assurance for app.controller.spec.ts. | @nestjs/testing |
+| `app.controller.ts` | File | Handles incoming HTTP requests and routing for app.controller.ts. | @nestjs/common |
+| `app.module.ts` | File | Defines the architectural module boundaries for app.module.ts. | @modules/auth, @modules/user, @modules/veil, @modules/treatments, @nestjs/core, @nestjs/serve-static, @modules/booking, @modules/gallery, @modules/payment, @modules/inventory, @nestjs/common, @modules/partnership, @modules/admin-settings |
+| `app.service.ts` | File | Encapsulates business logic and data access for app.service.ts. | @nestjs/common |
+| `common` | Directory | Contains architectural sub-modules and layer logic for common. | N/A |
+| `main.ts` | File | Provides core logic and orchestration for main.ts. | @nestjs/core, @nestjs/config, @nestjs/common |
+| `modules` | Directory | Contains architectural sub-modules and layer logic for modules. | N/A |
 
 ## 🔗 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`
-- `@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`
-- `path`
+- Relies on internal Mavluda Beauty architecture and designated FSD layers.
+- See 'Key Aliases Used' in the File Registry for explicit cross-domain references.
 
 ## 🛠️ Usage
 ```typescript
 // Example usage within the Mavluda Beauty ecosystem
-import { relevantMember } from './src';
+import { relevantMember } from './core';
 
 // Integrate into the application architecture
 relevantMember.execute();

diff --git a/backend/src/common/README.md b/backend/src/common/README.md
@@ -1,34 +1,46 @@
-# 📁 common
+# 📁 Common Directory
 
-[Root](/.) > [backend](/backend) > [src](/backend/src) > [common](/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
 ```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_seed["📁 seed"]
+  Root_common --> d_utils["📁 utils"]
 ```
 
 ## 📄 File Registry
-*No relevant files in this directory.*
+| File Name | Type | Responsibility | Key Aliases Used |
+|---|---|---|---|
+| `config` | Directory | Contains architectural sub-modules and layer logic for config. | N/A |
+| `constants` | Directory | Contains architectural sub-modules and layer logic for constants. | N/A |
+| `database` | Directory | Contains architectural sub-modules and layer logic for database. | N/A |
+| `decorators` | Directory | Contains architectural sub-modules and layer logic for decorators. | N/A |
+| `filters` | Directory | Contains architectural sub-modules and layer logic for filters. | N/A |
+| `guards` | Directory | Contains architectural sub-modules and layer logic for guards. | N/A |
+| `interfaces` | Directory | Contains architectural sub-modules and layer logic for interfaces. | N/A |
+| `seed` | Directory | Contains architectural sub-modules and layer logic for seed. | N/A |
+| `utils` | Directory | Contains architectural sub-modules and layer logic for utils. | N/A |
 
 ## 🔗 Dependencies
-- No external dependencies.
+- Relies on internal Mavluda Beauty architecture and designated FSD layers.
+- See 'Key Aliases Used' in the File Registry for explicit cross-domain references.
 
 ## 🛠️ Usage
 ```typescript
 // Example usage within the Mavluda Beauty ecosystem
-import { relevantMember } from './common';
+import { relevantMember } from './core';
 
 // Integrate into the application architecture
 relevantMember.execute();

diff --git a/backend/src/common/config/README.md b/backend/src/common/config/README.md
@@ -1,40 +1,34 @@
-# 📁 config
+# 📁 Config Directory
 
-[Root](/.) > [backend](/backend) > [src](/backend/src) > [common](/backend/src/common) > [config](/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
 ```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"]
+classDiagram
+  class AppConfigModule
+  class AppConfigService
+  class EnvironmentVariables
 ```
 
 ## 📄 File Registry
 | File Name | Type | Responsibility | Key Aliases Used |
 |---|---|---|---|
-| `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 |
+| `app-config.module.ts` | File | Defines the architectural module boundaries for app-config.module.ts. | @nestjs/config, @nestjs/common |
+| `app-config.service.ts` | File | Encapsulates business logic and data access for app-config.service.ts. | @nestjs/config, @nestjs/common |
+| `configuration.ts` | File | Provides core logic and orchestration for configuration.ts. | N/A |
+| `env.validation.ts` | File | Provides core logic and orchestration for env.validation.ts. | N/A |
 
 ## 🔗 Dependencies
-- `./app-config.service`
-- `./configuration`
-- `./env.validation`
-- `@nestjs/common`
-- `@nestjs/config`
-- `class-transformer`
+- Relies on internal Mavluda Beauty architecture and designated FSD layers.
+- See 'Key Aliases Used' in the File Registry for explicit cross-domain references.
 
 ## 🛠️ Usage
 ```typescript
 // Example usage within the Mavluda Beauty ecosystem
-import { relevantMember } from './config';
+import { relevantMember } from './core';
 
 // Integrate into the application architecture
 relevantMember.execute();

diff --git a/backend/src/common/constants/README.md b/backend/src/common/constants/README.md
@@ -1,29 +1,29 @@
-# 📁 constants
+# 📁 Constants Directory
 
-[Root](/.) > [backend](/backend) > [src](/backend/src) > [common](/backend/src/common) > [constants](/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
 ```mermaid
-graph TD
-  Root["📁 constants"]
-  Root --> error_messages_constant_ts["📄 error-messages.constant.ts"]
+classDiagram
+  class ErrorMessages
 ```
 
 ## 📄 File Registry
 | File Name | Type | Responsibility | Key Aliases Used |
 |---|---|---|---|
-| `error-messages.constant.ts` | TypeScript | Provides core logic and orchestration for error-messages.constant.ts. | N/A |
+| `error-messages.constant.ts` | File | Provides core logic and orchestration for error-messages.constant.ts. | N/A |
 
 ## 🔗 Dependencies
-- No external dependencies.
+- Relies on internal Mavluda Beauty architecture and designated FSD layers.
+- See 'Key Aliases Used' in the File Registry for explicit cross-domain references.
 
 ## 🛠️ Usage
 ```typescript
 // Example usage within the Mavluda Beauty ecosystem
-import { relevantMember } from './constants';
+import { relevantMember } from './core';
 
 // Integrate into the application architecture
 relevantMember.execute();

diff --git a/backend/src/common/database/README.md b/backend/src/common/database/README.md
@@ -1,31 +1,29 @@
-# 📁 database
+# 📁 Database Directory
 
-[Root](/.) > [backend](/backend) > [src](/backend/src) > [common](/backend/src/common) > [database](/backend/src/common/database)
+[Root](/.) / [backend](/backend) / [src](/backend/src) / [common](/backend/src/common) / [database](/backend/src/common/database)
 
 ## 🎯 Purpose
 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
 ```mermaid
-graph TD
-  Root["📁 database"]
-  Root --> database_module_ts["📄 database.module.ts"]
+classDiagram
+  class DatabaseModule
 ```
 
 ## 📄 File Registry
 | File Name | Type | Responsibility | Key Aliases Used |
 |---|---|---|---|
-| `database.module.ts` | TypeScript | Defines the architectural module boundaries for database.module.ts. | @nestjs |
+| `database.module.ts` | File | Defines the architectural module boundaries for database.module.ts. | @nestjs/mongoose, @nestjs/config, @nestjs/common |
 
 ## 🔗 Dependencies
-- `@nestjs/common`
-- `@nestjs/config`
-- `@nestjs/mongoose`
+- Relies on internal Mavluda Beauty architecture and designated FSD layers.
+- See 'Key Aliases Used' in the File Registry for explicit cross-domain references.
 
 ## 🛠️ Usage
 ```typescript
 // Example usage within the Mavluda Beauty ecosystem
-import { relevantMember } from './database';
+import { relevantMember } from './core';
 
 // Integrate into the application architecture
 relevantMember.execute();