nodejs-quickstart-structure 1.18.1 → 1.19.0

package/templates/common/.gitattributes

@@ -0,0 +1,46 @@
+# Enforce LF endings for all text files
+* text=auto eol=lf
+
+# Explicitly handle common text file types
+*.js      text eol=lf
+*.ts      text eol=lf
+*.tsx     text eol=lf
+*.jsx     text eol=lf
+*.mjs     text eol=lf
+*.cjs     text eol=lf
+*.json    text eol=lf
+*.md      text eol=lf
+*.sh      text eol=lf
+*.yml     text eol=lf
+*.yaml    text eol=lf
+*.html    text eol=lf
+*.css     text eol=lf
+*.scss    text eol=lf
+*.less    text eol=lf
+*.graphql text eol=lf
+*.sql     text eol=lf
+*.pug     text eol=lf
+
+# Configuration files
+.env*          text eol=lf
+.editorconfig  text eol=lf
+.prettierrc    text eol=lf
+.eslintrc*     text eol=lf
+.gitignore     text eol=lf
+.dockerignore  text eol=lf
+.gitattributes text eol=lf
+
+# Assets
+*.png     binary
+*.jpg     binary
+*.jpeg    binary
+*.gif     binary
+*.ico     binary
+*.webp    binary
+*.avif    binary
+*.pdf     binary
+*.woff    binary
+*.woff2   binary
+*.ttf     binary
+*.eot     binary
+*.svg     text eol=lf

package/templates/common/README.md.ejs

@@ -1,271 +1,295 @@
-# <%= projectName %>
-
-![Node.js](https://img.shields.io/badge/Node.js-18%2B-green.svg)
-![License](https://img.shields.io/badge/License-ISC-blue.svg)
-<% if (language === 'TypeScript') { %>![TypeScript](https://img.shields.io/badge/Language-TypeScript-blue.svg)<% } else { %>![JavaScript](https://img.shields.io/badge/Language-JavaScript-yellow.svg)<% } %>
-<% if (includeSecurity) { %>
-[![Snyk Vulnerabilities](https://img.shields.io/snyk/vulnerabilities/github/yourusername/<%= projectName %>?style=flat-square)](https://snyk.io/)
-[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=<%= projectName %>&metric=alert_status)](https://sonarcloud.io/)
-<% } %>
-
-A production-ready Node.js microservice generated with **<%= architecture %>** and **<%= database %>**. 
-This project follows a strict **7-Step Production-Ready Process** to ensure quality and scalability from day one.
-
----
-
-## 🚀 7-Step Production-Ready Process
-
-1.  **Initialize Git**: `git init` (Required for Husky hooks and security gates).
-2.  **Install Dependencies**: `npm install`.
-3.  **Configure Environment**: Copy `.env.example` to `.env`.
-4.  **Start Infrastructure**: `docker-compose up -d<% if (database !== 'None') { %> db<% } %><% if (caching === 'Redis') { %> redis<% } %><% if (communication === 'Kafka') { %> kafka<% } %>`.
-5.  **Run Development**: `npm run dev`.
-6.  **Verify Standards**: `npm run lint` and `npm test` (Enforce 80% coverage).
-7.  **Build & Deploy**: `npm run build` followed by `npm run deploy` (via PM2).
-
----
-
-## 🚀 Key Features
-
--   **Architecture**: <%= architecture %> (<% if (architecture === 'Clean Architecture') { %>Domain, UseCases, Infrastructure<% } else { %>MVC Pattern<% } %>).
--   **Database**: <%= database %> <% if (database !== 'None') { %>(via <%= database === 'MongoDB' ? 'Mongoose' : 'Sequelize' %>)<% } %>.
--   **Security**: Helmet, CORS, Rate Limiting, HPP, Snyk SCA.
--   **Quality**: 80%+ Test Coverage, Eslint, Prettier, Husky.
--   **DevOps**: Multi-stage Docker, CI/CD ready (GitHub/GitLab/Jenkins).
-<% if (includeSecurity) { %>-   **Enterprise Hardening**: SonarCloud SAST, Security Policies.<% } %>
-
-## 📂 Project Structure
-
-The project follows **<%= architecture %>** principles.
-<% if (architecture === 'Clean Architecture') { -%>
-- **Domain**: Pure business logic (Entities/Interfaces).
-- **Use Case**: Application-specific business rules.
-- **Infrastructure**: External concerns (DB, Messaging, Caching).
-<% } else { -%>
-- **Model**: Database schemas and data logic.
-- **View**: Template engines or API responders.
-- **Controller**: Orchestrates flow between Model and View.
-<% } -%>
-
----
-
-## 🛠️ Detailed Getting Started
-
-Follow the **🚀 7-Step Production-Ready Process** summary at the top, or follow these detailed instructions:
-
-### 1. Prerequisites
--   Node.js (v18+)
--   Docker & Docker Compose
-
-### 2. Environment Setup
-Copy the example environment file and adjust the values as needed:
-```bash
-cp .env.example .env
-```
-
-### 3. Infrastructure & App Launch
-```bash
-# Initialize Git for security hooks
-git init
-
-# Install dependencies
-npm install
-
-# Start required services
-docker-compose up -d<% if (database !== 'None') { %> db<% } %><% if (caching === 'Redis') { %> redis<% } %><% if (communication === 'Kafka') { %> kafka<% } %>
-
-# Run the app in development mode
-npm run dev
-```
-
-### 4. Quality & Standards
-```bash
-# Lint & Format
-npm run lint
-npm run format
-
-# Run Unit/Integration Tests
-npm test
-npm run test:coverage
-```
-
-<% if (communication === 'Kafka') { -%>
-Microservices communication handled via **Kafka**.
-<% } else if (communication === 'GraphQL') { -%>
-API is exposed via **GraphQL**.
-The Apollo Sandbox UI for API exploration and documentation is available natively, fully embedded for offline development:
-- **URL**: `http://localhost:3000/graphql` (Dynamic based on PORT)
-If you are opening `http://localhost:3000/graphql` in your browser, you can directly run the following in the Apollo Sandbox UI:
-
-**Query to get all users:**
-```graphql
-query GetAllUsers {
-  getAllUsers {
-    id
-    name
-    email
-  }
-}
-```
-
-**Mutation to create a user:**
-```graphql
-mutation CreateUser {
-  createUser(name: "John Doe", email: "john@example.com") {
-    id
-    name
-    email
-  }
-}
-```
-<% } else { -%>
-API is exposed via **REST**.
-A Swagger UI for API documentation is available at:
-- **URL**: `http://localhost:3000/api-docs` (Dynamic based on PORT)
-<%_ } -%>
-
-<% if (communication === 'Kafka') { -%>
-## 📡 Testing Kafka Asynchronous Flow
-This project demonstrates a production-ready Kafka flow:
-1. **Producer**: When a user is created via the API, a `USER_CREATED` event is sent to `user-topic`.
-2. **Consumer**: `WelcomeEmailConsumer` listens to `user-topic` and simulates sending an email.
-
-### How to verify:
-1. Ensure infrastructure is running: `docker-compose up -d<% if (database !== 'None') { %> db<% } %><% if (caching === 'Redis') { %> redis<% } %><% if (communication === 'Kafka') { %> kafka<% } %>`
-2. Start the app: `npm run dev`
-3. Trigger an event by creating a user (via Postman or curl):
-   ```bash
-   curl -X POST http://localhost:3000/api/users \
-     -H "Content-Type: application/json" \
-     -d '{"name": "Kafka Tester", "email": "kafka@example.com"}'
-   ```
-4. Observe the logs:
-   ```text
-   [Kafka] Producer: Sent USER_CREATED event for 'kafka@example.com'
-   [Kafka] Consumer: Received USER_CREATED. 
-   [Kafka] Consumer: 📧 Sending welcome email to 'kafka@example.com'... Done!
-   ```
-
-### 🛠️ Kafka Troubleshooting
-If the connection or events are failing:
-1. **Check Docker**: Ensure Kafka container is running (`docker ps`).
-2. **Verify Broker**: `KAFKA_BROKER` in `.env` must match your host/port (standard: 9093).
-3. **Advertised Listeners**: If using Windows/WSL, check `docker-compose.yml` advertisers are correct.
-4. **Logs**: Check `docker compose logs -f kafka` for start-up errors.
-<% } -%>
-
-<% if (caching === 'Redis') { -%>
-## ⚡ Caching
-This project uses **Redis** for caching.
-- **Client**: `ioredis`
-- **Connection**: Configured via `REDIS_HOST`, `REDIS_PORT`, `REDIS_PASSWORD` in `.env`.
-<% } else if (caching === 'Memory Cache') { -%>
-## ⚡ Caching
-This project uses **Memory Cache** for in-memory caching.
-- **Client**: `node-cache`
-<% } -%>
-
-## 📝 Logging
-This project uses **Winston** for structured logging.
-- **Development**: Logs are printed to the console.
-- **Production**: Logs are saved to files:
-  - `error.log`: Only error level logs.
-  - `combined.log`: All logs.
-
-## 🐳 Docker Deployment
-This project uses a **Multi-Stage Dockerfile** for optimized production images.
-
-<% if (database !== 'None' || caching === 'Redis' || communication === 'Kafka') { -%>
-### 1. Running Locally (Development)
-To run the Node.js application locally while using Docker for the infrastructure (Database, Redis, Kafka, etc.):
-
-```bash
-# Start infrastructure
-docker-compose up -d<% if (database !== 'None') { %> db<% } %><% if (caching === 'Redis') { %> redis<% } %><% if (communication === 'Kafka') { %> kafka<% } %>
-
-# Start the application
-npm run dev
-```
-
-### 2. Running the App Container with Compose Infrastructure
-If you want to run the application itself inside a Docker container while connecting to the infrastructure managed by your `docker-compose.yml`:
-
-```bash
-# First, ensure your infrastructure is running
-docker-compose up -d
-
-# Build Production Image
-docker build -t <%= projectName %> .
-
-# Run Container (attached to the compose network)
-docker run -p 3000:3000 --network <%= projectName %>_default \
-<% if (database !== 'None') { -%>
-  -e DB_HOST=db \
-<% } -%>
-<% if (caching === 'Redis') { -%>
-  -e REDIS_HOST=redis \
-<% } -%>
-<% if (communication === 'Kafka') { -%>
-  -e KAFKA_BROKER=kafka:29092 \
-<% } -%>
-  <%= projectName %>
-```
-<% } else { -%>
-```bash
-# Build Production Image
-docker build -t <%= projectName %> .
-
-# Run Container
-docker run -p 3000:3000 <%= projectName %>
-```
-<% } -%>
-## 🚀 PM2 Deployment (VPS/EC2)
-This project is pre-configured for direct deployment to a VPS/EC2 instance using **PM2** (via `ecosystem.config.js`).
-1. Install dependencies
-```bash
-npm install
-```
-2. **Start Infrastructure (DB, Redis, Kafka, etc.) in the background**
-*(This specifically starts the background services without running the application inside Docker, allowing PM2 to handle it).*
-```bash
-docker-compose up -d<% if (database !== 'None') { %> db<% } %><% if (caching === 'Redis') { %> redis<% } %><% if (communication === 'Kafka') { %> kafka<% } %>
-```
-3. **Wait 5-10s** for the database to fully initialize.
-4. **Deploy the App using PM2 in Cluster Mode**
-```bash
-<% if (language === 'TypeScript') { %>npm run build
-<% } %>npm run deploy
-```
-5. **Check logs**
-```bash
-npx pm2 logs
-```
-6. Stop and remove the PM2 application
-```bash
-npx pm2 delete <%= projectName %>
-```
-7. Stop and remove the Docker infrastructure
-```bash
-docker-compose down
-```
-
-## 🔒 Security Features
--   **Helmet**: Sets secure HTTP headers.
--   **CORS**: Configured for cross-origin requests.
--   **Rate Limiting**: Protects against DDoS / Brute-force.
--   **HPP**: Prevents HTTP Parameter Pollution attacks.
-<% if (includeSecurity) { %>
-### 🛡️ Enterprise Hardening (Big Tech Standard)
--   **Snyk SCA**: Run `npm run snyk:test` for dependency scanning.
--   **SonarCloud**: Automated SAST on every Push/PR.
--   **Digital Guardians**: Recommended Gitleaks integration for secret protection.
--   **Security Policy**: Standard `SECURITY.md` for vulnerability reporting.
-<% } %>
-## 🤖 AI-Native Development
-
-This project is "AI-Ready" out of the box. We have pre-configured industry-leading AI context files to bridge the gap between "Generated Code" and "AI-Assisted Development."
-
-- **Magic Defaults**: We've automatically tailored your AI context to focus on **<%= projectName %>** and its specific architectural stack (<%= architecture %>, <%= database %>, etc.).
-- **Use Cursor?** We've configured **`.cursorrules`** at the root. It enforces project standards (80% coverage, MVC/Clean) directly within the editor. 
-  - *Pro-tip*: You can customize the `Project Goal` placeholder in `.cursorrules` to help the AI understand your specific business logic!
+# <%= projectName %>
+
+![Node.js](https://img.shields.io/badge/Node.js-18%2B-green.svg)
+![License](https://img.shields.io/badge/License-ISC-blue.svg)
+<% if (language === 'TypeScript') { %>![TypeScript](https://img.shields.io/badge/Language-TypeScript-blue.svg)<% } else { %>![JavaScript](https://img.shields.io/badge/Language-JavaScript-yellow.svg)<% } %>
+<% if (includeSecurity) { %>
+[![Snyk Vulnerabilities](https://img.shields.io/snyk/vulnerabilities/github/yourusername/<%= projectName %>?style=flat-square)](https://snyk.io/)
+[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=<%= projectName %>&metric=alert_status)](https://sonarcloud.io/)
+<% } %>
+
+A production-ready Node.js microservice generated with **<%= architecture %>** and **<%= database %>**. 
+This project follows a strict **7-Step Production-Ready Process** to ensure quality and scalability from day one.
+
+---
+
+## 🚀 7-Step Production-Ready Process
+
+1.  **Initialize Git**: `git init` (Required for Husky hooks and security gates).
+2.  **Install Dependencies**: `npm install`.
+3.  **Configure Environment**: Copy `.env.example` to `.env`.
+4.  **Start Infrastructure**: `docker-compose up -d<% if (database !== 'None') { %> db<% } %><% if (caching === 'Redis') { %> redis<% } %><% if (communication === 'Kafka') { %> kafka<% } %>`.
+5.  **Run Development**: `npm run dev`.
+6.  **Verify Standards**: `npm run lint` and `npm test` (Enforce 80% coverage).
+7.  **Build & Deploy**: `npm run build` followed by `npm run deploy` (via PM2).
+
+---
+
+## 🚀 Key Features
+
+-   **Architecture**: <%= architecture %> (<% if (architecture === 'Clean Architecture') { %>Domain, UseCases, Infrastructure<% } else { %>MVC Pattern<% } %>).
+-   **Database**: <%= database %> <% if (database !== 'None') { %>(via <%= database === 'MongoDB' ? 'Mongoose' : 'Sequelize' %>)<% } %>.
+-   **Security**: Helmet, CORS, Rate Limiting, HPP, Snyk SCA.
+-   **Quality**: 80%+ Test Coverage, Eslint, Prettier, Husky.
+-   **DevOps**: Multi-stage Docker, CI/CD ready (GitHub/GitLab/Jenkins).
+<% if (includeSecurity) { %>-   **Enterprise Hardening**: SonarCloud SAST, Security Policies.<% } %>
+
+## 📂 Project Structure
+
+The project follows **<%= architecture %>** principles.
+<% if (architecture === 'Clean Architecture') { -%>
+- **Domain**: Pure business logic (Entities/Interfaces).
+- **Use Case**: Application-specific business rules.
+- **Infrastructure**: External concerns (DB, Messaging, Caching).
+<% } else { -%>
+- **Model**: Database schemas and data logic.
+- **View**: Template engines or API responders.
+- **Controller**: Orchestrates flow between Model and View.
+<% } -%>
+
+---
+
+## 🛠️ Detailed Getting Started
+
+Follow the **🚀 7-Step Production-Ready Process** summary at the top, or follow these detailed instructions:
+
+### 1. Prerequisites
+-   Node.js (v18+)
+-   Docker & Docker Compose
+
+### 2. Environment Setup
+Copy the example environment file and adjust the values as needed:
+```bash
+cp .env.example .env
+```
+
+### 3. Infrastructure & App Launch
+```bash
+# Initialize Git for security hooks
+git init
+
+# Install dependencies
+npm install
+
+# Start required services
+docker-compose up -d<% if (database !== 'None') { %> db<% } %><% if (caching === 'Redis') { %> redis<% } %><% if (communication === 'Kafka') { %> kafka<% } %>
+
+# Run the app in development mode
+npm run dev
+```
+
+### 4. Quality & Standards
+```bash
+# Lint & Format
+npm run lint
+npm run format
+
+# Run Unit/Integration Tests
+npm test
+npm run test:coverage
+```
+
+<% if (communication === 'Kafka') { -%>
+Microservices communication handled via **Kafka**.
+<% } else if (communication === 'GraphQL') { -%>
+API is exposed via **GraphQL**.
+The Apollo Sandbox UI for API exploration and documentation is available natively, fully embedded for offline development:
+- **URL**: `http://localhost:3000/graphql` (Dynamic based on PORT)
+If you are opening `http://localhost:3000/graphql` in your browser, you can directly run the following in the Apollo Sandbox UI:
+
+**Query to get all users:**
+```graphql
+query GetAllUsers {
+  getAllUsers {
+    id
+    name
+    email
+  }
+}
+```
+
+**Mutation to create a user:**
+```graphql
+mutation CreateUser {
+  createUser(name: "John Doe", email: "john@example.com") {
+    id
+    name
+    email
+  }
+}
+```
+
+**Mutation to update a user:**
+```graphql
+mutation UpdateUser {
+  updateUser(id: "1", name: "John Updated") {
+    id
+    name
+    email
+  }
+}
+```
+
+**Mutation to delete a user:**
+```graphql
+mutation DeleteUser {
+  deleteUser(id: "1")
+}
+```
+<% } else { -%>
+API is exposed via **REST**.
+A Swagger UI for API documentation is available at:
+- **URL**: `http://localhost:3000/api-docs` (Dynamic based on PORT)
+
+### 🛣️ User Endpoints:
+- `GET /api/users`: List all users.
+- `POST /api/users`: Create a new user.
+- `PATCH /api/users/:id`: Partially update a user.
+- `DELETE /api/users/:id`: Delete a user (Soft Delete).
+<%_ } -%>
+
+<% if (communication === 'Kafka') { -%>
+## 📡 Testing Kafka Asynchronous Flow
+This project demonstrates a production-ready Kafka flow:
+1. **Producer**: When a user is created via the API, a `USER_CREATED` event is sent to `user-topic`.
+2. **Consumer**: `WelcomeEmailConsumer` listens to `user-topic` and simulates sending an email.
+
+### How to verify:
+1. Ensure infrastructure is running: `docker-compose up -d<% if (database !== 'None') { %> db<% } %><% if (caching === 'Redis') { %> redis<% } %><% if (communication === 'Kafka') { %> kafka<% } %>`
+2. Start the app: `npm run dev`
+3. Trigger an event by creating a user (via Postman or curl):
+   ```bash
+   curl -X POST http://localhost:3000/api/users \
+     -H "Content-Type: application/json" \
+     -d '{"name": "Kafka Tester", "email": "kafka@example.com"}'
+   ```
+4. Observe the logs:
+   ```text
+   [Kafka] Producer: Sent USER_CREATED event for 'kafka@example.com'
+   [Kafka] Consumer: Received USER_CREATED. 
+   [Kafka] Consumer: 📧 Sending welcome email to 'kafka@example.com'... Done!
+   ```
+
+### 🛠️ Kafka Troubleshooting
+If the connection or events are failing:
+1. **Check Docker**: Ensure Kafka container is running (`docker ps`).
+2. **Verify Broker**: `KAFKA_BROKER` in `.env` must match your host/port (standard: 9093).
+3. **Advertised Listeners**: If using Windows/WSL, check `docker-compose.yml` advertisers are correct.
+4. **Logs**: Check `docker compose logs -f kafka` for start-up errors.
+<% } -%>
+
+<% if (caching === 'Redis') { -%>
+## ⚡ Caching
+This project uses **Redis** for caching.
+- **Client**: `ioredis`
+- **Connection**: Configured via `REDIS_HOST`, `REDIS_PORT`, `REDIS_PASSWORD` in `.env`.
+<% } else if (caching === 'Memory Cache') { -%>
+## ⚡ Caching
+This project uses **Memory Cache** for in-memory caching.
+- **Client**: `node-cache`
+<% } -%>
+
+## 📝 Logging
+This project uses **Winston** for structured logging.
+- **Development**: Logs are printed to the console.
+- **Production**: Logs are saved to files:
+  - `error.log`: Only error level logs.
+  - `combined.log`: All logs.
+
+## 🐳 Docker Deployment
+This project uses a **Multi-Stage Dockerfile** for optimized production images.
+
+<% if (database !== 'None' || caching === 'Redis' || communication === 'Kafka') { -%>
+### 1. Running Locally (Development)
+To run the Node.js application locally while using Docker for the infrastructure (Database, Redis, Kafka, etc.):
+
+```bash
+# Start infrastructure
+docker-compose up -d<% if (database !== 'None') { %> db<% } %><% if (caching === 'Redis') { %> redis<% } %><% if (communication === 'Kafka') { %> kafka<% } %>
+
+# Start the application
+npm run dev
+```
+
+### 2. Running the App Container with Compose Infrastructure
+If you want to run the application itself inside a Docker container while connecting to the infrastructure managed by your `docker-compose.yml`:
+
+```bash
+# First, ensure your infrastructure is running
+docker-compose up -d
+
+# Build Production Image
+docker build -t <%= projectName %> .
+
+# Run Container (attached to the compose network)
+docker run -p 3000:3000 --network <%= projectName %>_default \
+<% if (database !== 'None') { -%>
+  -e DB_HOST=db \
+<% } -%>
+<% if (caching === 'Redis') { -%>
+  -e REDIS_HOST=redis \
+<% } -%>
+<% if (communication === 'Kafka') { -%>
+  -e KAFKA_BROKER=kafka:29092 \
+<% } -%>
+  <%= projectName %>
+```
+<% } else { -%>
+```bash
+# Build Production Image
+docker build -t <%= projectName %> .
+
+# Run Container
+docker run -p 3000:3000 <%= projectName %>
+```
+<% } -%>
+## 🚀 PM2 Deployment (VPS/EC2)
+This project is pre-configured for direct deployment to a VPS/EC2 instance using **PM2** (via `ecosystem.config.js`).
+1. Install dependencies
+```bash
+npm install
+```
+2. **Start Infrastructure (DB, Redis, Kafka, etc.) in the background**
+*(This specifically starts the background services without running the application inside Docker, allowing PM2 to handle it).*
+```bash
+docker-compose up -d<% if (database !== 'None') { %> db<% } %><% if (caching === 'Redis') { %> redis<% } %><% if (communication === 'Kafka') { %> kafka<% } %>
+```
+3. **Wait 5-10s** for the database to fully initialize.
+4. **Deploy the App using PM2 in Cluster Mode**
+```bash
+<% if (language === 'TypeScript') { %>npm run build
+<% } %>npm run deploy
+```
+5. **Check logs**
+```bash
+npx pm2 logs
+```
+6. Stop and remove the PM2 application
+```bash
+npx pm2 delete <%= projectName %>
+```
+7. Stop and remove the Docker infrastructure
+```bash
+docker-compose down
+```
+
+## 🔒 Security Features
+-   **Helmet**: Sets secure HTTP headers.
+-   **CORS**: Configured for cross-origin requests.
+-   **Rate Limiting**: Protects against DDoS / Brute-force.
+-   **HPP**: Prevents HTTP Parameter Pollution attacks.
+<% if (includeSecurity) { %>
+### 🛡️ Enterprise Hardening (Big Tech Standard)
+-   **Snyk SCA**: Run `npm run snyk:test` for dependency scanning.
+-   **SonarCloud**: Automated SAST on every Push/PR.
+-   **Digital Guardians**: Recommended Gitleaks integration for secret protection.
+-   **Security Policy**: Standard `SECURITY.md` for vulnerability reporting.
+<% } %>
+## 🤖 AI-Native Development
+
+This project is "AI-Ready" out of the box. We have pre-configured industry-leading AI context files to bridge the gap between "Generated Code" and "AI-Assisted Development."
+
+- **Magic Defaults**: We've automatically tailored your AI context to focus on **<%= projectName %>** and its specific architectural stack (<%= architecture %>, <%= database %>, etc.).
+- **Use Cursor?** We've configured **`.cursorrules`** at the root. It enforces project standards (80% coverage, MVC/Clean) directly within the editor. 
+  - *Pro-tip*: You can customize the `Project Goal` placeholder in `.cursorrules` to help the AI understand your specific business logic!
 - **Use ChatGPT/Gemini/Claude?** Check the **`prompts/`** directory. It contains highly-specialized Agent Skill templates. You can copy-paste these into any LLM to give it a "Senior Developer" understanding of your codebase immediately.

package/templates/common/caching/clean/js/DeleteUser.js.ejs

@@ -0,0 +1,27 @@
+<%_ if (caching === 'Redis') { -%>
+const cacheService = require('../infrastructure/caching/redisClient');
+<%_ } else if (caching === 'Memory Cache') { -%>
+const cacheService = require('../infrastructure/caching/memoryCache');
+<%_ } -%>
+const logger = require('../infrastructure/log/logger');
+
+class DeleteUser {
+    constructor(userRepository) {
+        this.userRepository = userRepository;
+    }
+
+    async execute(id) {
+        const result = await this.userRepository.delete(id);
+
+        try {
+            await cacheService.del('users:all');
+            logger.info('Invalidated users:all cache');
+        } catch (error) {
+             logger.error('Cache error (del):', error);
+        }
+
+        return result;
+    }
+}
+
+module.exports = DeleteUser;