Files
aitbc/docs/reference/components/marketplace_web.md
oib 55ced77928 ```
chore: remove obsolete files and add Solidity build artifacts to .gitignore

- Add ignore patterns for Solidity build artifacts (typechain-types, artifacts, cache)
- Remove unused exchange mock API server (api/exchange_mock_api.py)
- Remove obsolete client-web README placeholder
- Remove deprecated marketplace-ui HTML implementation
```
2026-01-24 15:46:23 +01:00

2.7 KiB
Raw Blame History

Marketplace Web Task Breakdown

Status (2025-12-30)

  • Stage 1: DEPLOYED - Marketplace Web successfully deployed in production at https://aitbc.bubuit.net/marketplace/
    • Vite + TypeScript project with API layer, auth scaffolding, and mock/live data toggle
    • Offer list, bid form, stats cards implemented
    • Mock data fixtures with API abstraction
    • nginx proxy configured at /marketplace/ route
  • Stage 2: Completed - Connected to coordinator endpoints with feature flags for live mode rollout.

Stage 1 (MVP) - COMPLETED

  • Project Initialization

    • Scaffold Vite + TypeScript project under apps/marketplace-web/.
    • Define package.json, tsconfig.json, vite.config.ts, and .env.example with VITE_API_BASE, VITE_FEATURE_WALLET.
    • Configure ESLint/Prettier presets.
  • API Layer

    • Implement src/api/http.ts for base fetch wrapper with mock vs real toggle.
    • Create src/api/marketplace.ts with typed functions for offers, bids, stats, wallet.
    • Provide mock JSON files under public/mock/ for development.
  • State Management

    • Implement lightweight store in src/lib/api.ts with pub/sub and caching.
    • Define shared TypeScript interfaces in src/lib/types.ts.
  • Views & Components

    • Build router in src/main.ts and bootstrap application.
    • Implement views: offer list, bid form, stats cards.
    • Create components with validation and responsive design.
    • Add filters (region, hardware, price, latency).
  • Styling & UX

    • Create CSS system implementing design and responsive layout.
    • Ensure accessibility: semantic HTML, focus states, keyboard navigation.
    • Add toast notifications and form validation messaging.
  • Authentication

    • Implement auth/session scaffolding in src/lib/auth.ts.
    • Add feature flags for marketplace actions.
  • Documentation

    • Update apps/marketplace-web/README.md with instructions for dev/build, mock API usage, and configuration.

Production Deployment Details

  • Container: Incus container 'aitbc' at /var/www/aitbc.bubuit.net/marketplace/
  • Build: Vite + TypeScript build process
  • Port: Static files served by nginx
  • Access: https://aitbc.bubuit.net/marketplace/
  • Features: Offer list, bid form, stats cards, responsive design
  • Mock Data: JSON fixtures in public/mock/ directory

Stage 2+ - IN PROGRESS

  • 🔄 Integrate real coordinator/pool hub endpoints and authentication.
  • 🔄 Add WebSocket updates for live offer/pricing changes.
  • 🔄 Implement i18n support with dictionaries in public/i18n/.
  • 🔄 Add Vitest test suite for utilities and API modules.