Như Một Vì Tinh Tú

🧭 1. La bàn văn hóa (Cultural Compass) & Hệ thống 145 nguồn tư liệu kiểm chứng

Phân định rành mạch "Giữ · Cân nhắc · Được đổi": Thay vì áp đặt cứng nhắc, mỗi bộ trang phục đều có bảng quy tắc rõ ràng. Động cơ Cultural Compass tự động chấm điểm từng thay đổi của người dùng theo 4 mức: Phù hợp · Cách tân có chủ đích · Cần xem lại bối cảnh · Sai lệch – không nên, luôn đi kèm lời giải thích "vì sao" và gợi ý cách sửa.

Chốt chặn chống lai căng văn hóa: Hệ thống tự động cảnh báo đỏ khi người dùng phối các chi tiết ngoại lai (như thắt lưng obi, nơ jeogori hanbok) và tích hợp trò chơi "Việt hay không?" bằng ảnh thật. Đặc biệt, các bản phối bị chấm "Sai lệch" sẽ bị chặn hoàn toàn ở tầng Backend, tuyệt đối không được gửi sang AI để dựng ảnh.

Nguồn sự thật duy nhất (Single Source of Truth): Mọi dữ kiện trong ứng dụng đều được gắn mã định danh từ 145 nguồn tư liệu xác thực (sourceid), được kiểm duyệt tự động qua hệ thống kịch bản checkcontent và check_links.

✨ 2. Ứng dụng Google Gemini Đa phương thức ở 7 vai trò xuyên suốt

Với nguyên tắc thiết kế "Luật văn hóa quyết định, Gemini thể hiện", hệ sinh thái mô hình Google Gemini được khai thác tối đa sức mạnh đa phương thức (Nhìn – Vẽ – Nói – Nghe – Hiểu):

Thử đồ trên ảnh thật (gemini-2.5-flash-image / Nano Banana): Kết hợp ảnh chân dung người dùng, ảnh mẫu trang phục chuẩn và prompt lắp ghép tự động từ dữ liệu (mustkeep, mustavoid) để dựng ảnh người dùng mặc bộ đồ vừa phối đúng màu sắc, phụ kiện và bối cảnh dịp lễ mà vẫn giữ nguyên gương mặt, vóc dáng (đạt tỉ lệ thành công 8/8 lần gọi liên tiếp, thời gian phản hồi trung vị khoảng 12 giây).

Trợ lý văn hóa "Hỏi Tèo" chống ảo giác (gemini-3.8-flash): Trả về dữ liệu có cấu trúc JSON kèm danh sách source_id có thể bấm để đối chiếu. Nhờ cơ chế rào chắn nghiêm ngặt và kiểm tra chéo ở Backend, Tèo đạt tỉ lệ từ chối 10/10 trước các câu hỏi ngoài dữ liệu, thiếu căn cứ hoặc cố tình bẻ khóa (jailbreak).

Kể chuyện đa giác quan (Gemini TTS & Audio Understanding): Gemini TTS lồng tiếng cho 4 nhân vật (Bà, Tí, Tèo, cô giáo) qua 36 câu thoại mở đầu với cảm xúc riêng biệt; sau đó Gemini Audio nghe lại chính tệp âm thanh đó để căn chỉnh thời gian hiển thị từng dòng phụ đề khớp tới từng giây.

Minh họa nhất quán & Giám khảo AI tự động: Sử dụng một "Art Bible" chung lấy cảm hứng từ màu tranh Đông Hồ và chất liệu giấy dó để vẽ 10 cảnh mở đầu và 27 điểm dừng. Đồng thời, dùng Gemini Vision làm giám khảo chấm điểm ảnh thử đồ (grade_tryon) theo danh sách kiểm tra để tối ưu hóa các phiên bản prompt bằng số liệu thực nghiệm.

🗺️ 3. Hành trình "Sổ tay của Bà" giàu tính tương tác & Tinh thần đồng tạo cùng cộng đồng

Du ngoạn 5 vùng di sản qua Gamification: Bản đồ SVG Việt Nam (hiển thị đầy đủ quần đảo Hoàng Sa, Trường Sa) dẫn lối qua 5 chương (Bắc Ninh, Huế, Cần Thơ, Sơn La, Đắk Lắk) với 27 điểm dừng, nhật ký của Bà, bưu thiếp kỷ niệm và 10 trò chơi văn hóa tương tác (in tranh Đông Hồ, hát đối quan họ, ghép áo ngũ thân, mâm cơm kiểu Huế, cây bẹo chợ nổi, đánh chiêng...).

Tôn trọng bản sắc và đồng tạo cùng cộng đồng: Đối với trang phục các dân tộc thiểu số như Áo cóm (dân tộc Thái) và Thổ cẩm Ê Đê, dự án chủ động giới thiệu trong chương đọc và đánh dấu trạng thái chờ cộng đồng địa phương cùng chuyên gia thẩm định trước khi đưa vào tủ phối đồ, thể hiện sự cẩn trọng và tôn trọng sâu sắc với văn hóa bản địa.

👘 4. Từ "Tủ áo số" đến cuốn Lookbook "Du Ký" ngoài đời thực

Tủ áo thông minh đa tiện ích: Hỗ trợ phối 4 hệ trang phục (Áo dài, Áo ngũ thân, Áo bà ba, Áo tứ thân) cùng 15 phụ kiện trên búp bê giấy nam/nữ cho 5 dịp cụ thể (Tết/đi chùa, lễ hội truyền thống, sự kiện trường/kỷ yếu, chụp ảnh di tích, dự đám cưới). Tích hợp dự báo thời tiết thực tế ngày đi (Open-Meteo), nhận xét độ hài hòa màu sắc, ghim so sánh tối đa 3 phương án cạnh nhau và danh sách địa chỉ thuê/may uy tín.

Sổ tay "Du Ký" lan tỏa tri thức: Người dùng có thể lưu trang kế hoạch "Sắp đi", cập nhật trang "Đã mặc" với ảnh chụp thực tế, sưu tầm bộ con dấu Đến · Hiểu · Mặc của từng vùng, đồng bộ đám mây qua Supabase và xuất ảnh chuẩn mạng xã hội (1080x1350) đính kèm tên trang phục, vùng miền và nguồn tư liệu để tự tin chia sẻ mà không sợ bị bắt bẻ.

⚙️ 5. Kiến trúc Kỹ thuật Vững chắc, Bảo mật & Hoạt động mượt mà cả ở chế độ Tĩnh (Serverless Fallback)

Động cơ kép Python & TypeScript: Thuật toán cốt lõi Cultural Compass được xây dựng song song trên cả Backend (FastAPI / Python) và Frontend (Next.js 16 / React 19 / TypeScript) với cùng một bộ dữ liệu kiểm thử (shared fixtures). Nhờ đó, ngay cả khi chạy bản tĩnh trên GitHub Pages không có máy chủ hoặc khi hết hạn mức API, người dùng vẫn có thể đọc sổ, chơi game, phối đồ và chấm điểm văn hóa trọn vẹn.

Kiểm thử nghiêm ngặt & Bảo mật quyền riêng tư: Dự án sở hữu hệ thống 610 bài kiểm thử tự động (450 bài test Frontend bằng Vitest, 160 bài test Backend bằng pytest). Toàn bộ API key được bảo vệ hoàn toàn ở phía Backend, và ảnh chân dung người dùng tải lên chỉ được xử lý tạm thời trên bộ nhớ RAM trong lúc tạo ảnh, tuyệt đối không lưu trữ hay tạo bộ nhớ đệm (cache) trên máy chủ.