first version

2026-10-07 15:53:12 +02:00
commit 9d8c2a0488
14 changed files with 1481 additions and 0 deletions
@@ -0,0 +1,53 @@
+# Abacus → Kimai
+
+Firefox extension: grab worked hours from MyAbacus, then create Kimai timesheets so that every day matches 100%.
+
+## Install (dev)
+
+`about:debugging#/runtime/this-firefox` → *Load Temporary Add-on…* → pick `manifest.json`.
+Or `npx web-ext run` from this folder.
+
+## Setup
+
+1. Dashboard → **Settings**: Kimai URL + API token (Kimai 2: *My profile → API access*). Click **Test**, which also loads projects/activities.
+2. Pick a **default project / activity**: everything not covered by a rule goes there.
+3. **Recurring rules**: e.g. `Weekly meeting`, 1h, Mon, start 09:00 → Customer X / Project Y, activity A.
+   - Leave *hours* empty for a "remainder" rule: e.g. Fridays rest goes to an internal project instead of the default.
+   - *Every N weeks* + *anchor* for bi-weekly stuff, *valid from/to* for temporary ones.
+
+## Usage
+
+1. Open MyAbacus on the **Gestion des temps** card, click the toolbar icon, pick *From / To*, **Read days from MyAbacus**.
+   It clicks ‹ / › day by day, reads every *Arrivée / Départ* pair (and *Total heures*), and saves as it goes
+   (popup can be closed, there's a *Stop* button). Days with an open clock-in (no *Départ*) are skipped and flagged.
+   *Generic extraction* (under "Other pages") is the old table/text scraper, for other layouts.
+2. Dashboard opens with one line per day (editable):
+   ```
+   2026-10-05 08:00-12:00 13:00-17:24   # stamped intervals
+   2026-10-06 8:24                      # total only
+   ```
+   If extraction fails, select the table in Abacus, copy, and use *Paste raw text*.
+3. **Compare with Kimai & plan**: for each day it computes `Abacus - existing Kimai`, then fills the gap:
+   fixed rules first (at their start time if free), then remainder rule / default.
+   Entries go into the Abacus intervals, never overlapping existing Kimai entries.
+4. Review, untick days you don't want, **Create entries in Kimai**. It re-checks afterwards; matched days show `✓ 100%`.
+
+Re-running is safe: existing Kimai time counts toward the total, so only the missing part is created.
+
+## Extraction tuning
+
+Settings → *Abacus extraction*:
+- **Row selector**: default `tr, [role="row"]`. If nothing dated is found, falls back to page text lines.
+- **Time mode**: `ranges` (`08:00 - 12:00`), `pairs` (in/out in separate columns), `duration` (only totals).
+- **Duration column**: which duration in a row is the worked time (`0` first, `-1` last), useful when rows also show target/balance.
+
+The raw text read during the last extraction is visible on the Sync tab, to help tweak those.
+
+## Files
+
+- `lib/parse.js`: Abacus text → days
+- `lib/planner.js`: days + existing Kimai + rules → entries to create
+- `lib/kimai.js`: REST client
+- `lib/abacus-crawl.js`: day-by-day reader for the MyAbacus card (injected in the page)
+- `popup/`: extraction from the active tab
+- `app/`: dashboard (sync, rules, settings)