vctp2/phase0-baseline.md

Phase 0 Baseline and Regression Snapshot

Date captured: 2026-04-20 (Australia/Sydney)

Baseline metrics (local db.sqlite3 + reports/)

Area	Metric	Baseline
Hourly capture	snapshot_registry hourly entries	930
Hourly capture	Hourly compatibility tables (inventory_hourly_%)	930
Hourly capture	Canonical cache rows (vm_hourly_stats)	489865
Hourly capture	Latest hourly snapshot row count (snapshot_count)	52
Hourly capture	Latest hourly snapshot table	inventory_hourly_1776635926
Daily aggregation	snapshot_registry daily entries	39
Daily aggregation	Daily summary tables (inventory_daily_summary_%)	40
Daily aggregation	Canonical daily rollup rows (vm_daily_rollup)	1779
Daily aggregation	Latest daily summary table	inventory_daily_summary_20260419
Daily aggregation	Latest daily snapshot row count (snapshot_count)	52
Monthly aggregation	snapshot_registry monthly entries	1
Monthly aggregation	Latest monthly summary table	inventory_monthly_summary_202601
Monthly aggregation	Latest monthly snapshot row count (snapshot_count)	62
Report generation	Files present in reports/	10339
Report generation	Most recent files	inventory_hourly_1776635926.xlsx, inventory_daily_summary_20260419.xlsx, inventory_hourly_1776635626.xlsx

Notes:

• snapshot_runs rows: 10254, success distribution: TRUE=10254, attempts min/max/avg: 1/2/1.0001.
• Runtime histograms/counters for long-running jobs are emitted on /metrics and are not persisted in SQLite.
  • Hourly per-vCenter duration: vctp_vcenter_snapshot_duration_seconds
  • Daily duration: vctp_daily_aggregation_duration_seconds
  • Monthly duration: vctp_monthly_aggregation_duration_seconds
  • Reports available gauge: vctp_reports_available

API/endpoint contract regression snapshot

Source of truth: server/router/router.go.

Unauthenticated/public routes:

• /
• /vm/trace
• /vcenters
• /vcenters/totals
• /vcenters/totals/daily
• /vcenters/totals/hourly
• /snapshots/hourly
• /snapshots/daily
• /snapshots/monthly
• /metrics
• /api/auth/login
• /assets/*, /favicon*, /reports/*, /swagger*

Viewer routes (Bearer auth, viewer/admin role):

• /api/report/inventory
• /api/report/updates
• /api/report/snapshot
• /api/diagnostics/daily-creation

Admin routes (Bearer auth, admin role):

• /api/event/vm/create
• /api/event/vm/modify
• /api/event/vm/move
• /api/event/vm/delete
• /api/import/vm
• /api/inventory/vm/delete
• /api/inventory/vm/update
• /api/cleanup/updates
• /api/snapshots/aggregate
• /api/snapshots/hourly/force
• /api/snapshots/migrate
• /api/snapshots/repair
• /api/snapshots/repair/all
• /api/snapshots/regenerate-hourly-reports
• /api/vcenters/cache/rebuild
• /api/encrypt
• /debug/pprof/* (only when enabled)

/api/auth/me route:

• Protected by auth middleware (withAuth) but no explicit role gate.

Report filename behavior regression snapshot

Source of truth: server/handler/reportDownload.go, server/handler/snapshots.go, internal/report/snapshots.go.

HTTP download endpoints:

• GET /api/report/inventory -> Content-Disposition: attachment; filename="inventory_report.xlsx"
• GET /api/report/updates -> Content-Disposition: attachment; filename="updates_report.xlsx"
• GET /api/report/snapshot?table=<tableName> -> Content-Disposition: attachment; filename="<tableName>.xlsx"

On-disk generated report filename:

• SaveTableReport(...) writes <reports_dir>/<tableName>.xlsx
• Snapshot list pages link to /reports/<tableName>.xlsx

Migration guardrails confirmation

• No auth-model changes: route auth wrappers remain unchanged (withAuth, withAuthRole usage in router).
• SQLite support retained:
  • settings default driver remains sqlite (src/vctp.yml, README.md).
  • hourly canonical write path still has SQLite transactional upsert path (insertHourlyCache, insertHourlyBatch).
• Compatibility mode enabled by default:
  • settings.snapshot_table_compat_mode default is true in settings defaults.
  • runtime check falls back to enabled when unset (snapshotTableCompatModeEnabled()).