Přeskočit na obsah

Kalendář čte jen plánovací tabulku — entity s datem, ale bez plánu, jsou neviditelné

import { Aside } from ‘@astrojs/starlight/components’;

Záložka Kalendář v modulu zakázek (kapacitní plánování m²/den) byla trvale prázdná. Klient: „kalendář je prázdný, i když nám instalace probíhají“. Přitom seznam i kanban zakázky ukazovaly, některé ve stavu „Potvrzený termín“ nebo „Probíhá“.

Kalendář načítal výhradně řádky plánovací tabulky (PlannedDay {entityId, date, category}), kterou plní jen sidebar „přiřadit dny“. Zakázka ale má vlastní pole plannedDate / confirmedDate, které se nastavuje z detailu nebo kanbanu. V produkci:

  • plánovací tabulka měla 0 řádků (nikdo přes sidebar neplánoval),
  • 17 zakázek bylo ve stavu „Potvrzený termín“ bez jakéhokoli data (přesun karty v kanbanu datum nevyžadoval),
  • sidebar navíc nabízel k plánování jen stavy READY/SCHEDULED, takže „potvrzené“ zakázky bez dnů nešly ani doplánovat (API vracelo NOT_READY).

Výsledek: dva nezávislé zdroje pravdy o termínu, kalendář četl jen ten prázdný.

// PŘED — jen plánovací tabulka
const days = await prisma.plannedDay.findMany({ where: { date: { gte: from, lte: to } }, include: { entity: true } });
// PO — doplnit entity s termínem, které nemají žádný naplánovaný den
const withoutDays = await prisma.entity.findMany({
where: {
status: { in: ACTIVE_STATUSES },
plannedDays: { none: {} },
OR: [
{ confirmedDate: { gte: from, lte: to } },
{ confirmedDate: null, plannedDate: { gte: from, lte: to } },
],
},
});
// → položka v dni s `dayId: null` (nejde smazat jako plán, ale je vidět a počítá se do kapacity)

Dále sidebar nabízí i „potvrzené“ entity bez dnů a endpoint pro přiřazení dnů je pro tento stav povolen (status se přitom nemění). UI označí položku „termín z entity“ čárkovaným rámem.

Jak se tomu vyvarovat v jiných systémech

Sekce “Jak se tomu vyvarovat v jiných systémech”
  • Detection: SELECT count(*) FROM planned_days vs. SELECT count(*) FROM entities WHERE planned_date IS NOT NULL — pokud první je řádově menší, kalendář lže. Druhý dotaz: entity v „potvrzeném“ stavu s date IS NULL.
  • Anti-pattern: pohled, který čte jedinou „správnou“ tabulku, zatímco UI umožňuje zadat totéž jinde (kanban, detail, import). Stavový přechod („Potvrzeno“), který sémanticky znamená „má datum“, ale datum nevynucuje.
  • Lepší přístup: jeden dotaz sjednocující oba zdroje, nebo synchronizace (změna plannedDate → založí plánovací řádek). U stavů implikujících termín vyžadovat datum v přechodu.

Sister bugs / související

Sekce “Sister bugs / související”
  • Podobný vzor: dashboardové widgety čtoucí jen „novou“ tabulku po migraci dat, zatímco starší záznamy zůstaly ve staré.
Přidal aiarchitekt.cz · 28. 9. 2026 2:00
Provozuje aiarchitekt.cz