-
Notifications
You must be signed in to change notification settings - Fork 0
Feature Setup wizard vi
Từ 0.1.3, thiết kế lại ở 1.9.0. Trang này nói về bản thân wizard — các bước của nó, và màn hình "Setup Hub" đã thay thế một luồng tuyến tính dài. Claim code mà nó bắt đầu bằng đã được nói kỹ ở Cài đặt và Bảo mật; trang này không lặp lại điều đó.
Đi từ "vừa cài xong" tới "đọc được mail" cần một số quyết định được đưa ra an toàn (ai sở hữu instance này, dùng database nào, public URL là gì) mà không đi ngang qua một thứ không hoàn tác được, và cũng không thả một operator hoàn toàn mới thẳng vào một màn hình cài đặt với hàng chục tab trước khi họ kết nối được dù chỉ một hộp thư.
Chạy tự động lần đầu tiên khi chưa ai hoàn tất nó. Sau đó mở lại được bất cứ lúc nào từ Settings ▸ About ▸ Re-run setup — nó không phải một chốt chặn một-lần, hoàn tất hay bỏ qua nó không bao giờ chặn việc dùng sản phẩm.
Trước khi đăng nhập được (không gì ở đây đứng sau được một lượt đăng nhập, vì chưa có session nào):
- Claim — chứng minh người ngồi trước bàn phím có quyền truy cập máy chủ, bằng cách đọc một mã dùng-một-lần từ log hay CLI. Nói đầy đủ ở Bảo mật.
-
Database — chỉ hiện khi việc chọn thực sự là của bạn: bị bỏ qua khi
DB_DRIVERbị khoá bởi môi trường, hoặc khi database đã được cấu hình rồi (kể cả khi quay lại bước này sau khi restart để dùng một database ngoài). Xem Cấu hình để biết mô hình ba mặt phẳng đứng sau chuyện này. -
Sign-in — tạo credential thật (một passphrase, hoặc user admin đầu
tiên, tuỳ
AUTH_MODE). Claim code được gõ một lần ở đây và wizard tự gửi lại nó khi cần — bản cũ hỏi hai lần, một lần để mở khoá các endpoint database, một lần để tạo credential, và cả hai chốt chặn phía server đó vẫn độc lập với nhau hôm nay; chỉ có UI ngừng hỏi hai lần.
Sau khi đăng nhập, một bước bắt buộc rồi tới hub:
-
Identity — public URL của instance (
BASE_URL), hỏi ở đây vì redirect URI của OAuth, origin WebSocket và manifest PWA đều tính từ nó. - Setup Hub.
Một lưới thẻ trạng thái, hai cách trình bày cho cùng một màn hình:
- Lần đầu chạy chỉ hiện ba thẻ — Identity, connect tài khoản Gmail hoặc Outlook (OAuth), và thêm hộp thư đầu tiên của bạn — cố ý giữ nhỏ. Một bước chỉ được góp mặt ở đây nếu sản phẩm không hoạt động thiếu nó, rẻ hơn nhiều để làm ngay bây giờ so với sau này, hoặc không ai tự mình tìm ra nó được. Mọi thứ khác để dành cho việc tự khám phá trong Settings.
- Settings ▸ About hiện đầy đủ — ba cái trên cộng thêm chế độ đăng nhập, storage, database, connections, backup, plugins, license và appearance — như một checklist thường trực "instance này đã cấu hình thật chưa?". Một thẻ ứng với một màn hình Settings có sẵn (Storage, Connections, Backup, Plugins, License) mở đúng màn hình thật đó thay vì cài lại lần hai.
Mỗi thẻ hiện một trong năm trạng thái — done, todo, attention,
blocked, hoặc env (giá trị bị khoá bởi biến môi trường, hiện để biết
chứ không để hành động). Attention là màu hổ phách, cố ý không phải màu
đỏ: không gì đằng sau nó bị hỏng, chỉ là còn điều gì đó đang chờ bạn. Thẻ
"Thêm hộp thư đầu tiên" là ngoại lệ duy nhất vẫn giữ màu hổ phách thay vì lắng
xuống thành "tuỳ chọn" một khi bạn đã xem qua nó, vì sản phẩm thực sự không
làm được gì hữu ích cho tới khi có một hộp thư được kết nối. Thẻ OAuth ở
trạng thái blocked, không chỉ "todo", cho tới khi BASE_URL được đặt —
redirect URI không tính được nếu thiếu nó.
Finish ghi nhận việc hoàn tất trên server (chỉ owner) để hub ngừng tự hiện ra. Skip cố ý không ghi nhận gì cả, nên hub được đề nghị lại vào lần sau — đây là một lựa chọn về luồng làm việc, không phải lỗi: bỏ qua setup một lần không giống với việc tuyên bố đã xong.
| Có từ | 0.1.3 (luồng first-run); Setup Hub thiết kế lại ở 1.9.0 |
| Vai | các bước trước đăng nhập không cần vai nào cả; Finish chỉ owner |
| Chạy lại | bất cứ lúc nào, từ Settings ▸ About |
| Thẻ lần đầu chạy | 3 (Identity, OAuth, tài khoản đầu tiên) |
| Thẻ ở Settings ▸ About | đầy đủ — identity, chế độ đăng nhập, OAuth, storage, database, connections, backup, plugins, license, appearance, tài khoản đầu tiên |
- Không chặn sản phẩm. Bỏ qua nó, hay không bao giờ hoàn tất nó, không bao giờ ngăn SkimMail được dùng — nó là một checklist, không phải một khoá.
- Không lặp lại các màn hình cài đặt khác. Một thẻ hub cho thứ đã có tab Settings thật mở đúng tab đó; không gì về storage, connections, backup, plugins hay license bị cài lại ở đây.
-
Thẻ OAuth không thao tác được trước khi
BASE_URLđược đặt — đây là thẻ duy nhất thực sự bị blocked, không chỉ để dở.
- Cài đặt — claim code theo từng cách cài, và xác minh lần khởi động đầu
- Bảo mật — claim code chi tiết
- Cấu hình — mô hình ba mặt phẳng và việc chọn database đứng sau bước Database của wizard
- Accounts — panel "thêm hộp thư đầu tiên" chính là form Add Account dùng ở mọi nơi khác
SkimMail · skimmail@base101.app · 2026-09-15 · commit dffbb18