# 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.