Rahmat π¬ β Sozo ochiq loyiha va har qanday hissa qadrlanadi: kod, tarjima, dizayn, xato hisoboti yoki shunchaki g'oya.
git clone https://github.com/professorDeveloper/sozo.git
cd sozo
cp .env.example .env # .env pubspec asset β busiz build yiqiladi
flutter pub get
flutter runTalab: Flutter SDK (Dart ^3.11.1), Android SDK 34+, JDK 17.
Desktop uchun qo'shimcha: Windows'da Visual Studio C++ workload, Linux'da
libmpv-dev, macOS'da Xcode.
.env dagi barcha kalitlar ixtiyoriy β bo'sh qoldirilsa tegishli
imkoniyat o'chadi, ilova baribir ishga tushadi.
Feature-first + clean architecture:
lib/
core/ # Butun ilova bo'ylab ishlatiladigan narsalar
player/ js/ storage/ network/ theme/ di/ β¦
features/
<feature>/
data/ # Model, repository implementatsiyasi, servislar
domain/ # Entity, repository interfeysi, usecase
presentation/ # Bloc/Cubit, sahifalar, vidjetlar
Qoidalar:
presentationhech qachondataga to'g'ridan-to'g'ri murojaat qilmaydi. Faqatdomainorqali.- Yangi bog'liqlik
core/di/injection.dartda ro'yxatdan o'tadi. - State β
flutter_bloc. Yangi ekran uchun yangi Bloc/Cubit,setStateemas. - Navigatsiya β
go_router, marshrutcore/router/app_router.dartda. - Matn to'g'ridan-to'g'ri yozilmaydi β
assets/translations/*.jsonga kalit qo'shiladi va.tr()orqali ishlatiladi.
Bu repoda izoh nima qilinayotganini emas, nega qilinganini tushuntiradi.
Kod nima qilishini o'zi aytadi; nega aynan shunday qilinganini faqat izoh
aytadi. Mavjud fayllardagi uslubga qarang β masalan pubspec.yaml dagi har
bir paket izohi yoki core/js/js_runtime_service.dart boshidagi blok.
Yomon:
// Ro'yxatni saralaymiz
items.sort(...);Yaxshi:
// Eng yangi epizod tepada bo'lishi kerak: foydalanuvchi seriyani ochganda
// deyarli har doim oxirgi ko'rgan joyidan davom etadi, birinchisidan emas.
items.sort(...);Yuborishdan oldin:
flutter analyze # toza o'tishi shart
flutter test
dart format lib/- Bitta PR β bitta maqsad. "Xato tuzatildi + yangi ekran + refactor" uchta PR.
- Commit xabari nima o'zgarganini aytsin:
fix(player): mkv oqimida audio yo'l almashmasligi - PR shabloni to'ldirilsin, ayniqsa qanday tekshirilgani.
- Draft PR ochish mutlaqo normal β yarim yo'ldagi ish haqida maslahat so'rash uchun.
Manbalar ilovada emas, backend'da turadi:
sozo-backend β
src/providers/. U yerda harness bor, ilovani build qilmasdan sinash mumkin:
node tools/provider-harness/run.js <provider-id>assets/translations/ da en.json, ru.json, uz.json, ar.json bor.
Yangi til qo'shish uchun en.json ni nusxalang, tarjima qiling va
lib/main.dart dagi supportedLocales ga qo'shing.
Kalit yo'qolib qolmasligi uchun:
dart run tool/check_translations.dartSozo GPL-3.0 ostida. Hissa qo'shish orqali kodingiz ham shu litsenziya ostida tarqatilishiga rozilik bildirasiz β CLA.md.
Sun'iy intellekt yordamida yozilgan kod uchun β AI_POLICY.md.
Telegram yoki Discord β ikkalasida ham tez javob beriladi.