majiayu000 NestJS Skill
Build production-ready NestJS modules with entities, DTOs, services, controllers.
When to Use
- Creating new domain modules
- Adding entities to existing modules
- Creating CRUD endpoints
- Database migrations
- API design
File Patterns
*.module.ts*.controller.ts*.service.ts*.entity.ts*.dto.ts
Quick Reference
Layer Responsibilities
| Layer | Responsibility |
|---|---|
| Controller | HTTP handling + Business logic |
| Service | Database access ONLY |
Service = Thin Data Access
Services contain ONLY database operations:
findById(),findByField()- return entity or nullfindAll()- return arrayssave(),softRemove(),restore()- mutations- NO exceptions, NO business logic
Controller = Business Logic
Controllers handle:
- HTTP routing and response formatting
- Business rule validation (duplicates, constraints)
- Exception throwing
- Calling service methods
Progressive Content
| File | When to Load |
|---|---|
knowledge/learnings.md |
Starting NestJS task |
knowledge/patterns.md |
Looking for examples |
knowledge/anti-patterns.md |
Reviewing code or fixing issues |
rules/conventions.md |
Writing new code |
Commands Added
| Command | Description |
|---|---|
/nestjs-scaffold [name] |
Create complete module with all files |
/nestjs-entity [name] |
Create TypeORM entity |
/nestjs-dto [name] |
Create DTO with validation |
/nestjs-migration [name] |
Generate database migration |
/nestjs-db migrate |
Run pending migrations |
/nestjs-db seed |
Run seed data |
Module Structure
src/{module}/
├── entities/
│ ├── {entity-name}.entity.ts
│ └── index.ts
├── dto/
│ ├── create-{entity}.dto.ts
│ ├── update-{entity}.dto.ts
│ └── index.ts
├── {module}.service.ts
├── {module}.controller.ts
└── {module}.module.ts
Templates
See templates/ directory for:
entity.template.ts- TypeORM entitydto.template.ts- DTOs with validationservice.template.ts- Data access servicecontroller.template.ts- REST controllermodule.template.ts- NestJS modulemigration.template.ts- Database migration