Tất cả dự ánChọn hệ trên bản đồ
Hệ 05Bộ khungĐang xây
ERP + Bot VN
Kiến trúc sư, từ 2026
Bộ khung để dựng "ERP web + bot Telegram/Zalo" cho từng doanh nghiệp nhỏ Việt Nam - mỗi khách một hạ tầng riêng, khác nhau chỉ ở file cấu hình.
- Pháp nhân
- Bộ khung riêng (repo private, chưa chọn giấy phép); phần thư viện skill vendored giữ license gốc
- Vai trò
- Kiến trúc và chưng cất từ ba hệ của chính mình; viết cùng Claude Code theo lối nhiều agent song song, tự duyệt và tự kiểm
- Trạng thái
- Bản 0.1.0. Chưng cất từ ba hệ đang chạy thật của tôi. Bộ kiểm tự chạy lại ngày 03/09/2026: TẤT CẢ PASS. Sáu hồ sơ khách trong repo đều là mô phỏng - chưa có khách thật đi trọn vòng, đang tìm khách pilot đầu tiên.
Sơ đồ chức năng, vẽ từ cấu trúc thật.
Số đo, mỗi số có dấu nguồn
- 31module nghiệp vụ, 232 thao tác bot, 13 preset ngành - nạp thật 0 lỗi
- 269test logic + 16 unit test + 14 test mã hoá + 7 checker cấu trúc đọc thẳng file - tất cả PASS
- 8bước trong vòng đời một khách: nguyên tắc → khảo sát → chọn module → báo giá → khởi tạo → tuỳ biến → kiểm chứng → bàn giao
- 0khách thật đã đi trọn vòng - sáu hồ sơ trong repo là mô phỏng
Câu chuyện
Sau ba hệ thống chạy thật cho ba công ty khác nhau, tôi thấy cùng một khung lặp lại: Supabase là nguồn sự thật; web và bot là hai giao diện mỏng cùng gọi một bộ thao tác; AI chọn thao tác bằng tool-use nhưng mọi thao tác ghi phải người bấm duyệt. Nên tôi bóc nó ra thành một bộ khung có thể nhân bản: mỗi khách một hạ tầng riêng, khác nhau chỉ ở một file cấu hình.
Luật vào lõi rất chặt: pattern có mặt ở ít nhất hai hệ mới được vào lõi; một hệ thì thành module tuỳ chọn. Lõi không bao giờ sửa vì một khách. Bảy trong 31 module chạy được chế độ "adapter": hệ có sẵn của khách là nguồn gốc, thao tác ghi tự gỡ. Bằng chứng cho cách bóc tách này đến từ hệ nguồn: ship đủ mọi module cho một khách thì 37 trên 57 bảng chưa từng có một dòng ghi, còn hai module được dùng chiếm 92% thao tác.
Điểm khác biệt lớn nhất là cách nó tự kiểm chứng: 269 test + 7 checker đọc thẳng file, chạy được cả trên máy chưa cài Node, và checker mới phải được "tiêm lỗi" cho đỏ rồi mới được tin. Bộ này đã bắt hơn 80 lỗi thật trong lúc xây - trong đó 51 lỗi import sau khi mười agent viết song song. Điểm yếu lớn nhất tôi ghi rõ ở đầu tài liệu: chưa có khách nào đi trọn vòng.
Mô hình giá viết lại sau khi mô phỏng lộ lệch: bán công, không bán mã - phí dùng khung theo gói cộng giờ triển khai thật, kèm khoảng tin cậy, và một mục "khi nào khuyên khách đừng mua của tôi" (chỉ cần bán hàng và kho thì phần mềm bán hàng phổ biến làm tốt hơn).
Quyết định đáng kể
Action registry = tool cho AI + handler cho người
Mỗi nghiệp vụ là một object: tên, mô tả tiếng Việt, JSON schema, quyền, loại đọc/ghi, summary(), execute(). Vừa là tool cho Claude, vừa là handler cho web và bot.
Idempotency và cổng duyệt đặt ở DB
UNIQUE trên bank_ref / idempotency_key / dedupe_key; đối soát tiền qua RPC SELECT FOR UPDATE; trigger là lưới cuối mà cả service-role không lách được.
Học từ 22 bài học vận hành có thật
Log vận hành của hệ đi trước được đúc thành tài liệu bài học; 13 lỗ hổng thật vá thẳng vào mã (vòng giao-nhận việc có nút xác nhận, rút bài về sửa, pending/outbox không được nói dối kết quả).
Từ hệ này
Công ty 2-10 người đang quản lý bằng Zalo và Excel?
Tôi đang nhận khách pilot đầu tiên cho bộ khung này: khảo sát điểm đau có số, chọn module, báo giá kèm khoảng tin cậy, dựng trên hạ tầng riêng của bạn. Pilot nghĩa là giá tốt và tôi ở rất gần.