oib/aitbc
1
0
Fork 0
Code Issues Pull Requests Actions 3 Packages Projects Releases Wiki Activity
Files
e60cc3226c7408917ec832c21749d3884b015023
aitbc/docs/apps/marketplace/marketplace.md
aitbc 522655ef92
Some checks failed
API Endpoint Tests / test-api-endpoints (push) Successful in 10s
Details
Blockchain Synchronization Verification / sync-verification (push) Failing after 3s
Details
CLI Tests / test-cli (push) Failing after 4s
Details
Documentation Validation / validate-docs (push) Successful in 8s
Details
Documentation Validation / validate-policies-strict (push) Successful in 4s
Details
Integration Tests / test-service-integration (push) Successful in 38s
Details
Multi-Node Blockchain Health Monitoring / health-check (push) Successful in 2s
Details
P2P Network Verification / p2p-verification (push) Successful in 3s
Details
Security Scanning / security-scan (push) Successful in 40s
Details
Smart Contract Tests / test-solidity (map[name:aitbc-token path:packages/solidity/aitbc-token]) (push) Successful in 15s
Details
Smart Contract Tests / lint-solidity (push) Successful in 8s
Details
Move blockchain app READMEs to centralized documentation 
- Relocate blockchain-event-bridge README content to docs/apps/blockchain/blockchain-event-bridge.md
- Relocate blockchain-explorer README content to docs/apps/blockchain/blockchain-explorer.md
- Replace app READMEs with redirect notices pointing to new documentation location
- Consolidate documentation in central docs/ directory for better organization
2026-04-23 12:24:48 +02:00

1.9 KiB
Raw Blame History

Marketplace Web

Mock UI for exploring marketplace offers and submitting bids.

Development

npm install
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 Modes

Marketplace web reuses the explorer pattern of mock vs. live data:

  • Set VITE_MARKETPLACE_DATA_MODE=mock (default) to consume JSON fixtures under public/mock/.
  • Set VITE_MARKETPLACE_DATA_MODE=live and point VITE_MARKETPLACE_API to the coordinator backend when integration-ready.

Feature Flags & Auth

  • VITE_MARKETPLACE_ENABLE_BIDS (default true) gates whether the bid form submits to the backend. Set to false to keep the UI read-only during phased rollouts.
  • VITE_MARKETPLACE_REQUIRE_AUTH (default false) enforces a bearer token session before live bid submissions. Tokens are stored in localStorage by src/lib/auth.ts; the API helpers automatically attach the Authorization header when a session is present.
  • Session JSON is expected to include token (string) and expiresAt (epoch ms). Expired or malformed entries are cleared automatically.

Document any backend expectations (e.g., coordinator accepting bearer tokens) alongside the environment variables in deployment manifests.

Structure

  • public/mock/offers.json – sample marketplace offers.
  • public/mock/stats.json – summary dashboard statistics.
  • src/lib/api.ts – data-mode-aware fetch helpers.
  • src/main.ts – renders dashboard, offers table, and bid form.
  • src/style.css – layout and visual styling.

Submitting Bids

When in mock mode, bid submissions simulate latency and always succeed.

When in live mode, ensure the coordinator exposes /v1/marketplace/offers, /v1/marketplace/stats, and /v1/marketplace/bids endpoints compatible with the JSON shapes defined in src/lib/api.ts.