# FinlyticApp (Flutter Application)

FinlyticApp is the cross-platform mobile and desktop application for the Finlytic Enterprise Financial Intelligence Platform, built with Flutter, BLoC State Management, and Clean Architecture.

---

## Clean Architecture Structure

```
lib/
├── core/
│   ├── network/       # ApiClient (Dio), SignalRService
│   ├── services/      # SecureStorageService
│   ├── theme/         # AppTheme (Glassmorphism, Dark Emerald Theme)
│   └── widgets/       # GlassContainer, StatusBadge, AssetLogoWidget
└── features/
    ├── trades/        # models/, repositories/, bloc/, views/, widgets/
    ├── asset_detail/  # models/, repositories/, bloc/, views/, widgets/
    ├── favorites/     # models/, repositories/, bloc/, views/, widgets/
    ├── auth/          # models/, repositories/, bloc/, views/, widgets/
    ├── admin/         # models/, repositories/, bloc/, views/, widgets/
    ├── calendar/      # models/, repositories/, bloc/, views/, widgets/
    └── search/        # models/, repositories/, bloc/, views/, widgets/
```

---

## Core Features & Modules

### 1. Trades Module
- **`TradeModel`**, **`TradeRepository`**, **`TradeBloc`**: Manages real-time trade signals, entry/exit prices, stop-loss/take-profit, and position closure.
- **`TradesFeedScreen`**: Interactive trade cards with live profit/loss indicators.

### 2. Assets & Technical Analysis Module
- **`AssetModel`**, **`FundamentalDataModel`**, **`TechnicalAnalysisModel`**, **`AssetRepository`**, **`AssetDetailBloc`**.
- **`AssetDetailScreen`** & **`TechnicalAnalysisTabView`**: Interactive chart indicators (EMA 20, SMA 50, SMA 200, Supertrend, RSI, MACD).

### 3. Favorites Module
- **`FavoriteAssetModel`**, **`FavoritesRepository`**, **`FavoritesBloc`**.
- **`FavoritesScreen`** & **`WatchlistCard`**: Real-time price tracking and watchlist management.

### 4. Auth Module
- **`UserModel`** (with `Equatable`), **`AuthRepository`**, **`AuthBloc`**.
- **`LoginScreen`**, **`RegisterScreen`**, **`ForgotPasswordDialog`**: Secure JWT authentication and persistent local session storage.

### 5. Admin Module
- **`AdminUserModel`**, **`AdminRepository`**, **`AdminBloc`**.
- **`AdminUsersScreen`**: User role management and AI pipeline cutoff settings.

### 6. Calendar Module
- **`CorporateEventModel`**, **`CalendarRepository`**, **`CalendarBloc`**.
- **`CorporateCalendarScreen`**: Monthly calendar grid, date filter, and category chips (Earnings, ExDividend, Payout).

### 7. Search Module
- **`SearchResultModel`**, **`SearchRepository`**, **`SearchBloc`** (with Debounce).
- **`AssetSearchDialog`**: Reactive omnibox asset search with ISIN lookup and instant logo resolution.

---

## Feature Status

### Implemented Features
- [x] Full Clean Architecture migration across all 7 feature modules (`models/`, `repositories/`, `bloc/`).
- [x] Strongly typed data models extending `Equatable` for zero redundant widget rebuilds.
- [x] Complete removal of all mock/demo fallbacks in repositories and screens.
- [x] SignalR WebSocket integration (`NewsHub`, `TradeHub`).
- [x] Premium glassmorphism dark mode design system (`AppTheme`).

### Planned Features
- [ ] Push Notifications integration via Firebase Cloud Messaging for instant trade alerts.
- [ ] Biometric Authentication (FaceID / TouchID / Fingerprint) unlock.