Tài liệu nội bộ
Vận hành, tài chính, cấu hình và kiến trúc hệ thống YeChai.
Tài liệu này dành cho đội vận hành, tài chính, kỹ thuật và quản trị của YeChai.
Toàn bộ nội dung được đối chiếu với mã nguồn trong repo yechai-demo và màn hình
thật của môi trường vps-test.
Cách đọc tài liệu này
Tài liệu phân biệt rõ ba mức độ: đã xác nhận (có nguồn trong mã hoặc biên bản nghiệm thu), đã triển khai nhưng chưa nghiệm thu, và chỉ là dữ liệu mẫu. Chỗ nào chưa có nguồn, tài liệu ghi rõ thay vì suy đoán.
Bắt đầu
Hệ thống gồm những gì, ai dùng phần nào.
Kiến trúc hệ thống
Bốn app, một API, một cơ sở dữ liệu.
Vận hành đặt lịch
Duyệt, phân xe, từ chối lịch.
Phiên thu gom
Tạo phiên và nhập phiếu.
Hoá đơn
Vòng đời hoá đơn và cách tính tiền.
Cấu hình
Bảng giá, điểm tập kết, nhân sự.
Nội dung theo nhóm
Nhập môn
- Bắt đầu — thành phần hệ thống, vai trò và trách nhiệm.
- Phân quyền — các vai trò và quyền tương ứng.
Kiến trúc và kỹ thuật
- Kiến trúc hệ thống — app, package và luồng dữ liệu.
- API — cây route, xác thực và mã lỗi.
- Cơ sở dữ liệu — bảng, ràng buộc và migration.
- Môi trường — local, dev, vps-test, production và cách triển khai.