72 lines
3.3 KiB
Markdown
72 lines
3.3 KiB
Markdown
# 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.
|