docs: generate localized architectural READMEs across all directories

.github/README.md

@@ -1,6 +1,6 @@
-# 📁 Mavluda Beauty .github
+[Root](/.) > [.github](/.github)
 
-[.github](/.github)
+# 📁 .github
 
 ## 🎯 Purpose
 Delivering luxury-tier architectural components and high-performance logic for the **.github** domain. This directory is a crucial part of the Mavluda Beauty full-stack ecosystem, ensuring seamless scalability, robust performance, and an elite digital experience.
@@ -17,15 +17,16 @@ graph TD
 ## 📄 File Registry
 | File Name | Type | Responsibility | Key Aliases Used |
 |---|---|---|---|
-| *No files in this directory* | - | - | - |
-
+| (No files) | N/A | Subdirectory container | N/A |
 
 ## 🔗 Dependencies
-No external or alias dependencies detected.
+- No external dependencies.
 
 ## 🛠️ Usage
 ```typescript
-// Example integration for .github
-// Import capabilities from this directory to enrich your modules.
-```
-> This directory provides specialized logic tailored to the Mavluda Beauty standard.
+// Example usage within the Mavluda Beauty ecosystem
+import { relevantMember } from './core';
+
+// Integrate into the application architecture
+relevantMember.execute();
+```

.github/instructions/README.md

@@ -1,6 +1,6 @@
-# 📁 Mavluda Beauty instructions
+[Root](/.) > [.github](/.github) > [instructions](/.github/instructions)
 
-[.github](/.github) / [instructions](/.github/instructions)
+# 📁 Instructions
 
 ## 🎯 Purpose
 Delivering luxury-tier architectural components and high-performance logic for the **instructions** domain. This directory is a crucial part of the Mavluda Beauty full-stack ecosystem, ensuring seamless scalability, robust performance, and an elite digital experience.
@@ -19,19 +19,20 @@ graph TD
 ## 📄 File Registry
 | File Name | Type | Responsibility | Key Aliases Used |
 |---|---|---|---|
-| `agents.md` | File | Core logic and utilities for this domain. | N/A |
-| `angular-signals.md` | File | Core logic and utilities for this domain. | N/A |
-| `backend-architecture.md` | File | Core logic and utilities for this domain. | N/A |
-| `frontend.md` | File | Core logic and utilities for this domain. | N/A |
-| `typescript.md` | File | Core logic and utilities for this domain. | N/A |
-
+| `agents.md` | Markdown | Core logic and utilities for this domain. | @entities |
+| `angular-signals.md` | Markdown | Core logic and utilities for this domain. | N/A |
+| `backend-architecture.md` | Markdown | Core logic and utilities for this domain. | N/A |
+| `frontend.md` | Markdown | Core logic and utilities for this domain. | @angular |
+| `typescript.md` | Markdown | Core logic and utilities for this domain. | @entities |
 
 ## 🔗 Dependencies
-No external or alias dependencies detected.
+- `./api/update-veil.service`, `./application/admin-settings.service`, `./application/dto/settings-response.dto`, `./application/dto/update-settings.dto`, `./domain/entities/admin-settings.entity`, `./model/veil.data`, `./ui/veil.component`, `@angular/core`, `@entities/veil`, `@entities/veil/api/veil.service`
 
 ## 🛠️ Usage
 ```typescript
-// Example integration for instructions
-// Import capabilities from this directory to enrich your modules.
-```
-> This directory provides specialized logic tailored to the Mavluda Beauty standard.
+// Example usage within the Mavluda Beauty ecosystem
+import { relevantMember } from './core';
+
+// Integrate into the application architecture
+relevantMember.execute();
+```

.github/prompts/README.md

@@ -1,6 +1,6 @@
-# 📁 Mavluda Beauty prompts
+[Root](/.) > [.github](/.github) > [prompts](/.github/prompts)
 
-[.github](/.github) / [prompts](/.github/prompts)
+# 📁 Prompts
 
 ## 🎯 Purpose
 Delivering luxury-tier architectural components and high-performance logic for the **prompts** domain. This directory is a crucial part of the Mavluda Beauty full-stack ecosystem, ensuring seamless scalability, robust performance, and an elite digital experience.
@@ -15,15 +15,16 @@ graph TD
 ## 📄 File Registry
 | File Name | Type | Responsibility | Key Aliases Used |
 |---|---|---|---|
-| `mavluda-beauty.md` | File | Core logic and utilities for this domain. | N/A |
-
+| `mavluda-beauty.md` | Markdown | Core logic and utilities for this domain. | N/A |
 
 ## 🔗 Dependencies
-No external or alias dependencies detected.
+- No external dependencies.
 
 ## 🛠️ Usage
 ```typescript
-// Example integration for prompts
-// Import capabilities from this directory to enrich your modules.
-```
-> This directory provides specialized logic tailored to the Mavluda Beauty standard.
+// Example usage within the Mavluda Beauty ecosystem
+import { relevantMember } from './core';
+
+// Integrate into the application architecture
+relevantMember.execute();
+```

.github/workflows/README.md

@@ -1,6 +1,6 @@
-# 📁 Mavluda Beauty workflows
+[Root](/.) > [.github](/.github) > [workflows](/.github/workflows)
 
-[.github](/.github) / [workflows](/.github/workflows)
+# 📁 Workflows
 
 ## 🎯 Purpose
 Delivering luxury-tier architectural components and high-performance logic for the **workflows** domain. This directory is a crucial part of the Mavluda Beauty full-stack ecosystem, ensuring seamless scalability, robust performance, and an elite digital experience.
@@ -10,24 +10,25 @@ Delivering luxury-tier architectural components and high-performance logic for t
 graph TD
   workflows["📁 workflows"]
   workflows --> backend_deploy_yml["📄 backend-deploy.yml"]
-  workflows --> ci_yml["📄 ci.yml"]
-  workflows --> frontend_deployment_yml["📄 frontend-deployment.yml"]
+  workflows --> frontend_deploy_yml["📄 frontend-deploy.yml"]
+  workflows --> root_deploy_yml["📄 root-deploy.yml"]
 ```
 
 ## 📄 File Registry
 | File Name | Type | Responsibility | Key Aliases Used |
 |---|---|---|---|
 | `backend-deploy.yml` | File | Core logic and utilities for this domain. | N/A |
-| `ci.yml` | File | Core logic and utilities for this domain. | N/A |
-| `frontend-deployment.yml` | File | Core logic and utilities for this domain. | N/A |
-
+| `frontend-deploy.yml` | File | Provides core logic and orchestration for frontend-deploy.yml. | N/A |
+| `root-deploy.yml` | File | Provides core logic and orchestration for root-deploy.yml. | N/A |
 
 ## 🔗 Dependencies
-No external or alias dependencies detected.
+- No external dependencies.
 
 ## 🛠️ Usage
 ```typescript
-// Example integration for workflows
-// Import capabilities from this directory to enrich your modules.
-```
-> This directory provides specialized logic tailored to the Mavluda Beauty standard.
+// Example usage within the Mavluda Beauty ecosystem
+import { relevantMember } from './core';
+
+// Integrate into the application architecture
+relevantMember.execute();
+```

.gitignore

@@ -49,3 +49,4 @@ dist-ssr
 !**/README.md
 !GEMINI.md
 !AGENTS.md
+generate_readmes.py

README.md

@@ -1,35 +1,37 @@
-# 📁 Mavluda Beauty Repository
-
 [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"]
+  _["📁 ."]
+  _ --> _github["📁 .github"]
+  _ --> backend["📁 backend"]
+  _ --> frontend["📁 frontend"]
+  _ --> _env["📄 .env"]
+  _ --> _gitignore["📄 .gitignore"]
+  _ --> GEMINI_md["📄 GEMINI.md"]
+  _ --> SECURITY_md["📄 SECURITY.md"]
+  _ --> commit_files_sh["📄 commit_files.sh"]
+  _ --> generate_readmes_py["📄 generate_readmes.py"]
 ```
 
 ## 📄 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 |
+| `SECURITY.md` | Markdown | Provides core logic and orchestration for SECURITY.md. | N/A |
+| `commit_files.sh` | File | Provides core logic and orchestration for commit_files.sh. | N/A |
 | `generate_readmes.py` | File | Provides core logic and orchestration for generate_readmes.py. | N/A |
 
 ## 🔗 Dependencies
-- No external dependencies.
+- `./core`
 
 ## 🛠️ Usage
 ```typescript
@@ -38,4 +40,4 @@ import { relevantMember } from './core';
 
 // Integrate into the application architecture
 relevantMember.execute();
-```
+```

backend/README.md

@@ -1,44 +1,44 @@
-# 📁 backend
-
 [Root](/.) > [backend](/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"]
+  backend["📁 backend"]
+  backend --> src["📁 src"]
+  backend --> test["📁 test"]
+  backend --> _prettierrc["📄 .prettierrc"]
+  backend --> eslint_config_mjs["📄 eslint.config.mjs"]
+  backend --> nest_cli_json["📄 nest-cli.json"]
+  backend --> package_lock_json["📄 package-lock.json"]
+  backend --> package_json["📄 package.json"]
+  backend --> tsconfig_build_json["📄 tsconfig.build.json"]
+  backend --> 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. | @eslint |
+| `nest-cli.json` | JSON | Provides core logic and orchestration for nest-cli.json. | N/A |
+| `package-lock.json` | JSON | Provides core logic and orchestration for package-lock.json. | N/A |
+| `package.json` | JSON | Provides core logic and orchestration for package.json. | N/A |
+| `tsconfig.build.json` | JSON | Provides core logic and orchestration for tsconfig.build.json. | N/A |
+| `tsconfig.json` | JSON | Provides core logic and orchestration for tsconfig.json. | N/A |
 
 ## 🔗 Dependencies
-- No external dependencies.
+- `@eslint/js`, `eslint-plugin-prettier/recommended`, `globals`, `typescript-eslint`
 
 ## 🛠️ Usage
 ```typescript
 // Example usage within the Mavluda Beauty ecosystem
-import { relevantMember } from './backend';
+import { relevantMember } from './core';
 
 // Integrate into the application architecture
 relevantMember.execute();
-```
+```

backend/src/README.md

@@ -1,21 +1,21 @@
-# 📁 src
-
 [Root](/.) > [backend](/backend) > [src](/backend/src)
 
+# 📁 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"]
+  src["📁 src"]
+  src --> common["📁 common"]
+  src --> modules["📁 modules"]
+  src --> app_controller_spec_ts["📄 app.controller.spec.ts"]
+  src --> app_controller_ts["📄 app.controller.ts"]
+  src --> app_module_ts["📄 app.module.ts"]
+  src --> app_service_ts["📄 app.service.ts"]
+  src --> main_ts["📄 main.ts"]
 ```
 
 ## 📄 File Registry
@@ -28,34 +28,13 @@ graph TD
 | `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`
-- `@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`
+- `./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`
 
 ## 🛠️ Usage
 ```typescript
 // Example usage within the Mavluda Beauty ecosystem
-import { relevantMember } from './src';
+import { relevantMember } from './core';
 
 // Integrate into the application architecture
 relevantMember.execute();
-```
+```