Atase — это экосистема изучения языка, сочетающая современную программную архитектуру с академической программой русского языка, построенная на материалах с открытым исходным кодом и разработанная с дипломатической точностью. Выходя за рамки традиционных методов, она предлагает интегрированный опыт с геймификацией, интерактивной библиотекой и интеллектуальным голосовым движком.
Atase — это не просто приложение для заучивания слов, а цифровая дипломатическая школа, передающая пользователю дух и культурную глубину русского языка (классические сказки, система заслуг). Проект создан в рамках конкурса «Дипломаты русского слова» с использованием высочайших стандартов программного обеспечения (Next.js 14+, Drizzle ORM, Tailwind).
Основные модули, отличающие Atase от других платформ:
- Академическая учебная программа: Структура юнитов, предлагающая прогресс на основе заслуг от начального до продвинутого уровня.
- Библиотека Atase: Цифровая библиотека, представляющая избранные сказки из классической русской литературы в многоуровневом (A1.1, A1.2) и постраничном интерактивном формате.
- Игра в слова: Высокоинтерактивный игровой модуль для закрепления словарного запаса из юнитов, где игроки соревнуются со временем.
- Интеллектуальный синтез речи (TTS): Работающий в браузере интеллектуальный движок, который фильтрует турецкие пояснения и озвучивает только русские тексты профессиональным тоном.
- Заслуги и конкуренция: Система рангов на основе баллов пользователей и глобальная таблица лидеров.
- Framework: Next.js 14+ (App Router)
- База данных: Neon PostgreSQL (Serverless)
- ORM: Drizzle ORM
- Аутентификация: Clerk
- Стилизация: Tailwind CSS & Shadcn UI
- Управление состоянием: Zustand
Модульная иерархия приложения приведена ниже:
atase/
|- actions/ # Серверные действия (Server actions для баллов, прогресса и сброса)
|- app/ # Next.js App Router (Модули обучения, библиотека и панель управления)
|- components/ # Реактивные компоненты (Движок WordGame, ридер книг и UI kit)
|- constants/ # Содержимое библиотеки и статические наборы данных
|- db/ # Схема базы данных и уровень запросов
|- lib/ # Интеллектуальный TTS движок и вспомогательные функции
|- public/ # Оптимизированные ассеты «Ushanka Bear» и брендовые изображения
|- scripts/ # Скрипты загрузки учебной программы и синхронизации БД
|- store/ # Централизованное управление состоянием (Zustand)
Чтобы инициализировать проект в локальной среде, необходимо выполнить следующие шаги.
- Убедитесь, что установлен Node.js (v18+).
- Клонируйте проект и создайте файл .env в корневом каталоге.
Используйте следующий шаблон:
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=pk_test_...
CLERK_SECRET_KEY=sk_test_...
DATABASE_URL="postgresql://..."
NEXT_PUBLIC_APP_URL=http://localhost:3000
CLERK_ADMIN_IDS="user_..."# Установка зависимостей
npm install --legacy-peer-deps
# Создание базы данных и загрузка учебной программы Atase
npm run db:push && npm run db:prodnpm run dev© 2026 Четин Каракулак и Сена Каракулак — создано на основе материалов с открытым исходным кодом и сообществных проектов в рамках конкурса проектов «Дипломаты русского слова».
Лицензия MIT Copyright (c) 2026 Четин Каракулак и Сена Каракулак
Atase, modern yazilim mimarisi ile akademik Rusca mufredatini birlestiren, acik kaynak materyaller uzerine insa edilmis ve diplomatik hassasiyetle kurgulanmis bir dil ogrenme ekosistemidir. Geleneksel yontemlerin otesine gecerek; oyunlastirma, interaktif kutuphane ve akilli ses motoru ile butunlesik bir deneyim sunar.
Atase, sadece kelime ezberleten bir uygulama degil, Rusca dilinin ruhunu ve kulturel derinligini (klasik masallar, liyakat sistemi) kullaniciya aktaran dijital bir diplomasi okuludur. "Rusca Sozunun Diplomatlari" projesi kapsaminda, en yuksek yazilim standartlari (Next.js 14+, Drizzle ORM, Tailwind) kullanilarak insa edilmistir.
Atase'yi diger platformlardan ayiran temel moduller:
- Akademik Kurikulum: Baslangictan ileri seviyeye, liyakat temelli ilerleme sunan unite yapisi.
- Atase Kutuphanesi: Klasik Rus edebiyatindan secilmis masallari, seviyelendirilmis (A1.1, A1.2) ve sayfa tabanli interaktif bir formatta sunan dijital kutuphane.
- Kelime Oyunu: Unitelerdeki kelime dagarcigini pekistiren, zamana karsi yararsilan yuksek etkilesimli oyun modulu.
- Akilli Ses Sentezi (TTS): Tarayici uzerinde calisan, Turkce aciklamalari filtreleyerek sadece Rusca metinleri profesyonel tonda seslendiren akilli motor.
- Liyakat ve Rekabet: Kullanici puanlarina dayali rutbe sistemi ve kuresel liderlik tablosu.
- Framework: Next.js 14+ (App Router)
- Veritabani: Neon PostgreSQL (Serverless)
- ORM: Drizzle ORM
- Kimlik Dogrulama: Clerk
- Stil: Tailwind CSS & Shadcn UI
- Durum Yonetimi: Zustand
Uygulamanin moduler hiyerarsisi asagidadir:
atase/
|- actions/ # Sunucu tarafi islemler (Puan, ilerleme, sifirlama server actionlari)
|- app/ # Next.js App Router (Ogrenme modulleri, kutuphane ve yonetim paneli)
|- components/ # Reaktif bilesenler (WordGame motoru, Kitap okuyucu ve UI kit)
|- constants/ # Kutuphane icerikleri ve statik veri setleri
|- db/ # Veritabani semasi ve sorgu katmani
|- lib/ # Akilli TTS motoru ve yardimci fonksiyonlar
|- public/ # Optimize edilmis "Ushanka Bear" assetleri ve marka gorselleri
|- scripts/ # Mufredat yukleme ve veritabani senkronizasyon betikleri
|- store/ # Merkezi durum yonetimi (Zustand)
Projeyi yerel ortamda ilklendirmek icin asagidaki adimlar izlenmelidir.
- Node.js (v18+) yuklu oldugundan emin olun.
- Projeyi klonlayin ve kok dizinde bir .env dosyasi olusturun.
Asagidaki sablonu kullanin:
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=pk_test_...
CLERK_SECRET_KEY=sk_test_...
DATABASE_URL="postgresql://..."
NEXT_PUBLIC_APP_URL=http://localhost:3000
CLERK_ADMIN_IDS="user_..."# Bagimliliklari yukle
npm install --legacy-peer-deps
# Veritabanini olustur ve Atase mufredatini yukle
npm run db:push && npm run db:prodnpm run dev© 2026 Çetin Karakulak & Sena Karakulak - Rusca Sozunun Diplomatlari Proje Yarismasi kapsaminda, acik kaynak materyaller ve topluluk projeleri uzerine insa edilmistir.
MIT License Copyright (c) 2026 Çetin Karakulak & Sena Karakulak