Services¶

Current MVP

Core services for financial data retrieval and company lookups are implemented in Phase 3.

Service Layer Design¶

FinancialService¶

class FinancialService:
    async def get_income_statement(
        self, company_id: int, period: str
    ) -> IncomeStatement: ...

    async def get_key_ratios(
        self, company_id: int, periods: list[str]
    ) -> list[FinancialRatio]: ...

CompanyService¶

SearchService¶

Planned Architecture (Future Phases)

Hybrid search combining pgvector and Elasticsearch is implemented in Phase 3.

AIAnalysisService¶

Planned Architecture (Future Phases)

LLM-powered analysis service is implemented in Phase 3.

CacheService¶

Planned Architecture (Future Phases)

Redis caching layer is implemented in Phase 6.