38686-vm/docs/plans/parked-work.md

Parked / deferred work

Updated 15 May 2026. A small index of features that are designed, half-built, blocked on input, or pending an operator step. When a fresh session opens, glance here first to see what's already on the workbench.

---

⏸ Paused — ready to execute (not started, not pushed)

Post-Attendance Flow v2

Status: Brainstormed + designed + planned, approved by Konrad, execution paused (Konrad's call, 15 May 2026). Design doc docs/plans/2026-05-15-post-attendance-flow-v2-design.md (local commit 110545b), plan docs/plans/2026-05-15-post-attendance-flow-v2-plan.md (local commit 29c36be). These 2 commits are local-only on ai-dev, NOT pushed to origin — Konrad wants nothing reaching the working app until he's verified the flow locally.

What it does: Replaces the forced post-attendance SiteReport redirect with 3 explicit buttons (Log Work → dashboard / + Site Journal / + Absences) + a "Save Site Journal + Add Absences" button on the journal page. Renames user-facing "Site Report" → "Site Journal" (display-only, Path-A — frees "Journal" for the parked voice feature, which must now be called "Voice Notes").

To resume: new or same session → "execute the post-attendance-flow-v2 plan". 4 tiny TDD tasks (~120 LOC), reuses the proven Round C next_action pattern. HARD STOP after Task 4 — Konrad runs the manual verification checklist (in the design doc) locally and explicitly approves BEFORE any push. No migrations / collectstatic — pure template + view change.

---

Production status — ✅ fully caught up (15 May 2026)

Production (https://foxlog.flatlogic.app/) is deployed at origin/ai-dev HEAD 1d224bc. Everything is live: SiteReport

• Absences feature, all UX polish, the team filters, the dashboard/report number audit (18 findings), and the template-comment + subline-clarity fixes.

Deploy-ordering lesson learned (now in CLAUDE.md): production runs DEBUG=False → Django's cached template loader holds compiled templates in memory until the process restarts. The 14 commits of template fixes were briefly "invisible" because the service was restarted before the code reached the target commit. The fix was simply to restart AGAIN once git log confirmed the right commit. Correct order is always: git reset --hard github/ai-dev → migrate (if needed) → collectstatic (if static/ changed) → restart last. See the "DEPLOY ORDERING" bullet in CLAUDE.md's Flatlogic Deployment section.

---

🧊 Backburner — journal/voice features (separate offline track)

Decision (15 May 2026): Konrad parked the entire journal / voice-transcript line of work. It's more complex than the rest of the app and will be built + tested offline, on a separate track, NOT mixed into ai-dev. Do NOT start either of these in ai-dev or in any normal feature session. They are not "blocked waiting on an answer" — they are deliberately deferred until Konrad chooses to spin up a dedicated offline effort.

Important — nothing is in the working app. Verified 15 May 2026: zero JournalEntry model / views / URLs / templates anywhere in core/, zero Letterly / webhook / @csrf_exempt code on ai-dev, latest migration is 0015_absence_project. There is no dead code, no feature flag, no migration to reverse. "Removing" these was a no-op — they were never built into the running app. The working app (ai-dev + production) is completely clean of journal/voice code.

Phase A.2 — Manual JournalEntry web UI (deferred)

Designed in the Site Work Logging brainstorm (~/.claude/plans/ prancy-painting-brook.md, local). A JournalEntry model + manual entry form/list/edit, admin-only. Open question if/when resumed: Q7 "Who is Vi?" — drives whether JournalEntry needs a recipient/audience field. Default if never answered: no recipient field, all-admin-readable. ~1 hour scope. When resumed, build on the offline track first, not directly in ai-dev.

Phase B — Letterly inbound webhook (deferred)

Designed in the same brainstorm. A @csrf_exempt view at /webhooks/letterly/ that creates JournalEntry rows from voice transcripts, with HMAC body verification + shared-secret URL token. Open question if/when resumed: Q5 — a sample Letterly webhook payload (does it include the recording user / project metadata / audio URL / custom fields?). ~3-4 hours scope + one-off Letterly account setup. This was always meant to live on the integrations branch, never ai-dev — and now it's offline-track until Konrad revisits.

---

Small polish follow-ups from the Absences feature

All 7 cleared on 15 May 2026 (commit d1d3e15). Kept the section header in place because more polish items will accumulate from future code reviews — when they do, append here. The shipped items are summarized under "Recently shipped" below.

---

Defaulted (not blocking — flag if you disagree)

From Q9, Q4 of the Site Work Logging brainstorm:

• Q9 — photos on site reports. Deferred to v2 of SiteReport. Construction supervisors often want to attach a phone photo of "plinths cast today" but it adds ~50 LOC + storage handling + thumbnail rendering. v1 ships without.
• Q4 — per-project metric templates. Same metric set for all projects in v1. If/when a non-solar-farm project lands and the metrics diverge wildly, we add a MetricTemplate model. YAGNI for now — core/site_report_schema.py is one Python file edit.

---

Recently shipped (for context, so a fresh session knows what just landed)

• Dashboard + report numbers audit (commits 18c75b2 → c02edce, 15 May 2026): Konrad spotted that the home dashboard's "Paid This Month" actually showed the last 60 days. A thorough audit found 17 more issues across the home dashboard, payroll dashboard, and report. All 18 fixed in 7 commits: calendar-month math, outstanding totals aligned between dashboards, Project.name dedupe (was silently merging same-named projects), timezone.localdate() replacing timezone.now().date() (SAST drift fix), off-by-one on "last 7 / 60 days" windows, dead year_projects/year_teams context removed, _company_cost_velocity rewritten as single SQL aggregate, signed/coloured adjustment amounts on report tables (Bonus vs Deduction now visually distinct), "Outstanding Now" hero card subline now shows scope when filters active, dual daily_rate code paths documented in CLAUDE.md. 160 → 173 tests (+13 regression).
• Absence-feature polish pass (commit d1d3e15, 15 May 2026): Seven small cleanups in one focused commit. (1) Deleted unused AbsenceQuickForm (Round C made it obsolete). (2) Extracted _build_team_workers_map(user) helper using Prefetch(..., to_attr=...), fixing N+1 on both attendance_log and absence_log (one query instead of one-per-team). (3) absence_list now calls the existing _user_can_log_absences helper. (4) Removed undefined var(--badge-neutral-bg) CSS wrapper — fallback hex was always winning anyway. (5) conflicting_worklogs() rewritten as a single query with Python-side pair-set filtering — 25-query → 2-query for a 5×5 form. (6) Extracted _apply_absence_filters(qs, request) shared by absence_list + absence_export_csv so adding a filter param now touches one place, not two. (7) site_report_detail.html paid-check icon uses text-success instead of background-color variable as foreground (WCAG contrast fix). 157/157 tests still green.
• Day name in Work Log Payroll modal header (commit 70fa085, 15 May 2026): The modal opened from /history/ now shows "Friday, 15 May 2026" instead of "2026-05-15". Pure server-side strftime on the already-loaded log.date — zero overhead.
• Team filters on /workers/ and /history/ (commits 4b57cff, 398a5b2, 15 May 2026): Both pages now have a Team dropdown in their filter row. /workers/?team=<id> filters by Team.workers M2M membership (who's CURRENTLY on the team); /history/?team=<id> filters by WorkLog.team FK (logs TAGGED with the team when created — different semantics, intentional). Both accept team=none for the "no team assigned" / "ad-hoc work log" case. CSV export at /history/export/ honours the same param. +8 regression tests.
• Absences UX polish (commits 4368e53, 02c6d4d, 15 May 2026): Two production-found bugs fixed. (1) Absence-form team filter was hiding ALL workers when a team was selected — switched the JS to read <input name="workers">[value] directly instead of going through data-worker-id (proven attendance-form pattern). (2) Reasons multi-checkbox dropdown on /absences/ was rendering behind the table — lifted the filter card with position: relative; z-index: 10 so the whole card sits above its sibling table card in the stacking order. See the Coding Style section in CLAUDE.md for both gotchas.
• Worker Absences feature (commits bf6f0a5 → 27fe05e, 14 May 2026): Complete absence-tracking system. 8 reason choices, optional project FK (auto-attributes paid-absence Bonus adjustments to the project), date-range logging with weekend toggles, supervisor scoping (admin sees all; supervisors see their teams). Standalone /absences/log/ form + "Submit + Log Absences" shortcut on attendance form. List/edit/delete + CSV export. Worker-detail "Absences" tab with YTD totals. Dashboard alert card "X absent in last 7 days". Bidirectional cascade with PayrollAdjustment via _sync_absence_payroll_adjustment helper (single-chokepoint design, transaction.atomic-wrapped). 12 commits pushed to origin/ai-dev. Test count: 85 → 149 (+64 tests). Migrations 0013_add_site_report, 0014_add_absence, 0015_absence_project are LIVE on production as of late 14 May 2026.
• Phase A.1 — SiteReport (commit 864ae72, 14 May 2026): Model, migration 0013_add_site_report.py, form, two-step flow from attendance log, 16 new tests. CLAUDE.md updated with model summary + site_report_schema.py pattern section.
• Pastel soft-fill payroll action buttons (commit 6c6ade9, 24 Apr 2026): unified Worker Lookup / Batch Pay / Add Adjustment / Price Overtime treatment.
• Path A display-only rename (UX Polish Pass, Apr 2026): "New Loan" / "Advance Payment" / "Advance Repayment" display as "Loan" / "Advance" / "Advance Repaid" — but DB values are unchanged. See "UI-vs-DB naming drift" section in CLAUDE.md before writing any filter/comparison on PayrollAdjustment.type.

---

Original Site Work Logging brainstorm

The full Q1-Q13 question list and design rationale lives in ~/.claude/plans/prancy-painting-brook.md (local — deliberately not committed to the repo, since the parts that matter have been absorbed into CLAUDE.md and this file). If Konrad answers Q5 or Q7 later, refer back to that file for the original framing.