Files
ApiCore/ApiCore-Backend/src/dashboard/dashboard.service.ts
T
Nick SzaunigandClaude Opus 5.5 10cbe9bf2d
Backend Image / build-and-push (push) Successful in 3m15s
Frontend Image / build-and-push (push) Successful in 6m2s
fix: Paket 0 – data integrity, security hardening and field usability
Backend
- Backup covers every Prisma model (bundle v3); a guard test fails for any
  new model that is neither backed up nor explicitly excluded. Unsealed
  bundles may only add rows to 27 legacy master/field tables and never
  overwrite; counters, ledgers, settings, roles etc. need a sealed file.
  Shared import limit BACKUP_MAX_IMPORT_BYTES (default 50 MB, max 256 MB)
  with warnings in log and UI; replaced document files are removed after
  commit.
- Post-commit side effects (automation, calendar sync, webhooks) run via
  runAfterCommit and never turn a committed write into a 500, so retries
  with the same Idempotency-Key no longer create duplicates.
- Calendar outbox is multi-replica safe: per-entry claims with stale
  takeover, revision-based settle, new Graph event only on 404/410,
  transactionId on create, 30 s Graph timeout, URL-encoded ids, GUID
  validation for groupId, "run now" in background and resets FAILED.
- Automation tasks are deduplicated under a row lock on the rule.
- Update DTOs follow one null rule: omitted = unchanged, null clears a
  nullable field, null on a required field is a 400.
- Varroa mites/day is recomputed on correction; withdrawal status is
  checked against the harvest date (?at=), bounded colonyIds; inspection
  create is audited; updates re-enqueue calendar entries.
- Dashboard, statistics and apiary/colony guards treat WEAK, CONSPICUOUS
  and QUEENLESS colonies as living.
- Prisma errors and body-parser errors are logged without query values or
  request bodies.
- Migration 20261012100000_calendar_sync_claims; schema index name aligned
  with the existing database object.

Frontend
- Sticky save bar sticks again (no scroll container ancestors, card uses
  overflow-clip), safe-area insets, scroll-padding, FAB hidden on forms,
  sticky desktop sidebar.
- Inspections record yes / no / not checked instead of silent defaults.
- All living colonies are selectable; shared RecordSelect, EnumSelect,
  ChoiceGroup and TriStateField replace per-page copies; selects show
  names instead of ids; labels point at real controls.
- Emptied optional fields are sent as null (emptyToNull) so every field
  can be cleared; dates default to the local day and are sent via
  toApiDate.
- Harvest withdrawal warning uses the harvest date; backup page warns when
  a backup outgrows the import limit and lists skipped tables.

Build and docs
- Docker builds fail unless lint, typecheck and unit tests pass.
- ARCHITECTURE.md updated (assumptions 9-12, 19-21, section 8) and spec
  docs/superpowers/specs/2026-10-12-plattform-rueckgrat-und-fahrplan-design.md
  for the backbone (api/worker/job roles, domain event outbox) and the
  feature roadmap T3-T7.

Co-Authored-By: Claude Opus 5.5 (1M context) <[email protected]>
2026-10-12 16:38:55 +02:00

181 lines
5.4 KiB
TypeScript

import { Injectable } from '@nestjs/common';
import { PrismaService } from '../prisma/prisma.service';
import { LIVING_COLONY_WHERE } from '../colonies/colony-status';
export interface DashboardSummary {
apiariesActive: number;
coloniesActive: number;
queensActive: number;
openTasks: number;
honeyBatchesTotal: number;
stockItemsLowCount: number;
}
export interface DashboardAlert {
type:
| 'OVERDUE_TASK'
| 'COLONY_ATTENTION'
| 'LOW_STOCK'
| 'OVERDUE_SWARM_CHECK'
| 'OLD_QUEEN';
message: string;
relatedType: string;
relatedId: string;
}
const ATTENTION_COLONY_STATUSES = ['WEAK', 'QUEENLESS', 'CONSPICUOUS'] as const;
// Queens rarely stay reliably productive past their third season - laying
// rate and swarming risk both worsen well before then, so this flags a
// colony for evaluation rather than demanding immediate requeening.
const OLD_QUEEN_AGE_YEARS = 3;
@Injectable()
export class DashboardService {
constructor(private readonly prisma: PrismaService) {}
async summary(): Promise<DashboardSummary> {
const [
apiariesActive,
coloniesActive,
queensActive,
openTasks,
honeyBatchesTotal,
stockItems,
] = await Promise.all([
this.prisma.apiary.count({ where: { status: 'ACTIVE' } }),
this.prisma.colony.count({ where: LIVING_COLONY_WHERE }),
this.prisma.queen.count({
where: { status: { in: ['ACTIVE', 'RESERVE'] } },
}),
this.prisma.task.count({
where: { status: { in: ['OPEN', 'IN_PROGRESS'] } },
}),
this.prisma.honeyBatch.count(),
this.prisma.stockItem.findMany({
where: { minThreshold: { not: null } },
}),
]);
const stockItemsLowCount = stockItems.filter(
(item) => item.minThreshold !== null && item.quantity < item.minThreshold,
).length;
return {
apiariesActive,
coloniesActive,
queensActive,
openTasks,
honeyBatchesTotal,
stockItemsLowCount,
};
}
async alerts(): Promise<DashboardAlert[]> {
const [
overdueTasks,
attentionColonies,
stockItems,
swarmChecks,
queenedColonies,
] = await Promise.all([
this.prisma.task.findMany({
where: {
status: { in: ['OPEN', 'IN_PROGRESS'] },
dueDate: { lt: new Date() },
},
}),
this.prisma.colony.findMany({
where: { status: { in: [...ATTENTION_COLONY_STATUSES] } },
}),
this.prisma.stockItem.findMany({
where: { minThreshold: { not: null } },
}),
this.prisma.swarmControlCheck.findMany({
where: { colony: LIVING_COLONY_WHERE },
orderBy: [{ colonyId: 'asc' }, { date: 'desc' }],
select: {
colonyId: true,
nextCheckDate: true,
colony: { select: { code: true } },
},
}),
this.prisma.colony.findMany({
where: {
...LIVING_COLONY_WHERE,
currentQueen: { hatchYear: { not: null } },
},
select: {
id: true,
code: true,
currentQueen: { select: { hatchYear: true } },
},
}),
]);
const alerts: DashboardAlert[] = [];
for (const task of overdueTasks) {
alerts.push({
type: 'OVERDUE_TASK',
message: `Aufgabe "${task.title}" ist überfällig`,
relatedType: 'Task',
relatedId: task.id,
});
}
for (const colony of attentionColonies) {
alerts.push({
type: 'COLONY_ATTENTION',
message: `Volk ${colony.code} benötigt Aufmerksamkeit (${colony.status})`,
relatedType: 'Colony',
relatedId: colony.id,
});
}
for (const item of stockItems) {
if (item.minThreshold !== null && item.quantity < item.minThreshold) {
alerts.push({
type: 'LOW_STOCK',
message: `Lagerartikel "${item.name}" unter Mindestbestand`,
relatedType: 'StockItem',
relatedId: item.id,
});
}
}
// swarmChecks is ordered by colonyId then date desc, so the first entry
// seen per colonyId is that colony's most recent check - only the most
// recent nextCheckDate matters, an older overdue one has been superseded.
const now = new Date();
const latestCheckByColony = new Map<string, (typeof swarmChecks)[number]>();
for (const check of swarmChecks) {
if (!latestCheckByColony.has(check.colonyId)) {
latestCheckByColony.set(check.colonyId, check);
}
}
for (const check of latestCheckByColony.values()) {
if (check.nextCheckDate && check.nextCheckDate < now) {
alerts.push({
type: 'OVERDUE_SWARM_CHECK',
message: `Schwarmkontrolle für Volk ${check.colony.code} überfällig`,
relatedType: 'Colony',
relatedId: check.colonyId,
});
}
}
const currentYear = now.getFullYear();
for (const colony of queenedColonies) {
// The where clause above already requires currentQueen and its
// hatchYear to exist, but the relation is still nullable in the type.
if (!colony.currentQueen?.hatchYear) {
continue;
}
const ageYears = currentYear - colony.currentQueen.hatchYear;
if (ageYears >= OLD_QUEEN_AGE_YEARS) {
alerts.push({
type: 'OLD_QUEEN',
message: `Königin in Volk ${colony.code} ist ${ageYears} Jahre alt - Nachzucht prüfen`,
relatedType: 'Colony',
relatedId: colony.id,
});
}
}
return alerts;
}
}