docs: update credits documentation to reflect MC base currency implementation
This commit is contained in:
		@@ -162,7 +162,7 @@ impl DocsController {
 | 
				
			|||||||
        render_template(&tmpl, "docs/services.html", &ctx)
 | 
					        render_template(&tmpl, "docs/services.html", &ctx)
 | 
				
			||||||
    }
 | 
					    }
 | 
				
			||||||
 | 
					
 | 
				
			||||||
    /// USD Credits documentation page
 | 
					    /// Mycelium Credits documentation page
 | 
				
			||||||
    pub async fn credits(tmpl: web::Data<Tera>, session: Session) -> Result<impl Responder> {
 | 
					    pub async fn credits(tmpl: web::Data<Tera>, session: Session) -> Result<impl Responder> {
 | 
				
			||||||
        let mut ctx = crate::models::builders::ContextBuilder::new()
 | 
					        let mut ctx = crate::models::builders::ContextBuilder::new()
 | 
				
			||||||
            .active_page("docs")
 | 
					            .active_page("docs")
 | 
				
			||||||
 
 | 
				
			|||||||
@@ -71,8 +71,8 @@
 | 
				
			|||||||
                    </li>
 | 
					                    </li>
 | 
				
			||||||
                    <li class="nav-item">
 | 
					                    <li class="nav-item">
 | 
				
			||||||
                        <a class="nav-link {% if active_section == 'credits' %}active{% endif %}" href="/docs/credits">
 | 
					                        <a class="nav-link {% if active_section == 'credits' %}active{% endif %}" href="/docs/credits">
 | 
				
			||||||
                            <i class="bi bi-currency-dollar me-1"></i>
 | 
					                            <i class="bi bi-lightning-charge me-1"></i>
 | 
				
			||||||
                            USD Credits
 | 
					                            Mycelium Credits
 | 
				
			||||||
                        </a>
 | 
					                        </a>
 | 
				
			||||||
                    </li>
 | 
					                    </li>
 | 
				
			||||||
                    <li class="nav-item">
 | 
					                    <li class="nav-item">
 | 
				
			||||||
 
 | 
				
			|||||||
@@ -1,32 +1,51 @@
 | 
				
			|||||||
{% extends "docs/layout.html" %}
 | 
					{% extends "docs/layout.html" %}
 | 
				
			||||||
 | 
					
 | 
				
			||||||
{% block title %}USD Credits - Mycelium Marketplace{% endblock %}
 | 
					{% block title %}Mycelium Credits - Mycelium Marketplace{% endblock %}
 | 
				
			||||||
 | 
					
 | 
				
			||||||
{% block docs_content %}
 | 
					{% block docs_content %}
 | 
				
			||||||
<div class="docs-content">
 | 
					<div class="docs-content">
 | 
				
			||||||
    <h1>USD Credits</h1>
 | 
					    <h1>Mycelium Credits</h1>
 | 
				
			||||||
    <p class="lead">Mycelium Marketplace uses a simple USD credits system for all transactions.</p>
 | 
					    <p class="lead">Mycelium Credits (MC) is the foundation of our marketplace's credit-based economy, providing a seamless and flexible currency system for all transactions.</p>
 | 
				
			||||||
 | 
					
 | 
				
			||||||
    <div class="alert alert-info">
 | 
					    <div class="alert alert-info">
 | 
				
			||||||
        <h5>Simple and Intuitive</h5>
 | 
					        <h5>MC as Default Currency</h5>
 | 
				
			||||||
        <p>1 Credit = $1 USD. No complex conversions or confusing terminology.</p>
 | 
					        <p><strong>MC (Mycelium Credits)</strong> 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.</p>
 | 
				
			||||||
    </div>
 | 
					    </div>
 | 
				
			||||||
 | 
					
 | 
				
			||||||
    <h2>How Credits Work</h2>
 | 
					    <h2>What is Mycelium Credits?</h2>
 | 
				
			||||||
 | 
					    <p>Mycelium Credits represents the core of our marketplace's innovative credit economy:</p>
 | 
				
			||||||
    <ul>
 | 
					    <ul>
 | 
				
			||||||
        <li><strong>Direct USD Pricing:</strong> All products are priced in clear USD amounts</li>
 | 
					        <li><strong>Base Currency:</strong> All internal calculations and balances are maintained in MC</li>
 | 
				
			||||||
        <li><strong>Easy Top-up:</strong> Add credits to your wallet with standard payment methods</li>
 | 
					        <li><strong>Flexible Display:</strong> View prices and balances in your preferred currency (MC, USD, EUR, CAD, AED)</li>
 | 
				
			||||||
        <li><strong>Auto Top-up:</strong> Automatically purchase credits when your balance gets low</li>
 | 
					        <li><strong>1:1 Exchange Rate:</strong> For USD users, 1 MC = 1 USD - no conversion confusion</li>
 | 
				
			||||||
        <li><strong>One-Click Purchasing:</strong> Buy products instantly with the "Buy Now" button</li>
 | 
					        <li><strong>Credit Foundation:</strong> Built for future expansion of credit-based marketplace features</li>
 | 
				
			||||||
    </ul>
 | 
					    </ul>
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					    <h2>Currency Flexibility</h2>
 | 
				
			||||||
 | 
					    <p>While MC is our base currency, we understand users have different preferences:</p>
 | 
				
			||||||
 | 
					    <ul>
 | 
				
			||||||
 | 
					        <li><strong>Display Preference:</strong> Choose how you want to see prices and balances</li>
 | 
				
			||||||
 | 
					        <li><strong>Real-time Conversion:</strong> Automatic conversion for non-MC currencies</li>
 | 
				
			||||||
 | 
					        <li><strong>Consistent Balance:</strong> Your credit balance remains the same regardless of display currency</li>
 | 
				
			||||||
 | 
					        <li><strong>Supported Currencies:</strong> MC, USD, EUR, CAD, AED</li>
 | 
				
			||||||
 | 
					    </ul>
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					    <h2>How to Change Your Currency Preference</h2>
 | 
				
			||||||
 | 
					    <p>Changing your display currency is simple and can be done at any time:</p>
 | 
				
			||||||
 | 
					    <ol>
 | 
				
			||||||
 | 
					        <li>Navigate to your <a href="/dashboard/settings">Dashboard Settings</a></li>
 | 
				
			||||||
 | 
					        <li>Find the "Currency Preference" section</li>
 | 
				
			||||||
 | 
					        <li>Select your preferred display currency from the dropdown</li>
 | 
				
			||||||
 | 
					        <li>Save your changes - the update applies immediately</li>
 | 
				
			||||||
 | 
					    </ol>
 | 
				
			||||||
 | 
					
 | 
				
			||||||
    <h2>Auto Top-up</h2>
 | 
					    <h2>Auto Top-up</h2>
 | 
				
			||||||
    <p>Configure automatic credit purchasing for seamless marketplace experience:</p>
 | 
					    <p>Configure automatic credit purchasing for seamless marketplace experience:</p>
 | 
				
			||||||
    <ol>
 | 
					    <ol>
 | 
				
			||||||
        <li>Go to your <a href="/dashboard/wallet">Wallet</a></li>
 | 
					        <li>Go to your <a href="/dashboard/wallet">Wallet</a></li>
 | 
				
			||||||
        <li>Enable Auto Top-up in the settings section</li>
 | 
					        <li>Enable Auto Top-up in the settings section</li>
 | 
				
			||||||
        <li>Set your threshold (e.g., when credits fall below $10)</li>
 | 
					        <li>Set your threshold (e.g., when credits fall below 10 MC)</li>
 | 
				
			||||||
        <li>Set your top-up amount (e.g., purchase $25 when triggered)</li>
 | 
					        <li>Set your top-up amount (e.g., purchase 25 MC when triggered)</li>
 | 
				
			||||||
        <li>Choose your payment method</li>
 | 
					        <li>Choose your payment method</li>
 | 
				
			||||||
    </ol>
 | 
					    </ol>
 | 
				
			||||||
 | 
					
 | 
				
			||||||
@@ -41,12 +60,26 @@
 | 
				
			|||||||
        <strong>Best of Both Worlds:</strong> Use "Buy Now" for quick single purchases, or "Add to Cart" when you want to compare multiple products or make bulk purchases.
 | 
					        <strong>Best of Both Worlds:</strong> Use "Buy Now" for quick single purchases, or "Add to Cart" when you want to compare multiple products or make bulk purchases.
 | 
				
			||||||
    </div>
 | 
					    </div>
 | 
				
			||||||
 | 
					
 | 
				
			||||||
    <h2>Getting Started</h2>
 | 
					    <h2>Technical Details</h2>
 | 
				
			||||||
 | 
					    <p>For developers and advanced users:</p>
 | 
				
			||||||
 | 
					    <ul>
 | 
				
			||||||
 | 
					        <li><strong>Base Currency:</strong> All marketplace operations use MC internally</li>
 | 
				
			||||||
 | 
					        <li><strong>Display Layer:</strong> Currency preference affects only the presentation layer</li>
 | 
				
			||||||
 | 
					        <li><strong>API Consistency:</strong> Internal APIs work with MC values</li>
 | 
				
			||||||
 | 
					        <li><strong>Exchange Rates:</strong> Real-time rates for non-MC display currencies</li>
 | 
				
			||||||
 | 
					    </ul>
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					    <h2>Getting Started with MC</h2>
 | 
				
			||||||
    <ol>
 | 
					    <ol>
 | 
				
			||||||
        <li>Create your Mycelium Marketplace account</li>
 | 
					        <li>Create your Mycelium Marketplace account (defaults to MC)</li>
 | 
				
			||||||
        <li>Add credits to your wallet</li>
 | 
					        <li>Add credits to your wallet (purchased in your preferred currency)</li>
 | 
				
			||||||
        <li>Browse the marketplace</li>
 | 
					        <li>Browse the marketplace (prices shown in your display currency)</li>
 | 
				
			||||||
        <li>Click "Buy Now" for instant purchases</li>
 | 
					        <li>Click "Buy Now" for instant purchases</li>
 | 
				
			||||||
 | 
					        <li>Change currency preference anytime in <a href="/dashboard/settings">Settings</a></li>
 | 
				
			||||||
    </ol>
 | 
					    </ol>
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					    <div class="alert alert-success">
 | 
				
			||||||
 | 
					        <strong>Seamless Transition:</strong> Existing USD users experience no functional changes. Your balance and purchasing power remain identical.
 | 
				
			||||||
 | 
					    </div>
 | 
				
			||||||
</div>
 | 
					</div>
 | 
				
			||||||
{% endblock %}
 | 
					{% endblock %}
 | 
				
			||||||
		Reference in New Issue
	
	Block a user