Bắt đầu nhanh
Chạy server và stack của nó trên máy, cài app Android lên điện thoại, và xem trước bộ tài liệu này.
Trước khi bắt đầu
- Go 1.27 và Docker có Compose, để chạy server.
- JDK 21, Android SDK có platform 36, và một điện thoại Android 12 trở lên (hoặc emulator API 36), để chạy app.
- Bun, để chạy tài liệu.
Server
-
Chạy toàn bộ
Trong thư mục
server/:Terminalmake runLần đầu, lệnh này chép
.env.examplethành.envvà sinh thêm các khóa ký. Những lần sau, mỗi lần chạy nó bật stack dev, chạy migration, chuẩn bị bucket cho object store rồi khởi động server ở cổng 8080. -
Điền cấu hình model
Phần tìm kiếm dùng một language model để đọc câu truy vấn, và
.env.exampleđể trốngLLM_API_KEYvớiLLM_MODEL. Chưa điền hai biến này vào.envthì server không chạy. Server sẽ liệt kê đúng tên những biến còn thiếu. -
Kiểm tra server
GET /healthztrả lời ngay khi process chạy.GET /readyzkiểm tra thêm Postgres và Restate. -
Tạo admin cho console
API không có cách tạo admin. Chạy
go run ./cmd/console create-admin --email <email> --name <tên>, lệnh sẽ in ra mật khẩu tạm.
make down tắt các stack nhưng giữ nguyên database dev.
App Android
Trong thư mục app/, với điện thoại đã cắm qua adb:
./run.sh # cài bản debug rồi mở app
./run.sh -w # cài lại và mở lại sau mỗi lần lưu fileScript ưu tiên điện thoại thật hơn emulator. Muốn dùng emulator thì đặt ANDROID_SERIAL bằng serial của nó. App chạy bằng dữ liệu giả, có người bán và hãng vận chuyển giả lập, nên không cần server. Ở bản debug, nhấn giữ nút vị trí trên trang chủ để mở debug panel. Ở đó có thể nhảy đơn sang bất kỳ trạng thái nào hoặc reset dữ liệu.
Tài liệu này
Trong docs/web, chạy bun install rồi bun run dev để xem trước tại http://localhost:4321. Tìm kiếm chỉ chạy sau khi đã bun run build một lần, vì bước build mới tạo chỉ mục tìm kiếm.