diff --git a/TOOLS.md b/TOOLS.md index 381434b..4b568ef 100644 --- a/TOOLS.md +++ b/TOOLS.md @@ -184,15 +184,17 @@ Helper script: `~/bin/freescout` freescout mailboxes # List mailboxes freescout users # List users freescout report --from DATE --to DATE # Show time report (tab-separated) - [--mailbox ID] [--user ID] + [--mailbox ID] [--user ID] [--customer NAME] freescout excel --from DATE --to DATE # Generate invoice Excel - [--mailbox ID] [--user ID] [--output file.xlsx] + [--mailbox ID] [--user ID] [--customer NAME] [--output file.xlsx] ``` - Credentials: `.credentials/services.env` (CLOONAR_DB_* + FREESCOUT_DB_NAME) - Queries timelogs table directly (API doesn't expose time tracking) -- Excel groups by conversation, shows subject, customer, hours +- Excel groups by conversation, shows subject, customer, website, hours +- Customer and Website are custom field dropdowns (resolved to labels) - `time_spent` is stored in seconds, displayed as decimal hours +- Only timelogs within the date range are counted (not conversation dates) ---