Finlytic/FinlyticApp/Project.md

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

• Full Clean Architecture migration across all 7 feature modules (models/, repositories/, bloc/).
• Strongly typed data models extending Equatable for zero redundant widget rebuilds.
• Complete removal of all mock/demo fallbacks in repositories and screens.
• SignalR WebSocket integration (NewsHub, TradeHub).
• 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.