Kalendář čte jen plánovací tabulku — entity s datem, ale bez plánu, jsou neviditelné
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”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á“.
Root cause
Sekce “Root cause”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 vraceloNOT_READY).
Výsledek: dva nezávislé zdroje pravdy o termínu, kalendář četl jen ten prázdný.
// PŘED — jen plánovací tabulkaconst days = await prisma.plannedDay.findMany({ where: { date: { gte: from, lte: to } }, include: { entity: true } });Fix
Sekce “Fix”// PO — doplnit entity s termínem, které nemají žádný naplánovaný denconst 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_daysvs.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 sdate 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é.