oib/aitbc

Files

oib 9b9c5beb23 ```

chore: enhance .gitignore and remove obsolete documentation files

- Reorganize .gitignore with categorized sections for better maintainability
- Add comprehensive ignore patterns for Python, Node.js, databases, logs, and build artifacts
- Add project-specific ignore rules for coordinator, explorer, and deployment files
- Remove outdated documentation: BITCOIN-WALLET-SETUP.md, LOCAL_ASSETS_SUMMARY.md, README-CONTAINER-DEPLOYMENT.md, README-DOMAIN-DEPLOYMENT.md
```

2026-01-24 14:44:51 +01:00

public

```

2026-01-24 14:44:51 +01:00

src

```

2026-01-24 14:44:51 +01:00

test-results

Based on the repository's commit message style and the changes in the diff, here's an appropriate commit message:

2025-12-22 07:55:09 +01:00

tests/e2e

Based on the repository's commit message style and the changes in the diff, here's an appropriate commit message:

2025-12-22 07:55:09 +01:00

index.html

```

2025-12-22 15:51:19 +01:00

package.json

Based on the repository's commit message style and the changes in the diff, here's an appropriate commit message:

2025-12-22 07:55:09 +01:00

playwright.config.ts

Based on the repository's commit message style and the changes in the diff, here's an appropriate commit message:

2025-12-22 07:55:09 +01:00

README.md

Based on the repository's commit message style and the changes in the diff, here's an appropriate commit message:

2025-12-22 07:55:09 +01:00

tsconfig.json

chore: initialize monorepo with project scaffolding, configs, and CI setup

2025-09-27 06:05:25 +02:00

vite.config.ts

```

2025-12-22 15:51:19 +01:00

README.md

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):
```
npm run dev
```
The dev server listens on http://localhost:5173/ by default. Adjust via --host/--port flags in the systemd unit or package.json script.

Data Mode Toggle

Configuration lives in src/config.ts and can be overridden with environment variables.
Use VITE_DATA_MODE to choose between mock (default) and live.
When switching to live data, set VITE_COORDINATOR_API to the coordinator base URL (e.g., http://localhost:8000).

Example .env snippet:

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 install by running npx playwright install.
Launch the dev server (or point EXPLORER_BASE_URL at 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:e2e to execute the end-to-end tests.
The tests will automatically persist live mode and stub coordinator responses to verify overview, blocks, and transactions views.