Sổ yêu cầu của người soạn: hình ảnh
Sổ chỉ ghi thêm, không sửa dòng cũ: mỗi yêu cầu có ngày, nguyên văn ý chính, và các quyết định đã chốt. Đọc sổ này trước khi đổi bất kỳ chuẩn ảnh nào, nó trả lời "vì sao lại thế này".
26.09.2026: Bìa sách theo kệ Drink
Bìa sách của mảng Drink ổn phết. Dùng skill tạo bìa đó để áp dụng cho mọi quyển sách khác.
Kết quả: ~156 bìa vector 800×1200 cùng phong cách, prompt lưu trong pack của kệ. Xem Bìa sách.
27.09.2026: Ảnh khoá học (cover, thumbnail, avatar)
Bìa của các quyển sách khá đẹp rồi, đặc biệt là Drink. Hãy chỉnh cover, ảnh đại diện, thumbnail của các khoá học. Cơ chế tương tự Book Cover, tạo skill riêng, lưu prompt và metadata để tạo prompt. Làm Drink trước; ổn thì làm nốt mọi khoá của mọi cộng đồng. Lưu yêu cầu và tiêu chuẩn vào docs; có thể sắp xếp lại docs cho ngăn nắp.
Mười quyết định đã chốt với người soạn trước khi làm:
| # | Câu hỏi | Quyết định |
|---|---|---|
| 1 | Phong cách | Minh hoạ phẳng như bìa sách Drink |
| 2 | Ba loại ảnh | Một cảnh, ba khổ vẽ lại bố cục riêng: cover 16:9, thumbnail 4:3, avatar 1:1 |
| 3 | Lưu ở đâu | Tệp SVG trong repo (như bìa sách); D1 chỉ giữ đường dẫn |
| 4 | Chữ trong ảnh | Không chữ |
| 5 | Màu | Bốn màu token chung; phân biệt cộng đồng bằng vật |
| 6 | Nguồn ý | Outcome + unit của chính khoá |
| 7 | Prompt | JSON theo cộng đồng trong repo + cột D1 (art_prompt, art_meta_json) |
| 8 | Phạm vi | 18 cộng đồng, bỏ "chưa phân loại" |
| 9 | Cổng duyệt | Làm Drink → trang xem trước → người soạn duyệt → mới merge và làm tiếp |
| 10 | Docs | Mục mới "Hình ảnh & nhận diện", gom trang rời, không đảo cả cổng |
27.09.2026: Bộ ảnh nhận diện cộng đồng
Mỗi community có ảnh cover, ảnh phía footer, vẽ SVG như bìa sách. Tạo mỗi community một vài ảnh đại diện, hero banner, footer phù hợp, để khi vào từng community thì users có cảm giác luôn về community đó.
Quyết định (theo cùng mười luật trên): ba tài sản, avatar 1:1 thay emoji ở thanh trên, hero 3:1 đầu Trang chính, footer 6:1 cuối mọi tab. Làm Drink trước cùng đợt duyệt với ảnh khoá học. Xem Bộ ảnh cộng đồng.
27.09.2026: Duyệt Drink, làm nốt 17 cộng đồng
Ổn rồi, merge Drink và làm tiếp các cộng đồng còn lại.
Kết quả: 207 khoá × 3 khổ (621 SVG) và 18 bộ ảnh cộng đồng (54 SVG), mỗi cộng đồng một trưởng nhóm phân cảnh rồi giao vẽ từng khoá. Migration 20260930b (Drink), 20260930c01–c17b (17 cộng đồng còn lại). Hai khoá đã phải vẽ lại vì cửa kiểm không bắt được: ghế xe khách vẽ thành hình chữ L đọc ra "LLLL" (vi phạm luật không chữ theo nghĩa thị giác), và hai bàn tay vẽ thành khối tròn trông như ống nhòm, cả hai chỉ lộ ra khi nhìn bằng mắt.
02.10.2026: Bìa sách thế hệ 2, chi tiết gấp mười
Chỉnh lại Skill để tạo Book Cover, cần chi tiết hơn hiện nay gấp 10 lần, mỗi book cần lưu lại meta-data về book, và lưu prompt để tạo book cover. Tạo trước 3 cover cho 3 quyển sách trước, nếu ổn thì tạo nốt cho tất cả book cover còn lại.
Quyết định:
| # | Câu hỏi | Quyết định |
|---|---|---|
| 1 | "Gấp 10" đo bằng gì | Số khối vẽ: thế hệ 1 ~40, ngưỡng thế hệ 2 là 400; kèm ≥6 vật phụ, ≥4 chi tiết kể chuyện |
| 2 | Giữ nhà cũ không | Giữ: bốn màu token, không chữ, khổ 800×1200. Chỉ đổi mức chi tiết |
| 3 | Metadata lưu đâu | content/books/art/<community>.json trong repo; D1 cột mới cover_meta_json là bản chiếu |
| 4 | Prompt | ≥600 ký tự, khuôn bảy phần, viết SAU khi vẽ để tả đúng cái đã vẽ |
| 5 | Bản vẽ | Mã Python trong repo (scripts/book_cover_art/scenes/), không sửa SVG tay |
| 6 | Bộ đệm | Giữ tên tệp, cover_url thêm ?v=2 |
| 7 | Cổng duyệt | Ba bìa thử ở ba cộng đồng (Food, Finance, Drink) → người soạn duyệt → mới làm 213 bìa còn lại |
Xem Bìa sách và skill book-covers.
02.10.2026: Duyệt ba bìa thử, làm nốt cả kệ
Merge PR 310, làm nốt các bìa còn lại
Kết quả: 213 bìa còn lại (216 tổng) cho 18 cộng đồng, mỗi cộng đồng một agent phân cảnh cả kệ rồi vẽ. Người điều phối xem cả 216 bìa ở cỡ thẻ 200px và trả lại 5 bìa có hình đọc ra chữ ("WWWW", "X"). Bài học ghi ở skill book-covers.
03.10.2026: Ảnh minh hoạ chương/section và trình đọc
Hãy đóng vai là một người đọc sách, hãy tạo ra các Jobs to be done của họ, các pains của mỗi Jobs to be done. Ngoài ra hãy tham khảo app Books của Apple. Và hãy làm các features để giúp cho Book Readers có trải nghiệm đọc được tốt hơn. Với mỗi chapter, và mỗi section, cần vẽ ra một ảnh minh họa khá chi tiết bằng thuật toán, dạng SVG. Cần lưu prompt vẽ vào database, và lưu các thông tin về ảnh minh họa đó vào đâu đó trong database nữa. Màu sắc của mỗi bức đó đa dạng khác biệt vào, khác biệt giữa các chapter, khác biệt giữa các section. Nhưng xuyên suốt mỗi book thì phong cách ảnh minh họa cần đồng nhất ở một số khía cạnh nào đó. Mỗi quyển sách thì cần lưu lại khía cạnh đó. Cần tạo hoặc nâng cấp các skill để tạo ảnh Book Cover, và cả ảnh minh họa cho Chapter, và cả các ảnh minh họa cho từng Section.
Quyết định:
| # | Câu hỏi | Quyết định |
|---|---|---|
| 1 | Luật bốn màu token có áp cho minh hoạ không | Không: người soạn yêu cầu màu đa dạng giữa chương và section. Bìa sách vẫn giữ bốn màu |
| 2 | "Đồng nhất ở một số khía cạnh" là gì | DNA của quyển: dải bão hoà/độ sáng, nét, bo góc, bóng, hạt giấy, khung, ánh sáng, bày biện, vật ký hiệu. Chỉ sắc độ đổi |
| 3 | Lưu ảnh ở đâu | Không lưu tệp; D1 lưu cảnh + prompt + metadata, Worker vẽ lúc phục vụ (5.773 ảnh thành tệp là hàng trăm MB) |
| 4 | Phạm vi đợt này | Thí điểm một quyển ("Đêm trống", 25 ảnh) + trình đọc, duyệt rồi mới làm cả kệ |
| 5 | Tính năng trình đọc | Theo JTBD: đọc tiếp, vị trí trên URL, trước/tiếp, phút còn lại, Aa (cỡ chữ, giãn dòng, nền), mục lục có dấu đã đọc |
Xem Ảnh minh hoạ chương và section, Trình đọc sách.
03.10.2026: Làm tiếp ảnh minh hoạ cho cả kệ
Làm tiếp đi. Tự chọn cái gì tốt nhất, thì tự quyết. Rồi làm
Quyết định tự chốt: sổ vật tách một tệp mỗi cộng đồng (18 agent song song không ghi đè nhau); 12 vật dùng chung mới; bộ đệm Cloudflare (Cache API) cho route ảnh; bỏ 29 quyển chưa phân loại; một migration mỗi quyển. Kết quả: 215 quyển, 5.370 ảnh, khoảng 780 vật ngành. Xem Ảnh minh hoạ chương và section.