chore(release): v2.4.28 - Odin expense totals

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

package-lock.json

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

package.json

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

src/__tests__/ai-tools.test.ts

@@ -112,6 +112,16 @@ beforeAll(async () => {
     },
   });
   fixUser2Id = u2.id;
+  // Leave balance for the HR tools (far-future year per fixture hygiene).
+  await prisma.leave_balances.create({
+    data: {
+      user_id: fixUserId,
+      year: 2098,
+      vacation_total: 25,
+      vacation_used: 5,
+      sick_used: 2,
+    },
+  });
   await prisma.attendance.create({
     data: {
       user_id: fixUserId,
@@ -177,12 +187,57 @@ beforeAll(async () => {
 });
 
 const FIX_OFFER_NUMBER = "2098/NA/99999";
+const FIX_SUPPLIER = "AiTest Dodavatel s.r.o.";
+const FIX_RI_SUPPLIER = "AiTest Supplier s.r.o.";
+const FIX_CUSTOMER = "AiTest Zákazník s.r.o.";
 let fixOfferId = 0;
+let fixSupplierId = 0;
+let fixRiId = 0;
+let fixCustomerId = 0;
 
 beforeAll(async () => {
   await prisma.quotations.deleteMany({
     where: { quotation_number: FIX_OFFER_NUMBER },
   });
+  await prisma.sklad_suppliers.deleteMany({ where: { name: FIX_SUPPLIER } });
+  await prisma.received_invoices.deleteMany({
+    where: { supplier_name: FIX_RI_SUPPLIER },
+  });
+  const sup = await prisma.sklad_suppliers.create({
+    data: { name: FIX_SUPPLIER, ico: "99999998", city: "Brno" },
+  });
+  fixSupplierId = sup.id;
+  // Customer + two projects for the per-customer aggregation tool.
+  await prisma.projects.deleteMany({
+    where: { name: { startsWith: "AiTest Projekt" } },
+  });
+  await prisma.customers.deleteMany({ where: { name: FIX_CUSTOMER } });
+  const cust = await prisma.customers.create({
+    data: { name: FIX_CUSTOMER },
+  });
+  fixCustomerId = cust.id;
+  await prisma.projects.createMany({
+    data: [
+      { name: "AiTest Projekt 1", customer_id: fixCustomerId },
+      { name: "AiTest Projekt 2", customer_id: fixCustomerId },
+    ],
+  });
+  const ri = await prisma.received_invoices.create({
+    data: {
+      month: 6,
+      year: 2098,
+      supplier_name: FIX_RI_SUPPLIER,
+      invoice_number: "AITEST-RI-1",
+      amount: 1210,
+      vat_rate: 21,
+      vat_amount: 210,
+      currency: "CZK",
+      issue_date: new Date(Date.UTC(2098, 5, 1)),
+      due_date: new Date(Date.UTC(2098, 5, 15)),
+      status: "unpaid",
+    },
+  });
+  fixRiId = ri.id;
   const q = await prisma.quotations.create({
     data: {
       quotation_number: FIX_OFFER_NUMBER,
@@ -225,6 +280,11 @@ beforeAll(async () => {
 afterAll(async () => {
   // Items/sections cascade with the quotation.
   await prisma.quotations.deleteMany({ where: { id: fixOfferId } });
+  await prisma.sklad_suppliers.deleteMany({ where: { id: fixSupplierId } });
+  await prisma.received_invoices.deleteMany({ where: { id: fixRiId } });
+  // Projects before the customer (Restrict FK on projects.customer_id).
+  await prisma.projects.deleteMany({ where: { customer_id: fixCustomerId } });
+  await prisma.customers.deleteMany({ where: { id: fixCustomerId } });
 });
 
 afterAll(async () => {
@@ -511,6 +571,298 @@ describe("ai-tools — employees, attendance detail, trips, work plan", () => {
     expect(denied.ok).toBe(false);
   });
 
+  it("get_leave_balance: own for a recorder; foreign needs balances/manage", async () => {
+    const own = await executeTool(
+      "get_leave_balance",
+      { year: 2098 },
+      {
+        userId: fixUserId,
+        roleName: "viewer",
+        permissions: ["attendance.record"],
+      },
+    );
+    expect(own.ok).toBe(true);
+    expect(own.result).toMatchObject({
+      user_id: fixUserId,
+      year: 2098,
+      vacation_total: 25,
+      vacation_used: 5,
+      vacation_remaining: 20,
+      sick_used: 2,
+    });
+
+    // Bare attendance.record asking about someone else → denied.
+    const denied = await executeTool(
+      "get_leave_balance",
+      { user_id: fixUserId, year: 2098 },
+      RECORDER,
+    );
+    expect(denied.ok).toBe(false);
+
+    // attendance.balances (the overview route's permission) unlocks others.
+    const hr = await executeTool(
+      "get_leave_balance",
+      { user_id: fixUserId, year: 2098 },
+      {
+        userId: 999999998,
+        roleName: "viewer",
+        permissions: ["attendance.balances"],
+      },
+    );
+    expect(hr.ok).toBe(true);
+  });
+
+  it("get_work_fund returns the current-month fund; foreign needs manage", async () => {
+    const res = await executeTool(
+      "get_work_fund",
+      { user_id: fixUserId },
+      ADMIN,
+    );
+    expect(res.ok).toBe(true);
+    const r = res.result as {
+      fund_hours: number;
+      worked_hours: number;
+      business_days: number;
+    };
+    expect(r.fund_hours).toBeGreaterThan(0);
+    expect(r.business_days).toBeGreaterThan(0);
+    expect(r.worked_hours).toBe(0); // fixture attendance lives in 2098
+
+    const denied = await executeTool(
+      "get_work_fund",
+      { user_id: fixUserId },
+      RECORDER,
+    );
+    expect(denied.ok).toBe(false);
+  });
+
+  it("get_project_hours_report is manage-gated and aggregates the fixture shift", async () => {
+    const denied = await executeTool("get_project_hours_report", {}, RECORDER);
+    expect(denied.ok).toBe(false);
+
+    // The 2098 fixture shift (8.00 h, no project) lands in the labeled
+    // no-project bucket with per-user hours.
+    const res = await executeTool(
+      "get_project_hours_report",
+      { year: 2098 },
+      ADMIN,
+    );
+    expect(res.ok).toBe(true);
+    const r = res.result as {
+      year: number;
+      projects: {
+        label: string;
+        hours: number;
+        by_user: Record<string, number>;
+      }[];
+    };
+    expect(r.year).toBe(2098);
+    const bucket = r.projects.find((p) => p.label === "(bez projektu)");
+    expect(bucket).toBeDefined();
+    expect(bucket!.hours).toBe(8);
+    expect(bucket!.by_user[`${FIX.first} ${FIX.last}`]).toBe(8);
+  });
+
+  it("find_supplier + list_vehicles return their compact shapes", async () => {
+    const sup = await executeTool(
+      "find_supplier",
+      { search: "AiTest Dodavatel" },
+      { userId: 999999998, roleName: "viewer", permissions: ["orders.view"] },
+    );
+    expect(sup.ok).toBe(true);
+    const s = (
+      sup.result as { suppliers: { name: string; ico: string | null }[] }
+    ).suppliers.find((x) => x.name === FIX_SUPPLIER);
+    expect(s).toMatchObject({ ico: "99999998" });
+
+    // IČO typed with spaces finds the space-less stored value.
+    const spacedIco = await executeTool(
+      "find_supplier",
+      { search: "999 99 998" },
+      { userId: 999999998, roleName: "viewer", permissions: ["orders.view"] },
+    );
+    expect(
+      (spacedIco.result as { suppliers: { name: string }[] }).suppliers.some(
+        (x) => x.name === FIX_SUPPLIER,
+      ),
+    ).toBe(true);
+
+    const veh = await executeTool(
+      "list_vehicles",
+      { search: FIX.spz },
+      { userId: fixUserId, roleName: "viewer", permissions: ["trips.history"] },
+    );
+    expect(veh.ok).toBe(true);
+    const v = (
+      veh.result as {
+        vehicles: { spz: string; current_km: number; trip_count: number }[];
+      }
+    ).vehicles[0];
+    // Odometer rule: max trip end_km (1050) over initial_km; 3 fixture trips.
+    expect(v).toMatchObject({ spz: FIX.spz, current_km: 1050, trip_count: 3 });
+
+    // SPZ spacing is normalized: "AITEST 999" finds the stored "AITEST999",
+    // in list_vehicles AND in the list_trips vehicle filter.
+    const spaced = await executeTool(
+      "list_vehicles",
+      { search: "aitest 999" },
+      { userId: fixUserId, roleName: "viewer", permissions: ["trips.history"] },
+    );
+    expect(
+      (spaced.result as { vehicles: { spz: string }[] }).vehicles[0]?.spz,
+    ).toBe(FIX.spz);
+    const tripsByPlate = await executeTool(
+      "list_trips",
+      { vehicle: "AITEST 999", date_from: "2098-06-15", date_to: "2098-06-16" },
+      { userId: fixUserId, roleName: "viewer", permissions: ["trips.history"] },
+    );
+    expect(
+      (tripsByPlate.result as { total_matching: number }).total_matching,
+    ).toBe(2);
+
+    expect(
+      (await executeTool("find_supplier", { search: "x" }, NOBODY)).ok,
+    ).toBe(false);
+  });
+
+  it("get_document_totals sums the WHOLE filtered set per currency", async () => {
+    const res = await executeTool(
+      "get_document_totals",
+      { type: "offers", search: FIX_OFFER_NUMBER },
+      ADMIN,
+    );
+    expect(res.ok).toBe(true);
+    expect(
+      (res.result as { totals: { currency: string; amount: number }[] }).totals,
+    ).toEqual([{ currency: "EUR", amount: 2000 }]); // excluded row not counted
+
+    // orders.view alone cannot read offer totals (per-type re-check).
+    const denied = await executeTool(
+      "get_document_totals",
+      { type: "offers" },
+      { userId: 999999998, roleName: "viewer", permissions: ["orders.view"] },
+    );
+    expect(denied.ok).toBe(false);
+
+    // Offers have no period filter — month/year must error, not be ignored.
+    const offersMonth = await executeTool(
+      "get_document_totals",
+      { type: "offers", month: 6, year: 2026 },
+      ADMIN,
+    );
+    expect(offersMonth.ok).toBe(false);
+
+    // A bare month defaults the year (never an unmarked all-time sum) and
+    // the applied period is echoed back.
+    const bareMonth = await executeTool(
+      "get_document_totals",
+      { type: "orders", month: 6 },
+      ADMIN,
+    );
+    expect(bareMonth.ok).toBe(true);
+    expect((bareMonth.result as { period: string }).period).toBe(
+      `6/${new Date().getFullYear()}`,
+    );
+  });
+
+  it("get_document_totals: received_invoices sums gross + converts to CZK", async () => {
+    // invoices.view alone unlocks the received-invoices branch.
+    const res = await executeTool(
+      "get_document_totals",
+      { type: "received_invoices", month: 6, year: 2098 },
+      VIEWER_INVOICES,
+    );
+    expect(res.ok).toBe(true);
+    const r = res.result as {
+      period: string;
+      invoice_count: number;
+      totals: { currency: string; amount: number }[];
+      total_czk: number;
+    };
+    expect(r.period).toBe("6/2098");
+    expect(r.invoice_count).toBe(1);
+    expect(r.totals).toEqual([{ currency: "CZK", amount: 1210 }]);
+    expect(r.total_czk).toBe(1210); // CZK rows convert 1:1, no rate fetch
+
+    // orders.view alone cannot read expense totals.
+    const denied = await executeTool(
+      "get_document_totals",
+      { type: "received_invoices" },
+      { userId: 999999998, roleName: "viewer", permissions: ["orders.view"] },
+    );
+    expect(denied.ok).toBe(false);
+  });
+
+  it("get_top_customers aggregates per customer across the whole table", async () => {
+    const res = await executeTool(
+      "get_top_customers",
+      { type: "projects" },
+      ADMIN,
+    );
+    expect(res.ok).toBe(true);
+    const r = res.result as {
+      customers_with_records: number;
+      top: { customer: string; count: number }[];
+    };
+    const mine = r.top.find((t) => t.customer === FIX_CUSTOMER);
+    expect(mine).toBeDefined();
+    expect(mine!.count).toBe(2);
+    expect(r.customers_with_records).toBeGreaterThanOrEqual(1);
+
+    // invoices.view alone cannot aggregate projects (per-type re-check).
+    const denied = await executeTool(
+      "get_top_customers",
+      { type: "projects" },
+      VIEWER_INVOICES,
+    );
+    expect(denied.ok).toBe(false);
+  });
+
+  it("find_employee and find_supplier report total_matching", async () => {
+    const emp = await executeTool(
+      "find_employee",
+      { search: FIX.last },
+      RECORDER,
+    );
+    expect(
+      (emp.result as { total_matching: number }).total_matching,
+    ).toBeGreaterThanOrEqual(1);
+    const sup = await executeTool(
+      "find_supplier",
+      { search: FIX_SUPPLIER },
+      ADMIN,
+    );
+    expect(
+      (sup.result as { total_matching: number }).total_matching,
+    ).toBeGreaterThanOrEqual(1);
+  });
+
+  it("get_received_invoice_detail returns the gross-amount detail", async () => {
+    const res = await executeTool(
+      "get_received_invoice_detail",
+      { search: "AiTest Supplier" },
+      VIEWER_INVOICES,
+    );
+    expect(res.ok).toBe(true);
+    expect(res.result).toMatchObject({
+      supplier: FIX_RI_SUPPLIER,
+      number: "AITEST-RI-1",
+      amount_with_vat: 1210,
+      vat_amount: 210,
+      status: "unpaid",
+    });
+
+    expect(
+      (
+        await executeTool(
+          "get_received_invoice_detail",
+          { search: "x" },
+          NOBODY,
+        )
+      ).ok,
+    ).toBe(false);
+  });
+
   it("get_work_plan resolves the range-entry into per-day rows", async () => {
     const res = await executeTool(
       "get_work_plan",

src/__tests__/pdf-shared.test.ts

@@ -0,0 +1,55 @@
+import { describe, it, expect } from "vitest";
+import { cleanQuillHtml } from "../utils/pdf-shared";
+
+describe("cleanQuillHtml — inline-style whitelist", () => {
+  it("keeps Quill text and background colors", () => {
+    const html =
+      '<p><span style="color: rgb(230, 0, 0);">červeně</span> ' +
+      '<span style="background-color: #ffff00;">zvýrazněně</span> ' +
+      '<span style="color: #06c;">modře</span></p>';
+    const out = cleanQuillHtml(html);
+    expect(out).toContain('style="color: rgb(230, 0, 0)"');
+    expect(out).toContain('style="background-color: #ffff00"');
+    expect(out).toContain('style="color: #06c"');
+  });
+
+  it("drops every non-color style declaration", () => {
+    const out = cleanQuillHtml(
+      '<span style="position: fixed; color: red; font-size: 99px;">x</span>',
+    );
+    expect(out).toBe('<span style="color: red">x</span>');
+  });
+
+  it("drops unsafe color values (url, expression, quotes)", () => {
+    expect(
+      cleanQuillHtml('<span style="color: url(javascript:alert(1))">x</span>'),
+    ).toBe("<span>x</span>");
+    expect(
+      cleanQuillHtml('<span style="color: expression(alert(1))">x</span>'),
+    ).toBe("<span>x</span>");
+    expect(cleanQuillHtml("<span style='color: \"red\"'>x</span>")).toBe(
+      "<span>x</span>",
+    );
+  });
+
+  it("restores Quill 2's empty <p></p> blank lines to <p><br></p>", () => {
+    // Quill 2's semantic HTML drops the <br> placeholder from blank lines.
+    expect(cleanQuillHtml("<p>A</p><p></p><p>B</p>")).toBe(
+      "<p>A</p><p><br></p><p>B</p>",
+    );
+    // Attribute-carrying and whitespace-only empties too.
+    expect(cleanQuillHtml('<p class="ql-align-center"> </p>')).toBe(
+      '<p class="ql-align-center"><br></p>',
+    );
+  });
+
+  it("keeps stripping scripts, event handlers and js: URLs", () => {
+    const out = cleanQuillHtml(
+      '<p onclick="alert(1)"><script>alert(1)</script>' +
+        '<a href="javascript:alert(1)">x</a></p>',
+    );
+    expect(out).not.toContain("script");
+    expect(out).not.toContain("onclick");
+    expect(out).not.toContain("javascript:");
+  });
+});

src/admin/components/document/DocumentItemsEditor.tsx

@@ -214,7 +214,8 @@ function SortableItemRow({
           placeholder="Volitelný"
           InputProps={{ readOnly }}
           multiline
-          rows={2}
+          minRows={2}
+          maxRows={16}
           slotProps={{ htmlInput: { maxLength: itemDescriptionMaxLength } }}
           sx={{ "& textarea": { resize: "vertical" } }}
         />
@@ -352,7 +353,8 @@ function SortableItemRow({
             placeholder="Podrobný popis (volitelný)"
             InputProps={{ readOnly }}
             multiline
-            rows={2}
+            minRows={2}
+            maxRows={16}
             slotProps={{ htmlInput: { maxLength: itemDescriptionMaxLength } }}
             sx={{
               "& textarea": {

src/admin/pages/InvoiceDetail.tsx

@@ -58,6 +58,7 @@ import {
   formatCurrency,
   formatDate,
   numberOr,
+  restoreQuillBlankLines,
   todayLocalStr,
 } from "../utils/formatters";
 import { normalizeDateStr } from "../utils/attendanceHelpers";
@@ -317,7 +318,8 @@ function SortableInvoiceRow({
           onChange={(e) => onUpdate(index, "item_description", e.target.value)}
           placeholder="Volitelný"
           multiline
-          rows={2}
+          minRows={2}
+          maxRows={16}
           sx={{ "& textarea": { resize: "vertical" } }}
         />
         <Box
@@ -418,7 +420,8 @@ function SortableInvoiceRow({
             }
             placeholder="Podrobný popis (volitelný)"
             multiline
-            rows={2}
+            minRows={2}
+            maxRows={16}
             sx={{
               "& textarea": {
                 fontSize: "0.8rem",
@@ -1668,7 +1671,9 @@ export default function InvoiceDetail() {
                   {(s.content || "").replace(/<[^>]*>/g, "").trim() && (
                     <RichTextView
                       dangerouslySetInnerHTML={{
-                        __html: DOMPurify.sanitize(s.content || ""),
+                        __html: DOMPurify.sanitize(
+                          restoreQuillBlankLines(s.content),
+                        ),
                       }}
                     />
                   )}
@@ -1688,7 +1693,9 @@ export default function InvoiceDetail() {
           invoice.internal_notes !== "<p><br></p>" ? (
             <RichTextView
               dangerouslySetInnerHTML={{
-                __html: DOMPurify.sanitize(invoice.internal_notes),
+                __html: DOMPurify.sanitize(
+                  restoreQuillBlankLines(invoice.internal_notes),
+                ),
               }}
             />
           ) : (

src/admin/pages/OrderDetail.tsx

@@ -18,7 +18,11 @@ import Typography from "@mui/material/Typography";
 import OrderConfirmationModal from "../components/OrderConfirmationModal";
 import Forbidden from "../components/Forbidden";
 import apiFetch from "../utils/api";
-import { formatCurrency, formatDate } from "../utils/formatters";
+import {
+  formatCurrency,
+  formatDate,
+  restoreQuillBlankLines,
+} from "../utils/formatters";
 import { ORDER_STATUS, statusLabel, statusColor } from "../lib/documentStatus";
 import {
   Button,
@@ -713,7 +717,9 @@ export default function OrderDetail() {
                   <RichTextView
                     sx={{ p: 2 }}
                     dangerouslySetInnerHTML={{
-                      __html: DOMPurify.sanitize(section.content),
+                      __html: DOMPurify.sanitize(
+                        restoreQuillBlankLines(section.content),
+                      ),
                     }}
                   />
                 )}

src/admin/utils/formatters.ts

@@ -76,3 +76,15 @@ export function czechPlural(
   if (n >= 2 && n <= 4) return few;
   return many;
 }
+
+/**
+ * Quill 2's semantic HTML saves blank lines as truly empty <p></p>, which
+ * collapse to zero height outside the editor — restore the <br> placeholder
+ * before rendering stored rich text read-only. (The PDF path does the same
+ * in cleanQuillHtml.)
+ */
+export function restoreQuillBlankLines(
+  html: string | null | undefined,
+): string {
+  return (html || "").replace(/<p([^>]*)>\s*<\/p>/gi, "<p$1><br></p>");
+}

src/routes/admin/invoices-pdf.ts

@@ -253,7 +253,7 @@ export function buildInvoicePdfFooter(
   const t = translations[lang] || translations.cs;
   const pageWord = lang === "cs" ? "Strana" : "Page";
   const ofWord = lang === "cs" ? "z" : "of";
-  return `<div style="width:100%; font-size:8pt; font-family:Tahoma, sans-serif; color:#646464; padding:0 12mm; box-sizing:border-box; display:flex; align-items:center;">
+  return `<div style="width:100%; font-size:8pt; font-family:'Segoe UI', Tahoma, Arial, sans-serif; color:#646464; padding:0 12mm; box-sizing:border-box; display:flex; align-items:center;">
     <div style="flex:1; text-align:left;"><span style="font-weight:600;">${escapeHtml(t.issued_by)}</span> ${escapeHtml(issuerLine)}</div>
     <div style="flex:1; text-align:center;">${pageWord} <span class="pageNumber"></span> ${ofWord} <span class="totalPages"></span></div>
     <div style="flex:1;"></div>
@@ -898,7 +898,7 @@ export default async function invoicesPdfRoutes(
   }
   .section-content,
   .section-content * {
-    font-family: Tahoma, sans-serif !important;
+    font-family: "Segoe UI", Tahoma, Arial, sans-serif !important;
   }
   .section-content { font-size: 14px; }
   .section-content h1 { font-size: 20px; }
@@ -910,7 +910,7 @@ export default async function invoicesPdfRoutes(
   .section-content li { margin-bottom: 0.2em; }
 
   /* Quill fonty – v PDF vynuceno Tahoma */
-  [class*="ql-font-"] { font-family: Tahoma, sans-serif !important; }
+  [class*="ql-font-"] { font-family: "Segoe UI", Tahoma, Arial, sans-serif !important; }
   .ql-align-center  { text-align: center; }
   .ql-align-right   { text-align: right; }
   .ql-align-justify { text-align: justify; }

src/routes/admin/issued-orders-pdf.ts

@@ -267,7 +267,7 @@ export function buildIssuedOrderPdfFooter(
   const t = translations[lang];
   const pageWord = lang === "cs" ? "Strana" : "Page";
   const ofWord = lang === "cs" ? "z" : "of";
-  return `<div style="width:100%; font-size:8pt; font-family:Tahoma, sans-serif; color:#646464; padding:0 12mm; box-sizing:border-box; display:flex; align-items:center;">
+  return `<div style="width:100%; font-size:8pt; font-family:'Segoe UI', Tahoma, Arial, sans-serif; color:#646464; padding:0 12mm; box-sizing:border-box; display:flex; align-items:center;">
     <div style="flex:1; text-align:left;"><span style="font-weight:600;">${escapeHtml(t.issued_by)}</span> ${escapeHtml(issuerName)}</div>
     <div style="flex:1; text-align:center;">${pageWord} <span class="pageNumber"></span> ${ofWord} <span class="totalPages"></span></div>
     <div style="flex:1;"></div>
@@ -655,7 +655,7 @@ export function renderIssuedOrderHtml(
   }
   .section-content,
   .section-content * {
-    font-family: Tahoma, sans-serif !important;
+    font-family: "Segoe UI", Tahoma, Arial, sans-serif !important;
   }
   .section-content { font-size: 14px; }
   .section-content h1 { font-size: 20px; }
@@ -667,7 +667,7 @@ export function renderIssuedOrderHtml(
   .section-content li { margin-bottom: 0.2em; }
 
   /* Quill fonty – v PDF vynuceno Tahoma */
-  [class*="ql-font-"] { font-family: Tahoma, sans-serif !important; }
+  [class*="ql-font-"] { font-family: "Segoe UI", Tahoma, Arial, sans-serif !important; }
   .ql-align-center  { text-align: center; }
   .ql-align-right   { text-align: right; }
   .ql-align-justify { text-align: justify; }

src/routes/admin/offers-pdf.ts

@@ -293,7 +293,7 @@ export function renderOfferHtml(
   img, table, pre, code { max-width: 100%; }
 
   /* ---- Quill font classes – v PDF vynuceno Tahoma ---- */
-  [class*="ql-font-"] { font-family: Tahoma, sans-serif !important; }
+  [class*="ql-font-"] { font-family: "Segoe UI", Tahoma, Arial, sans-serif !important; }
 
   /* ---- Quill alignment ---- */
   .ql-align-center  { text-align: center; }
@@ -502,7 +502,7 @@ ${indentCSS}
   }
   .section-content,
   .section-content * {
-    font-family: Tahoma, sans-serif !important;
+    font-family: "Segoe UI", Tahoma, Arial, sans-serif !important;
   }
   .section-content { font-size: 14px; }
   .section-content h1 { font-size: 20px; }

src/routes/admin/orders-pdf.ts

@@ -570,7 +570,7 @@ export function renderOrderConfirmationHtml(
   .invoice-notes-content li { margin-bottom: 0.2em; }
   .invoice-notes-content,
   .invoice-notes-content * {
-    font-family: Tahoma, sans-serif !important;
+    font-family: "Segoe UI", Tahoma, Arial, sans-serif !important;
   }
   .invoice-notes-content { font-size: 14px; }
   .invoice-notes-content h1 { font-size: 20px; }
@@ -579,7 +579,7 @@ export function renderOrderConfirmationHtml(
   .invoice-notes-content h4 { font-size: 15px; }
 
   /* Quill fonty – v PDF vynuceno Tahoma */
-  [class*="ql-font-"] { font-family: Tahoma, sans-serif !important; }
+  [class*="ql-font-"] { font-family: "Segoe UI", Tahoma, Arial, sans-serif !important; }
   .ql-align-center  { text-align: center; }
   .ql-align-right   { text-align: right; }
   .ql-align-justify { text-align: justify; }

src/services/ai-tools.ts

@@ -1,12 +1,22 @@
 import type Anthropic from "@anthropic-ai/sdk";
 import prisma from "../config/database";
 import { listInvoices, getInvoiceStats, getInvoice } from "./invoices.service";
-import { listOffers, getOffer } from "./offers.service";
+import { listOffers, getOffer, getOfferTotals } from "./offers.service";
-import { listOrders, getOrder } from "./orders.service";
+import { listOrders, getOrder, getOrderTotals } from "./orders.service";
-import { listIssuedOrders, getIssuedOrder } from "./issued-orders.service";
+import {
+  listIssuedOrders,
+  getIssuedOrder,
+  getIssuedOrderTotals,
+} from "./issued-orders.service";
 import { listProjects, getProject } from "./projects.service";
 import { getBelowMinimumItems } from "./warehouse.service";
-import { calcWorkedHours } from "./attendance.service";
+import {
+  calcWorkedHours,
+  getBalances,
+  getWorkfund,
+  getProjectReport,
+} from "./attendance.service";
+import { toCzk } from "./exchange-rates";
 import { resolveGrid, listPlanUsers } from "./plan.service";
 
 /**
@@ -85,6 +95,14 @@ const hhmm = (d: Date | null): string | null =>
     ? `${String(d.getHours()).padStart(2, "0")}:${String(d.getMinutes()).padStart(2, "0")}`
     : null;
 const round2 = (n: number): number => Math.round(n * 100) / 100;
+/** SPZ normalization: users type plates with/without spaces or dashes. */
+const normPlate = (s: string): string => s.replace(/[\s-]/g, "").toUpperCase();
+/**
+ * Diacritic-folded lowercase for JS-side matching — parity with the DB's
+ * utf8mb4_unicode_ci contains ("dodavka" must match "Dodávka").
+ */
+const normText = (s: string): string =>
+  s.normalize("NFD").replace(/[̀-ͯ]/g, "").toLowerCase();
 
 /** Quill/HTML rich text → compact plain text for model context. */
 const stripHtml = (html: string | null | undefined): string =>
@@ -463,7 +481,7 @@ const TOOLS: ToolSpec[] = [
     definition: {
       name: "list_customers",
       description:
-        "Zákazníci firmy (adresy, IČO, DIČ). Vrací max 20 odpovídajících.",
+        "Zákazníci firmy (adresy, IČO, DIČ). Vrací max 20 odpovídajících; total_matching = CELKOVÝ počet zákazníků odpovídajících filtru (bez search = všichni).",
       input_schema: {
         type: "object",
         properties: {
@@ -476,12 +494,13 @@ const TOOLS: ToolSpec[] = [
     },
     handler: async (input) => {
       // Mirrors the customers route's read (search on name/company_id).
+      // IČO is stored without spaces but users type "123 45 678".
       const search = str(input.search);
       const where = search
         ? {
             OR: [
               { name: { contains: search } },
-              { company_id: { contains: search } },
+              { company_id: { contains: search.replace(/\s+/g, "") } },
             ],
           }
         : {};
@@ -545,14 +564,17 @@ const TOOLS: ToolSpec[] = [
       }
       // Stock math mirrors the service's total-stock rule: sum of
       // unconsumed batch quantities.
-      const rows = await prisma.sklad_items.findMany({
+      const where = {
-        where: {
         is_active: true,
         OR: [
           { name: { contains: search } },
           { item_number: { contains: search } },
         ],
-        },
+      };
+      const [rows, total] = await Promise.all([
+        prisma.sklad_items.findMany({
+          where,
+          orderBy: [{ name: "asc" }, { id: "asc" }],
           take: 20,
           select: {
             item_number: true,
@@ -563,8 +585,11 @@ const TOOLS: ToolSpec[] = [
               select: { quantity: true },
             },
           },
-      });
+        }),
+        prisma.sklad_items.count({ where }),
+      ]);
       return {
+        total_matching: total,
         shown: rows.length,
         items: rows.map((r) => ({
           item_number: r.item_number,
@@ -780,10 +805,12 @@ const TOOLS: ToolSpec[] = [
       if (!fullDirectory && populations.length === 0) {
         return { error: DENIED("seznam zaměstnanců") };
       }
-      const rows = await prisma.users.findMany({
+      const where = fullDirectory
-        where: fullDirectory
         ? { OR: or }
-          : { AND: [{ OR: or }, { is_active: true }, { OR: populations }] },
+        : { AND: [{ OR: or }, { is_active: true }, { OR: populations }] };
+      const [rows, total] = await Promise.all([
+        prisma.users.findMany({
+          where,
           orderBy: [{ is_active: "desc" }, { last_name: "asc" }, { id: "asc" }],
           take: 10,
           select: {
@@ -793,7 +820,9 @@ const TOOLS: ToolSpec[] = [
             username: true,
             is_active: true,
           },
-      });
+        }),
+        prisma.users.count({ where }),
+      ]);
       // GET /trips/users deliberately omits usernames (login identifiers);
       // only the attendance picker and the users admin expose them.
       const showUsername =
@@ -801,6 +830,7 @@ const TOOLS: ToolSpec[] = [
         ctxCan(ctx, "attendance.record") ||
         ctxCan(ctx, "attendance.manage");
       return {
+        total_matching: total,
         shown: rows.length,
         employees: rows.map((u) => ({
           user_id: u.id,
@@ -874,15 +904,29 @@ const TOOLS: ToolSpec[] = [
       }
       const vehicle = str(input.vehicle);
       if (vehicle) {
-        where.vehicles = {
+        // Resolve in JS so SPZ spacing is normalized on both sides
-          is: {
+        // ("4SY7039" must match the stored "4SY 7039") — SQL contains is
-            OR: [
+        // literal. The vehicles table is tiny.
-              { name: { contains: vehicle } },
+        const allVehicles = await prisma.vehicles.findMany({
-              { spz: { contains: vehicle } },
+          select: { id: true, name: true, spz: true },
-            ],
+        });
-          },
+        const ids = allVehicles
+          .filter(
+            (v) =>
+              normText(v.name).includes(normText(vehicle)) ||
+              normPlate(v.spz).includes(normPlate(vehicle)),
+          )
+          .map((v) => v.id);
+        if (ids.length === 0) {
+          return {
+            total_matching: 0,
+            shown: 0,
+            trips: [],
+            note: "Žádné vozidlo neodpovídá hledání (zkontroluj název nebo SPZ).",
           };
         }
+        where.vehicle_id = { in: ids };
+      }
 
       const [rows, all] = await Promise.all([
         prisma.trips.findMany({
@@ -1281,6 +1325,684 @@ const TOOLS: ToolSpec[] = [
       };
     },
   },
+  {
+    // Own balance parity: getStatus exposes it to every attendance.record
+    // holder; the all-users overview route requires attendance.balances.
+    // attendance.manage also unlocks foreign balances — DELIBERATE widening:
+    // the manage-gated print route (getPrintData) already returns
+    // vacation_total/remaining for every user, so manage holders gain
+    // nothing new here.
+    permission: [
+      "attendance.record",
+      "attendance.manage",
+      "attendance.balances",
+    ],
+    definition: {
+      name: "get_leave_balance",
+      description:
+        "Zůstatek dovolené a čerpání nemocenské za rok (nárok, vyčerpáno, zbývá). Bez user_id vrací zůstatek PŘIHLÁŠENÉHO uživatele; cizí zůstatky vyžadují oprávnění na zůstatky/správu docházky.",
+      input_schema: {
+        type: "object",
+        properties: {
+          user_id: {
+            type: "number",
+            description: "ID jiného uživatele (zjistíš přes find_employee)",
+          },
+          year: { type: "number", description: "Rok (výchozí aktuální)" },
+        },
+      },
+    },
+    handler: async (input, ctx) => {
+      const targetUserId = num(input.user_id) ?? ctx.userId;
+      if (
+        targetUserId !== ctx.userId &&
+        !ctxCan(ctx, "attendance.balances") &&
+        !ctxCan(ctx, "attendance.manage")
+      ) {
+        return { error: DENIED("zůstatky dovolené jiných uživatelů") };
+      }
+      const year = num(input.year) ?? new Date().getFullYear();
+      const { balances } = await getBalances(year);
+      const b = balances[String(targetUserId)];
+      if (!b) {
+        return {
+          error:
+            "Uživatel není v přehledu docházky (neaktivní nebo bez docházky).",
+        };
+      }
+      return { user_id: targetUserId, year, ...b };
+    },
+  },
+  {
+    // Own month parity: getStatus exposes the fund to the user; the
+    // all-users workfund route requires attendance.manage.
+    permission: ["attendance.record", "attendance.manage"],
+    definition: {
+      name: "get_work_fund",
+      description:
+        "Fond pracovní doby za měsíc: fond hodin (i k dnešnímu dni), odpracováno, pokryto (práce + dovolená/nemoc), přesčas a chybějící hodiny. Bez user_id vrací PŘIHLÁŠENÉHO uživatele; cizí fond vyžaduje správu docházky.",
+      input_schema: {
+        type: "object",
+        properties: {
+          user_id: {
+            type: "number",
+            description: "ID jiného uživatele (jen se správou docházky)",
+          },
+          month: {
+            type: "number",
+            description: "Měsíc 1-12 (výchozí aktuální)",
+          },
+          year: { type: "number", description: "Rok (výchozí aktuální)" },
+        },
+      },
+    },
+    handler: async (input, ctx) => {
+      const targetUserId = num(input.user_id) ?? ctx.userId;
+      if (targetUserId !== ctx.userId && !ctxCan(ctx, "attendance.manage")) {
+        return { error: DENIED("fond pracovní doby jiných uživatelů") };
+      }
+      const now = new Date();
+      const month = num(input.month) ?? now.getMonth() + 1;
+      const year = num(input.year) ?? now.getFullYear();
+      if (!Number.isInteger(month) || month > 12) {
+        return { error: "Měsíc musí být celé číslo 1-12." };
+      }
+      const fund = await getWorkfund(year);
+      // getWorkfund's future-year early return types months as `{}` — pin
+      // the indexable shape.
+      const months: Record<
+        string,
+        {
+          month_name: string;
+          fund: number;
+          fund_to_date: number;
+          business_days: number;
+          users: Record<
+            string,
+            {
+              name: string;
+              worked: number;
+              covered: number;
+              overtime: number;
+              missing: number;
+            }
+          >;
+        }
+      > = fund.months;
+      const m = months[String(month)];
+      if (!m) {
+        return {
+          error: "Pro tento měsíc zatím nejsou data (budoucí období).",
+        };
+      }
+      const u = m.users[String(targetUserId)];
+      if (!u) {
+        return {
+          error:
+            "Uživatel není v přehledu docházky (neaktivní nebo bez docházky).",
+        };
+      }
+      return {
+        user_id: targetUserId,
+        month,
+        year,
+        month_name: m.month_name,
+        business_days: m.business_days,
+        fund_hours: m.fund,
+        fund_hours_to_date: m.fund_to_date,
+        worked_hours: u.worked,
+        covered_hours: u.covered,
+        overtime_hours: u.overtime,
+        missing_hours: u.missing,
+        note: "Pokryto = odpracováno + dovolená/nemoc; fond k dnešnímu dni počítá jen uplynulé pracovní dny.",
+      };
+    },
+  },
+  {
+    // Route parity: action=project_report requires attendance.manage.
+    permission: "attendance.manage",
+    definition: {
+      name: "get_project_hours_report",
+      description:
+        "Report odpracovaných hodin podle PROJEKTŮ za rok (z docházky). Volitelně filtr na jeden projekt (číslo nebo část názvu) a měsíc; vrací hodiny celkem, po měsících a po lidech. Volej na dotazy typu 'kolik hodin jsme strávili na projektu X'.",
+      input_schema: {
+        type: "object",
+        properties: {
+          year: { type: "number", description: "Rok (výchozí aktuální)" },
+          month: {
+            type: "number",
+            description: "Jen měsíc 1-12 (vynech pro celý rok)",
+          },
+          project: {
+            type: "string",
+            description:
+              "Číslo nebo část názvu projektu (vynech pro přehled všech)",
+          },
+        },
+      },
+    },
+    handler: async (input) => {
+      const year = num(input.year) ?? new Date().getFullYear();
+      const monthFilter = num(input.month);
+      const projectFilter = str(input.project)?.toLowerCase();
+      const report = await getProjectReport(year);
+
+      type Agg = {
+        label: string;
+        project_number?: string;
+        project_name?: string;
+        hours: number;
+        by_month: Record<string, number>;
+        by_user: Record<string, number>;
+      };
+      const byProject = new Map<string, Agg>();
+      for (const [monthKey, m] of Object.entries(report.months)) {
+        if (monthFilter && Number(monthKey) !== monthFilter) continue;
+        for (const p of m.projects) {
+          const label = p.project_number || p.project_name || "(bez projektu)";
+          if (
+            projectFilter &&
+            !`${p.project_number ?? ""} ${p.project_name ?? ""}`
+              .toLowerCase()
+              .includes(projectFilter)
+          ) {
+            continue;
+          }
+          const agg = byProject.get(label) ?? {
+            // Always-present label: the no-project bucket has undefined
+            // number/name, which JSON.stringify would drop entirely.
+            label,
+            project_number: p.project_number,
+            project_name: p.project_name,
+            hours: 0,
+            by_month: {},
+            by_user: {},
+          };
+          agg.hours += p.hours;
+          agg.by_month[monthKey] = round2(
+            (agg.by_month[monthKey] || 0) + p.hours,
+          );
+          for (const u of p.users) {
+            agg.by_user[u.user_name] = round2(
+              (agg.by_user[u.user_name] || 0) + u.hours,
+            );
+          }
+          byProject.set(label, agg);
+        }
+      }
+      const projects = [...byProject.values()]
+        .sort((a, b) => b.hours - a.hours)
+        .slice(0, 20)
+        .map((p) => ({ ...p, hours: round2(p.hours) }));
+      return {
+        year,
+        ...(monthFilter ? { month: monthFilter } : {}),
+        projects_matched: byProject.size,
+        projects,
+        note: "Hodiny pocházejí z docházky (záznamy práce s projektem).",
+      };
+    },
+  },
+  {
+    // The issued-orders supplier picker serves orders.view; the warehouse
+    // supplier admin serves warehouse.manage — the fields returned here are
+    // the same set getIssuedOrder already exposes to orders.view holders.
+    permission: ["warehouse.manage", "orders.view"],
+    definition: {
+      name: "find_supplier",
+      description:
+        "Najde dodavatele podle názvu, IČO nebo města (sklad + objednávky vydané). Vrací max 10 odpovídajících.",
+      input_schema: {
+        type: "object",
+        properties: {
+          search: {
+            type: "string",
+            description: "Název, IČO nebo město (stačí část)",
+          },
+        },
+        required: ["search"],
+      },
+    },
+    handler: async (input, ctx) => {
+      const search = str(input.search);
+      if (!search) return { error: "Zadej název, IČO nebo město dodavatele." };
+      // IČO is stored without spaces but users type "123 45 678".
+      const icoDigits = search.replace(/\s+/g, "");
+      // Route parity: the orders.view picker (GET /issued-orders/suppliers)
+      // filters is_active: true — only the warehouse.manage supplier admin
+      // sees deactivated (soft-deleted) suppliers.
+      const where = {
+        ...(ctxCan(ctx, "warehouse.manage") ? {} : { is_active: true }),
+        OR: [
+          { name: { contains: search } },
+          { ico: { contains: icoDigits } },
+          { city: { contains: search } },
+        ],
+      };
+      const [rows, total] = await Promise.all([
+        prisma.sklad_suppliers.findMany({
+          where,
+          orderBy: [{ is_active: "desc" }, { name: "asc" }, { id: "asc" }],
+          take: 10,
+          select: {
+            name: true,
+            city: true,
+            ico: true,
+            dic: true,
+            is_active: true,
+          },
+        }),
+        prisma.sklad_suppliers.count({ where }),
+      ]);
+      return {
+        total_matching: total,
+        shown: rows.length,
+        suppliers: rows.map((s) => ({
+          name: s.name,
+          city: s.city,
+          ico: s.ico,
+          dic: s.dic,
+          active: s.is_active,
+        })),
+      };
+    },
+  },
+  {
+    // Mirrors GET /vehicles: any trips permission or vehicle management.
+    permission: [
+      "vehicles.manage",
+      "trips.record",
+      "trips.manage",
+      "trips.history",
+    ],
+    definition: {
+      name: "list_vehicles",
+      description:
+        "Firemní vozidla: SPZ, značka/model, aktuální stav tachometru a počet jízd. Volej na dotazy typu 'kolik má najeto dodávka'.",
+      input_schema: {
+        type: "object",
+        properties: {
+          search: {
+            type: "string",
+            description: "Hledání podle názvu nebo SPZ (vynech pro všechna)",
+          },
+        },
+      },
+    },
+    handler: async (input) => {
+      const search = str(input.search);
+      // The vehicles table is tiny — fetch all and match in JS so SPZ
+      // spacing can be normalized on BOTH sides ("4SY7039" must find the
+      // stored "4SY 7039" and vice versa); a SQL contains is literal.
+      const [allVehicles, tripStats] = await Promise.all([
+        prisma.vehicles.findMany({
+          orderBy: [{ name: "asc" }, { id: "asc" }],
+          select: {
+            id: true,
+            name: true,
+            spz: true,
+            brand: true,
+            model: true,
+            initial_km: true,
+            is_active: true,
+          },
+        }),
+        prisma.trips.groupBy({
+          by: ["vehicle_id"],
+          _max: { end_km: true },
+          _count: { id: true },
+        }),
+      ]);
+      const matched = search
+        ? allVehicles.filter(
+            (v) =>
+              normText(v.name).includes(normText(search)) ||
+              normPlate(v.spz).includes(normPlate(search)),
+          )
+        : allVehicles;
+      const total = matched.length;
+      const vehicles = matched.slice(0, 20);
+      const statsMap = new Map(
+        tripStats.map((s) => [
+          s.vehicle_id,
+          { maxKm: s._max.end_km ?? 0, count: s._count.id },
+        ]),
+      );
+      return {
+        total_matching: total,
+        shown: vehicles.length,
+        vehicles: vehicles.map((v) => {
+          const stats = statsMap.get(v.id);
+          return {
+            name: v.name,
+            spz: v.spz,
+            brand: [v.brand, v.model].filter(Boolean).join(" ") || null,
+            current_km: stats
+              ? Math.max(v.initial_km, stats.maxKm)
+              : v.initial_km,
+            trip_count: stats?.count ?? 0,
+            active: v.is_active,
+          };
+        }),
+      };
+    },
+  },
+  {
+    // Coarse gate any-of; the handler re-checks the exact permission per
+    // document type (offers vs orders vs invoices families).
+    permission: ["offers.view", "orders.view", "invoices.view"],
+    definition: {
+      name: "get_document_totals",
+      description:
+        "Součty hodnot dokumentů za CELÝ filtr (ne jen prvních 20 z listu!) po měnách. Typy: offers (nabídky, bez DPH), orders (objednávky přijaté, bez DPH), issued_orders (objednávky vydané, bez DPH), received_invoices (přijaté faktury = VÝDAJE, včetně DPH, s přepočtem do CZK). VŽDY použij tento nástroj místo sčítání řádků z list_* nástrojů. Na dotazy 'kolik jsme utratili' použij received_invoices a/nebo issued_orders.",
+      input_schema: {
+        type: "object",
+        properties: {
+          type: {
+            type: "string",
+            enum: ["offers", "orders", "issued_orders", "received_invoices"],
+            description:
+              "Typ dokumentů (received_invoices = přijaté faktury / výdaje, VČETNĚ DPH + přepočet do CZK)",
+          },
+          status: {
+            type: "string",
+            description:
+              "Filtr stavu (vynech pro všechny; received_invoices: unpaid/paid)",
+          },
+          search: {
+            type: "string",
+            description:
+              "Hledání jako v list_* nástroji (ne received_invoices)",
+          },
+          month: {
+            type: "number",
+            description: "Měsíc 1-12 (ne offers)",
+          },
+          year: {
+            type: "number",
+            description: "Rok (ne offers)",
+          },
+        },
+        required: ["type"],
+      },
+    },
+    handler: async (input, ctx) => {
+      const type = str(input.type);
+      const month = num(input.month);
+      // A bare month means the current year — the where-builders apply the
+      // period only when BOTH are set, and a silently dropped filter would
+      // let all-time totals masquerade as the asked-about month.
+      const year =
+        num(input.year) ?? (month ? new Date().getFullYear() : undefined);
+      if (month && (!Number.isInteger(month) || month > 12)) {
+        return { error: "Měsíc musí být celé číslo 1-12." };
+      }
+      const filters = {
+        search: str(input.search),
+        status: str(input.status),
+        month,
+        year,
+      };
+      // Echoed so the model (and the user) always see which period the sum
+      // actually covers.
+      const period =
+        month && year ? `${month}/${year}` : "vše (bez filtru období)";
+      if (type === "offers") {
+        if (!ctxCan(ctx, "offers.view")) return { error: DENIED("nabídky") };
+        if (month || num(input.year)) {
+          // OfferFilterParams has no month/year — they'd be silently ignored
+          // and the all-time sum would pose as a monthly figure.
+          return {
+            error:
+              "Nabídky nelze filtrovat podle měsíce/roku — souhrn nabídek je vždy za všechny odpovídající; vynech month/year.",
+          };
+        }
+        const { totals } = await getOfferTotals(filters);
+        return {
+          type,
+          period: "vše",
+          totals,
+          note: "Součty bez DPH, po měnách.",
+        };
+      }
+      if (type === "orders") {
+        if (!ctxCan(ctx, "orders.view")) return { error: DENIED("objednávky") };
+        const { totals } = await getOrderTotals(filters);
+        return { type, period, totals, note: "Součty bez DPH, po měnách." };
+      }
+      if (type === "received_invoices") {
+        if (!ctxCan(ctx, "invoices.view")) {
+          return { error: DENIED("přijaté faktury") };
+        }
+        // month/year are literal columns on received_invoices; gross sums
+        // per currency + CZK conversion mirror GET /received-invoices/stats.
+        const where: Record<string, unknown> = {};
+        if (month && year) {
+          where.month = month;
+          where.year = year;
+        } else if (year) {
+          where.year = year;
+        }
+        const status = str(input.status);
+        if (status === "unpaid" || status === "paid") where.status = status;
+        const rows = await prisma.received_invoices.findMany({
+          where,
+          select: { amount: true, currency: true },
+        });
+        const byCurrency: Record<string, number> = {};
+        for (const r of rows) {
+          const cur = r.currency || "CZK";
+          byCurrency[cur] = (byCurrency[cur] || 0) + (Number(r.amount) || 0);
+        }
+        const totals = Object.entries(byCurrency).map(([currency, amount]) => ({
+          currency,
+          amount: round2(amount),
+        }));
+        // CZK conversion mirrors the stats route: a row with an unknown
+        // currency is skipped (logged), never fails the whole sum.
+        let totalCzk = 0;
+        let skipped = 0;
+        for (const r of rows) {
+          try {
+            totalCzk += await toCzk(Number(r.amount) || 0, r.currency);
+          } catch (e) {
+            skipped += 1;
+            console.error(
+              `[ai-tools] toCzk failed for currency "${r.currency}"`,
+              e,
+            );
+          }
+        }
+        return {
+          type,
+          period: month && year ? `${month}/${year}` : year ? `${year}` : "vše",
+          invoice_count: rows.length,
+          totals,
+          total_czk: round2(totalCzk),
+          ...(skipped ? { czk_conversion_skipped_rows: skipped } : {}),
+          note: "Částky jsou VČETNĚ DPH (gross); total_czk je přepočet aktuálním kurzem.",
+        };
+      }
+      if (type === "issued_orders") {
+        if (!ctxCan(ctx, "orders.view")) {
+          return { error: DENIED("objednávky vydané") };
+        }
+        const { totals } = await getIssuedOrderTotals(filters);
+        return { type, period, totals, note: "Součty bez DPH, po měnách." };
+      }
+      return { error: "Neznámý typ dokumentu." };
+    },
+  },
+  {
+    permission: "invoices.view",
+    definition: {
+      name: "get_received_invoice_detail",
+      description:
+        "Detail jedné přijaté faktury (od dodavatele): částka VČETNĚ DPH, stav, splatnost/uhrazení, popis a interní poznámky. Hledej podle čísla faktury nebo názvu dodavatele.",
+      input_schema: {
+        type: "object",
+        properties: {
+          search: {
+            type: "string",
+            description: "Číslo faktury nebo název dodavatele (stačí část)",
+          },
+        },
+        required: ["search"],
+      },
+    },
+    handler: async (input) => {
+      const search = str(input.search);
+      if (!search) return { error: "Zadej číslo faktury nebo dodavatele." };
+      const where = {
+        OR: [
+          { invoice_number: { contains: search } },
+          { supplier_name: { contains: search } },
+        ],
+      };
+      const [inv, matched] = await Promise.all([
+        prisma.received_invoices.findFirst({
+          where,
+          orderBy: [{ issue_date: "desc" }, { id: "desc" }],
+        }),
+        prisma.received_invoices.count({ where }),
+      ]);
+      if (!inv) {
+        return { error: "Přijatá faktura odpovídající hledání neexistuje." };
+      }
+      return {
+        total_matching: matched,
+        supplier: inv.supplier_name,
+        number: inv.invoice_number,
+        description: inv.description,
+        amount_with_vat: Number(inv.amount),
+        vat_rate: Number(inv.vat_rate),
+        vat_amount: Number(inv.vat_amount),
+        currency: inv.currency,
+        issue_date: inv.issue_date,
+        due_date: inv.due_date,
+        paid_date: inv.paid_date,
+        status: inv.status,
+        attachment: inv.file_name,
+        internal_notes: stripHtml(inv.notes).slice(0, 300) || null,
+        note: "Částka je včetně DPH (gross). Zobrazena nejnovější odpovídající faktura.",
+      };
+    },
+  },
+  {
+    // Coarse gate any-of; the handler re-checks the exact permission per
+    // aggregation source. Counts only — no amounts beyond what the lists
+    // already expose to the same permission.
+    permission: ["invoices.view", "orders.view", "projects.view"],
+    definition: {
+      name: "get_top_customers",
+      description:
+        "Agregace podle ZÁKAZNÍKA přes celou databázi: počet vydaných faktur / přijatých objednávek / projektů na zákazníka (TOP 20 + počet zákazníků se záznamem). Volej na dotazy 'pro koho pracujeme nejvíc', 'největší zákazník'. Celkový počet zákazníků zjistíš z list_customers (total_matching).",
+      input_schema: {
+        type: "object",
+        properties: {
+          type: {
+            type: "string",
+            enum: ["invoices", "orders", "projects"],
+            description: "Podle čeho agregovat",
+          },
+          year: {
+            type: "number",
+            description: "Jen daný rok (vynech pro celou historii)",
+          },
+        },
+        required: ["type"],
+      },
+    },
+    handler: async (input, ctx) => {
+      const type = str(input.type);
+      const year = num(input.year);
+      // Year ranges as UTC midnights (issue_date is @db.Date; created_at
+      // DateTime comparisons are unaffected by the choice).
+      const range = year
+        ? {
+            gte: new Date(Date.UTC(year, 0, 1)),
+            lt: new Date(Date.UTC(year + 1, 0, 1)),
+          }
+        : undefined;
+      // Normalized per branch — Prisma's groupBy generics don't survive a
+      // shared pre-declared variable type.
+      let groups: { customer_id: number | null; count: number }[];
+      let note: string;
+      if (type === "invoices") {
+        if (!ctxCan(ctx, "invoices.view")) return { error: DENIED("faktury") };
+        const g = await prisma.invoices.groupBy({
+          by: ["customer_id"],
+          where: {
+            status: { not: "draft" },
+            ...(range ? { issue_date: range } : {}),
+          },
+          _count: { _all: true },
+        });
+        groups = g.map((x) => ({
+          customer_id: x.customer_id,
+          count: x._count._all,
+        }));
+        note = "Počty vydaných faktur (bez konceptů).";
+      } else if (type === "orders") {
+        if (!ctxCan(ctx, "orders.view")) {
+          return { error: DENIED("objednávky") };
+        }
+        const g = await prisma.orders.groupBy({
+          by: ["customer_id"],
+          where: range ? { created_at: range } : {},
+          _count: { _all: true },
+        });
+        groups = g.map((x) => ({
+          customer_id: x.customer_id,
+          count: x._count._all,
+        }));
+        note = "Počty přijatých objednávek (všechny stavy).";
+      } else if (type === "projects") {
+        if (!ctxCan(ctx, "projects.view")) {
+          return { error: DENIED("projekty") };
+        }
+        const g = await prisma.projects.groupBy({
+          by: ["customer_id"],
+          where: range ? { created_at: range } : {},
+          _count: { _all: true },
+        });
+        groups = g.map((x) => ({
+          customer_id: x.customer_id,
+          count: x._count._all,
+        }));
+        note = "Počty projektů (všechny stavy).";
+      } else {
+        return { error: "Neznámý typ agregace." };
+      }
+      const assigned = groups
+        .filter((g) => g.customer_id != null)
+        .sort(
+          (a, b) =>
+            b.count - a.count || (a.customer_id ?? 0) - (b.customer_id ?? 0),
+        );
+      const unassigned = groups.find((g) => g.customer_id == null)?.count ?? 0;
+      const top = assigned.slice(0, 20);
+      const names = await prisma.customers.findMany({
+        where: { id: { in: top.map((g) => g.customer_id as number) } },
+        select: { id: true, name: true },
+      });
+      const nameById = new Map(names.map((c) => [c.id, c.name]));
+      return {
+        type,
+        ...(year ? { year } : {}),
+        customers_with_records: assigned.length,
+        shown: top.length,
+        top: top.map((g) => ({
+          customer:
+            nameById.get(g.customer_id as number) ??
+            `Zákazník #${g.customer_id}`,
+          count: g.count,
+        })),
+        ...(unassigned ? { records_without_customer: unassigned } : {}),
+        note,
+      };
+    },
+  },
 ];
 
 /** Tool definitions the caller may use — filtered by their permissions. */
@@ -1348,4 +2070,12 @@ export const TOOL_LABELS: Record<string, string> = {
   get_issued_order_detail: "Detail obj. vydané",
   get_invoice_detail: "Detail faktury",
   get_project_detail: "Detail projektu",
+  get_leave_balance: "Zůstatek dovolené",
+  get_work_fund: "Fond pracovní doby",
+  get_project_hours_report: "Hodiny na projektech",
+  find_supplier: "Dodavatelé",
+  list_vehicles: "Vozidla",
+  get_document_totals: "Součty dokumentů",
+  get_received_invoice_detail: "Detail přijaté faktury",
+  get_top_customers: "TOP zákazníci",
 };

src/services/ai.service.ts

@@ -291,6 +291,7 @@ function agentSystemPrompt(
     "Odpovědi piš jako PROSTÝ TEXT — žádný Markdown (žádné tabulky, **tučné**, nadpisy); výčty piš jako řádky s pomlčkou. " +
     (tools.length > 0
       ? "Máš nástroje POUZE PRO ČTENÍ dat systému — používej je, kdykoli se dotaz týká firemních dat, a odpovídej výhradně z jejich výsledků (nikdy si firemní čísla nevymýšlej). " +
+        "Seznamové nástroje zobrazují max ~20 řádků, ale total_matching je CELKOVÝ počet odpovídajících záznamů — na otázky 'kolik' odpovídej z total_matching. Na 'pro koho nejvíc' a součty používej agregační nástroje (get_top_customers, get_document_totals, get_invoice_stats) — nikdy nesčítej řádky ze seznamů. " +
         (hasFindEmployee
           ? "Když se dotaz týká konkrétního zaměstnance (docházka, kniha jízd, plán práce), zjisti nejdřív jeho user_id nástrojem find_employee podle jména — neptej se uživatele na ID. "
           : "") +

src/utils/pdf-shared.ts

@@ -94,7 +94,7 @@ export function buildPdfHeaderTemplate(
   logoDataUri: string,
   heading: string,
 ): string {
-  return `<div style="width:100%; font-family:Tahoma, sans-serif; padding:0 12mm; box-sizing:border-box;">
+  return `<div style="width:100%; font-family:'Segoe UI', Tahoma, Arial, sans-serif; padding:0 12mm; box-sizing:border-box;">
     <div style="display:flex; justify-content:space-between; align-items:center; padding-bottom:1mm; border-bottom:2pt solid #de3a3a;">
       <div style="flex:0 0 auto;">${logoDataUri ? `<img src="${logoDataUri}" style="max-width:42mm; max-height:22mm; object-fit:contain;" />` : ""}</div>
       <div style="font-size:13pt; font-weight:700; color:#de3a3a; text-align:right; letter-spacing:0.03em;">${escapeHtml(heading)}</div>
@@ -108,6 +108,13 @@ export function buildPdfHeaderTemplate(
  * and merge adjacent identical spans. Runs AFTER DOMPurify at every call site
  * (regex pass = defense-in-depth, not the primary sanitizer).
  */
+/**
+ * Literal CSS color values only: #hex, rgb()/rgba() with numeric components,
+ * or a bare keyword. No quotes, parentheses beyond rgb(a), url(), variables.
+ */
+const SAFE_CSS_COLOR =
+  /^(#[0-9a-f]{3,8}|rgba?\(\s*\d{1,3}\s*,\s*\d{1,3}\s*,\s*\d{1,3}\s*(,\s*(0|1|0?\.\d+)\s*)?\)|[a-z]{3,20})$/i;
+
 export function cleanQuillHtml(html: string | null | undefined): string {
   if (!html) return "";
   let s = html;
@@ -134,7 +141,32 @@ export function cleanQuillHtml(html: string | null | undefined): string {
   );
   // Replace &nbsp; with regular space (outside of tags)
   s = s.replace(/(&nbsp;)/g, " ");
-  s = s.replace(/\s+style\s*=\s*("[^"]*"|'[^']*'|[^\s>]*)/gi, "");
+  // Quill 2's semantic HTML saves blank lines as truly empty <p></p>, which
+  // collapse to zero height in the PDF — restore the <br> placeholder so an
+  // editor blank line stays a blank line.
+  s = s.replace(/<p([^>]*)>\s*<\/p>/gi, "<p$1><br></p>");
+  // Inline styles: Quill writes text/background colors as style attributes.
+  // Keep ONLY color/background-color with literal color values — everything
+  // else (url(), expression(), positioning…) must never reach Puppeteer.
+  s = s.replace(
+    /\s+style\s*=\s*(?:"([^"]*)"|'([^']*)'|([^\s>]+))/gi,
+    (_m, dq, sq, bare) => {
+      const kept = String(dq ?? sq ?? bare ?? "")
+        .split(";")
+        .map((decl) => {
+          const i = decl.indexOf(":");
+          if (i < 0) return null;
+          const prop = decl.slice(0, i).trim().toLowerCase();
+          const val = decl.slice(i + 1).trim();
+          return (prop === "color" || prop === "background-color") &&
+            SAFE_CSS_COLOR.test(val)
+            ? `${prop}: ${val}`
+            : null;
+        })
+        .filter((d): d is string => d !== null);
+      return kept.length ? ` style="${kept.join("; ")}"` : "";
+    },
+  );
   // Merge adjacent spans with same attributes
   let prev = "";
   while (prev !== s) {