Skip to content

v2.2.0

Choose a tag to compare

@huynhbaoking112 huynhbaoking112 released this 19 Apr 16:18
· 129 commits to main since this release

Release 2.2.0

Overview

This release significantly expands the Stocks + Backtest + Lead Agent capabilities:

  • Added multiple stock-related APIs (catalog, company info, intraday prices, watchlists)
  • Introduced a public Backtest API and an Ichimoku template
  • Upgraded Lead Agent with context summarization
  • Expanded frontend integration docs and test coverage

Key Highlights

1) Stock Catalog API (PR #20, #22)

  • Added stock symbol catalog foundations powered by VNStock
  • Main endpoint: GET /api/v1/stocks
  • Supports search/filter/pagination; extended filtering with industry_code
  • Added caching + refresh flow + data normalization
  • Frontend docs:
    • doc/feature/stocks/frontend_integration_guide.md
    • doc/feature/stocks/stock_industries.json

2) Stock Company Info API (PR #23, #24)

  • Added company-level endpoints:
    • GET /api/v1/stocks/{symbol}/company/overview
    • GET /api/v1/stocks/{symbol}/company/officers
    • GET /api/v1/stocks/{symbol}/company/affiliate
    • GET /api/v1/stocks/{symbol}/company/events
    • GET /api/v1/stocks/{symbol}/company/news
    • GET /api/v1/stocks/{symbol}/company/reports
  • Improved resilience for missing upstream values (NaN → None) to stabilize schema validation
  • Frontend docs:
    • doc/feature/stocks/stock_company_frontend_guide.md

3) Stock Price Timeseries / Intraday (PR #25)

  • Added price endpoints:
    • GET /api/v1/stocks/{symbol}/prices/history
    • GET /api/v1/stocks/{symbol}/prices/intraday
  • Added dedicated gateway/service/cache for price data
  • Frontend docs:
    • doc/feature/stocks/stock_price_frontend_guide.md

4) Stock Watchlists (PR #27)

  • Added watchlist APIs:
    • POST /api/v1/stocks/watchlists
    • GET /api/v1/stocks/watchlists
    • DELETE /api/v1/stocks/watchlists/{watchlist_id}
    • GET /api/v1/stocks/watchlists/{watchlist_id}/items
  • Added watchlist model, repositories, service, and domain-specific exceptions
  • Frontend docs:
    • doc/feature/stocks/stock_watchlist_frontend_guide.md

5) Public Backtest API Domain (PR #26)

  • Added public backtest endpoints:
    • GET /api/v1/backtests/templates
    • POST /api/v1/backtests/run
  • Added backtest engine/metrics/templates/data-service orchestration
  • Expanded schema/router/service/integration test coverage

6) Ichimoku Backtest Template (PR #28)

  • Added Ichimoku strategy template for backtesting
  • Added default strategy parameters (tenkan/kijun/senkou/displacement/warmup)
  • Updated presenter/schema/service flows
  • Frontend docs:
    • doc/feature/backtest/frontend_integration_guide.md

7) Lead Agent Context Summarization (PR #29)

  • Added context summarization middleware for Lead Agent
  • Updated state/prompt/runtime middleware wiring
  • Goal: keep orchestration quality stable while controlling context growth

8) Documentation updates (PR #21 + README update commit)

  • Added/updated frontend integration docs for newly introduced modules
  • Updated README.md

Included PRs

  • #20 King/feat/stocklist
  • #21 DOC
  • #22 King/feat/stocklist
  • #23 King/feat/companydetail
  • #24 fix bug AI review
  • #25 King/feat/intraday
  • #26 King/feat/backtest
  • #27 King/feat/saved stock
  • #28 King/feat/ichimoku
  • #29 King/feat/sumary context

Compatibility Notes

  • New VNStock-related environment variable added in .env.example
  • New endpoints introduced under /api/v1/stocks and /api/v1/backtests
  • Frontend integration updates are recommended based on the new docs