Skip to main content

Dự án mới cùng AI

"Tôi đang phát triển hệ thống quản lý "Tour Trips" với:

1. Kiến trúc tổng thể​

  • Pattern: Modular Monolith - MVC với Service Layer

  • Tech stack:

    • Backend: Node.js + Express
    • Frontend: React + React Native
    • Database: MongoDB - Dùng pool - Dùng timestamd trong schema - Embedded Data - References - Indexing - Single Document Atomicity Action Type Information Frequency Priority

  • Authentication: JWT

2. Các bước chuẩn bị trước khi code chức năng​

  1. Khởi tạo dự án và cấu hình cơ bản:

    • Tạo cấu trúc thư mục dự án theo kiến trúc Modular Monolith.
    • Cài đặt các dependencies chính cho Express và Mongoose.
    • Cấu hình kết nối MongoDB.
    • Thiết lập file .env và thư viện quản lý biến môi trường (dotenv).

  2. Cấu hình Global Middleware và Error Handling:

    • Global Error Middleware
    • Global Error Handler

  3. Thiết lập Utility Functions ban đầu:

    • Khởi tạo core/utils/database.js với các hàm cơ bản như query (để log hoặc wrap Mongoose), và paginate.
    • Thiết lập các tiện ích chung
      • Database Utilities
      • Validation Utilities
      • Response Utilities

  4. Tạo Helper Functions

    • Date Helpers
    • Number Helpers
    • String Helpers

3. Yêu cầu về thiết kế và triển khai Backend​

  • Async/Await Pattern: Toàn bộ logic bất đồng bộ phải sử dụng async/await.
  • Triển khai đầy đủ Model-Service-Controller (MSC):
    • Controller: Chỉ xử lý request/response và gọi Service.
    • Service: Chứa toàn bộ logic nghiệp vụ phức tạp, giao tiếp với Model.
    • Model: Định nghĩa schema và tương tác trực tiếp với database.
  • Standardized Responses: Sử dụng utils/response.js để chuẩn hóa định dạng trả về JSON cho mọi API call (bao gồm cả thành công và thất bại).
  • Error Handling:
    • Sử dụng try-catch trong các hàm để bắt lỗi cục bộ.
    • Logging: Sử dụng console.error

4. Yêu cầu về Code Standards​

  • JSDoc Comments: Tất cả các hàm (functions), class, và phương thức (methods) quan trọng phải có JSDoc comments đầy đủ mô tả mục đích, tham số (@param), giá trị trả về (@returns), và các trường hợp lỗi (@throws).
  • Consistent Naming Conventions: Tuân thủ một quy tắc đặt tên thống nhất cho biến, hàm, class, file, và thư mục (ví dụ: camelCase cho biến/hàm, PascalCase cho class/model, kebab-case cho tên file).
  • Proper Error Messages: Các thông báo lỗi trả về cho client phải rõ ràng, dễ hiểu và không tiết lộ thông tin nhạy cảm về hệ thống nội bộ.
  • Input Validation: Tất cả dữ liệu đầu vào từ client phải được kiểm tra và xác thực nghiêm ngặt ở phía server (ví dụ: sử dụng Joi, Express-validator)."

Phase 1: Khởi tạo dự án và thống nhất nền tảng làm việc giữa người và AI

🎯 Mục tiêu​

Tạo nền tảng vững chắc giúp con người và AI cùng làm việc hiệu quả, nhanh chóng, nhất quán, hạn chế tối đa sai sót trong các giai đoạn sau.

1. Xác định Ý tưởng và Mục tiêu Dự án​

  • Tên dự án và mục tiêu tổng thể
  • Vấn đề cần giải quyết
  • Đối tượng người dùng chính (user personas)
  • Giá trị cốt lõi mang lại cho người dùng
tip

Tôi muốn xây dựng một hệ thống [học từ vựng] giúp [học sinh cấp 2] [ghi nhớ lâu] bằng phương pháp [lặp lại ngắt quãng].”

2. Kiến trúc Tổng thể​

  • Kiến trúc hệ thống (Monolith / Microservices)
  • Hệ sinh thái công nghệ:
    • Frontend (React, Vue, ...)
    • Backend (Node.js, Django, ...)
    • Database (MongoDB, MySQL, ...)
    • Hosting / CI/CD / Git flow

3. Chuẩn hóa về Quy ước & Cách Giao tiếp với AI​

  • Format yêu cầu (câu lệnh rõ ràng, đầy đủ ngữ cảnh)
  • Ngôn ngữ chính khi làm việc (EN / VN)
  • Cách AI phản hồi (step-by-step / toàn bộ file / phân đoạn / gợi ý từng phần)

4. Vai trò giữa Con người & AI​

Vai tròCon ngườiAI
Sáng tạo / Định hướng✅❌
Đặt câu hỏi / Truy vấn✅❌
Đề xuất kiến trúc / mẫu code✅✅
Viết code thực thi✅✅
Kiểm thử logic nghiệp vụ✅✅ (nếu được mô tả đúng)
Review bảo mật, hiệu năng✅⚠️ (có giới hạn)

5. Công cụ & Tài liệu Ban đầu​

  • Các file dự kiến có:
    • README.md
    • architecture.md
    • tech-stack.md
    • features-list.md
    • workflow.md (quy trình làm việc)
  • Công cụ đồng hành:
    • Git repo (GitHub, GitLab)
    • Task tracking (Notion, Jira)
    • Chat với AI (ChatGPT, Gemini, Claude…)

6. Checklist Trước Khi Chuyển Sang Giai Đoạn Phân Tích Chức Năng​

  • Đã xác định rõ mục tiêu và người dùng
  • Đã chọn công nghệ và kiến trúc phù hợp
  • Đã thống nhất cách đặt yêu cầu và phản hồi với AI
  • Đã xác định vai trò người và AI
  • Đã có folder/tài liệu nền tảng ban đầu

✅ Khi hoàn tất các bước trên, chúng ta có thể chuyển sang Phase 2: Phân tích chức năng và thiết kế sơ bộ.