{% extends "docs/layout.html" %}

{% block title %}Mycelium Gateways - Mycelium Marketplace{% endblock %}

{% block docs_content %}
<div class="my-4">
    <h1>Mycelium Gateways</h1>
    <p class="lead">Comprehensive guide to internet connectivity services in the Mycelium ecosystem.</p>

    <div class="doc-section">
        <h2>Overview</h2>
        <p>Mycelium Gateways are distributed network access points that provide secure, peer-to-peer internet connectivity services within the Mycelium ecosystem. These gateways facilitate routing, name resolution, and secure access to resources across the network.</p>
        
        <div class="alert alert-info">
            <div class="d-flex">
                <div class="me-3">
                    <i class="bi bi-info-circle-fill fs-3"></i>
                </div>
                <div>
                    <h5 class="alert-heading">Key Concept</h5>
                    <p class="mb-0">Mycelium Gateways represent a fundamental shift from centralized internet infrastructure to a distributed, resilient network model where connectivity is provided through a mesh of interconnected nodes rather than traditional ISPs.</p>
                </div>
            </div>
        </div>
    </div>

    <div class="doc-section">
        <h2>Core Functions</h2>
        <div class="row row-cols-1 row-cols-md-2 row-cols-lg-3 g-4 mb-4">
            <div class="col">
                <div class="card h-100">
                    <div class="card-body">
                        <h5 class="card-title"><i class="bi bi-globe me-2 text-primary"></i>Internet Access</h5>
                        <p class="card-text">Provide secure connection points between the Mycelium Grid and the traditional internet.</p>
                    </div>
                </div>
            </div>
            <div class="col">
                <div class="card h-100">
                    <div class="card-body">
                        <h5 class="card-title"><i class="bi bi-signpost-split me-2 text-primary"></i>Traffic Routing</h5>
                        <p class="card-text">Intelligently route network traffic using optimized pathways for improved performance.</p>
                    </div>
                </div>
            </div>
            <div class="col">
                <div class="card h-100">
                    <div class="card-body">
                        <h5 class="card-title"><i class="bi bi-shield-lock me-2 text-primary"></i>Security</h5>
                        <p class="card-text">Implement encryption, access controls, and security protocols to protect network traffic.</p>
                    </div>
                </div>
            </div>
            <div class="col">
                <div class="card h-100">
                    <div class="card-body">
                        <h5 class="card-title"><i class="bi bi-diagram-3 me-2 text-primary"></i>Mesh Networking</h5>
                        <p class="card-text">Create resilient, self-healing network topologies that adapt to changing conditions.</p>
                    </div>
                </div>
            </div>
            <div class="col">
                <div class="card h-100">
                    <div class="card-body">
                        <h5 class="card-title"><i class="bi bi-search me-2 text-primary"></i>Name Resolution</h5>
                        <p class="card-text">Provide decentralized alternatives to DNS for locating resources on the network.</p>
                    </div>
                </div>
            </div>
            <div class="col">
                <div class="card h-100">
                    <div class="card-body">
                        <h5 class="card-title"><i class="bi bi-speedometer2 me-2 text-primary"></i>Bandwidth Management</h5>
                        <p class="card-text">Optimize bandwidth allocation and quality of service for different types of traffic.</p>
                    </div>
                </div>
            </div>
        </div>
    </div>

    <div class="doc-section">
        <h2>Gateway Types</h2>
        <p>The Mycelium Gateway ecosystem comprises several specialized gateway types, each optimized for specific connectivity needs:</p>
        
        <div class="row">
            <div class="col-md-6">
                <div class="card mb-4 h-100">
                    <div class="card-header bg-primary text-white">
                        <h5 class="mb-0">Standard Gateways</h5>
                    </div>
                    <div class="card-body">
                        <p><strong>General-purpose gateways providing basic connectivity services:</strong></p>
                        <ul>
                            <li>Internet access with moderate bandwidth</li>
                            <li>Basic security features</li>
                            <li>Standard routing capabilities</li>
                            <li>Suitable for personal and small business use</li>
                        </ul>
                    </div>
                </div>
            </div>
            <div class="col-md-6">
                <div class="card mb-4 h-100">
                    <div class="card-header bg-primary text-white">
                        <h5 class="mb-0">High-Performance Gateways</h5>
                    </div>
                    <div class="card-body">
                        <p><strong>Enhanced gateways designed for intensive bandwidth requirements:</strong></p>
                        <ul>
                            <li>High-throughput connections</li>
                            <li>Low latency optimization</li>
                            <li>Advanced traffic shaping</li>
                            <li>Ideal for streaming, gaming, and business applications</li>
                        </ul>
                    </div>
                </div>
            </div>
            <div class="col-md-6">
                <div class="card mb-4 h-100">
                    <div class="card-header bg-primary text-white">
                        <h5 class="mb-0">Secure Gateways</h5>
                    </div>
                    <div class="card-body">
                        <p><strong>Security-focused gateways with enhanced protection features:</strong></p>
                        <ul>
                            <li>End-to-end encryption</li>
                            <li>Advanced threat detection</li>
                            <li>Privacy-preserving routing</li>
                            <li>Perfect for sensitive data and communications</li>
                        </ul>
                    </div>
                </div>
            </div>
            <div class="col-md-6">
                <div class="card mb-4 h-100">
                    <div class="card-header bg-primary text-white">
                        <h5 class="mb-0">Edge Gateways</h5>
                    </div>
                    <div class="card-body">
                        <p><strong>Distributed gateways positioned at network edges for reduced latency:</strong></p>
                        <ul>
                            <li>Geographically optimized connections</li>
                            <li>Content delivery capabilities</li>
                            <li>Local processing of edge data</li>
                            <li>Suited for IoT and real-time applications</li>
                        </ul>
                    </div>
                </div>
            </div>
        </div>
    </div>

    <div class="doc-section">
        <h2>Credits Exchange Mechanism</h2>
        <p>Mycelium Gateways operate on a bandwidth consumption model within the Credits ecosystem:</p>
        
        <div class="table-responsive">
            <table class="table table-striped table-bordered">
                <thead class="table-primary">
                    <tr>
                        <th>Aspect</th>
                        <th>Details</th>
                    </tr>
                </thead>
                <tbody>
                    <tr>
                        <td><strong>Payment Model</strong></td>
                        <td>Pay-as-you-go based on actual bandwidth consumption (measured in GB)</td>
                    </tr>
                    <tr>
                        <td><strong>Pricing Factors</strong></td>
                        <td>Gateway type, bandwidth quality, geographic location, security features</td>
                    </tr>
                    <tr>
                        <td><strong>Billing Cycle</strong></td>
                        <td>Real-time metering with periodic settlement (typically monthly)</td>
                    </tr>
                    <tr>
                        <td><strong>Provider Compensation</strong></td>
                        <td>Gateway operators receive Credits proportional to the bandwidth they provide</td>
                    </tr>
                    <tr>
                        <td><strong>Resource Allocation</strong></td>
                        <td>Dynamic allocation based on network conditions and user requirements</td>
                    </tr>
                </tbody>
            </table>
        </div>

        <div class="alert alert-warning mt-4">
            <div class="d-flex">
                <div class="me-3">
                    <i class="bi bi-exclamation-triangle-fill fs-3"></i>
                </div>
                <div>
                    <h5 class="alert-heading">Bandwidth Estimation</h5>
                    <p class="mb-0">When planning your gateway usage, estimate your bandwidth requirements carefully. Unexpected high-bandwidth activities can result in higher Credits consumption. The marketplace provides tools to help monitor and control your usage.</p>
                </div>
            </div>
        </div>
    </div>

    <div class="doc-section">
        <h2>Technical Architecture</h2>
        <p>Mycelium Gateways implement a sophisticated technical architecture that enables their distributed capabilities:</p>
        
        <div class="row">
            <div class="col-md-6">
                <h5 class="mb-3"><i class="bi bi-layers me-2 text-secondary"></i>Network Stack</h5>
                <ul class="list-group mb-4">
                    <li class="list-group-item"><strong>Physical Layer:</strong> Diverse connectivity options including fiber, wireless, and satellite</li>
                    <li class="list-group-item"><strong>Data Link Layer:</strong> Enhanced Ethernet with optimized frame processing</li>
                    <li class="list-group-item"><strong>Network Layer:</strong> IPv6-first approach with IPv4 compatibility</li>
                    <li class="list-group-item"><strong>Transport Layer:</strong> Optimized TCP/UDP with custom congestion control</li>
                    <li class="list-group-item"><strong>Application Layer:</strong> Protocol-aware optimizations</li>
                </ul>
            </div>
            <div class="col-md-6">
                <h5 class="mb-3"><i class="bi bi-gear me-2 text-secondary"></i>Key Components</h5>
                <ul class="list-group mb-4">
                    <li class="list-group-item"><strong>Routing Engine:</strong> Distributed path selection algorithms</li>
                    <li class="list-group-item"><strong>Security Suite:</strong> Multi-layered protection mechanisms</li>
                    <li class="list-group-item"><strong>Bandwidth Manager:</strong> Adaptive traffic shaping</li>
                    <li class="list-group-item"><strong>Mesh Coordinator:</strong> Inter-gateway communication and topology</li>
                    <li class="list-group-item"><strong>Telemetry System:</strong> Performance monitoring and reporting</li>
                </ul>
            </div>
        </div>
    </div>

    <div class="doc-section">
        <h2>Getting Started with Mycelium Gateways</h2>
        <p>To begin using Mycelium Gateways for your connectivity needs:</p>
        
        <div class="row">
            <div class="col-lg-4">
                <div class="card mb-4">
                    <div class="card-body text-center">
                        <div class="mb-3">
                            <i class="bi bi-search fs-1 text-primary"></i>
                        </div>
                        <h5 class="card-title">1. Assess Your Needs</h5>
                        <p class="card-text">Determine your bandwidth requirements, security needs, and geographic preferences.</p>
                    </div>
                </div>
            </div>
            <div class="col-lg-4">
                <div class="card mb-4">
                    <div class="card-body text-center">
                        <div class="mb-3">
                            <i class="bi bi-cart fs-1 text-primary"></i>
                        </div>
                        <h5 class="card-title">2. Select a Gateway</h5>
                        <p class="card-text">Browse available gateways in the marketplace and choose one that meets your criteria.</p>
                    </div>
                </div>
            </div>
            <div class="col-lg-4">
                <div class="card mb-4">
                    <div class="card-body text-center">
                        <div class="mb-3">
                            <i class="bi bi-pc-display fs-1 text-primary"></i>
                        </div>
                        <h5 class="card-title">3. Configure Access</h5>
                        <p class="card-text">Set up your devices to connect through the gateway using provided configuration details.</p>
                    </div>
                </div>
            </div>
        </div>
    </div>

    <div class="card bg-light mt-5">
        <div class="card-body">
            <h2><i class="bi bi-globe2 me-2"></i>Ready to Enhance Your Connectivity?</h2>
            <p class="lead">Explore available Mycelium Gateways to find the perfect connectivity solution for your needs.</p>
            <div class="mt-3">
                <a href="/marketplace/gateways" class="btn btn-primary me-2">Browse Gateways</a>
                <a href="/docs" class="btn btn-outline-secondary">Back to Documentation</a>
            </div>
        </div>
    </div>
</div>
{% endblock %}