---
name: fikoyt-flutter
description: FikoYT Flutter uygulamalarını (mesaici, akcali, sistem, hmi_pano, soyagaci + fikoyt_ui/fikoyt_plugin kütüphaneleri) Fikri'nin tarzında geliştirme. Isar şema/migration güvenliği, build_runner, çoklu-proje test, Modbus HMI, backend fikoyt.com:9000. Bu skill "flutter", "dart", "isar", "build_runner", "mesaici", "akcali", "hmi", "modbus", "fikoyt_ui", "pubspec", "apk", "flutter build" anahtar kelimeleriyle tetiklenir.
---

# fikoyt-flutter — Fikri tarzında Flutter geliştirme

Konum: `flutter/` · Backend: https://fikoyt.com:9000 (Go/Fiber) · Platform: Android + Windows (+Linux/macOS çoğu).
Ayrıntı fihristi (ÖNCE OKU): hafıza `projeler/flutter/_index.md` → uygulama başına detay dosyaları.

## Projeler
- Kütüphaneler: **fikoyt_ui** (HTTP, Socket.IO, bildirim, cihaz — paylaşılan çekirdek), fikoyt_ui_web, fikoyt_plugin (native FFI).
- Uygulamalar: fikoyt_mesaici v2.0.5 (mesai/maaş), fikoyt_akcali v2.0.4 + akcali_v1 (akıllı fabrika), fikoyt_sistem (sistem yönetim), fikoyt_hmi_pano (endüstriyel HMI + Modbus), fikoyt_soyagaci (genealoji).
- fikoyt_ui KULLANAN app'lerde çekirdek davranışı app içinde kopyalama — kütüphaneyi genişlet (tüm app'ler kazanır).

## Tarz
Küçük iş direkt; büyük işe kısa plan. Commit yalnız istenince. Türkçe isimlendirme + kullanıcı mesajları. UI: dark+light tema, bol animasyon/micro-interaction, tam responsive, oyun-tarzı kart estetiği. Perf: liste → ListView.builder/sliver, ağır iş → isolate, gereksiz rebuild'den kaçın (const, select).

## KRİTİK: Isar şema güvenliği
`*.model.dart` içinde @Collection değişikliği (alan ekleme/silme/tip değişimi) = migration riski → **flutter-isar-migrator ajanını kullan** (Agent tool'da kayıtlı: eksik alan tespiti + build_runner sonrası şema uyumluluk doğrulaması). Alan SİLME/tip değiştirme mevcut kullanıcı verisini bozabilir — önce geriye-uyum planı, sonra kod. Studyo'da her şey anında Isar'a yazılır (debounce'lu taslak) — o kalıbı boz-ma.

## Derleme / Test
```
cd flutter/<app>
flutter pub get
dart run build_runner build --delete-conflicting-outputs   # Isar/codegen sonrası ZORUNLU
flutter analyze                                            # bitirmeden yeşil olmalı
flutter build windows | flutter build apk
```
Global yardımcı skill'ler mevcut: `flutter-build-runner`, `flutter-multi-project-test` (çoklu projede toplu test) — uygunsa çağır.

## Değişiklik disiplini
1. Hangi app? Önce o app'in detay dosyasını oku (mimari farklı: akcali_v1 fikoyt_ui kullanır, v2 kullanmaz).
2. Socket.IO event'leri backend socket-events.md ile eşleşmeli (fikoyt-go-backend skill) — iki uçta aynı isim/payload.
3. HMI/Modbus (hmi_pano): register haritasına dokunurken mevcut cihaz konfigürasyonunu boz-ma; widget registry dinamik (39 HMI widget — hafıza `projeler/dinamik-bilesen-sistemi.md`).
4. analyze + build yeşil olmadan bitirme; cihaz testi kullanıcıya ("RUNTIME TEST" notu).