AINovelFlow - Story Architect Engine ✍️✨

AINovelFlow là một công cụ hỗ trợ sáng tác truyện và kịch bản chuyên nghiệp được trợ lực bởi trí tuệ nhân tạo (Gemini AI). Với sự đồng hành của persona "bé Ginger", ứng dụng giúp bạn biến những ý tưởng sơ khai thành những tác phẩm hoàn chỉnh với đầy đủ bối cảnh, nhân vật và nội dung chi tiết.

🌟 Tính năng nổi bật

• Persona "bé Ginger": Trợ lý AI chuyên nghiệp, tận tâm với phong cách viết văn lôi cuốn và hiểu biết sâu sắc về cấu trúc kịch bản/tiểu thuyết.
• Phân tích Nền tảng (Foundation Art): Tự động phân tích ý tưởng để xây dựng Thế giới (World Context) và Hồ sơ nhân vật (Character Profiles) chi tiết trước khi viết.
• Hỗ trợ Song ngữ (Bilingual Mode): Tự động dịch truyện theo từng câu hoặc từng cụm từ, hỗ trợ học ngoại ngữ qua đọc truyện.
• Tạo Hình ảnh AI: Tích hợp Gemini 2.0 Flash để tạo bìa truyện (Book Cover) và hình ảnh minh họa dựa trên prompt gợi ý.
• Hệ thống TTS (Text-to-Speech) Tối ưu:
  • Hỗ trợ đa ngôn ngữ, đặc biệt là Tiếng Việt.
  • Giao diện cài đặt âm thanh rộng rãi, dễ dàng tìm kiếm và lựa chọn giọng đọc (Microsoft HoaiMy, Google Tiếng Việt, v.v.).
  • Chế độ đọc song ngữ thông minh.
• Cơ chế Fallback thông minh: Tự động luân chuyển giữa các mô hình (Gemini 3 Preview, 2.5 Flash, 2.0 Flash) để đảm bảo quá trình sáng tác không bị gián đoạn do lỗi nghẽn mạng.

🛠 Công nghệ sử dụng

• Frontend: Next.js 15+, React 19, TypeScript.
• Styling: Tailwind CSS 4.
• State Management: Zustand (có persist storage).
• AI Engine: Google Generative AI (@google/genai).
• Icons: Lucide React.
• Animations: Framer Motion.

🚀 Hướng dẫn cài đặt

1. Yêu cầu hệ thống

• Đã cài đặt Node.js (khuyên dùng phiên bản LTS mới nhất).
• Một Google Gemini API Key (lấy tại Google AI Studio).

2. Các bước cài đặt

1. Clone project hoặc giải nén source code.
2. Truy cập vào thư mục frontend:

   cd frontend

3. Cài đặt các thư viện phụ thuộc:

   npm install

4. Cấu hình biến môi trường: Tạo file .env.local trong thư mục frontend/ và dán vào nội dung sau:

   GOOGLE_API_KEY=your_api_key_here

3. Chạy ứng dụng

Khởi động server phát triển:

npm run dev

Sau đó, mở trình duyệt và truy cập: http://localhost:3000

📖 Hướng dẫn sử dụng

1. Nhập ý tưởng: Tại mục Narrative Core, hãy mô tả ngắn gọn cốt truyện bạn muốn viết.
2. Phân tích nền tảng: Nhấn nút "Phân tích ý tưởng" để bé Ginger xây dựng thế giới và nhân vật cho bạn.
3. Cấu hình truyện: Chọn thể loại, phong cách (Tiểu thuyết/Kịch bản), ngôn ngữ và số chương mong muốn.
4. Tạo bìa: Nhấn "Tạo bìa truyện AI" để có một hình ảnh minh họa chuyên nghiệp.
5. Viết truyện: Nhấn nút "Bắt Đồ Viết Truyện" để AI bắt đầu dệt nên tác phẩm của bạn.
6. Cài đặt âm thanh: Nhấn vào biểu tượng loa hoặc TTS Settings để chọn giọng đọc. Lưu ý: Hãy dùng Google Chrome hoặc Microsoft Edge để có những giọng đọc Tiếng Việt tốt nhất.

---

Phát triển bởi đội ngũ thiết kế AINovelFlow. Chúc bạn có những giây phút sáng tác tuyệt vời!