projectmycelium/docs/dev/design/marketplace-redesign-plan.md

Project Mycelium Marketplace Redesign Plan

Overview

This document outlines the comprehensive redesign of the Project Mycelium marketplace to align with the new branding and simplified user experience.

🎯 Main Objectives

1. Rebranding & Terminology Updates

• 3nodes → Mycelium Nodes

  • Update frontend templates (dashboard, marketplace, docs)
  • Update backend models and services
  • Update database/storage references
  • Update API responses and documentation

• Farmers → Resource Providers

  • Update user roles and permissions
  • Update dashboard sections
  • Update navigation and menus
  • Update backend user management

• Application Solutions → Agentic Apps ✅ COMPLETED

  • Update product categories
  • Update marketplace listings
  • Update search and filtering
  • Update backend product models
  • Expand abbreviations (app_* → application_*)
  • Update frontend display text
  • Update documentation and specs
  • Verified zero remaining references

• ThreeFold Credit (TFC) → Mycelium Credit (MC)

  • Update currency display throughout UI
  • Update wallet and balance displays
  • Update transaction records
  • Update backend currency handling

2. Currency System Overhaul

• Implement Mycelium Credit (MC)

  • Update currency service to use MC as base
  • Set initial exchange rate: 1 MC = 1 USD
  • Update currency conversion logic
  • Update pricing calculations

• Currency Display Preferences

  • Add AED to supported currencies
  • Update settings page with currency selector
  • Implement currency preference persistence
  • Update currency display throughout UI

3. Statistics & Grid Integration

• TF Grid Statistics

  • Implement grid proxy integration
  • Add statistics dashboard section
  • Create statistics API endpoints
  • Update grid node data fetching

• Node Management Integration

  • Review existing add node functionality
  • Integrate with grid statistics
  • Update node status displays
  • Add real-time grid data

4. UX Verification & Testing

• Frontend Testing

  • Test all updated terminology
  • Test currency display preferences
  • Check responsive design

• Backend Testing

  • Test API endpoints with new terminology
  • Verify currency calculations
  • Test grid integration
  • Validate data persistence

• Integration Testing

  • End-to-end purchase flow testing
  • Cross-browser compatibility
  • Mobile responsiveness
  • Performance testing

📋 Implementation Phases

Phase 1: Terminology & Branding Updates

Focus: Update all user-facing text and terminology

• Frontend template updates
• Backend model updates
• Database migration for terminology
• Documentation updates

Phase 2: Currency System Implementation

Focus: Implement MC currency and preferences

• Currency service updates
• Settings page enhancements
• UI updates for currency display
• Testing and validation

Phase 3: Statistics & Grid Integration

Focus: Add grid statistics and improve node management

• Grid proxy integration
• Statistics dashboard
• Node management improvements
• Real-time data updates

Phase 4: Final Testing & Polish

Focus: Comprehensive testing and UX refinement

• Full UX testing suite
• Performance optimization
• Documentation updates
• Production readiness

🔧 Technical Considerations

Files to Modify

• Frontend: src/views/**/*.html, src/static/js/**/*.js
• Backend: src/controllers/**/*.rs, src/services/**/*.rs, src/models/**/*.rs
• Database: User data files, product data, transaction records
• Configuration: Currency settings, grid proxy configuration

Dependencies

• Grid proxy service integration
• Currency conversion service updates
• User preference storage
• Real-time data fetching

Risk Mitigation

• Comprehensive testing before deployment
• Database backup and migration testing
• Rollback plan for critical changes
• User communication plan

📊 Progress Tracking

• Total Tasks: 45
• Completed: 28
• In Progress: 2 (TFC → MC currency, Grid Statistics)
• Remaining: 15

Recently Completed (2025-01-08)

✅ Application Solutions → Agentic Apps - Complete rebranding with:

• Backend code changes (expanded abbreviations: app_* → application_*)
• Frontend display text changes ("Application Solutions" → "Agentic Apps")
• Documentation and specs updates
• Verification of zero remaining references
• Updated 13 files across backend, frontend, tests, and documentation

🎯 Success Criteria

• All terminology updated consistently ✅ (3nodes→Mycelium Nodes, Farmers→Resource Providers, Application Solutions→Agentic Apps)
• MC currency fully implemented (Next priority)
• Grid statistics integrated
• All UX flows verified working
• Performance maintained or improved
• Documentation updated ✅ (Specs and design docs updated)

---

This plan will be updated as implementation progresses. Checkboxes will be marked as tasks are completed.