Skip to main content
Cấu hình môi trường quyết định backend kết nối PostgreSQL và các dịch vụ bên ngoài như thế nào. Mini App có cấu hình frontend riêng; đặt biến vào sai runtime sẽ không bật được luồng cần chạy.

​
Bạn cần đọc trang nào?

​
Chọn cấu hình theo luồng

​
Chuẩn bị file cấu hình

1

Chuẩn bị backend

Application có .env.example ở thư mục gốc. Tạo .env trong cùng thư mục và điền các biến cần cho luồng đang chạy theo mẫu env. prisma.config.ts dùng dotenv/config để đọc cấu hình; runtime Prisma đọc DATABASE_URL.
2

Chuẩn bị frontend Mini App

Nếu cần đích API riêng, tạo resident-miniapp/.env.local và đặt VITE_TAHO_API_URL. Nếu dùng proxy dev có sẵn, bạn có thể để biến này trống.Vite đọc .env.local từ thư mục env của frontend và nạp biến khi khởi động. Sau khi sửa, khởi động lại Vite; giá trị VITE_ được đưa vào bundle trình duyệt. Xem hướng dẫn env của Vite.
3

Chạy và kiểm tra đúng luồng

Khởi động application hoặc Mini App theo hướng dẫn local. Kiểm tra bước sử dụng dịch vụ tương ứng, không chỉ kiểm tra server mở được trang.
Các biến có tiền tố VITE_ được frontend dùng trong trình duyệt. Không đặt khóa OpenAI, JWT, Resend, R2 hoặc secret verifier vào nhóm biến này.

​
Khác biệt giữa file mẫu và source

File .env.example hiện có tên TAHO_ZALO_APP_SECRET, nhưng chưa liệt kê hai biến verifier mà handler xác minh Zalo cũng yêu cầu. VITE_TAHO_API_URL được frontend đọc nhưng không nằm trong file mẫu backend. Danh mục và mẫu trong docs bổ sung các tên này theo consumer hiện tại. Các tên DIRECT_URL và TAHO_DB_* từng xuất hiện trong docs cũ không có consumer tương ứng trong đường kết nối Prisma hiện tại. Không coi việc thêm chúng vào .env là thay đổi cấu hình pool hoặc URL migration.