From 02a0977b5d379d3b23610bce8c74b0fb7b21a29a Mon Sep 17 00:00:00 2001 From: mik-tf Date: Mon, 8 Sep 2025 15:58:25 -0400 Subject: [PATCH] docs: update credits documentation to reflect MC base currency implementation --- src/controllers/docs.rs | 2 +- src/views/docs/layout.html | 4 +-- src/views/docs/tfp.html | 67 ++++++++++++++++++++++++++++---------- 3 files changed, 53 insertions(+), 20 deletions(-) diff --git a/src/controllers/docs.rs b/src/controllers/docs.rs index 18db44d..415d0aa 100644 --- a/src/controllers/docs.rs +++ b/src/controllers/docs.rs @@ -162,7 +162,7 @@ impl DocsController { render_template(&tmpl, "docs/services.html", &ctx) } - /// USD Credits documentation page + /// Mycelium Credits documentation page pub async fn credits(tmpl: web::Data, session: Session) -> Result { let mut ctx = crate::models::builders::ContextBuilder::new() .active_page("docs") diff --git a/src/views/docs/layout.html b/src/views/docs/layout.html index c239542..75c3341 100644 --- a/src/views/docs/layout.html +++ b/src/views/docs/layout.html @@ -71,8 +71,8 @@
  • - - USD Credits + + Mycelium Credits
  • diff --git a/src/views/docs/tfp.html b/src/views/docs/tfp.html index d70ad09..12ac9db 100644 --- a/src/views/docs/tfp.html +++ b/src/views/docs/tfp.html @@ -1,32 +1,51 @@ {% extends "docs/layout.html" %} -{% block title %}USD Credits - Mycelium Marketplace{% endblock %} +{% block title %}Mycelium Credits - Mycelium Marketplace{% endblock %} {% block docs_content %}
    -

    USD Credits

    -

    Mycelium Marketplace uses a simple USD credits system for all transactions.

    +

    Mycelium Credits

    +

    Mycelium Credits (MC) is the foundation of our marketplace's credit-based economy, providing a seamless and flexible currency system for all transactions.

    -
    Simple and Intuitive
    -

    1 Credit = $1 USD. No complex conversions or confusing terminology.

    +
    MC as Default Currency
    +

    MC (Mycelium Credits) is now the default base currency for all new users. 1 MC = 1 USD for familiar pricing - you see equivalent values in your preferred display currency.

    -

    How Credits Work

    +

    What is Mycelium Credits?

    +

    Mycelium Credits represents the core of our marketplace's innovative credit economy:

      -
    • Direct USD Pricing: All products are priced in clear USD amounts
      • -
    • Easy Top-up: Add credits to your wallet with standard payment methods
      • -
    • Auto Top-up: Automatically purchase credits when your balance gets low
      • -
    • One-Click Purchasing: Buy products instantly with the "Buy Now" button
      • +
    • Base Currency: All internal calculations and balances are maintained in MC
      • +
    • Flexible Display: View prices and balances in your preferred currency (MC, USD, EUR, CAD, AED)
      • +
    • 1:1 Exchange Rate: For USD users, 1 MC = 1 USD - no conversion confusion
      • +
    • Credit Foundation: Built for future expansion of credit-based marketplace features
    +

    Currency Flexibility

    +

    While MC is our base currency, we understand users have different preferences:

    +
      +
    • Display Preference: Choose how you want to see prices and balances
      • +
    • Real-time Conversion: Automatic conversion for non-MC currencies
      • +
    • Consistent Balance: Your credit balance remains the same regardless of display currency
      • +
    • Supported Currencies: MC, USD, EUR, CAD, AED
      • +
    + +

    How to Change Your Currency Preference

    +

    Changing your display currency is simple and can be done at any time:

    +
      +
    1. Navigate to your Dashboard Settings
      2. +
    2. Find the "Currency Preference" section
      3. +
    3. Select your preferred display currency from the dropdown
      4. +
    4. Save your changes - the update applies immediately
      5. +
    +

    Auto Top-up

    Configure automatic credit purchasing for seamless marketplace experience:

    1. Go to your Wallet
    2. Enable Auto Top-up in the settings section
      3. -
    3. Set your threshold (e.g., when credits fall below $10)
      4. -
    4. Set your top-up amount (e.g., purchase $25 when triggered)
      5. +
    5. Set your threshold (e.g., when credits fall below 10 MC)
      6. +
    6. Set your top-up amount (e.g., purchase 25 MC when triggered)
    7. Choose your payment method
    @@ -36,17 +55,31 @@
  • Buy Now: Instant one-click purchase with automatic balance management and auto top-up integration
  • Add to Cart: Traditional shopping cart experience for purchasing multiple items together
    • - +
    Best of Both Worlds: Use "Buy Now" for quick single purchases, or "Add to Cart" when you want to compare multiple products or make bulk purchases.
    -

    Getting Started

    +

    Technical Details

    +

    For developers and advanced users:

    +
      +
    • Base Currency: All marketplace operations use MC internally
      • +
    • Display Layer: Currency preference affects only the presentation layer
      • +
    • API Consistency: Internal APIs work with MC values
      • +
    • Exchange Rates: Real-time rates for non-MC display currencies
      • +
    + +

    Getting Started with MC

      -
    1. Create your Mycelium Marketplace account
      2. -
    2. Add credits to your wallet
      3. -
    3. Browse the marketplace
      4. +
    4. Create your Mycelium Marketplace account (defaults to MC)
      5. +
    5. Add credits to your wallet (purchased in your preferred currency)
      6. +
    6. Browse the marketplace (prices shown in your display currency)
    7. Click "Buy Now" for instant purchases
      8. +
    8. Change currency preference anytime in Settings
    + +
    + Seamless Transition: Existing USD users experience no functional changes. Your balance and purchasing power remain identical. +
    {% endblock %} \ No newline at end of file