Skip to main content

Kế Hoạch Tái Cấu Trúc Học Liệu NestJS

Bối Cảnh & Vấn Đề​

Khoá học NestJS hiện tại trong docs/nestjs/ có 4 phần với tổng cộng 22 files được tạo bởi AI, chưa được kiểm chứng bởi bất kỳ nguồn uy tín nào. Nguồn tham chiếu chính thức sources/documentations/docs.nestjs.com/ đã được crawl đầy đủ và chứa 90+ files gốc từ docs.nestjs.com.

Mục tiêu: Rebuild toàn bộ học liệu theo scope đầy đủ — cover từ Fundamentals → Techniques → GraphQL → Microservices → WebSocket → OpenAPI. Lấy nguồn chính thức làm nền, giữ lại văn phong sư phạm của Anh Tú.

Quyết Định Đã Xác Nhận​

#Câu hỏiQuyết định
1Xử lý files AI-gen cũOption B — Verify & Keep cẩn thận. Giữ file chất lượng cao, cross-check từng claim với nguồn
2Scope khoá họcFull coverage — REST API + GraphQL + Microservices + WebSocket + OpenAPI
3Thứ tự thực thiVerify existing trước → Build new content theo module

Nguyên Tắc Tái Cấu Trúc​

[!IMPORTANT] Source-First: Mọi nội dung phải có nguồn trực tiếp từ sources/documentations/docs.nestjs.com/. Ghi rõ source_file trong frontmatter của từng bài.

[!NOTE] Preserve Style: Giữ nguyên văn phong sư phạm: Hook → Analogy → Deep Dive → Code Example → Pitfalls → Tổng kết. Các file chất lượng cao (như 04-aop.mdx) → verify + giữ lại.

[!WARNING] Verify Rule: Khi giữ lại file AI-gen, mỗi code example và mỗi claim kỹ thuật phải được đánh dấu trạng thái: ✅ verified, ⚠️ needs-update, hoặc ❌ incorrect.

Bảng Tham Chiếu Nội Dung & Nguồn​

📦 Group 1: Getting Started​

#Bài học (docs/nestjs)File nguồn (sources/…)SizeTrạng thái hiện tại
00.1Tại Sao Chọn NestJS?index.md4KB❌ Chưa có
00.2Cài Đặt & First Stepsfirst-steps.md8KB❌ Chưa có
00.3Làm Chủ NestJS CLIcli/overview.md + cli/usages.md + cli/scripts.md23KB❌ Chưa có
00.4Standalone App & Deploystandalone-applications.md + deployment.md24KB❌ Chưa có

📦 Group 2: OOP Foundation (Verify & Keep)​

#Bài học (docs/nestjs)File nguồn (sources/…)SizeTrạng thái hiện tại
01.1OOP Foundation01-oop/01-foundation.md~15KB✅ Rebuilt & Verified (Chuẩn create-tech-lecture)
01.2Encapsulation & Decorators01-oop/02-encapsulation-decorators.md~16KB✅ Rebuilt & Verified (Chuẩn create-tech-lecture)
01.3Interface & Abstract01-oop/03-interface-abstract.md~16KB✅ Rebuilt & Verified (Chuẩn create-tech-lecture)
01.4Dependency Injection01-oop/04-dependency-injection.md~18KB✅ Rebuilt & Verified (Chuẩn create-tech-lecture)
01.5SOLID Principles01-oop/05-solid.md~18KB✅ Rebuilt & Verified (Chuẩn create-tech-lecture)
01.6Design Patterns01-oop/06-design-patterns.md~18KB✅ Rebuilt & Verified (Chuẩn create-tech-lecture)

📦 Group 3: Building Blocks — HTTP Layer (Rebuild)​

#Bài học (docs/nestjs)File nguồn (sources/…)SizeTrạng thái hiện tại
02.1Modulesmodules.md13KB✅ Đã xây dựng 01-modules.mdx
02.2Controllerscontrollers.md27KB✅ Đã xây dựng 02-controllers.mdx
02.3Providersproviders.md10KB✅ Đã xây dựng 03-providers.mdx
02.4Middlewaremiddleware.md12KB✅ Đã xây dựng 04-middleware.mdx

📦 Group 4: Core Fundamentals — IoC & DI (Rebuild)​

#Bài học (docs/nestjs)File nguồn (sources/…)SizeTrạng thái hiện tại
03.1Custom Providersfundamentals/custom-providers.md17KB❌ Rebuild (hiện có 03-dynamic-module.mdx sai scope)
03.2Dynamic Modulesfundamentals/dynamic-modules.md29KB❌ Rebuild
03.3Injection Scopesfundamentals/injection-scopes.md14KB❌ Chưa có
03.4Circular Dependencyfundamentals/circular-dependency.md4KB❌ Chưa có
03.5Module Referencefundamentals/module-ref.md9KB❌ Chưa có
03.6Lazy Loading Modulesfundamentals/lazy-loading-modules.md7KB❌ Chưa có
03.7Execution Contextfundamentals/execution-context.md15KB❌ Chưa có
03.8Lifecycle Eventsfundamentals/lifecycle-events.md8KB❌ Chưa có
03.9Async Providersfundamentals/async-providers.md2KB❌ Chưa có
03.10Discovery Servicefundamentals/discovery-service.md5KB❌ Chưa có

📦 Group 5: AOP Pipeline (Verify & Keep + Bổ Sung)​

#Bài học (docs/nestjs)File nguồn (sources/…)SizeTrạng thái hiện tại
04.0AOP Overview & Request Lifecycle02-core-concepts/04-aop.mdx (AI-gen)29KB✅ Đã Verify và đổi tên thành 01-aop-overview.mdx
04.1Guardsguards.md + microservices/guards.md + websockets/guards.md14KB✅ Đã xây dựng 02-guards.mdx
04.2Interceptorsinterceptors.md + microservices/interceptors.md16KB✅ Đã xây dựng 03-interceptors.mdx
04.3Pipespipes.md + microservices/pipes.md25KB✅ Đã xây dựng 04-pipes.mdx
04.4Exception Filtersexception-filters.md + microservices/exception-filters.md19KB✅ Đã Rebuild thành 05-exception-filters.mdx
04.5Custom Decoratorscustom-decorators.md8KB✅ Đã xây dựng 06-custom-decorators.mdx

📦 Group 6: Techniques — Kỹ Thuật Thực Chiến (Mới hoàn toàn)​

#Bài học (docs/nestjs)File nguồn (sources/…)SizeTrạng thái hiện tại
05.1Configurationtechniques/configuration.md30KB❌ Chưa có
05.2Validationtechniques/validation.md17KB❌ Chưa có
05.3Database (TypeORM)techniques/database.md + recipes/sql-typeorm.md45KB+5KB❌ Chưa có
05.4Database (MongoDB)techniques/mongodb.md26KB❌ Chưa có
05.5Database (MikroORM)recipes/mikroorm.md10KB❌ Chưa có
05.6Cachingtechniques/caching.md13KB❌ Chưa có
05.7Serializationtechniques/serialization.md8KB❌ Chưa có
05.8Versioningtechniques/versioning.md12KB❌ Chưa có
05.9Task Schedulingtechniques/task-scheduling.md16KB❌ Chưa có
05.10Queues (Bull/BullMQ)techniques/queues.md45KB❌ Chưa có
05.11Loggertechniques/logger.md + 03-tooling/02-logger.md (AI-gen)21KB⚠️ Có bài AI-gen → Verify + Rebuild từ nguồn
05.12File Uploadtechniques/file-upload.md13KB❌ Chưa có
05.13HTTP Moduletechniques/http-module.md7KB❌ Chưa có
05.14MVCtechniques/mvc.md7KB❌ Chưa có
05.15Server-Sent Eventstechniques/server-sent-events.md4KB❌ Chưa có
05.16Streaming Filestechniques/streaming-files.md4KB❌ Chưa có
05.17Eventstechniques/events.md7KB❌ Chưa có
05.18Compressiontechniques/compression.md3KB❌ Chưa có
05.19Performance (Fastify)techniques/performance.md6KB❌ Chưa có
05.20Cookies & Sessiontechniques/cookies.md + techniques/session.md11KB❌ Chưa có
05.21Hot Reload (SWC)recipes/hot-reload.md + recipes/swc.md20KB❌ Chưa có
05.22Debug với VSCode03-tooling/01-debug-vscode.mdx (AI-gen)8KB⚠️ Có bài AI-gen → Verify
05.23CRUD Generatorrecipes/crud-generator.md6KB❌ Chưa có
05.24REPL Moderecipes/repl.md5KB❌ Chưa có

📦 Group 7: Security (Mới hoàn toàn)​

#Bài học (docs/nestjs)File nguồn (sources/…)SizeTrạng thái hiện tại
06.1Authentication (Passport)security/authentication.md + recipes/passport.md21KB+46KB❌ Chưa có
06.2Authorization (RBAC/ABAC)security/authorization.md19KB❌ Chưa có
06.3Encryption & Hashingsecurity/encryption-and-hashing.md3KB❌ Chưa có
06.4CORSsecurity/cors.md2KB❌ Chưa có
06.5CSRF Protectionsecurity/csrf.md2KB❌ Chưa có
06.6Helmetsecurity/helmet.md4KB❌ Chưa có
06.7Rate Limitingsecurity/rate-limiting.md15KB❌ Chưa có

📦 Group 8: GraphQL (Mới hoàn toàn)​

#Bài học (docs/nestjs)File nguồn (sources/…)SizeTrạng thái hiện tại
07.1Quick Start (Code-first vs Schema-first)graphql/quick-start.md18KB❌ Chưa có
07.2Resolversgraphql/resolvers.md30KB❌ Chưa có
07.3Mutationsgraphql/mutations.md4KB❌ Chưa có
07.4Subscriptionsgraphql/subscriptions.md22KB❌ Chưa có
07.5Scalars & Enumsgraphql/scalars.md + graphql/unions-and-enums.md16KB❌ Chưa có
07.6Directivesgraphql/directives.md4KB❌ Chưa có
07.7Interfacesgraphql/interfaces.md4KB❌ Chưa có
07.8Mapped Typesgraphql/mapped-types.md6KB❌ Chưa có
07.9Field Middlewaregraphql/field-middleware.md5KB❌ Chưa có
07.10Complexitygraphql/complexity.md4KB❌ Chưa có
07.11Extensions & Pluginsgraphql/extensions.md + graphql/plugins.md6KB❌ Chưa có
07.12CLI Plugingraphql/cli-plugin.md7KB❌ Chưa có
07.13Federationgraphql/federation.md27KB❌ Chưa có
07.14Other Featuresgraphql/other-features.md7KB❌ Chưa có

📦 Group 9: WebSocket & Real-time (Mới hoàn toàn)​

#Bài học (docs/nestjs)File nguồn (sources/…)SizeTrạng thái hiện tại
08.1Gatewayswebsockets/gateways.md11KB❌ Chưa có
08.2Exception Filters, Guards, Pipeswebsockets/exception-filters.md + websockets/guards.md + websockets/pipes.md + websockets/interceptors.md5KB❌ Chưa có
08.3Custom Adapterwebsockets/adapter.md8KB❌ Chưa có

📦 Group 10: Microservices (Mới hoàn toàn)​

#Bài học (docs/nestjs)File nguồn (sources/…)SizeTrạng thái hiện tại
09.1Basics & Transportersmicroservices/basics.md26KB❌ Chưa có
09.2Redis Transportmicroservices/redis.md8KB❌ Chưa có
09.3MQTT Transportmicroservices/mqtt.md10KB❌ Chưa có
09.4NATS Transportmicroservices/nats.md11KB❌ Chưa có
09.5RabbitMQ Transportmicroservices/rabbitmq.md14KB❌ Chưa có
09.6Kafka Transportmicroservices/kafka.md26KB❌ Chưa có
09.7gRPC Transportmicroservices/grpc.md24KB❌ Chưa có
09.8Custom Transportmicroservices/custom-transport.md13KB❌ Chưa có
09.9Exception Filters, Guards, Pipesmicroservices/exception-filters.md + microservices/guards.md + microservices/pipes.md6KB❌ Chưa có

📦 Group 11: OpenAPI / Swagger (Mới hoàn toàn)​

#Bài học (docs/nestjs)File nguồn (sources/…)SizeTrạng thái hiện tại
10.1Introduction & Setupopenapi/introduction.md11KB❌ Chưa có
10.2Types, Parameters, Operationsopenapi/types-and-parameters.md + openapi/operations.md21KB❌ Chưa có
10.3Mapped Typesopenapi/mapped-types.md4KB❌ Chưa có
10.4Decorators & Securityopenapi/decorators.md + openapi/security.md4KB❌ Chưa có
10.5CLI Pluginopenapi/cli-plugin.md12KB❌ Chưa có
10.6Other Featuresopenapi/other-features.md7KB❌ Chưa có

📦 Group 12: Testing (Tách riêng — quan trọng)​

#Bài học (docs/nestjs)File nguồn (sources/…)SizeTrạng thái hiện tại
11.1Unit Test & E2E Testfundamentals/testing.md22KB❌ Chưa có

📦 Group 13: Mock Project (Tái cấu trúc)​

#Bài học (docs/nestjs)NguồnTrạng thái hiện tại
12.0Project Overview & ArchitectureTổng hợp từ khoá học⚠️ Có 99-plans/ → cần restructure
12.1Setup (Docker + DB)techniques/database.md + deployment.md⚠️ Tham khảo từ week1-plan.md
12.2Auth Modulesecurity/authentication.md + recipes/passport.md⚠️ Tham khảo từ week2-plan.md
12.3Feature Module (CRUD)techniques/database.md + recipes/crud-generator.md⚠️ Tham khảo từ week3-plan.md
12.4Real-time (WebSocket)websockets/gateways.md⚠️ Tham khảo từ week4-plan.md
12.5Queue & Background Jobstechniques/queues.md⚠️ Tham khảo từ week5-plan.md

Tổng Hợp Số Liệu​

GroupModuleFiles hoạch địnhTrạng thái
Getting Started00-setup4❌ 4 mới
OOP Foundation01-oop6⚠️ 6 verify
Building Blocks02-building-blocks4✅ 4 hoàn thành
Core Fundamentals03-core-fundamentals10❌ 10 mới
AOP Pipeline04-aop-layer6✅ 6 hoàn thành
Techniques05-techniques24⚠️2 verify + ❌22 mới
Security06-security7❌ 7 mới
GraphQL07-graphql14❌ 14 mới
WebSocket08-websockets3❌ 3 mới
Microservices09-microservices9❌ 9 mới
OpenAPI10-openapi6❌ 6 mới
Testing11-testing1❌ 1 mới
Mock Project12-project6⚠️ 6 restructure
Tổng13 modules~100 files✕11 / ⚠️16 / ❌74

Cấu Trúc Thư Mục Mới​

docs/nestjs/
├── _category_.json
├── 00-setup/
│   ├── _category_.json
│   ├── 01-why-nestjs.md
│   ├── 02-installation.md
│   └── 03-cli.md
├── 01-oop/                    # ← Verify & Keep
├── 02-building-blocks/
├── 03-core-fundamentals/
├── 04-aop-layer/
├── 05-techniques/
├── 06-security/
├── 07-graphql/
├── 08-websockets/
├── 09-microservices/
├── 10-openapi/
├── 11-testing/
└── 12-project/

Kế Hoạch Thực Thi​

Phase 1 — Cleanup (1-2h)​

  • Archive 99-plans/ → rename thành 12-project/
  • Rename 02-core-concepts/ → 04-aop-layer/ (giữ 04-aop.mdx)
  • Tạo các thư mục mới: 00-setup/, 02-building-blocks/, 03-core-fundamentals/, 05-techniques/, 06-security/, 07-graphql/, 08-websockets/, 09-microservices/, 10-openapi/, 11-testing/
  • Cập nhật tất cả _category_.json

Phase 2 — Verify Existing Files (3-4h)​

  • Verify & Rebuild 01-oop/ (6 files) → Kết quả: ✅ Đã viết lại toàn bộ 6 bài theo đúng chuẩn 4MAT và B1+ Vocabulary. Tẩy sạch emoji.
  • Verify & Rebuild 03-tooling/ (2 files: Debugger & Logger) → Kết quả: ✅ Đã viết lại toàn bộ 2 bài theo chuẩn 4MAT, xoá sạch emoji, bổ sung Glossary và kiến trúc chuyên sâu.
  • Verify 04-aop.mdx — cross-check với guards.md, interceptors.md, pipes.md, exception-filters.md → Kết quả: ✅ Đã đổi tên thành 01-aop-overview.mdx và chuẩn hóa.

Phase 3 — Build New Content (Ưu tiên theo dependency)​

Thứ tự build theo dependency học tập:

  1. 00-setup → 4 files
  2. 02-building-blocks → 4 files ✅ (Đã hoàn thành)
  3. 03-core-fundamentals → 10 files
  4. 04-aop-layer (new files) → 5 files ✅ (Đã hoàn thành)
  5. 11-testing → 1 file (cần thiết để test mock project)
  6. 05-techniques → 24 files (chia nhỏ, build dần)
  7. 06-security → 7 files
  8. 10-openapi → 6 files (swagger docs cho REST API)
  9. 07-graphql → 14 files
  10. 08-websockets → 3 files
  11. 09-microservices → 9 files (advanced, build sau cùng)
  12. 12-project → 6 files (tổng hợp từ toàn bộ khoá học)

Phase 4 — Review & Publish​

  • Sau mỗi module hoàn thành → chạy /push-content workflow

Made by Anh Tu - Share to be share