feat: T4b/T4c wave 9 - phenology reports, autopilot A4-A10, honey ledger, Telegram delivery

- Phenology reports API with corrections and revokes; recompute per
  apiary via PhenologyRecomputeRequested, allowBackward for corrections;
  season changes are announced in the morning digest (changes since the
  previous digest, each once)
- Season autopilot A4-A10 with per-apiary sync (Apiary before Colony
  locks) and WinterCheckRecorded
- Honey batch ledger at runtime: initial amount, BOTTLING bookings,
  manual movements, one gram rounding, untracked bottlings never book
- Telegram delivery: planning, Berlin delivery times incl. DST, quiet
  hours, permission re-check and stale skip at send time, rate limits,
  cleanup of old deliveries
- ARCHITECTURE.md: assumptions 47-50 and updated sections 11.x

Co-Authored-By: Claude Opus 5.5 (1M context) <[email protected]>

ApiCore-Backend/src/autopilot/autopilot.handlers.ts

@@ -6,6 +6,7 @@ import type {
   DomainEventType,
 } from '../domain-events/domain-event-types';
 import { OnDomainEvent } from '../domain-events/on-domain-event.decorator';
+import { lockRowsForUpdate } from '../prisma/row-lock';
 import { AutopilotService } from './autopilot.service';
 
 const COLONY_SYNC_EVENTS = [
@@ -28,6 +29,7 @@ const COLONY_SYNC_EVENTS = [
   'QueenAged',
   'InspectionOverdue',
   'VarroaMeasurementDue',
+  'WinterCheckRecorded',
 ] as const satisfies readonly DomainEventType[];
 
 type ColonySyncEvent = AnyDomainEventEnvelope<
@@ -61,6 +63,7 @@ async function colonyIdsOf(
     case 'FeedingRecorded':
     case 'FeedingCorrected':
     case 'WithdrawalEnded':
+    case 'WinterCheckRecorded':
     case 'QueenAged':
       return [event.payload.colonyId];
     case 'HarvestRecorded':
@@ -85,7 +88,9 @@ async function colonyIdsOf(
 }
 
 /**
- * Reconciles the autopilot suggestions of the colonies an event touches.
+ * Reconciles the autopilot suggestions of the colonies an event touches
+ * (autopilot.colony-sync) and, for a season change, of all colonies of the
+ * apiary (autopilot.apiary-sync).
  * Pure DB writer through the delivery transaction; the colonies are synced
  * in id order, so two deliveries never lock them the other way round.
  */
@@ -104,9 +109,31 @@ export class AutopilotEventHandlers {
     if (colonyIds.length === 0) {
       return;
     }
+    if (colonyIds.length > 1) {
+      // All colonies in one statement before any sync, like syncApiaryIn.
+      await lockRowsForUpdate(tx, 'Colony', colonyIds);
+    }
     const today = berlinToday();
     for (const colonyId of colonyIds) {
       await this.autopilot.syncColonyIn(tx, colonyId, today);
     }
   }
+
+  /**
+   * A season change (new phase or segment) alters the rules for every colony
+   * of the apiary: reconcile them all. There is one such event per apiary and
+   * day (dailyDedupeKey); a change later the same day is caught by the daily
+   * autopilot step.
+   */
+  @OnDomainEvent(['SeasonPhaseChanged'], 'autopilot.apiary-sync')
+  async apiarySync(
+    event: AnyDomainEventEnvelope<'SeasonPhaseChanged'>,
+    tx: Prisma.TransactionClient,
+  ): Promise<void> {
+    await this.autopilot.syncApiaryIn(
+      tx,
+      event.payload.apiaryId,
+      berlinToday(),
+    );
+  }
 }