Compare commits

...

4 Commits

Author SHA1 Message Date
BOHA
3530dd247c chore(release): v2.4.46 — Chybějící hodiny (manko) in the payroll recap
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-08 00:22:36 +02:00
BOHA
996012e3d3 feat(attendance): 'Chybějící hodiny' (manko) row — real hours below the fond
manko = max(0, fond − (worked_total + dovolená + nemoc + neplacené volno))
using REAL clock time, not the paušál. Supplement next to Přesčas — the
verified binding formulas are untouched.

Why: the paušál Odpracováno can nominally cover the fond while dozens of
real hours are missing (Dominik 6/2026: 21 days × 8 + 8h dovolená = 176 =
fond exactly, thanks to weekend shifts compensating 3 recordless weekdays —
yet real worked time was 136,5h). Přesčas = 0 correctly, and the 31,5h gap
vanished from every total. Now it's a permanent summary line, red+bold when
positive, plus a 'Chybí: Xh' chip on the admin screen cards.

+4 tests incl. the real June dataset as a pinned acceptance case (also
pins noc 6,75 — early shifts starting 05:30/05:45 legitimately count
night minutes before 06:00).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-08 00:12:20 +02:00
BOHA
3cd7cfcc34 chore(release): v2.4.45 — binding payroll-recap formulas (payslip-verified)
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-07 19:03:28 +02:00
BOHA
68d9c224bc fix(attendance): binding payroll-recap formulas, back-computed against a real payslip
Formulas per the owner's verified spec (Dominik Vesecký 5/2026, exact to
a tenth of an hour — built-in acceptance dataset pins every line):

- fond        = (Po-Pá dny mimo svátek) × 8         [was: incl. holidays]
- odpracováno = (dny se záznamem Práce mimo svátek) × 8, paušálně
                [was: actual worked hours minus holiday work]
- přesčas     = max(0, (worked_total + dovolená) − fond)
                [was: worked only, holiday-including fond]
- vč. svátků  = odpracováno + přesčas  [was: worked_total]
- svátek/dovolená/so-ne/noc unchanged (already verified correct)

Expected 5/2026: fond 152 · odpracováno 144 · svátek 8 · dovolená 24 ·
přesčas 17,25→17,3 · vč. 161,25→161,3 · So/Ne 57,25 · noc 36,75 (the
payslip's 31 was the accountant's own error — she missed the 31.5.→1.6.
overnight shift; the spec mandates 36,75).

Two-shift days count once toward odpracováno; 'holiday' placeholder
records stay evidence-only; holiday table remains year-parametric
(fixed dates + computed Easter).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-07 19:00:54 +02:00
7 changed files with 325 additions and 147 deletions

4
package-lock.json generated
View File

@@ -1,12 +1,12 @@
{
"name": "app-ts",
"version": "2.4.44",
"version": "2.4.46",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "app-ts",
"version": "2.4.44",
"version": "2.4.46",
"license": "ISC",
"dependencies": {
"@anthropic-ai/sdk": "^0.102.0",

View File

@@ -1,6 +1,6 @@
{
"name": "app-ts",
"version": "2.4.44",
"version": "2.4.46",
"description": "",
"main": "dist/server.js",
"scripts": {

View File

@@ -347,6 +347,10 @@ exports[`buildUserSectionHtml > produces a stable per-user section (full output
<span class="summary-label">Přesčas:</span>
<span class="summary-value">0,00h</span>
</div>
<div class="summary-row summary-alert">
<span class="summary-label">Chybějící hodiny:</span>
<span class="summary-value">152,00h</span>
</div>
<div class="summary-row">
<span class="summary-label">Svátek:</span>
<span class="summary-value">0,00h</span>

View File

@@ -1,175 +1,283 @@
import { describe, it, expect } from "vitest";
import { computeMzdaSummary } from "../admin/utils/attendanceHelpers";
import {
computeMzdaSummary,
formatHoursDecimal1,
} from "../admin/utils/attendanceHelpers";
import { buildUserSectionHtml } from "../admin/hooks/useAttendanceAdmin";
/**
* Payroll recap spec (accountant notes, confirmed by the owner 2026-07):
* - Odpracováno = all worked hours EXCEPT hours worked on holidays
* - Vč. svátků a přesčasů = ALL worked hours (so line2 line1 = Svátek)
* - Dovolená = Σ vacation leave_hours (hour-based)
* - Přesčas = max(0, worked fond) — month-level, never negative
* - Svátek = hours actually WORKED on public-holiday dates
* - So/Ne = worked hours on Sat/Sun
* - Fond = MonFri (holidays included) × 8 h
* June 2026: 22 workdays, no holidays → fond 176.
* July 2026: 23 MonFri days (6.7. Monday holiday counted; 5.7. is Sunday) → fond 184.
* BINDING payroll-recap formulas (owner spec 2026-07, back-computed against
* the real payslip of Dominik Vesecký 5/2026 — the dataset below is the
* built-in acceptance test and MUST match exactly, not approximately):
*
* fond = (PoPá dny, které NEJSOU svátek) × 8
* odpracováno = (kalendářní dny se záznamem Práce mimo svátek) × 8, paušálně
* svátek = čisté odpracované hodiny ve dnech svátku
* dovolená = Σ leave_hours (evidence)
* přesčas = max(0, (worked_total + dovolená) fond) [měsíční]
* vč. svátků = odpracováno + přesčas
* so/ne = čisté hodiny směn začínajících v So/Ne (celá směna)
* noc = průnik s 22:0006:00 minus pauzy v pásmu, ke dni začátku
*
* Expected 5/2026 (holidays 1.5. + 8.5.): fond 152 · odpracováno 144 ·
* svátek 8 · dovolená 24 · přesčas 17,25 (=17,3 na desetiny) · vč. 161,25
* (=161,3) · So/Ne 57,25 · noc 36,75 (payslip said 31 — accountant's own
* error, she missed the 31.5.→1.6. overnight shift; 36,75 is CORRECT).
*/
const work = (
day: string,
from: string,
to: string,
brk?: [string, string],
) => ({
shift_date: `${day}T02:00:00`,
arrival_time: `${day}T${from}:00`,
departure_time: `${day}T${to}:00`,
break_start: brk ? `${day}T${brk[0]}:00` : null,
break_end: brk ? `${day}T${brk[1]}:00` : null,
const W = (d: string, from: string, to: string, brk?: [string, string]) => ({
shift_date: `${d}T02:00:00`,
arrival_time: from.includes(" ") ? from.replace(" ", "T") : `${d}T${from}:00`,
departure_time: to.includes(" ") ? to.replace(" ", "T") : `${d}T${to}:00`,
break_start: brk
? brk[0].includes(" ")
? brk[0].replace(" ", "T")
: `${d}T${brk[0]}:00`
: null,
break_end: brk
? brk[1].includes(" ")
? brk[1].replace(" ", "T")
: `${d}T${brk[1]}:00`
: null,
leave_type: "work",
});
const vacation = (day: string, hours: number) => ({
shift_date: `${day}T02:00:00`,
const V = (d: string, h: number) => ({
shift_date: `${d}T02:00:00`,
leave_type: "vacation",
leave_hours: hours,
leave_hours: h,
arrival_time: null,
departure_time: null,
break_start: null,
break_end: null,
});
const JUNE_WORKDAYS = [
"01",
"02",
"03",
"04",
"05",
"08",
"09",
"10",
"11",
"12",
"15",
"16",
"17",
"18",
"19",
"22",
"23",
"24",
"25",
"26",
"29",
"30",
].map((d) => `2026-06-${d}`);
/** The exact dataset from the spec (times with a space carry a full date). */
const DOMINIK_MAY_2026 = [
W("2026-05-01", "08:15", "17:15", ["12:30", "13:30"]),
W("2026-05-03", "21:30", "2026-05-04 06:15:00", [
"2026-05-04 01:52:00",
"2026-05-04 02:22:00",
]),
V("2026-05-05", 8),
V("2026-05-06", 8),
V("2026-05-07", 8),
W("2026-05-10", "21:15", "2026-05-11 06:30:00", [
"2026-05-11 01:52:00",
"2026-05-11 02:22:00",
]),
W("2026-05-12", "07:45", "16:00", ["11:52", "12:22"]),
W("2026-05-13", "08:00", "16:15", ["12:07", "12:37"]),
W("2026-05-14", "08:00", "16:15", ["12:07", "12:37"]),
W("2026-05-15", "08:00", "16:00", ["12:00", "12:30"]),
W("2026-05-16", "10:00", "23:30", ["16:45", "17:45"]),
W("2026-05-17", "21:30", "2026-05-18 06:30:00", [
"2026-05-18 02:00:00",
"2026-05-18 02:30:00",
]),
W("2026-05-19", "09:30", "17:00", ["13:15", "13:45"]),
W("2026-05-20", "08:30", "16:30", ["12:30", "13:00"]),
W("2026-05-21", "09:45", "15:15"),
W("2026-05-22", "10:45", "15:30"),
W("2026-05-24", "17:45", "2026-05-25 06:00:00", [
"23:45",
"2026-05-25 00:45:00",
]),
W("2026-05-26", "09:00", "14:30"),
W("2026-05-27", "10:00", "15:30"),
W("2026-05-28", "08:00", "15:45", ["11:45", "12:15"]),
W("2026-05-29", "08:15", "15:00", ["11:30", "12:00"]),
W("2026-05-31", "19:45", "2026-06-01 04:15:00", [
"2026-06-01 00:00:00",
"2026-06-01 00:30:00",
]),
];
describe("computeMzdaSummary — accountant spec", () => {
it("single 3h day: worked 3, no overtime (173h below fond)", () => {
describe("computeMzdaSummary — built-in acceptance dataset (Dominik 5/2026)", () => {
const s = computeMzdaSummary(DOMINIK_MAY_2026 as never, "2026-05");
it("Fond měsíce = 152 (19 PoPá dnů mimo svátky 1.5. a 8.5.)", () => {
expect(s.businessDays).toBe(19);
expect(s.fund).toBe(152);
});
it("Odpracováno = 144 (18 pracovních dnů mimo svátek × 8, paušálně)", () => {
expect(s.odpracovano).toBe(144);
});
it("Svátek = 8 (skutečné hodiny odpracované 1. 5.)", () => {
expect(s.svatekHours).toBe(8);
});
it("Dovolená = 24", () => {
expect(s.vacationHours).toBe(24);
});
it("worked_total = 145,25 (145:15 čistého času)", () => {
expect(s.workedHoursRaw).toBe(145.25);
});
it("Přesčas = 17,25 → zobrazeno 17,3 ((145,25 + 24) 152)", () => {
expect(s.prescas).toBe(17.25);
expect(formatHoursDecimal1(s.prescas * 60)).toBe("17,3");
});
it("Odpracováno včetně svátků a přesčasů = 161,25 → zobrazeno 161,3 (144 + 17,25)", () => {
expect(s.vcetneSvatku).toBe(161.25);
expect(formatHoursDecimal1(s.vcetneSvatku * 60)).toBe("161,3");
});
it("So/Ne = 57,25 (6 směn začínajících v So/Ne, celé směny)", () => {
expect(s.weekendHours).toBe(57.25);
});
it("Práce v noci = 36,75 — VČETNĚ směny 31.5.→1.6. (výplatnice s 31 h se mýlí)", () => {
expect(s.nightMinutes / 60).toBe(36.75);
});
it("Chybějící hodiny = 0 (145,25 + 24 pokrývá fond 152)", () => {
expect(s.manko).toBe(0);
});
});
describe("computeMzdaSummary — Chybějící hodiny (Dominik 6/2026, reálná data)", () => {
// Real production month exposing the gap the paušál hides: 21 attended days
// × 8 = 168 + 8h dovolená = 176 = fond exactly (weekend shifts nominally
// compensate 3 missing weekdays 1.6./11.6./15.6.), yet REAL worked time is
// only 136,5h → 31,5h below the fond. Přesčas must stay 0 (formulas are
// binding), manko must surface the 31,5.
const JUNE = [
W("2026-06-02", "06:15", "14:00", ["10:00", "10:30"]),
W("2026-06-03", "06:30", "13:30", ["10:00", "10:30"]),
W("2026-06-04", "06:00", "13:45", ["09:45", "10:15"]),
W("2026-06-05", "06:15", "13:45", ["10:00", "10:30"]),
W("2026-06-07", "07:15", "13:00", ["09:30", "10:00"]), // Sunday
W("2026-06-08", "07:15", "13:30", ["10:15", "10:45"]),
W("2026-06-09", "06:00", "11:15", ["09:30", "10:00"]),
W("2026-06-10", "06:00", "11:45", ["09:30", "10:00"]),
W("2026-06-12", "06:00", "13:45", ["09:45", "10:15"]),
W("2026-06-14", "17:30", "2026-06-15 04:15:00", ["22:45", "23:15"]), // Sun→Mon
W("2026-06-16", "07:30", "13:30", ["10:00", "10:30"]),
W("2026-06-17", "10:45", "13:15"),
W("2026-06-18", "06:00", "13:15", ["09:30", "10:00"]),
W("2026-06-19", "07:00", "13:15", ["10:00", "10:30"]),
W("2026-06-22", "06:00", "13:30", ["09:45", "10:15"]),
W("2026-06-23", "06:00", "13:45", ["09:45", "10:15"]),
W("2026-06-24", "05:30", "13:45", ["09:30", "10:00"]),
V("2026-06-25", 8),
W("2026-06-26", "05:45", "14:45", ["10:15", "10:45"]),
W("2026-06-27", "05:45", "17:00", ["11:15", "11:45"]), // Saturday
W("2026-06-29", "11:45", "14:30"),
W("2026-06-30", "06:30", "09:15"),
W("2026-06-30", "10:45", "13:30"),
];
const s = computeMzdaSummary(JUNE as never, "2026-06");
it("verified rows stay exactly as before (fond 176, odpracováno 168, přesčas 0)", () => {
expect(s.fund).toBe(176);
expect(s.businessDays).toBe(22);
expect(s.odpracovano).toBe(168); // 21 days × 8 flat
expect(s.vacationHours).toBe(8);
expect(s.workedHoursRaw).toBe(136.5);
expect(s.prescas).toBe(0); // (136,5 + 8) 176 < 0 — unchanged formula
expect(s.vcetneSvatku).toBe(168);
expect(s.svatekHours).toBe(0);
expect(s.weekendHours).toBe(26.25); // shifts starting 7.6., 14.6., 27.6.
// 14.6. shift (22:0004:15 minus break = 5:45) + early starts before
// 06:00: 24.6. 05:30 (0:30), 26.6. 05:45 (0:15), 27.6. 05:45 (0:15).
expect(s.nightMinutes / 60).toBe(6.75);
});
it("Chybějící hodiny = 31,5 — the gap the paušál nominally hides", () => {
expect(s.manko).toBe(31.5); // 176 (136,5 + 8)
});
it("nemoc a neplacené volno kryjí fond stejně jako dovolená", () => {
const withSick = [...JUNE, { ...V("2026-06-01", 8), leave_type: "sick" }];
const s2 = computeMzdaSummary(withSick as never, "2026-06");
expect(s2.sickHours).toBe(8);
expect(s2.manko).toBe(23.5); // 31,5 8
});
});
describe("computeMzdaSummary — formula edge cases", () => {
it("Odpracováno is a flat 8h per day: a lone 4:45 day counts as 8", () => {
const s = computeMzdaSummary(
[work("2026-06-02", "09:00", "12:00")],
[W("2026-06-02", "10:45", "15:30")] as never,
"2026-06",
);
expect(s.odpracovano).toBe(3);
expect(s.vcetneSvatku).toBe(3);
expect(s.prescas).toBe(0);
expect(s.fund).toBe(176);
expect(s.odpracovano).toBe(8);
expect(s.workedHoursRaw).toBe(4.75);
expect(s.prescas).toBe(0); // (4,75 + 0) 176 < 0
expect(s.vcetneSvatku).toBe(8); // odpracováno + přesčas
});
it("accountant's Přesčas example: +3h one day, 2h elsewhere → 1h overtime", () => {
const recs = JUNE_WORKDAYS.slice(0, 20).map((d) =>
work(d, "08:00", "16:30", ["12:00", "12:30"]),
); // 20 × 8h
recs.push(work("2026-06-29", "08:00", "14:00")); // 6h (2h short)
recs.push(work("2026-06-30", "08:00", "19:30", ["12:00", "12:30"])); // 11h (+3h)
const s = computeMzdaSummary(recs, "2026-06");
expect(s.vcetneSvatku).toBe(177);
expect(s.prescas).toBe(1);
it("two shifts on one day count that day ONCE (8h, not 16h)", () => {
const s = computeMzdaSummary(
[
W("2026-06-02", "06:00", "10:00"),
W("2026-06-02", "14:00", "18:00"),
] as never,
"2026-06",
);
expect(s.odpracovano).toBe(8);
expect(s.workedHoursRaw).toBe(8);
});
it("accountant's Svátek example: 10h worked on 6.7. → Svátek 10; excluded from Odpracováno", () => {
const julyWorkdays = [
it("dovolená covers the fond in Přesčas", () => {
// 176h fond (June 2026): 152h worked + 30h vacation = 182 → +6 přesčas.
const recs: unknown[] = [];
const days = [
"01",
"02",
"03",
"07",
"04",
"05",
"08",
"09",
"10",
"13",
"14",
"11",
"12",
"15",
"16",
"17",
"20",
"21",
"18",
"19",
"22",
"23",
"24",
"27",
"28",
"29",
"30",
"31",
].map((d) => `2026-07-${d}`);
const recs = julyWorkdays.map((d) =>
work(d, "08:00", "16:30", ["12:00", "12:30"]),
); // 22 × 8h
recs.push(work("2026-07-06", "08:00", "18:30", ["12:00", "12:30"])); // holiday, 10h
const s = computeMzdaSummary(recs, "2026-07");
expect(s.fund).toBe(184); // 23 MonFri days incl. the Monday holiday
expect(s.svatekHours).toBe(10);
expect(s.vcetneSvatku).toBe(186); // all worked hours
expect(s.odpracovano).toBe(176); // minus the holiday-worked 10h
expect(s.prescas).toBe(2); // max(0, 186 184) — never negative
"25",
].map((d) => `2026-06-${d}`);
for (const d of days) recs.push(W(d, "08:00", "16:30", ["12:00", "12:30"])); // 19×8=152
recs.push(V("2026-06-29", 8), V("2026-06-30", 8), V("2026-06-26", 14));
const s = computeMzdaSummary(recs as never, "2026-06");
expect(s.vacationHours).toBe(30);
expect(s.prescas).toBe(6);
});
it("vacation does NOT flow into Přesčas (worked-hours-only rule)", () => {
const recs: ReturnType<typeof work | typeof vacation>[] =
JUNE_WORKDAYS.slice(0, 21).map((d) =>
work(d, "08:00", "16:30", ["12:00", "12:30"]),
); // 21 × 8 = 168
recs.push(vacation("2026-06-30", 8));
const s = computeMzdaSummary(recs, "2026-06");
expect(s.vacationHours).toBe(8);
expect(s.prescas).toBe(0); // 168 worked < 176 fond — vacation doesn't count
});
it("partial-day vacation next to a work shift on the same day (5h work + 3h vacation)", () => {
const recs = [
work("2026-06-02", "08:00", "13:00"), // 5h
vacation("2026-06-02", 3),
];
const s = computeMzdaSummary(recs, "2026-06");
expect(s.odpracovano).toBe(5);
expect(s.vacationHours).toBe(3);
});
it("weekend hours count into So/Ne and into worked totals", () => {
it("a shift STARTING on a holiday goes to Svátek, not to Odpracováno days", () => {
const s = computeMzdaSummary(
[work("2026-06-06", "08:00", "12:00")], // Saturday 4h
"2026-06",
[W("2026-07-06", "08:00", "18:30", ["12:00", "12:30"])] as never, // 6.7. holiday, 10h
"2026-07",
);
expect(s.weekendHours).toBe(4);
expect(s.odpracovano).toBe(4);
expect(s.svatekHours).toBe(10);
expect(s.odpracovano).toBe(0);
expect(s.fund).toBe(176); // 23 MonFri 6.7. holiday = 22 × 8
});
});
describe("print day table — multiple records on one day", () => {
it("renders one row per record (two shifts are both visible)", () => {
const records = [
work("2026-06-02", "06:00", "10:00"),
work("2026-06-02", "14:00", "18:00"),
W("2026-06-02", "06:00", "10:00"),
W("2026-06-02", "14:00", "18:00"),
];
const totalMins = 8 * 60;
const html = buildUserSectionHtml(
"1",
{ name: "Test", minutes: totalMins, vacation_hours: 0, records } as never,
{ name: "Test", minutes: 480, vacation_hours: 0, records } as never,
{ month: "2026-06", month_name: "Červen 2026", user_totals: {} } as never,
);
// Both shifts appear, each with its own arrival time.
expect(html).toContain("06:00");
expect(html).toContain("14:00");
// Two rows dated 2. 6.
const rows = html.match(/<td>2\. 6\. 2026<\/td>/g) || [];
expect(rows.length).toBe(2);
});

View File

@@ -97,6 +97,7 @@ interface UserTotal {
weekend_hours?: number;
night_minutes?: number;
worked_holiday_hours?: number; // sum of hours worked ON a holiday
manko?: number; // Chybějící hodiny: real clock time below the fond
records?: AttendanceRecord[];
}
@@ -243,6 +244,7 @@ function computeUserTotals(
t.weekend_hours = s.weekendHours;
t.night_minutes = s.nightMinutes;
t.worked_holiday_hours = s.svatekHours;
t.manko = s.manko;
}
return totals;
@@ -427,6 +429,10 @@ export function buildUserSectionHtml(
<span class="summary-label">Přesčas:</span>
<span class="summary-value">${formatHoursDecimal(s.prescas * 60)}h</span>
</div>
<div class="summary-row${s.manko > 0 ? " summary-alert" : ""}">
<span class="summary-label">Chybějící hodiny:</span>
<span class="summary-value">${formatHoursDecimal(s.manko * 60)}h</span>
</div>
<div class="summary-row">
<span class="summary-label">Svátek:</span>
<span class="summary-value">${formatHoursDecimal(s.svatekHours * 60)}h</span>
@@ -547,6 +553,9 @@ export function buildPrintHtml(
}
.user-summary .summary-label { color: #555; }
.user-summary .summary-value { font-weight: 600; }
/* Chybějící hodiny > 0 — must jump out of the sheet, not hide in it. */
.user-summary .summary-alert .summary-label,
.user-summary .summary-alert .summary-value { color: #b00020; font-weight: 700; }
.user-summary .summary-fund {
border-top: 1px solid #ddd; margin-top: 4px; padding-top: 6px;
}

View File

@@ -46,6 +46,8 @@ interface UserTotalData {
prescas?: number;
svatek?: number;
worked_holiday_hours?: number;
/** Chybějící hodiny: real clock time below the fond (approved absences count). */
manko?: number;
}
/** Fond "used" total mirrors the Fond footer line below:
@@ -293,6 +295,13 @@ export default function AttendanceAdmin() {
label={`Nep: ${ut.unpaid_hours}h`}
/>
)}
{ut.manko !== undefined && ut.manko > 0 && (
<StatusChip
color="error"
label={`Chybí: ${String(Math.round(ut.manko * 100) / 100).replace(".", ",")}h`}
title="Skutečně odpracované hodiny + schválené absence nedosahují fondu měsíce"
/>
)}
</Box>
{/* Fond usage */}

View File

@@ -373,32 +373,58 @@ export const calculateFreeHolidayHours = (
// ---------------------------------------------------------------------------
// Mzda rekapitulace (single source — the print AND the admin screen consume
// this, so the two can never drift again; spec confirmed with the accountant
// 2026-07, see the summary lines below)
// this, so the two can never drift again). Formulas are BINDING per the
// accountant-verified spec (2026-07, back-computed to the tenth of an hour
// against a real payslip — Dominik Vesecký 5/2026; the built-in dataset test
// in attendance-mzda-summary.test.ts pins every line). Do not "improve" them:
// fond = (PoPá dny, které NEJSOU svátek) × 8
// odpracováno = (kalendářní dny se záznamem Práce mimo svátek) × 8 — FLAT
// 8 h per day regardless of the shift's real length; real
// deviations settle monthly via Přesčas
// svátek = skutečné čisté hodiny odpracované ve dnech svátku
// dovolená = Σ leave_hours (evidence only, never from timestamps)
// přesčas = max(0, (worked_total + dovolená) fond) [monthly]
// vč. svátků = odpracováno + přesčas (plain sum, NOT from timestamps)
// so/ne = čisté hodiny směn ZAČÍNAJÍCÍCH v So/Ne (celá směna)
// noc = průnik směny s 22:0006:00 minus pauzy v pásmu; celá směna
// patří dni svého ZAČÁTKU (i přes hranici měsíce)
// ---------------------------------------------------------------------------
export interface MzdaSummary {
/** All worked hours in the month: arrival→departure minus recorded breaks. */
/** worked_total: all net worked hours (arrival→departure minus breaks). */
workedHoursRaw: number;
/** Odpracováno: all worked hours EXCEPT hours worked on public holidays. */
/** Odpracováno: non-holiday calendar days with a work record × 8 h flat. */
odpracovano: number;
/** Odpracováno včetně svátků a přesčasů: ALL worked hours (line2 line1 = Svátek). */
/** Odpracováno včetně svátků a přesčasů = odpracovano + prescas. */
vcetneSvatku: number;
/** Dovolená: sum of vacation leave_hours (hour-based, partial days allowed). */
vacationHours: number;
/** Přesčas: worked hours above the monthly fund — max(0, worked fond). */
/** Přesčas: max(0, (worked_total + dovolená) fond) — monthly, never daily. */
prescas: number;
/** Svátek: hours actually WORKED on public-holiday dates. */
/** Svátek: net hours actually WORKED on public-holiday dates. */
svatekHours: number;
/** So/Ne: worked hours on Saturdays and Sundays. */
/** So/Ne: net hours of shifts whose START day is Sat/Sun (whole shift). */
weekendHours: number;
/** Práce v noci: worked minutes in the 22:0006:00 window. */
/** Práce v noci: minutes in 22:0006:00 minus breaks in the window. */
nightMinutes: number;
/** Fond měsíce: MonFri (public holidays included) × 8 h. */
/** Fond měsíce: MonFri days that are NOT public holidays × 8 h. */
fund: number;
/** MonFri non-holiday day count backing the fond. */
businessDays: number;
/** 8 h per holiday the user did NOT work (fond is covered by these). */
freeHolidayHours: number;
/** Nemoc: sum of sick leave_hours (evidence records). */
sickHours: number;
/** Neplacené volno: sum of unpaid leave_hours (evidence records). */
unpaidHours: number;
/**
* Chybějící hodiny (manko):
* max(0, fond (worked_total + dovolená + nemoc + neplacené volno))
* — REAL clock hours below the fond. A supplement next to Přesčas, never a
* replacement: the paušál Odpracováno can nominally cover the fond (weekend
* work compensating missing weekdays) while dozens of real hours are
* missing — e.g. Dominik 6/2026: paušál 168 + 8 dovolená = fond 176, yet
* real worked was 136,5 → manko 31,5. This line makes that visible.
*/
manko: number;
}
/** Compute the payroll recap for one user's month of records. */
@@ -410,54 +436,76 @@ export const computeMzdaSummary = (
const yr = parseInt(yearStr, 10);
const mo = parseInt(monthNumStr, 10);
const holidayDates = holidaysInMonth(yr, mo);
const holidaySet = new Set(holidayDates);
const holidaySet = new Set(holidaysInMonth(yr, mo));
let workedMinutes = 0;
let svatekMinutes = 0;
let weekendMinutes = 0;
let nightMinutes = 0;
let vacationHours = 0;
let sickHours = 0;
let unpaidHours = 0;
// Distinct non-holiday calendar days (start day) with a "Práce" record —
// two shifts on one day still count that day once.
const workDays = new Set<string>();
for (const r of records) {
const lt = r.leave_type || "work";
if (lt !== "work") {
// "holiday" placeholder records are evidence-only — skip everywhere.
if (lt === "vacation") vacationHours += Number(r.leave_hours) || 8;
else if (lt === "sick") sickHours += Number(r.leave_hours) || 8;
else if (lt === "unpaid") unpaidHours += Number(r.leave_hours) || 8;
continue;
}
const m = calculateWorkMinutesPrint(r);
workedMinutes += m;
const day = normalizeDateStr(r.shift_date);
if (holidaySet.has(day)) svatekMinutes += m;
if (holidaySet.has(day)) {
svatekMinutes += m;
} else if (day) {
workDays.add(day);
}
if (isWeekendDate(day)) weekendMinutes += m;
nightMinutes += calculateNightMinutes(r);
}
// Fond: MonFri × 8 h; public holidays stay in the count (they are paid via
// the fond — an unworked holiday earns its 8 h, see freeHolidayHours).
// Fond: MonFri days that are NOT public holidays × 8 h.
let businessDays = 0;
const cur = new Date(yr, mo - 1, 1);
while (cur.getMonth() === mo - 1) {
const dow = cur.getDay();
if (dow !== 0 && dow !== 6) businessDays++;
if (dow !== 0 && dow !== 6) {
const dayStr = `${yr}-${String(mo).padStart(2, "0")}-${String(cur.getDate()).padStart(2, "0")}`;
if (!holidaySet.has(dayStr)) businessDays++;
}
cur.setDate(cur.getDate() + 1);
}
const fund = businessDays * 8;
const workedHoursRaw = workedMinutes / 60;
const svatekHours = svatekMinutes / 60;
const odpracovano = workDays.size * 8;
const prescas = Math.max(0, workedHoursRaw + vacationHours - fund);
// Chybějící hodiny: REAL clock time (not the paušál) vs the fond — approved
// absences (dovolená/nemoc/neplacené volno) cover the fond.
const manko = Math.max(
0,
fund - (workedHoursRaw + vacationHours + sickHours + unpaidHours),
);
return {
workedHoursRaw,
odpracovano: workedHoursRaw - svatekHours,
vcetneSvatku: workedHoursRaw,
odpracovano,
vcetneSvatku: odpracovano + prescas,
vacationHours,
prescas: Math.max(0, workedHoursRaw - fund),
svatekHours,
prescas,
svatekHours: svatekMinutes / 60,
weekendHours: weekendMinutes / 60,
nightMinutes,
fund,
businessDays,
freeHolidayHours: calculateFreeHolidayHours(records, holidayDates),
sickHours,
unpaidHours,
manko,
};
};