chore: refactor logging module, update genesis timestamp, remove model relationships, and reorganize routers - Rename logging.py to logger.py and update import paths in poa.py and main.py - Update devnet genesis timestamp to 1766828620 - Remove SQLModel Relationship declarations from Block, Transaction, and Receipt models - Add SessionDep type alias and get_session dependency in coordinator-api deps - Reorganize coordinator-api routers: replace explorer/registry with exchange, users, marketplace
Explorer Web
Purpose & Scope
Static web explorer for the AITBC blockchain node, displaying blocks, transactions, and receipts as outlined in docs/bootstrap/explorer_web.md.
Development Setup
npm install
- Start the dev server (Vite):
The dev server listens onnpm run devhttp://localhost:5173/by default. Adjust via--host/--portflags in thesystemdunit orpackage.jsonscript.
Data Mode Toggle
- Configuration lives in
src/config.tsand can be overridden with environment variables. - Use
VITE_DATA_MODEto choose betweenmock(default) andlive. - When switching to live data, set
VITE_COORDINATOR_APIto the coordinator base URL (e.g.,http://localhost:8000). - Example
.envsnippet:VITE_DATA_MODE=live VITE_COORDINATOR_API=https://coordinator.dev.internal
Feature Flags & Auth
- Document any backend expectations (e.g., coordinator accepting bearer tokens) alongside the environment variables in deployment manifests.
End-to-End Tests
- Install browsers after
npm installby runningnpx playwright install. - Launch the dev server (or point
EXPLORER_BASE_URLat an already running instance) and run:npm run test:e2e - Tests automatically persist live mode and stub coordinator responses to verify overview, blocks, and transactions views.
Playwright
- Run
npm run test:e2eto execute the end-to-end tests. - The tests will automatically persist live mode and stub coordinator responses to verify overview, blocks, and transactions views.