32 lines
1.4 KiB
Markdown
32 lines
1.4 KiB
Markdown
# Finlytic Fundamentals Service
|
|
|
|
Finlytic Fundamentals is a C# background worker microservice responsible for fetching, caching, and serving financial fundamental data (P/E ratios, market cap, dividend yield, revenue growth, corporate calendar events) across global equities.
|
|
|
|
---
|
|
|
|
## Core Features & Architecture
|
|
|
|
1. **Fundamental Data Ingestion**:
|
|
- Scrapes and ingests company fundamentals (`AssetFundamentalsDto`) including P/E, EPS, Market Cap, Dividend Yield, Revenue, Profit Margins, and Debt-to-Equity ratios.
|
|
|
|
2. **Corporate Event Calendar**:
|
|
- Tracks earnings release dates, ex-dividend dates, payout dates, and shareholder meetings (`CorporateEventDto`).
|
|
|
|
3. **MQTT Distribution Channels**:
|
|
- Publishes fundamental updates to `finlytic/fundamentals/{isin}` and `finlytic/assets/fundamentals/{isin}`.
|
|
- Responds to RPC requests on `services/request/fundamentals_Get/#` and `services/request/events_GetAll/#`.
|
|
|
|
---
|
|
|
|
## Feature Status
|
|
|
|
### Implemented Features
|
|
- [x] Fundamentals Database Persistence & Caching (`FundamentalsDbContext`).
|
|
- [x] Corporate Event Calendar storage & query handlers.
|
|
- [x] Zero-Allocation MQTT serialization via `FinlyticJsonSerializerContext`.
|
|
- [x] Pure Worker Service architecture (`Host.CreateApplicationBuilder`, no Kestrel HTTP server).
|
|
|
|
### Planned Features
|
|
- [ ] Financial Modeling Prep / SEC EDGAR API automated quarterly filing sync.
|
|
- [ ] Automated Dividend Growth Rate & Dividend Safety Rating calculation engine.
|