feat(schedule2): Schedule 2 print section (Story 20.6)

Adds the Schedule 2 (Purchased and Private Log Costs and Sales) section to the
combined Print Schedules PDF, following the 20.2 SectionMapper + bean-datasource
pattern. Schedule 2 is a SINGLE aggregate document.

- ScheduleKey.SCHEDULE_2 declared FIRST (prints before Schedule 5 in the fixed
  legacy order, BR-08) + reports/schedule2.jrxml (portrait; seven fixed CostBlock
  rows — Volume m³ / Cost $ / $-per-m³ — with grouping separators and body/comment
  gating)
- Schedule2SectionMapper: maps Schedule2Response to ONE section row; derived
  figures (subtotal / net / totals / perUnit, carried Sch1/3 terms) reused verbatim,
  format-only (whole-dollar cost, 2dp volume + $/m³, "-" for null); returns null when
  every cost block is null (skip-empty, BR-09)
- ReportService.fillSection wiring + Schedule2Service injection; PrintService
  selectionOf case; removed schedule2 from logUnimplementedSelections
- frontend printSchedules: schedule2 renderable: true

Tests: Schedule2SectionMapperTest (5) + ScheduleKeyTest (order, SCHEDULE_2 first);
PrintScheduleIT extended — 621 renders + one bookmark, 515 Sch-2-only -> 404, and the
allSchedules case now asserts Schedule 2 first in the bookmark order (517). Green under
Oracle Testcontainers (17/17).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: gpascucci

backend/src/main/java/ca/bc/gov/nrs/ilcr/reporting/PrintService.java

@@ -18,13 +18,13 @@
 /**
  * Orchestrates the combined Print Schedules PDF (Epic 20.2). Given a validated mill/year context
  * and a {@link PrintRequest}, it fills each SELECTED in-scope schedule section in the FIXED legacy
- * order (5 → 6 → 7A → 7B → 9 → 11, the {@link ScheduleKey} declaration order), SKIPS any section
- * with no data (BR-09 skip-empty), and exports the accumulated sections to ONE bookmarked PDF
- * (BR-08) — one top-level bookmark per rendered schedule. When no selected content yields any data
- * the result is all-empty and no PDF is produced: {@link ScheduleNotFoundException} (→ 404
+ * order (2 → 5 → 6 → 7A → 7B → 9 → 11, the {@link ScheduleKey} declaration order), SKIPS any
+ * section with no data (BR-09 skip-empty), and exports the accumulated sections to ONE bookmarked
+ * PDF (BR-08) — one top-level bookmark per rendered schedule. When no selected content yields any
+ * data the result is all-empty and no PDF is produced: {@link ScheduleNotFoundException} (→ 404
  * ERR-005).
  *
- * <p>Selected-but-unimplemented schedules (1/2/3/8/10) and the mill-information-report option are
+ * <p>Selected-but-unimplemented schedules (1/3/8/10) and the mill-information-report option are
  * accepted for forward-compatibility but produce no section yet — they are skipped-with-a-log
  * (documented interim gap) until their story lands. Selection VALIDATION (ERR-002/003/004) is the
  * controller's responsibility and runs before this.
@@ -176,6 +176,7 @@ private static Predicate<ScheduleKey> selectionOf(PrintRequest request) {
     }
     return key ->
         switch (key) {
+          case SCHEDULE_2 -> request.schedule2();
           case SCHEDULE_5 -> request.schedule5();
           case SCHEDULE_6 -> request.schedule6();
           case SCHEDULE_7A -> request.schedule7a();
@@ -193,7 +194,6 @@ private void logUnimplementedSelections(PrintRequest request) {
     boolean anyUnimplemented =
         request.allSchedules()
             || request.schedule1()
-            || request.schedule2()
             || request.schedule3()
             || request.schedule4()
             || request.schedule8()
@@ -206,8 +206,8 @@ private void logUnimplementedSelections(PrintRequest request) {
       // interim gap is documented; raise to DEBUG logging when diagnosing a caller that still sends
       // them.
       log.debug(
-          "Print selection includes schedules/options not yet implemented in Epic 20.2 "
-              + "(1/2/3/4/8/10 and/or the Mill Information report); those are skipped for now");
+          "Print selection includes schedules/options not yet implemented in Epic 20 "
+              + "(1/3/4/8/10 and/or the Mill Information report); those are skipped for now");
     }
   }
 }

backend/src/main/java/ca/bc/gov/nrs/ilcr/reporting/ReportService.java

@@ -2,6 +2,7 @@
 
 import ca.bc.gov.nrs.ilcr.millcontext.ScheduleNotFoundException;
 import ca.bc.gov.nrs.ilcr.schedule11.Schedule11Service;
+import ca.bc.gov.nrs.ilcr.schedule2.Schedule2Service;
 import ca.bc.gov.nrs.ilcr.schedule5.Schedule5Service;
 import ca.bc.gov.nrs.ilcr.schedule6.Schedule6Service;
 import ca.bc.gov.nrs.ilcr.schedule7a.Schedule7aService;
@@ -59,6 +60,7 @@ public class ReportService {
   private static final Logger log = LoggerFactory.getLogger(ReportService.class);
 
   private final DataSource dataSource;
+  private final Schedule2Service schedule2Service;
   private final Schedule5Service schedule5Service;
   private final Schedule6Service schedule6Service;
   private final Schedule7aService schedule7aService;
@@ -79,6 +81,7 @@ public class ReportService {
    *     from — its own small pool, isolated from the {@code @Primary} transactional pool so a burst
    *     of report renders cannot starve ordinary schedule requests (its connections are read-only
    *     as a hint, not an enforced privilege)
+   * @param schedule2Service the Schedule 2 read (bean-datasource feed, Story 20.6)
    * @param schedule5Service the Schedule 5 read (bean-datasource feed)
    * @param schedule6Service the Schedule 6 read (bean-datasource feed)
    * @param schedule7aService the Schedule 7A read (bean-datasource feed)
@@ -91,6 +94,7 @@ public class ReportService {
    */
   public ReportService(
       @Qualifier("reportingDataSource") DataSource dataSource,
+      Schedule2Service schedule2Service,
       Schedule5Service schedule5Service,
       Schedule6Service schedule6Service,
       Schedule7aService schedule7aService,
@@ -99,6 +103,7 @@ public ReportService(
       Schedule11Service schedule11Service,
       ReportVirtualizerFactory virtualizerFactory) {
     this.dataSource = dataSource;
+    this.schedule2Service = schedule2Service;
     this.schedule5Service = schedule5Service;
     this.schedule6Service = schedule6Service;
     this.schedule7aService = schedule7aService;
@@ -178,6 +183,16 @@ public JasperPrint fillSection(
       String bookmarkTitle,
       JRSwapFileVirtualizer virtualizer) {
     return switch (key) {
+      case SCHEDULE_2 ->
+          fillBean(
+              key,
+              millId,
+              year,
+              options,
+              millTitleBlock,
+              bookmarkTitle,
+              Schedule2SectionMapper.map(schedule2Service.getSchedule2(millId, year, false)),
+              virtualizer);
       case SCHEDULE_5 ->
           fillBean(
               key,

backend/src/main/java/ca/bc/gov/nrs/ilcr/reporting/Schedule2SectionMapper.java

@@ -0,0 +1,66 @@
+package ca.bc.gov.nrs.ilcr.reporting;
+
+import ca.bc.gov.nrs.ilcr.schedule2.dto.CostBlock;
+import ca.bc.gov.nrs.ilcr.schedule2.dto.Schedule2Response;
+import java.util.LinkedHashMap;
+import java.util.List;
+import java.util.Map;
+
+/**
+ * Maps the Schedule 2 (Purchased/Private Log Costs and Sales) read document to the print section
+ * datasource. Unlike the per-record fan-out sections (Schedule 5's one-row-per-camp), Schedule 2 is
+ * a SINGLE aggregate document, so this emits exactly ONE row holding the seven fixed cost blocks —
+ * {@code purchasedLogCost}, {@code purchasedWoodOverhead}, {@code subtotal}, {@code lessLogSales},
+ * {@code netPurchased}, {@code totalCompanyLogging}, {@code totalAverage} — each as a
+ * volume/cost/$-per-m³ triple. Every derived figure (the computed subtotal / net / totals and every
+ * {@code perUnit}, plus the carried Schedule-1/3 terms) is already computed by {@code
+ * Schedule2Service}; this only formats: whole-dollar cost, fractional volume + $-per-m³ at two
+ * decimals, and {@code "-"} for null.
+ *
+ * <p>Skip-empty (BR-09) keys off the DATA, not a detail-row count: when every cost block is null
+ * (an unsaved Schedule 2 with no carried Schedule-3 figures) this returns {@code null} so the
+ * orchestrator omits the section.
+ */
+final class Schedule2SectionMapper {
+
+  private Schedule2SectionMapper() {}
+
+  static SectionData map(Schedule2Response response) {
+    if (response == null || isEmpty(response)) {
+      return null;
+    }
+    Map<String, Object> row = new LinkedHashMap<>();
+    putBlock(row, "purchasedLogCost", response.purchasedLogCost());
+    putBlock(row, "purchasedWoodOverhead", response.purchasedWoodOverhead());
+    putBlock(row, "subtotal", response.subtotal());
+    putBlock(row, "lessLogSales", response.lessLogSales());
+    putBlock(row, "netPurchased", response.netPurchased());
+    putBlock(row, "totalCompanyLogging", response.totalCompanyLogging());
+    putBlock(row, "totalAverage", response.totalAverage());
+    row.put("comments", SectionFormat.text(response.comments()));
+    return new SectionData(List.of(row), Map.of());
+  }
+
+  /** Emit a block's three cells ({@code <name>Vol/Cos/Cal}), pre-formatted with "-" for null. */
+  private static void putBlock(Map<String, Object> row, String name, CostBlock block) {
+    row.put(name + "Vol", SectionFormat.decimal(block == null ? null : block.volume()));
+    row.put(name + "Cos", SectionFormat.money(block == null ? null : block.cost()));
+    row.put(name + "Cal", SectionFormat.decimal(block == null ? null : block.perUnit()));
+  }
+
+  /** True when no cost block carries any figure — the skip-empty signal (BR-09). */
+  private static boolean isEmpty(Schedule2Response r) {
+    return allNull(r.purchasedLogCost())
+        && allNull(r.purchasedWoodOverhead())
+        && allNull(r.subtotal())
+        && allNull(r.lessLogSales())
+        && allNull(r.netPurchased())
+        && allNull(r.totalCompanyLogging())
+        && allNull(r.totalAverage());
+  }
+
+  private static boolean allNull(CostBlock block) {
+    return block == null
+        || (block.volume() == null && block.cost() == null && block.perUnit() == null);
+  }
+}

backend/src/main/java/ca/bc/gov/nrs/ilcr/reporting/ScheduleKey.java

@@ -1,13 +1,16 @@
 package ca.bc.gov.nrs.ilcr.reporting;
 
 /**
- * The schedules Epic 20.2 can render, each bound to its classpath template and its bookmark title.
- * Declared in the FIXED legacy print order (5 → 6 → 7A → 7B → 9 → 11 within the 1..11 sequence), so
- * iterating the enum yields the combined PDF's section order (BR-08) without a separate ordering
- * table. Schedules 1/2/3/8/10 and the Mill Information report are out of scope (no enum constant) —
- * a selected-but-unimplemented schedule is skipped-with-a-log by the orchestrator.
+ * The schedules Epic 20 can render, each bound to its classpath template and its bookmark title.
+ * Declared in the FIXED legacy print order (2 → 5 → 6 → 7A → 7B → 9 → 11 within the 1..11
+ * sequence), so iterating the enum yields the combined PDF's section order (BR-08) without a
+ * separate ordering table. Schedule 2 sits before Schedule 5 in the legacy sequence, so its
+ * constant is declared FIRST. Schedules 1/3/8/10 and the Mill Information report are out of scope
+ * (no enum constant) — a selected-but-unimplemented schedule is skipped-with-a-log by the
+ * orchestrator.
  */
 public enum ScheduleKey {
+  SCHEDULE_2("reports/schedule2.jrxml", "Schedule 2: Purchased and Private Log Costs and Sales"),
   SCHEDULE_5("reports/schedule5.jrxml", "Schedule 5: Camp and Access Expenses"),
   SCHEDULE_6("reports/schedule6.jrxml", "Schedule 6: Road Management Costs"),
   SCHEDULE_7A("reports/schedule7a.jrxml", "Schedule 7A: Bridge Costs"),