feat(logging-p0): replace console.* with logger and add error logging before ERP throws

Eliminate console.* remnants in bootstrap, session-manager, migrations, and app entry
so startup and login failures are captured in log files. Add log.error before all 14
throw sites in ERP services (auth, extractor, cleaner, browser manager) to ensure
critical automation failures are traceable. Introduce capturePageContext utility for
defensive Playwright page state capture during error logging.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
Misaka
2026-04-04 12:12:41 +08:00
parent 018d524fe8
commit 12a17eccb7
10 changed files with 128 additions and 24 deletions

View File

@@ -0,0 +1,47 @@
/**
* ERP Error Context Capture
*
* Lightweight helper to capture Playwright page state when ERP operations fail.
* All capture calls are defensive — failures do not propagate to the caller.
*/
import type { Page } from 'playwright'
export interface ErpErrorContext {
pageUrl?: string
frameHierarchy?: Array<{ name: string; url: string }>
targetSelector?: string
}
/**
* Capture the current state of a Playwright page for error logging.
* Returns a plain object safe for structured logging.
*
* @param page - The Playwright page to inspect
* @param targetSelector - Optional selector that was being targeted
*/
export async function capturePageContext(
page: Page,
targetSelector?: string
): Promise<ErpErrorContext> {
const ctx: ErpErrorContext = {}
try {
ctx.pageUrl = page.url()
} catch {
// page may be closed or inaccessible
}
try {
const frames = page.frames()
ctx.frameHierarchy = frames.map((f) => ({ name: f.name(), url: f.url() }))
} catch {
// frame enumeration may fail on detached pages
}
if (targetSelector) {
ctx.targetSelector = targetSelector
}
return ctx
}