Files
aitbc/docs/marketplace_web.md
oib 99bf335970 docs: update documentation with latest completed milestones (2025-12-30)
- Update done.md: Reflect 9 container services running and Explorer live API integration
- Update roadmap.md: Mark Stages 8-10 as completed, add Stage 14 for Explorer JavaScript fixes
- Update explorer_web.md: Add Stage 3 completion for JavaScript error fixes
- Update coordinator_api.md: Add Stage 2 completion for import/syntax error fixes
- Update marketplace_web.md: Update status date to 2025-12-30
2025-12-30 10:30:19 +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.