54 lines
2.8 KiB
Markdown
54 lines
2.8 KiB
Markdown
# 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)
|