feat(Fundamentals): add fundamentals service

2026-08-09 21:01:39 +02:00
parent e0778b88ea
commit 605e41cfeb
21 changed files with 3122 additions and 0 deletions
@@ -0,0 +1,31 @@
+# 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.