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
- Add the manifest entry and fetcher module.
- Restart the backend (or reload Explorer).
- Open a matching stock's Filings overlay — the new button should appear.
- Run a fetch and confirm files land under
filings/with expected names.
See also: Downloading Filings