Fixed assets, fully featured: tags, serials, acquisition links, label sheets, the fixed asset register, and an Assets section in the viewer; fix a flaky verify

- core: asset tags (generated PREFIX-0001 or the human's own; unique ignoring case; never reused by another asset) and serial numbers (rules.md B-24); a journaled link from an asset to the entry that acquired it (posted, unreversed, debiting the cost account); fixed_asset_register(as_of), reconciled to the GL (unposted depreciation, unregistered cost) - store: asset.tagged, asset.serial_set, asset.acquisition_linked journaled, replayed, projected (schema v9); differs_from now also compares control roles and tag history - config: [books] asset_tag_prefix, default the company's initials without legal-form words - import: Avery 5160/8160 label sheets with QR codes (geometry vendored from Avery, docs/spec/sources/avery-5160.md); the register as XLSX and PDF - mcp: register_asset tags (and links) automatically; books.label_asset, books.asset_labels; asset tools take a tag; books.show asset / assets page / register report; export fixed_asset_register (json, csv, xlsx, pdf) and in the CPA package - viewer: Assets page (register, reconciliation), asset page (identity, schedule posted vs not, entries, documents), Fixed asset register report, global search by tag/serial/description, journal text, needs-attention items - fix: verify compared snapshot amounts as strings; a zero total summed in hash-map order could print "0" or "0.00", so agreeing books failed verify at random. Now by value (regression test) - tests: spec-blind suites for tags, register, prefix, store, MCP; label and register PDF/XLSX tests; viewer tests Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01GWVo7x3UHw5kwCUaWxiejX
2026-10-15 12:18:00 -06:00
1 parent 4e96b5f54d
commit cd085108c1
@@ -0,0 +1,221 @@
+//! Spec tests for the fixed asset register PDF
+//! (`ledger_import::asset_register`); the XLSX checks live in
+//! spec_import.rs beside its workbook reader. Each test names the module
+//! INVARIANT it checks.
+
+use chrono::NaiveDate;
+use ledger_core::{AssetRegister, AssetRegisterRow};
+use ledger_import::asset_register::{layout, typeset_asset_register};
+use ledger_import::report::ReportMeta;
+use ledger_import::{PdfError, asset_register_pdf};
+use rust_decimal::Decimal;
+use typst::layout::{Frame, FrameItem};
+
+fn d(y: i32, m: u32, day: u32) -> NaiveDate {
+    NaiveDate::from_ymd_opt(y, m, day).unwrap()
+}
+
+fn cents(c: i64) -> Decimal {
+    Decimal::new(c, 2)
+}
+
+fn meta() -> ReportMeta {
+    ReportMeta {
+        company: "Fernhill Labs LLC".into(),
+        basis: "Accrual".into(),
+        prepared_on: d(2026, 10, 15),
+        journal_seq: 314,
+    }
+}
+
+fn row(id: u64, tag: &str, desc: &str, cost: i64, acc: i64) -> AssetRegisterRow {
+    AssetRegisterRow {
+        asset_id: id,
+        tag: Some(tag.into()),
+        description: desc.into(),
+        serial: None,
+        in_service: d(2026, 1, 15),
+        cost: cents(cost),
+        salvage: Decimal::ZERO,
+        useful_life_months: 36,
+        accumulated: cents(acc),
+        book_value: cents(cost - acc),
+        disposed: None,
+    }
+}
+
+fn register(rows: Vec<AssetRegisterRow>) -> AssetRegister {
+    let held = || rows.iter().filter(|r| r.disposed.is_none());
+    let total_cost = held().map(|r| r.cost).sum();
+    let total_accumulated = held().map(|r| r.accumulated).sum();
+    AssetRegister {
+        as_of: d(2026, 10, 15),
+        total_book_value: total_cost - total_accumulated,
+        ledger_cost: total_cost,
+        ledger_accumulated: total_accumulated - cents(1234),
+        total_cost,
+        total_accumulated,
+        rows,
+    }
+}
+
+fn sample() -> AssetRegister {
+    let mut disposed = row(3, "FL-0003", "Old monitor", 40000, 0);
+    disposed.book_value = Decimal::ZERO;
+    disposed.disposed = Some((d(2026, 9, 30), cents(4500)));
+    let mut laptop = row(
+        1,
+        "FL-0001",
+        "Framework Laptop 13 (Ryzen 7 7840U, 64 GB, 4 TB)",
+        250000,
+        52778,
+    );
+    laptop.serial = Some("FRANBMCP0A1234".into());
+    laptop.salvage = cents(10000);
+    register(vec![
+        laptop,
+        row(2, "FL-0002", "MacBook Air", 129900, 32475),
+        disposed,
+    ])
+}
+
+fn texts(frame: &Frame, out: &mut String) {
+    for (_, item) in frame.items() {
+        match item {
+            FrameItem::Group(g) => texts(&g.frame, out),
+            FrameItem::Text(t) => {
+                out.push_str(&t.text);
+                out.push(' ');
+            }
+            _ => {}
+        }
+    }
+}
+
+fn all_text(r: &AssetRegister, m: &ReportMeta) -> String {
+    let doc = typeset_asset_register(r, m).expect("typesets");
+    let mut out = String::new();
+    for p in doc.pages() {
+        texts(&p.frame, &mut out);
+    }
+    // Runs end at line breaks: collapse the seams to single spaces.
+    out.split_whitespace().collect::<Vec<_>>().join(" ")
+}
+
+/// INVARIANT 6: the same register renders to the same bytes.
+#[test]
+fn pdf_is_deterministic() {
+    let r = sample();
+    let a = asset_register_pdf(&r, &meta()).unwrap();
+    assert!(a.starts_with(b"%PDF"));
+    assert_eq!(a, asset_register_pdf(&r, &meta()).unwrap());
+}
+
+/// INVARIANTS 1, 2, 3, 5: header, every asset, the status of each, the
+/// register's totals, and the reconciliation with both differences.
+#[test]
+fn pdf_shows_assets_totals_and_reconciliation() {
+    let t = all_text(&sample(), &meta());
+    for s in [
+        "Fernhill Labs LLC",
+        "Fixed Asset Register",
+        "As of October 15, 2026",
+        "FL-0001",
+        "FRANBMCP0A1234",
+        "MacBook Air",
+        "Active",
+        "Disposed 2026-09-30, proceeds 45.00",
+        "Total, assets held",
+        "3,799.00", // cost held: 2,500.00 + 1,299.00
+        "852.53",   // accumulated held
+        "2,946.47", // book value held
+        "Cost per register",
+        "Cost per books",
+        "Difference (unregistered cost)",
+        "Accumulated depreciation per schedule",
+        "Accumulated depreciation per books",
+        "Difference (not yet posted)",
+        "12.34",
+        "Journal seq 314",
+    ] {
+        assert!(t.contains(s), "{s:?} missing from {t:?}");
+    }
+    // The disposed asset's cost (400.00) is shown but in no total.
+    assert!(t.contains("400.00"));
+    let l = layout(&sample());
+    assert_eq!(l.totals, [cents(379900), cents(85253), cents(294647)]);
+}
+
+/// INVARIANT 4: an empty register renders a "No fixed assets" line, its
+/// totals, and the reconciliation.
+#[test]
+fn empty_register_renders() {
+    let r = register(vec![]);
+    let pdf = asset_register_pdf(&r, &meta()).expect("empty renders");
+    assert!(pdf.starts_with(b"%PDF"));
+    let t = all_text(&r, &meta());
+    for s in [
+        "No fixed assets",
+        "Total, assets held",
+        "Difference (not yet posted)",
+    ] {
+        assert!(t.contains(s), "{s:?} missing from {t:?}");
+    }
+}
+
+/// INVARIANT 6: markup in every text field prints literally and never runs.
+#[test]
+fn text_is_data() {
+    let mut a = row(1, "#FL-*1*", "#panic() *bold* $x$ <l> @r [x] \\", 100, 0);
+    a.serial = Some("_u_ // /*".into());
+    let m = ReportMeta {
+        company: "#co *Inc*".into(),
+        ..meta()
+    };
+    let t = all_text(&register(vec![a]), &m);
+    for s in [
+        "#FL-*1*", "#panic()", "*bold*", "$x$", "<l>", "@r", "[x]", "_u_", "#co", "*Inc*",
+    ] {
+        assert!(t.contains(s), "{s:?} not literal in {t:?}");
+    }
+    for s in [
+        "#panic()", "*", "_", "$", "[", "]", "\\", "#", "<a>", "@a", "//", "/*", "\"", "`",
+    ] {
+        let mut a = row(1, s, s, 100, 0);
+        a.serial = Some(s.into());
+        let m = ReportMeta {
+            company: s.into(),
+            ..meta()
+        };
+        let r: Result<Vec<u8>, PdfError> = asset_register_pdf(&register(vec![a]), &m);
+        r.unwrap_or_else(|e| panic!("{s:?}: {e}"));
+    }
+}
+
+/// A long register flows onto more landscape pages instead of being cut.
+#[test]
+fn long_register_paginates_landscape() {
+    let rows = (1..=120)
+        .map(|i| {
+            row(
+                i,
+                &format!("FL-{i:04}"),
+                &format!("Asset {i}"),
+                100_000,
+                1_000,
+            )
+        })
+        .collect();
+    let doc = typeset_asset_register(&register(rows), &meta()).unwrap();
+    assert!(doc.pages().len() > 1);
+    let size = doc.pages()[0].frame.size();
+    assert!(size.x > size.y, "landscape");
+}
+
+/// The sample register for eyeballing: writes `$REGISTER_SAMPLE` (a path).
+#[test]
+#[ignore = "writes a sample PDF for a human to look at"]
+fn write_sample() {
+    let out = std::env::var("REGISTER_SAMPLE").expect("set REGISTER_SAMPLE to the output path");
+    std::fs::write(out, asset_register_pdf(&sample(), &meta()).unwrap()).unwrap();
+}