phos 1.2.1 → 1.3.1

package/README.md

@@ -10,7 +10,7 @@ Full-stack interactive project generator CLI
 [![Node.js Version](https://img.shields.io/node/v/phos)](https://nodejs.org)
 [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](http://makeapullrequest.com)
 
-**Version 1.2.1 - Production Release** 🎉
+**Version 1.3.1 - Production Release** 🎉
 
 [View on npmjs.com](https://www.npmjs.com/package/phos)
 
@@ -25,12 +25,12 @@ Phos is a powerful CLI tool that scaffolds modern full-stack web applications wi
 ## Features
 
 - ✨ Interactive CLI with beautiful prompts
-- 🚀 Multiple backend frameworks (Elysia, FastAPI)
-- 🎨 Multiple frontend frameworks (Astro, Svelte, Next.js)
+- 🚀 Multiple backend frameworks (Elysia, FastAPI, NestJS)
+- 🎨 Multiple frontend frameworks (Astro, Svelte, Next.js, Vue)
 - 📦 Monorepo support with workspace configuration
 - 🛠️ Configurable tooling (TypeScript, ESLint, Prettier)
 - 🎨 CSS framework options (Tailwind, SCSS, CSS Modules)
-- 🧩 UI component library support (shadcn/ui, Radix UI)
+- 🧩 UI component library support (Ant Design, shadcn/ui, Radix UI, Vuetify)
 - 🧪 Testing framework options (Vitest, Playwright)
 - 🔤 Multiple package manager support (npm, yarn, pnpm, bun)
 - 📝 Automatic README generation
@@ -64,6 +64,7 @@ Phos is a powerful CLI tool that scaffolds modern full-stack web applications wi
 | ---------------------------------------- | ------- | ---------------------------------- |
 | [Elysia](https://elysiajs.com/)          | Bun     | Fast and elegant Bun web framework |
 | [FastAPI](https://fastapi.tiangolo.com/) | Python  | Modern Python web framework        |
+| [NestJS](https://nestjs.com/)           | Node.js | Progressive Node.js framework with TypeScript |
 
 #### Frontend
 
@@ -72,6 +73,7 @@ Phos is a powerful CLI tool that scaffolds modern full-stack web applications wi
 | [Astro](https://astro.build/)        | Modern static site generator           |
 | [SvelteKit](https://kit.svelte.dev/) | Full-stack Svelte framework            |
 | [Next.js](https://nextjs.org/)       | React framework with server components |
+| [Vue](https://vuejs.org/)            | Progressive JavaScript framework       |
 
 ## Quick Start
 
@@ -131,14 +133,13 @@ Phos will guide you through a series of questions to configure your project:
 5. **Backend: Use TypeScript?** - Enable TypeScript for backend
 6. **Backend: Add ESLint?** - Add ESLint configuration
 7. **Backend: Add Prettier?** - Add Prettier configuration
-8. **Frontend Framework** - Astro, Svelte, or Next.js
+8. **Frontend Framework** - Astro, Svelte, Next.js, or Vue
 9. **Frontend Package Manager** - npm, yarn, pnpm, or bun
 10. **Frontend: Use TypeScript?** - Enable TypeScript for frontend
 11. **Frontend: Add ESLint?** - Add ESLint configuration
 12. **Frontend: Add Prettier?** - Add Prettier configuration
 13. **Select CSS Framework** - No, Tailwind CSS, SCSS, or CSS Modules
-14. **Add UI Components?** - No, shadcn/ui, or Radix UI
-15. **Add Testing?** - No, Vitest, Playwright, or both
+14. **Add Testing?** - No, Vitest, Playwright, or both
 16. **Initialize Git?** - Initialize a Git repository
 17. **Install Dependencies?** - Auto-install dependencies after generation
 
@@ -209,7 +210,6 @@ npx phos create
 # Frontend: Add ESLint? Yes
 # Frontend: Add Prettier? Yes
 # CSS Framework: Tailwind CSS
-# UI Components: shadcn/ui
 # Testing: Vitest + Playwright
 # Initialize Git? Yes
 # Install dependencies? No
@@ -227,7 +227,6 @@ bunx phos create
 # Add ESLint? Yes
 # Add Prettier? Yes
 # CSS Framework: Tailwind CSS
-# UI Components: No
 # Testing: Vitest
 # Initialize Git? Yes
 # Install dependencies? No
@@ -278,6 +277,8 @@ Contributions are welcome! Please feel free to submit a Pull Request.
 
 Phos follows [semantic versioning](https://semver.org/).
 
+- **1.3.1** - Patch release (Vue frontend support, documentation updates)
+- **1.3.0** - Minor release (NestJS backend support)
 - **1.2.1** - Patch release (TypeScript type fix)
 - **1.2.0** - Minor release (backend API architecture)
 - **1.1.0** - Minor release (new features, non-breaking changes)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "phos",
-  "version": "1.2.1",
+  "version": "1.3.1",
   "description": "Full-stack interactive project generator CLI - Phos",
   "type": "module",
   "bin": {

package/src/templates/backend/nestjs/.env.example

@@ -0,0 +1,15 @@
+# Server
+PORT=3000
+
+# Database
+DATABASE_HOST=localhost
+DATABASE_PORT=5432
+DATABASE_USERNAME=postgres
+DATABASE_PASSWORD=postgres
+DATABASE_NAME=nestjs_db
+DATABASE_SYNCHRONIZE=false
+DATABASE_LOGGING=false
+
+# JWT
+JWT_SECRET=your-secret-key-change-this-in-production
+JWT_EXPIRATION=1d

package/src/templates/backend/nestjs/.prettierrc

@@ -0,0 +1,4 @@
+{
+  "singleQuote": true,
+  "trailingComma": "all"
+}

package/src/templates/backend/nestjs/README.md

@@ -0,0 +1,98 @@
+<p align="center">
+  <a href="http://nestjs.com/" target="blank"><img src="https://nestjs.com/img/logo-small.svg" width="120" alt="Nest Logo" /></a>
+</p>
+
+[circleci-image]: https://img.shields.io/circleci/build/github/nestjs/nest/master?token=abc123def456
+[circleci-url]: https://circleci.com/gh/nestjs/nest
+
+  <p align="center">A progressive <a href="http://nodejs.org" target="_blank">Node.js</a> framework for building efficient and scalable server-side applications.</p>
+    <p align="center">
+<a href="https://www.npmjs.com/~nestjscore" target="_blank"><img src="https://img.shields.io/npm/v/@nestjs/core.svg" alt="NPM Version" /></a>
+<a href="https://www.npmjs.com/~nestjscore" target="_blank"><img src="https://img.shields.io/npm/l/@nestjs/core.svg" alt="Package License" /></a>
+<a href="https://www.npmjs.com/~nestjscore" target="_blank"><img src="https://img.shields.io/npm/dm/@nestjs/common.svg" alt="NPM Downloads" /></a>
+<a href="https://circleci.com/gh/nestjs/nest" target="_blank"><img src="https://img.shields.io/circleci/build/github/nestjs/nest/master" alt="CircleCI" /></a>
+<a href="https://discord.gg/G7Qnnhy" target="_blank"><img src="https://img.shields.io/badge/discord-online-brightgreen.svg" alt="Discord"/></a>
+<a href="https://opencollective.com/nest#backer" target="_blank"><img src="https://opencollective.com/nest/backers/badge.svg" alt="Backers on Open Collective" /></a>
+<a href="https://opencollective.com/nest#sponsor" target="_blank"><img src="https://opencollective.com/nest/sponsors/badge.svg" alt="Sponsors on Open Collective" /></a>
+  <a href="https://paypal.me/kamilmysliwiec" target="_blank"><img src="https://img.shields.io/badge/Donate-PayPal-ff3f59.svg" alt="Donate us"/></a>
+    <a href="https://opencollective.com/nest#sponsor"  target="_blank"><img src="https://img.shields.io/badge/Support%20us-Open%20Collective-41B883.svg" alt="Support us"></a>
+  <a href="https://twitter.com/nestframework" target="_blank"><img src="https://img.shields.io/twitter/follow/nestframework.svg?style=social&label=Follow" alt="Follow us on Twitter"></a>
+</p>
+  <!--[![Backers on Open Collective](https://opencollective.com/nest/backers/badge.svg)](https://opencollective.com/nest#backer)
+  [![Sponsors on Open Collective](https://opencollective.com/nest/sponsors/badge.svg)](https://opencollective.com/nest#sponsor)-->
+
+## Description
+
+[Nest](https://github.com/nestjs/nest) framework TypeScript starter repository.
+
+## Project setup
+
+```bash
+$ npm install
+```
+
+## Compile and run the project
+
+```bash
+# development
+$ npm run start
+
+# watch mode
+$ npm run start:dev
+
+# production mode
+$ npm run start:prod
+```
+
+## Run tests
+
+```bash
+# unit tests
+$ npm run test
+
+# e2e tests
+$ npm run test:e2e
+
+# test coverage
+$ npm run test:cov
+```
+
+## Deployment
+
+When you're ready to deploy your NestJS application to production, there are some key steps you can take to ensure it runs as efficiently as possible. Check out the [deployment documentation](https://docs.nestjs.com/deployment) for more information.
+
+If you are looking for a cloud-based platform to deploy your NestJS application, check out [Mau](https://mau.nestjs.com), our official platform for deploying NestJS applications on AWS. Mau makes deployment straightforward and fast, requiring just a few simple steps:
+
+```bash
+$ npm install -g @nestjs/mau
+$ mau deploy
+```
+
+With Mau, you can deploy your application in just a few clicks, allowing you to focus on building features rather than managing infrastructure.
+
+## Resources
+
+Check out a few resources that may come in handy when working with NestJS:
+
+- Visit the [NestJS Documentation](https://docs.nestjs.com) to learn more about the framework.
+- For questions and support, please visit our [Discord channel](https://discord.gg/G7Qnnhy).
+- To dive deeper and get more hands-on experience, check out our official video [courses](https://courses.nestjs.com/).
+- Deploy your application to AWS with the help of [NestJS Mau](https://mau.nestjs.com) in just a few clicks.
+- Visualize your application graph and interact with the NestJS application in real-time using [NestJS Devtools](https://devtools.nestjs.com).
+- Need help with your project (part-time to full-time)? Check out our official [enterprise support](https://enterprise.nestjs.com).
+- To stay in the loop and get updates, follow us on [X](https://x.com/nestframework) and [LinkedIn](https://linkedin.com/company/nestjs).
+- Looking for a job, or have a job to offer? Check out our official [Jobs board](https://jobs.nestjs.com).
+
+## Support
+
+Nest is an MIT-licensed open source project. It can grow thanks to the sponsors and support by the amazing backers. If you'd like to join them, please [read more here](https://docs.nestjs.com/support).
+
+## Stay in touch
+
+- Author - [Kamil Myśliwiec](https://twitter.com/kammysliwiec)
+- Website - [https://nestjs.com](https://nestjs.com/)
+- Twitter - [@nestframework](https://twitter.com/nestframework)
+
+## License
+
+Nest is [MIT licensed](https://github.com/nestjs/nest/blob/master/LICENSE).

package/src/templates/backend/nestjs/eslint.config.mjs

@@ -0,0 +1,35 @@
+// @ts-check
+import eslint from '@eslint/js';
+import eslintPluginPrettierRecommended from 'eslint-plugin-prettier/recommended';
+import globals from 'globals';
+import tseslint from 'typescript-eslint';
+
+export default tseslint.config(
+  {
+    ignores: ['eslint.config.mjs'],
+  },
+  eslint.configs.recommended,
+  ...tseslint.configs.recommendedTypeChecked,
+  eslintPluginPrettierRecommended,
+  {
+    languageOptions: {
+      globals: {
+        ...globals.node,
+        ...globals.jest,
+      },
+      sourceType: 'commonjs',
+      parserOptions: {
+        projectService: true,
+        tsconfigRootDir: import.meta.dirname,
+      },
+    },
+  },
+  {
+    rules: {
+      '@typescript-eslint/no-explicit-any': 'off',
+      '@typescript-eslint/no-floating-promises': 'warn',
+      '@typescript-eslint/no-unsafe-argument': 'warn',
+      "prettier/prettier": ["error", { endOfLine: "auto" }],
+    },
+  },
+);

package/src/templates/backend/nestjs/nest-cli.json

@@ -0,0 +1,8 @@
+{
+  "$schema": "https://json.schemastore.org/nest-cli",
+  "collection": "@nestjs/schematics",
+  "sourceRoot": "src",
+  "compilerOptions": {
+    "deleteOutDir": true
+  }
+}

package/src/templates/backend/nestjs/package.json

@@ -0,0 +1,78 @@
+{
+  "name": "nestjs",
+  "version": "0.0.1",
+  "description": "",
+  "author": "",
+  "private": true,
+  "license": "UNLICENSED",
+  "scripts": {
+    "build": "nest build",
+    "start": "nest start",
+    "start:dev": "nest start --watch",
+    "start:debug": "nest start --debug --watch",
+    "start:prod": "node dist/main",
+    "lint": "eslint \"{src,apps,libs,test}/**/*.ts\" --fix",
+    "format": "prettier --write \"src/**/*.ts\" \"test/**/*.ts\""
+  },
+  "dependencies": {
+    "@nestjs/common": "^11.0.1",
+    "@nestjs/core": "^11.0.1",
+    "@nestjs/platform-express": "^11.0.1",
+    "@nestjs/config": "^4.0.1",
+    "@nestjs/jwt": "^10.2.3",
+    "@nestjs/passport": "^11.0.6",
+    "@nestjs/swagger": "^11.2.6",
+    "passport": "^0.7.0",
+    "passport-jwt": "^4.0.1",
+    "bcrypt": "^5.1.1",
+    "class-transformer": "^0.5.1",
+    "class-validator": "^0.14.1",
+    "pg": "^8.13.1",
+    "typeorm": "^0.3.20",
+    "uuid": "^11.0.3",
+    "reflect-metadata": "^0.2.2",
+    "rxjs": "^7.8.1"
+  },
+  "devDependencies": {
+    "@eslint/eslintrc": "^3.2.0",
+    "@eslint/js": "^9.18.0",
+    "@nestjs/cli": "^11.0.0",
+    "@nestjs/schematics": "^11.0.0",
+    "@nestjs/testing": "^11.0.1",
+    "@types/express": "^5.0.0",
+    "@types/jest": "^30.0.0",
+    "@types/node": "^22.10.7",
+    "@types/supertest": "^6.0.2",
+    "eslint": "^9.18.0",
+    "eslint-config-prettier": "^10.0.1",
+    "eslint-plugin-prettier": "^5.2.2",
+    "globals": "^16.0.0",
+    "jest": "^30.0.0",
+    "prettier": "^3.4.2",
+    "source-map-support": "^0.5.21",
+    "supertest": "^7.0.0",
+    "ts-jest": "^29.2.5",
+    "ts-loader": "^9.5.2",
+    "ts-node": "^10.9.2",
+    "tsconfig-paths": "^4.2.0",
+    "typescript": "^5.7.3",
+    "typescript-eslint": "^8.20.0"
+  },
+  "jest": {
+    "moduleFileExtensions": [
+      "js",
+      "json",
+      "ts"
+    ],
+    "rootDir": "src",
+    "testRegex": ".*\\.spec\\.ts$",
+    "transform": {
+      "^.+\\.(t|j)s$": "ts-jest"
+    },
+    "collectCoverageFrom": [
+      "**/*.(t|j)s"
+    ],
+    "coverageDirectory": "../coverage",
+    "testEnvironment": "node"
+  }
+}

package/src/templates/backend/nestjs/src/app.controller.spec.ts

@@ -0,0 +1,22 @@
+import { Test, TestingModule } from '@nestjs/testing';
+import { AppController } from './app.controller';
+import { AppService } from './app.service';
+
+describe('AppController', () => {
+  let appController: AppController;
+
+  beforeEach(async () => {
+    const app: TestingModule = await Test.createTestingModule({
+      controllers: [AppController],
+      providers: [AppService],
+    }).compile();
+
+    appController = app.get<AppController>(AppController);
+  });
+
+  describe('root', () => {
+    it('should return "Hello World!"', () => {
+      expect(appController.getHello()).toBe('Hello World!');
+    });
+  });
+});

package/src/templates/backend/nestjs/src/app.controller.ts

@@ -0,0 +1,12 @@
+import { Controller, Get } from '@nestjs/common';
+import { AppService } from './app.service';
+
+@Controller()
+export class AppController {
+  constructor(private readonly appService: AppService) {}
+
+  @Get()
+  getHello(): string {
+    return this.appService.getHello();
+  }
+}

package/src/templates/backend/nestjs/src/app.module.ts

@@ -0,0 +1,34 @@
+import { Module } from '@nestjs/common';
+import { ConfigModule, ConfigService } from '@nestjs/config';
+import { TypeOrmModule } from '@nestjs/typeorm';
+import { AppController } from './app.controller';
+import { AppService } from './app.service';
+import { User } from './user/user.entity';
+import { UserModule } from './user/user.module';
+
+@Module({
+  imports: [
+    ConfigModule.forRoot({ isGlobal: true }),
+    TypeOrmModule.forRootAsync({
+      imports: [ConfigModule],
+      useFactory: async (configService: ConfigService) => ({
+        type: 'postgres',
+        host: configService.get('DATABASE_HOST', 'localhost'),
+        port: configService.get('DATABASE_PORT', 5432),
+        username: configService.get('DATABASE_USERNAME', 'postgres'),
+        password: configService.get('DATABASE_PASSWORD', 'postgres'),
+        database: configService.get('DATABASE_NAME', 'nestjs_db'),
+        entities: [User],
+        synchronize: configService.get('DATABASE_SYNCHRONIZE', 'false') === 'true',
+        logging: configService.get('DATABASE_LOGGING', 'false') === 'true',
+      }),
+      inject: [ConfigService],
+    }),
+    UserModule,
+  ],
+  controllers: [AppController],
+  providers: [AppService],
+})
+export class AppModule {
+  constructor(private dataSource: any) {}
+}

package/src/templates/backend/nestjs/src/app.service.ts

@@ -0,0 +1,8 @@
+import { Injectable } from '@nestjs/common';
+
+@Injectable()
+export class AppService {
+  getHello(): string {
+    return 'Hello World!';
+  }
+}

package/src/templates/backend/nestjs/src/main.ts

@@ -0,0 +1,34 @@
+import { NestFactory } from '@nestjs/core';
+import { ValidationPipe } from '@nestjs/common';
+import { SwaggerModule, DocumentBuilder } from '@nestjs/swagger';
+import { AppModule } from './app.module';
+
+async function bootstrap() {
+  const app = await NestFactory.create(AppModule);
+
+  app.useGlobalPipes(
+    new ValidationPipe({
+      whitelist: true,
+      forbidNonWhitelisted: true,
+      transform: true,
+    }),
+  );
+
+  const config = new DocumentBuilder()
+    .setTitle('NestJS API')
+    .setDescription('NestJS backend API with TypeORM and PostgreSQL')
+    .setVersion('1.0')
+    .addTag('users')
+    .addBearerAuth()
+    .build();
+
+  SwaggerModule.setup('api', app, config);
+
+  const port = process.env.PORT || 3000;
+  await app.listen(port);
+
+  console.log(`🚀 Application is running on: http://localhost:${port}`);
+  console.log(`📚 Swagger documentation available at: http://localhost:${port}/api`);
+}
+
+bootstrap();

package/src/templates/backend/nestjs/src/user/dto/create-user.dto.ts

@@ -0,0 +1,40 @@
+import { IsEmail, IsString, IsNotEmpty, IsOptional, MinLength, MaxLength, IsBoolean } from 'class-validator';
+
+export class CreateUserDto {
+  @IsEmail()
+  @IsNotEmpty()
+  email: string;
+
+  @IsString()
+  @MinLength(3)
+  @MaxLength(100)
+  @IsNotEmpty()
+  username: string;
+
+  @IsString()
+  @MinLength(1)
+  @MaxLength(255)
+  @IsNotEmpty()
+  fullName: string;
+
+  @IsString()
+  @MinLength(6)
+  @MaxLength(255)
+  @IsNotEmpty()
+  password: string;
+
+  @IsOptional()
+  @IsString()
+  @MaxLength(1000)
+  avatarUrl?: string;
+
+  @IsOptional()
+  @IsString()
+  @MaxLength(1000)
+  bio?: string;
+
+  @IsOptional()
+  @IsString()
+  @MaxLength(50)
+  role?: string;
+}

package/src/templates/backend/nestjs/src/user/dto/update-user.dto.ts

@@ -0,0 +1,44 @@
+import { IsEmail, IsString, IsOptional, MinLength, MaxLength, IsBoolean } from 'class-validator';
+
+export class UpdateUserDto {
+  @IsOptional()
+  @IsEmail()
+  email?: string;
+
+  @IsOptional()
+  @IsString()
+  @MinLength(3)
+  @MaxLength(100)
+  username?: string;
+
+  @IsOptional()
+  @IsString()
+  @MinLength(1)
+  @MaxLength(255)
+  fullName?: string;
+
+  @IsOptional()
+  @IsString()
+  @MinLength(6)
+  @MaxLength(255)
+  password?: string;
+
+  @IsOptional()
+  @IsString()
+  @MaxLength(1000)
+  avatarUrl?: string;
+
+  @IsOptional()
+  @IsString()
+  @MaxLength(1000)
+  bio?: string;
+
+  @IsOptional()
+  @IsString()
+  @MaxLength(50)
+  role?: string;
+
+  @IsOptional()
+  @IsBoolean()
+  isActive?: boolean;
+}

package/src/templates/backend/nestjs/src/user/user.controller.spec.ts

@@ -0,0 +1,20 @@
+import { Test, TestingModule } from '@nestjs/testing';
+import { UsersController } from './users.controller';
+import { UsersService } from './users.service';
+
+describe('UsersController', () => {
+  let controller: UsersController;
+
+  beforeEach(async () => {
+    const module: TestingModule = await Test.createTestingModule({
+      controllers: [UsersController],
+      providers: [UsersService],
+    }).compile();
+
+    controller = module.get<UsersController>(UsersController);
+  });
+
+  it('should be defined', () => {
+    expect(controller).toBeDefined();
+  });
+});

package/src/templates/backend/nestjs/src/user/user.controller.ts

@@ -0,0 +1,74 @@
+import { Controller, Get, Post, Put, Delete, Param, Body, HttpCode, HttpStatus, HttpException, ParseIntPipe } from '@nestjs/common';
+import { ApiTags, ApiOperation, ApiResponse, ApiBearerAuth } from '@nestjs/swagger';
+import { UserService } from './user.service';
+import { CreateUserDto } from './dto/create-user.dto';
+import { UpdateUserDto } from './dto/update-user.dto';
+
+@ApiTags('users')
+@Controller('users')
+export class UserController {
+  constructor(private readonly userService: UserService) {}
+
+  @Get()
+  @ApiOperation({ summary: 'Get all users' })
+  @ApiResponse({ status: 200, description: 'Returns all active users' })
+  async findAll() {
+    return this.userService.findAll();
+  }
+
+  @Get(':id')
+  @ApiOperation({ summary: 'Get user by ID' })
+  @ApiResponse({ status: 200, description: 'Returns user by ID' })
+  async findOne(@Param('id', ParseIntPipe) id: number) {
+    if (id <= 0) {
+      throw new HttpException('Invalid user ID', HttpStatus.BAD_REQUEST);
+    }
+    return this.userService.findOne(id);
+  }
+
+  @Get('search/:keyword')
+  @ApiOperation({ summary: 'Search users' })
+  @ApiResponse({ status: 200, description: 'Returns users matching the keyword' })
+  async search(@Param('keyword') keyword: string) {
+    return this.userService.search(keyword);
+  }
+
+  @Post()
+  @HttpCode(HttpStatus.CREATED)
+  @ApiOperation({ summary: 'Create a new user' })
+  @ApiResponse({ status: 201, description: 'User created successfully' })
+  async create(@Body() createUserDto: CreateUserDto) {
+    return this.userService.create(createUserDto);
+  }
+
+  @Put(':id')
+  @ApiOperation({ summary: 'Update a user' })
+  @ApiResponse({ status: 200, description: 'User updated successfully' })
+  async update(@Param('id', ParseIntPipe) id: number, @Body() updateUserDto: UpdateUserDto) {
+    if (id <= 0) {
+      throw new HttpException('Invalid user ID', HttpStatus.BAD_REQUEST);
+    }
+    return this.userService.update(id, updateUserDto);
+  }
+
+  @Delete(':id')
+  @HttpCode(HttpStatus.NO_CONTENT)
+  @ApiOperation({ summary: 'Delete a user' })
+  @ApiResponse({ status: 204, description: 'User deleted successfully' })
+  async remove(@Param('id', ParseIntPipe) id: number) {
+    if (id <= 0) {
+      throw new HttpException('Invalid user ID', HttpStatus.BAD_REQUEST);
+    }
+    return this.userService.remove(id);
+  }
+
+  @Post(':id/soft-delete')
+  @ApiOperation({ summary: 'Soft delete a user' })
+  @ApiResponse({ status: 200, description: 'User soft deleted successfully' })
+  async softDelete(@Param('id', ParseIntPipe) id: number) {
+    if (id <= 0) {
+      throw new HttpException('Invalid user ID', HttpStatus.BAD_REQUEST);
+    }
+    return this.userService.softDelete(id);
+  }
+}

package/src/templates/backend/nestjs/src/user/user.entity.ts

@@ -0,0 +1,37 @@
+import { Entity, PrimaryGeneratedColumn, Column, CreateDateColumn, UpdateDateColumn } from 'typeorm';
+
+@Entity()
+export class User {
+  @PrimaryGeneratedColumn()
+  id: number;
+
+  @Column({ unique: true })
+  email: string;
+
+  @Column({ unique: true })
+  username: string;
+
+  @Column()
+  fullName: string;
+
+  @Column()
+  password: string;
+
+  @Column({ nullable: true })
+  avatarUrl: string;
+
+  @Column({ nullable: true, type: 'text' })
+  bio: string;
+
+  @Column({ default: 'user' })
+  role: string;
+
+  @Column({ default: true })
+  isActive: boolean;
+
+  @CreateDateColumn({ name: 'created_at' })
+  createdAt: Date;
+
+  @UpdateDateColumn({ name: 'updated_at' })
+  updatedAt: Date;
+}

package/src/templates/backend/nestjs/src/user/user.module.ts

@@ -0,0 +1,13 @@
+import { Module } from '@nestjs/common';
+import { TypeOrmModule } from '@nestjs/typeorm';
+import { UserController } from './user.controller';
+import { UserService } from './user.service';
+import { User } from './user.entity';
+
+@Module({
+  imports: [TypeOrmModule.forFeature([User])],
+  controllers: [UserController],
+  providers: [UserService],
+  exports: [UserService],
+})
+export class UserModule {}

package/src/templates/backend/nestjs/src/user/user.service.spec.ts

@@ -0,0 +1,18 @@
+import { Test, TestingModule } from '@nestjs/testing';
+import { UsersService } from './users.service';
+
+describe('UsersService', () => {
+  let service: UsersService;
+
+  beforeEach(async () => {
+    const module: TestingModule = await Test.createTestingModule({
+      providers: [UsersService],
+    }).compile();
+
+    service = module.get<UsersService>(UsersService);
+  });
+
+  it('should be defined', () => {
+    expect(service).toBeDefined();
+  });
+});

package/src/templates/backend/nestjs/src/user/user.service.ts

@@ -0,0 +1,122 @@
+import { Injectable, NotFoundException, ConflictException } from '@nestjs/common';
+import { InjectRepository } from '@nestjs/typeorm';
+import { Repository, Like } from 'typeorm';
+import { User } from './user.entity';
+import { CreateUserDto } from './dto/create-user.dto';
+import { UpdateUserDto } from './dto/update-user.dto';
+import * as bcrypt from 'bcrypt';
+import { instanceToPlain, plainToInstance } from 'class-transformer';
+
+const SALT_ROUNDS = 10;
+
+@Injectable()
+export class UserService {
+  constructor(
+    @InjectRepository(User)
+    private readonly userRepository: Repository<User>,
+  ) {}
+
+  async findAll() {
+    return this.userRepository.find({
+      where: { isActive: true },
+      order: { createdAt: 'DESC' },
+    });
+  }
+
+  async findOne(id: number) {
+    const user = await this.userRepository.findOne({ where: { id } });
+    if (!user) {
+      throw new NotFoundException('User not found');
+    }
+    return user;
+  }
+
+  async findByEmail(email: string) {
+    return this.userRepository.findOne({ where: { email } });
+  }
+
+  async findByUsername(username: string) {
+    return this.userRepository.findOne({ where: { username } });
+  }
+
+  async create(createUserDto: CreateUserDto) {
+    const existingEmail = await this.findByEmail(createUserDto.email);
+    if (existingEmail) {
+      throw new ConflictException('User with this email already exists');
+    }
+
+    const existingUsername = await this.findByUsername(createUserDto.username);
+    if (existingUsername) {
+      throw new ConflictException('Username already taken');
+    }
+
+    const hashedPassword = await bcrypt.hash(createUserDto.password, SALT_ROUNDS);
+
+    const user = this.userRepository.create({
+      ...createUserDto,
+      password: hashedPassword,
+      avatarUrl: createUserDto.avatarUrl || null,
+      bio: createUserDto.bio || null,
+      role: createUserDto.role || 'user',
+      isActive: true,
+    });
+
+    return this.userRepository.save(user);
+  }
+
+  async update(id: number, updateUserDto: UpdateUserDto) {
+    const user = await this.findOne(id);
+
+    if (updateUserDto.email) {
+      const emailUser = await this.findByEmail(updateUserDto.email);
+      if (emailUser && emailUser.id !== id) {
+        throw new ConflictException('Email already in use');
+      }
+    }
+
+    if (updateUserDto.username) {
+      const usernameUser = await this.findByUsername(updateUserDto.username);
+      if (usernameUser && usernameUser.id !== id) {
+        throw new ConflictException('Username already taken');
+      }
+    }
+
+    const updateData: Partial<User> = {};
+
+    if (updateUserDto.email !== undefined) updateData.email = updateUserDto.email;
+    if (updateUserDto.username !== undefined) updateData.username = updateUserDto.username;
+    if (updateUserDto.fullName !== undefined) updateData.fullName = updateUserDto.fullName;
+    if (updateUserDto.password !== undefined) {
+      updateData.password = await bcrypt.hash(updateUserDto.password, SALT_ROUNDS);
+    }
+    if (updateUserDto.avatarUrl !== undefined) updateData.avatarUrl = updateUserDto.avatarUrl;
+    if (updateUserDto.bio !== undefined) updateData.bio = updateUserDto.bio;
+    if (updateUserDto.role !== undefined) updateData.role = updateUserDto.role;
+    if (updateUserDto.isActive !== undefined) updateData.isActive = updateUserDto.isActive;
+
+    Object.assign(user, updateData);
+    return this.userRepository.save(user);
+  }
+
+  async remove(id: number) {
+    const user = await this.findOne(id);
+    await this.userRepository.remove(user);
+  }
+
+  async softDelete(id: number) {
+    const user = await this.findOne(id);
+    user.isActive = false;
+    return this.userRepository.save(user);
+  }
+
+  async search(keyword: string) {
+    return this.userRepository.find({
+      where: [
+        { email: Like(`%${keyword}%`), isActive: true },
+        { username: Like(`%${keyword}%`), isActive: true },
+        { fullName: Like(`%${keyword}%`), isActive: true },
+      ],
+      order: { createdAt: 'DESC' },
+    });
+  }
+}

package/src/templates/backend/nestjs/test/app.e2e-spec.ts

@@ -0,0 +1,25 @@
+import { Test, TestingModule } from '@nestjs/testing';
+import { INestApplication } from '@nestjs/common';
+import request from 'supertest';
+import { App } from 'supertest/types';
+import { AppModule } from './../src/app.module';
+
+describe('AppController (e2e)', () => {
+  let app: INestApplication<App>;
+
+  beforeEach(async () => {
+    const moduleFixture: TestingModule = await Test.createTestingModule({
+      imports: [AppModule],
+    }).compile();
+
+    app = moduleFixture.createNestApplication();
+    await app.init();
+  });
+
+  it('/ (GET)', () => {
+    return request(app.getHttpServer())
+      .get('/')
+      .expect(200)
+      .expect('Hello World!');
+  });
+});

package/src/templates/backend/nestjs/test/jest-e2e.json

@@ -0,0 +1,9 @@
+{
+  "moduleFileExtensions": ["js", "json", "ts"],
+  "rootDir": ".",
+  "testEnvironment": "node",
+  "testRegex": ".e2e-spec.ts$",
+  "transform": {
+    "^.+\\.(t|j)s$": "ts-jest"
+  }
+}

package/src/templates/backend/nestjs/tsconfig.build.json

@@ -0,0 +1,4 @@
+{
+  "extends": "./tsconfig.json",
+  "exclude": ["node_modules", "test", "dist", "**/*spec.ts"]
+}

package/src/templates/backend/nestjs/tsconfig.json

@@ -0,0 +1,25 @@
+{
+  "compilerOptions": {
+    "module": "nodenext",
+    "moduleResolution": "nodenext",
+    "resolvePackageJsonExports": true,
+    "esModuleInterop": true,
+    "isolatedModules": true,
+    "declaration": true,
+    "removeComments": true,
+    "emitDecoratorMetadata": true,
+    "experimentalDecorators": true,
+    "allowSyntheticDefaultImports": true,
+    "target": "ES2023",
+    "sourceMap": true,
+    "outDir": "./dist",
+    "baseUrl": "./",
+    "incremental": true,
+    "skipLibCheck": true,
+    "strictNullChecks": true,
+    "forceConsistentCasingInFileNames": true,
+    "noImplicitAny": false,
+    "strictBindCallApply": false,
+    "noFallthroughCasesInSwitch": false
+  }
+}