Adding New Document Download Links

Filing download buttons in the Filings overlay are driven by filings_sources in Explorer's manifest.json. Each source maps a document type to a Python fetcher module.

Manifest entry

Each source defines:

Field Purpose
label Button text in the Filings overlay
filing_type Cache key and document classification
cache_policy How long blobs are retained (forever, edgar_hybrid, …)
trigger XPath-style path match (e.g. \.US/filings$)
module Python module path under apps.explorer.sources

Fetcher module

Implement a fetcher that returns filing metadata and file paths. Place it under fire-app-apps/explorer/sources/<market>/. The explorer service discovers sources at startup from the manifest.

Testing

  1. Add the manifest entry and fetcher module.
  2. Restart the backend (or reload Explorer).
  3. Open a matching stock's Filings overlay — the new button should appear.
  4. Run a fetch and confirm files land under filings/ with expected names.

See also: Downloading Filings