Nhiều app, một tài khoản

Khi bạn có app thứ hai, thứ năm, thứ mười. Bẫy dùng chung cơ sở dữ liệu, quy ước tên, và cách để app này hỏng không kéo app kia theo.

Người đi hết giáo trình này thường không dừng ở một app. Sau một năm bạn có thể có 5–20 Worker, vài chục tên miền, và một mớ cơ sở dữ liệu. Bài này nói về lúc đó.

Bẫy lớn nhất: dùng chung một D1

Khi hết hạn mức số cơ sở dữ liệu, cách làm hiển nhiên là nhét app mới vào D1 có sẵn, phân biệt bằng tiền tố tên bảng:

minhtrung-checkin (một D1)
├─ nguoi_dung, bao_cao, anh          ← app chấm công
├─ td_hang, td_phieu                 ← app quản lý kho
└─ cn_doi_soat, cn_cong_no           ← app công nợ

Nó chạy được, và đôi khi là lựa chọn đúng. Nhưng phải biết cái giá:

Khi nào dùng chung chấp nhận được: các app cùng một tổ chức, cùng do bạn vận hành, lưu lượng thấp, và quan trọng nhất — không app nào chạy truy vấn nặng trong giờ làm việc.

Quy ước đặt tên — làm từ app thứ hai

Khi có 20 Worker, cái bạn cần nhất là nhìn tên biết ngay là gì.

<tổ-chức>-<app>[-<môi-trường>]

mt-checkin          app chấm công của Minh Trung
mt-checkin-thu      bản thử của chính nó
mt-congno           app công nợ
changan-pos         app bán hàng quán Chang An

Và đặt tên tài nguyên theo app, đừng đặt tên chung chung:

D1:   mt-checkin-db        (KHÔNG: "database", "app-db")
R2:   mt-checkin-anh
KV:   mt-checkin-phien

Ba tháng sau, một bucket tên anh sẽ làm bạn mất 10 phút để nhớ nó của app nào.

Một bảng kê, và nó phải sống

File HA-TANG.md ở một chỗ cố định, liệt kê mọi thứ bạn đang chạy:

| App | Worker/Pages | Tên miền | D1 | R2 | Repo | Ai dùng |
|---|---|---|---|---|---|---|
| Chấm công | mt-checkin | ck.cty.com | mt-checkin-db | mt-checkin-anh | gh:.../checkin | 180 NV |
| Công nợ | mt-congno | — (pages.dev) | DÙNG CHUNG mt-checkin-db (tiền tố cn_) | — | gh:.../congno | 4 kế toán |
| Web quán | changan-web | changan.com | — | — | gh:.../changan | công khai |

Cột "Ai dùng" là cột quan trọng nhất: nó cho bạn biết app nào hỏng thì ai gọi điện, và app nào có thể tắt mà không ai để ý.

Bảng này tự sinh được:

npx wrangler deployments list
npx wrangler d1 list
npx wrangler r2 bucket list
npx wrangler kv namespace list

Đưa mọi Worker lên GitHub

Khi có nhiều app, việc mã nguồn chỉ nằm trên máy bạn trở thành rủi ro thật. Mỗi Worker nên có một repo riêng tư, và nối Workers Builds (Cloudflare tự build khi bạn push).

Hai loại Worker cần lưu ý khi chuyển:

• Worker dùng Static Assets — phải đưa cả thư mục tài nguyên lên repo, và kiểm cấu hình [assets] đúng thư mục.
• Worker có Durable Object — migration phải nằm trong wrangler.toml; lần deploy đầu từ CI có thể cần chạy wrangler deploy thẳng một lần.

Tách để hỏng không lan

Bốn mức tách, từ rẻ tới đắt:

Mức 4 đáng nghĩ sớm hơn bạn tưởng: nếu khách dùng tài khoản của chính họ, bạn tránh được cả vấn đề điều khoản bán lại hạ tầng (Chi phí) lẫn chuyện bàn giao khi hết hợp tác. Bạn làm phần ứng dụng, họ sở hữu phần hạ tầng.

Gọi giữa các app: service binding

Khi app A cần gọi app B, đừng gọi qua Internet — dùng service binding, nối thẳng Worker này sang Worker kia:

[[services]]
binding = "MAIL"
service = "mt-mail-api"

const r = await env.MAIL.fetch(new Request("https://noi-bo/gui", {
  method: "POST",
  body: JSON.stringify({ den: "a@b.com", tieu_de: "...", noi_dung: "..." }),
}));

Lợi: không đi vòng ra Internet (nhanh hơn, không tốn thêm request vào), không cần khóa API giữa hai app của chính bạn, và tránh được lỗi khi một Worker gọi một Worker khác cùng tài khoản qua tên miền công cộng — một tình huống hay gây lỗi khó hiểu.

Chạy các lệnh sau rồi tổng hợp thành bảng Markdown trong HA-TANG.md:

  wrangler deployments list
  wrangler d1 list
  wrangler r2 bucket list
  wrangler kv namespace list

Bảng gồm cột: App | Worker/Pages | Tên miền | D1 | R2 | KV | Repo |
Lần deploy cuối | Ghi chú.

Với mỗi Worker, đọc wrangler.toml tương ứng trong C:\NVAI\Claude
(nếu tìm thấy) để điền tên miền và binding. Cái nào không tìm thấy
mã nguồn trên máy thì ghi "CHƯA CÓ MÃ NGUỒN LOCAL" — đó là rủi ro
cần xử lý.

Cuối bảng, liệt kê riêng:
- Các D1 đang bị DÙNG CHUNG bởi nhiều app (nguy cơ nghẽn chéo)
- Các Worker deploy cách đây trên 6 tháng (ứng viên khai tử)

Chỉ đọc, không xóa, không sửa gì.