Nihongo Nakama 日本語仲間

Một nền tảng học tiếng Nhật trọn gói cho trình độ N5–N4, được xây dựng bằng cách hợp nhất các module học tập rời rạc thành một monolith duy nhất: một ứng dụng, một cơ sở dữ liệu, một tài khoản.

Nội dung

1.984 từ vựng, 284 kanji, 365 mẫu luyện viết, 50 bài ngữ pháp Minna no Nihongo và thư viện đọc – nghe.

Dữ liệu

SQLite nhúng, lịch ôn tập ngắt quãng, XP, chuỗi ngày học và thành tựu được lưu theo từng tài khoản.

Bảo mật

Mật khẩu băm scrypt, phiên đăng nhập lưu trong DB với cookie httpOnly, giới hạn số lần đăng nhập sai.

Phương pháp

Học theo immersion-first: ôn đúng lúc, luyện đầu ra ngay sau khi học từ mới.

Nguồn gốc

Dự án được tổ chức lại từ các ứng dụng học tập trước đây (Home, Vocabulary, Writing, Speaking, Reading & Listening). Mã nguồn gốc được lưu trongarchive/legacy-apps/để tham khảo; toàn bộ chức năng đang chạy nằm trong thư mục src/. Công cụ phụ đề trực tiếp jp-live-subs là một dịch vụ tùy chọn riêng, cần ffmpeg, yt-dlp và khóa Gemini.

Dữ liệu khi trò chuyện với ひより (AI Roleplay)

Khi bật micro, âm thanh đi thẳng từ trình duyệt tới Google Gemini Live để Hiyori nghe và trả lời. Micro chỉ mở khi bạn bấm nút và tắt khi bấm lại hoặc rời trang.
Trình duyệt chỉ nhận một khoá tạm thời dùng một lần (hết hạn sau 30 phút); khoá API thật nằm trên máy chủ. Nihongo Nakama không ghi lại hay lưu âm thanh; Google xử lý theo điều khoản Gemini API.
Hội thoại được chép thành chữ và lưu cục bộ trong trình duyệt. Tên và chủ đề bạn kể được gửi kèm khi mở phiên để Hiyori nhớ bạn; nút “Bắt đầu lại” hoặc tải lại trang sẽ xoá chúng.
“Lưu kết quả” chỉ ghi số lượt nói và thời lượng vào tài khoản để tính XP, không lưu nội dung hội thoại.

Công nghệ

Next.js 16 (App Router) · React 19 · Tailwind CSS v4 · Base UI · SQLite quanode:sqlite· TypeScript.

Tạo tài khoản Đăng nhập