LOCAL_DEVELOPMENT_vi-VN.md

Phát triển cục bộ

Phát Triển Backend

Xem backend/README.

Phát triển Frontend

Trong mẫu này, bạn có thể sửa đổi và khởi chạy frontend một cách cục bộ bằng cách sử dụng các tài nguyên AWS (API Gateway, Cognito, v.v.) đã được triển khai bằng npx cdk deploy.

1. Tham khảo Triển khai bằng CDK để triển khai trên môi trường AWS.
2. Sao chép frontend/.env.template và lưu thành frontend/.env.local.
3. Điền nội dung của .env.local dựa trên kết quả đầu ra của npx cdk deploy (như BedrockChatStack.AuthUserPoolClientIdXXXXX).
4. Thực thi lệnh sau:

cd frontend && npm ci && npm run dev

(Tùy chọn, khuyến nghị) Thiết lập hook pre-commit

Chúng tôi đã giới thiệu các GitHub workflows để kiểm tra kiểu và kiểm tra lỗi. Những việc này được thực thi khi một Pull Request được tạo, nhưng việc chờ đợi kiểm tra lỗi hoàn tất trước khi tiếp tục không phải là một trải nghiệm phát triển tốt. Do đó, những nhiệm vụ kiểm tra lỗi này nên được thực hiện tự động tại giai đoạn commit. Chúng tôi đã giới thiệu Lefthook như một cơ chế để đạt được điều này. Điều này không bắt buộc, nhưng chúng tôi khuyến nghị áp dụng nó để có trải nghiệm phát triển hiệu quả. Ngoài ra, mặc dù chúng tôi không áp đặt định dạng TypeScript với Prettier, nhưng chúng tôi sẽ rất trân trọng nếu bạn có thể áp dụng nó khi đóng góp, vì nó giúp ngăn ngừa các khác biệt không cần thiết trong quá trình xem xét mã.

Cài đặt lefthook

Tham khảo tại đây. Nếu bạn là người dùng Mac và homebrew, chỉ cần chạy brew install lefthook.

Cài đặt poetry

Điều này là cần thiết vì việc kiểm tra lỗi mã Python phụ thuộc vào mypy và black.

cd backend
python3 -m venv .venv  # Tùy chọn (Nếu bạn không muốn cài đặt poetry trên môi trường của mình)
source .venv/bin/activate  # Tùy chọn (Nếu bạn không muốn cài đặt poetry trên môi trường của mình)
pip install poetry
poetry install

Để biết thêm chi tiết, vui lòng kiểm tra README của backend.

Tạo hook pre-commit

Chỉ cần chạy lefthook install trong thư mục gốc của dự án này.