Add Excel estimate export workflow to CLI

This commit is contained in:
2026-02-11 13:55:07 -05:00
parent c24d5acc8b
commit 0798d90043
5 changed files with 215 additions and 16 deletions

View File

@@ -19,8 +19,31 @@ python -m gov_travel.main --db data/travel_rates.sqlite3
- `--sources international domestic accommodations` to limit which sources are scraped.
- `--pause 1.5` to pause between processing tables.
- `--log-level DEBUG` to increase logging verbosity.
- `--no-scrape` to skip scraping and only work with existing database data.
- `GOV_TRAVEL_USER_AGENT="YourOrg/1.0"` to override the default user agent.
## Export an estimate to Excel
After data exists in SQLite (from a previous scrape), export a cost estimate workbook:
```bash
python -m gov_travel.main \
--db data/travel_rates.sqlite3 \
--no-scrape \
--export-estimate-xlsx output/travel_estimate.xlsx \
--estimate-days 5 \
--estimate-rate-type meal \
--estimate-country Canada \
--estimate-city Ottawa \
--estimate-lodging-per-night 235 \
--estimate-transport-total 175 \
--estimate-misc-total 80
```
Workbook sheets:
- `estimate_summary`: Days, recommended meal allowance, line item subtotals, and grand total.
- `matched_rate_entries`: Source rows used to derive the allowance recommendation.
## Database contents
The database includes:
- `raw_tables` for every scraped HTML table.
- `rate_entries` for parsed rate rows (country/city/province + rate fields).
@@ -28,3 +51,9 @@ The database includes:
- `accommodations` for parsed lodging listings.
If a field is not detected by the heuristics, the full row is still preserved in `raw_tables` and the `raw_json` columns for deeper post-processing.
## Suggested next improvements
- Add automated tests for parser heuristics and the estimate export path.
- Add currency conversion in estimate exports using `exchange_rates` so totals can be normalized to CAD.
- Add source-level freshness metadata to avoid duplicate inserts when scraping repeatedly.
- Expose estimate/export in a small web UI for non-technical users.