Bắt đầu
Hệ thống YeChai gồm những thành phần nào và mỗi vai trò dùng phần nào.
YeChai vận hành như thế nào
YeChai là dịch vụ thu gom phế liệu tận nhà. Người dân đặt lịch qua ứng dụng, đội điều phối xếp xe và phiên thu gom, người thu gom đến cân tại nhà, sau đó YeChai kiểm tra khối lượng, phát hành hoá đơn và chi trả cho khách.
Một vòng đời đơn đi qua ba khu vực làm việc khác nhau:
| Bước | Ai làm | Ở đâu |
|---|---|---|
| Khách đặt lịch | Người dân | App người dân |
| Duyệt và phân xe | Điều phối | Trang quản trị → Đặt lịch |
| Tạo phiên, nhập phiếu | Điều phối, người thu gom | Trang quản trị → Phiên thu gom |
| Kiểm cân | Nhân viên kiểm tra | Trang quản trị → Phiên kiểm tra |
| Phát hành hoá đơn | Hệ thống, khi phiên kiểm tra hoàn tất | Tự động |
| Chi trả | Kế toán | Trang quản trị → Tài chính |
Thành phần hệ thống
Bốn ứng dụng, bốn package dùng chung
Repo yechai-demo chứa bốn app và bốn package dùng chung, chạy trên một cơ sở
dữ liệu PostgreSQL. Chi tiết ở Kiến trúc hệ thống.
| Thành phần | Vai trò | Ai dùng |
|---|---|---|
apps/citizen | Ứng dụng web (PWA) cho người dân | Khách hàng |
apps/citizen-mobile | Ứng dụng di động (Expo/React Native) | Khách hàng |
apps/admin | Trang quản trị nội bộ | Điều phối, kiểm tra, kế toán, quản trị |
apps/api | API trung tâm | Chạy nền, không người dùng trực tiếp |
packages/contracts | Kiểu dữ liệu và luật kiểm tra dùng chung | Lập trình viên |
packages/client | Thư viện gọi API | Lập trình viên |
packages/ui | Component và token thiết kế | Lập trình viên |
packages/citizen-domain | Logic hiển thị thuần cho app người dân | Lập trình viên |
Các vai trò nội bộ
| Vai trò | Trách nhiệm chính |
|---|---|
| Quản trị viên (admin) | Toàn quyền, cấu hình hệ thống và tài khoản. |
| Điều phối (coord) | Duyệt lịch, phân xe, tạo phiên thu gom. |
| Nhân viên kiểm tra (insp) | Kiểm cân, đối chiếu phiếu thu gom. |
| Kế toán (acct) | Hoá đơn, chi trả, đối soát tài chính. |
| Điểm tập kết (depot) | Nghiệp vụ giới hạn theo điểm tập kết được phân. |
Chi tiết quyền của từng vai trò ở Phân quyền.
Màn hình đầu tiên bạn sẽ thấy
Trang quản trị yêu cầu email công ty và mật khẩu được cấp. Đây là điểm khác biệt so với app người dân: khách đăng nhập bằng số điện thoại, nhân viên đăng nhập bằng email.
Tổng quan sau khi đăng nhập
Màn Tổng quan là nơi bắt đầu mỗi ngày làm việc. Nó trả lời bốn câu hỏi:
- Hôm nay có gì cần xử lý? — KPI lịch chờ duyệt, phiên hôm nay, chờ kiểm tra, chờ chi.
- Việc gì đang tồn? — danh sách Cần xử lý với số lượng từng loại.
- Tiền đang thế nào? — doanh thu, chi phí và lợi nhuận của tháng.
- Có gì mới? — Thông báo mới ở cột phải.
Bước tiếp theo
Kiến trúc hệ thống
Hiểu hệ thống trước khi thao tác.
Vận hành đặt lịch
Công việc hằng ngày của điều phối.
Nhịp làm việc trong ngày
Buổi sáng — nắm việc còn tồn
Mở Tổng quan và đọc danh sách Cần xử lý. Danh sách này gom mọi việc đang chờ theo nhóm: lịch chờ duyệt, phiếu chờ chi, phiếu cần kiểm tra, và cảnh báo kho.
Cả ngày — thông báo là kênh chính
Màn Thông báo tập hợp mọi sự kiện cần bạn chú ý: lịch mới chờ duyệt, phiên đang chạy, phiên chờ kiểm cân, hoá đơn mới, khách xác nhận hoá đơn, khách huỷ lịch, và cảnh báo kho sắp đầy.
Bạn lọc theo nhóm và theo mức ưu tiên, và có thể đánh dấu đã đọc cho toàn bộ.
Cuối ngày — đối soát
Kiểm tra các phiên đã kết thúc, các phiên đang chờ kiểm cân, và hoá đơn phát sinh trong ngày.
Về dữ liệu trong ảnh tài liệu
Ảnh chụp phản ánh môi trường xem thử, không phải số liệu thật
Toàn bộ ảnh trong tài liệu này được chụp trên môi trường vps-test với dữ liệu mẫu. Con số trong ảnh — doanh thu, lợi nhuận, số lượng đơn — không phải số liệu kinh doanh thật và không dùng để đối soát.
Trạng thái dữ liệu tại thời điểm chụp (13/10/2026): khoảng 35 lịch hẹn, 10 phiên thu gom, 6 phiên kiểm tra, 7 hoá đơn đều đang ở trạng thái chờ khách xác nhận, và lợi nhuận tháng âm. Một số màn vì vậy trông trống hoặc chỉ hiển thị dữ liệu mẫu.