{% extends 'base.html' %}

{% block title %}Admin API Documentation{% endblock %}

{% block head %}
<style>
.container { max-width: 1200px; margin: 2rem auto; padding: 0 2rem; }
.api-header {
    background: linear-gradient(135deg, #dc2626 0%, #b91c1c 100%);
    color: white;
    padding: 2rem;
    border-radius: 12px;
    margin-bottom: 2rem;
    box-shadow: 0 4px 6px rgba(0, 0, 0, 0.07);
}

.api-header h1 {
    font-size: 3rem;
    font-weight: 700;
    margin-bottom: 1rem;
}

.api-header .lead {
    font-size: 1.25rem;
    opacity: 0.9;
}

.endpoint-card {
    background: white;
    border-radius: 12px;
    box-shadow: 0 4px 6px rgba(0, 0, 0, 0.07);
    border: 1px solid #e5e7eb;
    margin-bottom: 2rem;
    overflow: hidden;
    transition: transform 0.2s ease, box-shadow 0.2s ease;
}

.endpoint-card:hover {
    transform: translateY(-2px);
    box-shadow: 0 8px 25px rgba(0, 0, 0, 0.15);
}

.endpoint-header {
    background: linear-gradient(135deg, #f59e0b 0%, #d97706 100%);
    color: white;
    padding: 1.5rem;
    border-bottom: 1px solid #e5e7eb;
}

.endpoint-header h3 {
    margin: 0;
    font-size: 1.5rem;
    font-weight: 600;
}

.endpoint-header .method {
    display: inline-block;
    background: rgba(255, 255, 255, 0.2);
    padding: 0.25rem 0.75rem;
    border-radius: 20px;
    font-size: 0.875rem;
    font-weight: 500;
    margin-right: 1rem;
}

.endpoint-content {
    padding: 1.5rem;
}

.endpoint-description {
    color: #6b7280;
    margin-bottom: 1.5rem;
    font-size: 1.1rem;
    line-height: 1.6;
}

.params-section h4,
.curl-section h4,
.response-section h4 {
    color: #374151;
    font-weight: 600;
    margin-bottom: 0.75rem;
    font-size: 1.1rem;
}

.params-list {
    background: #f8fafc;
    border-radius: 8px;
    padding: 1rem;
    margin-bottom: 1.5rem;
}

.param-item {
    margin-bottom: 0.75rem;
    padding-bottom: 0.75rem;
    border-bottom: 1px solid #e5e7eb;
}

.param-item:last-child {
    border-bottom: none;
    margin-bottom: 0;
    padding-bottom: 0;
}

.param-name {
    font-weight: 600;
    color: #dc2626;
    font-family: 'Monaco', 'Menlo', 'Ubuntu Mono', monospace;
}

.param-type {
    color: #059669;
    font-size: 0.875rem;
    margin-left: 0.5rem;
}

.param-desc {
    color: #6b7280;
    margin-top: 0.25rem;
}

.code-block {
    background: #1f2937;
    color: #f9fafb;
    border-radius: 8px;
    padding: 1rem;
    font-family: 'Monaco', 'Menlo', 'Ubuntu Mono', monospace;
    font-size: 0.875rem;
    line-height: 1.5;
    overflow-x: auto;
    margin-bottom: 1.5rem;
}

.code-block .token {
    color: #60a5fa;
}

.auth-notice {
    background: linear-gradient(135deg, #fee2e2 0%, #fecaca 100%);
    border: 1px solid #ef4444;
    border-radius: 8px;
    padding: 1.5rem;
    margin-bottom: 2rem;
}

.auth-notice .alert-icon {
    color: #dc2626;
    font-size: 1.5rem;
    margin-right: 0.75rem;
}

.auth-notice strong {
    color: #991b1b;
}

.auth-notice p {
    color: #7f1d1d;
    margin: 0;
}

@media (max-width: 768px) {
    .api-header h1 {
        font-size: 2rem;
    }

    .endpoint-card {
        margin-bottom: 1.5rem;
    }

    .endpoint-header {
        padding: 1rem;
    }

    .endpoint-content {
        padding: 1rem;
    }
}
</style>
{% endblock %}

{% block content %}
<div class="container">
    <div class="api-header">
        <h1><i class="fas fa-crown"></i> Admin API Documentation</h1>
        <p class="lead">Administrative API endpoints for system management</p>
    </div>
    <div class="auth-notice">
        <div class="d-flex align-items-start">
            <i class="fas fa-exclamation-triangle alert-icon"></i>
            <div>
                <strong>Admin Authentication Required</strong>
                <p>All endpoints require admin authentication via login session or admin API token (Bearer token in Authorization header).</p>
            </div>
        </div>
    </div>

    <div class="row">
        <div class="col-12">
            <div class="endpoint-card" id="browse">
                <div class="endpoint-header">
                    <span class="method">GET</span>
                    <h3>/admin/api/browse</h3>
                </div>
                <div class="endpoint-content">
                    <p class="endpoint-description">
                        <i class="fas fa-folder-open text-info"></i>
                        Browse files and directories in the configured server directory for administrative purposes.
                    </p>

                    <div class="params-section">
                        <h4><i class="fas fa-cogs"></i> Parameters</h4>
                        <div class="params-list">
                            <div class="param-item">
                                <span class="param-name">path</span>
                                <span class="param-type">string (optional)</span>
                                <div class="param-desc">Directory path to browse (default: root directory)</div>
                            </div>
                        </div>
                    </div>

                    <div class="curl-section">
                        <h4><i class="fas fa-terminal"></i> Curl Example</h4>
                        <div class="code-block">curl -H "Authorization: Bearer YOUR_ADMIN_API_TOKEN" \
  "{{ request.host_url }}admin/api/browse?path=/some/path"</div>
                    </div>

                    <div class="response-section">
                        <h4><i class="fas fa-reply"></i> Response</h4>
                        <div class="code-block">{
  "current_path": "/some/path",
  "items": [
    {
      "name": "file.txt",
      "path": "/some/path/file.txt",
      "is_dir": false,
      "size": 1024
    }
  ]
}</div>
                    </div>
                </div>
            </div>

            <div class="endpoint-card" id="train">
                <div class="endpoint-header">
                    <span class="method">POST</span>
                    <h3>/admin/api/train</h3>
                </div>
                <div class="endpoint-content">
                    <p class="endpoint-description">
                        <i class="fas fa-graduation-cap text-success"></i>
                        Start AI model training process. Costs 100 tokens (free for admins).
                    </p>

                    <div class="params-section">
                        <h4><i class="fas fa-cogs"></i> Parameters</h4>
                        <div class="params-list">
                            <div class="param-item">
                                <span class="param-name">output_model</span>
                                <span class="param-type">string (optional)</span>
                                <div class="param-desc">Name for the trained model (default: "MyCustomModel")</div>
                            </div>
                            <div class="param-item">
                                <span class="param-name">description</span>
                                <span class="param-type">string (optional)</span>
                                <div class="param-desc">Description of the model</div>
                            </div>
                            <div class="param-item">
                                <span class="param-name">train_path</span>
                                <span class="param-type">string (required)</span>
                                <div class="param-desc">Path to the training data directory</div>
                            </div>
                        </div>
                    </div>

                    <div class="curl-section">
                        <h4><i class="fas fa-terminal"></i> Curl Example</h4>
                        <div class="code-block">curl -X POST -H "Authorization: Bearer YOUR_ADMIN_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "output_model": "MyModel",
    "description": "Custom trained model",
    "train_path": "/path/to/training/data"
  }' {{ request.host_url }}admin/api/train</div>
                    </div>

                    <div class="response-section">
                        <h4><i class="fas fa-reply"></i> Response</h4>
                        <div class="code-block">{
  "message": "Training completed",
  "tokens_used": 100,
  "remaining_tokens": 900
}</div>
                    </div>
                </div>
            </div>

            <div class="endpoint-card" id="users">
                <div class="endpoint-header">
                    <span class="method">GET</span>
                    <h3>/admin/api/users</h3>
                </div>
                <div class="endpoint-content">
                    <p class="endpoint-description">
                        <i class="fas fa-users text-primary"></i>
                        Retrieve a complete list of all users in the system for administrative management.
                    </p>

                    <div class="curl-section">
                        <h4><i class="fas fa-terminal"></i> Curl Example</h4>
                        <div class="code-block">curl -H "Authorization: Bearer YOUR_ADMIN_API_TOKEN" \
  {{ request.host_url }}admin/api/users</div>
                    </div>

                    <div class="response-section">
                        <h4><i class="fas fa-reply"></i> Response</h4>
                        <div class="code-block">{
  "users": [
    {
      "id": 1,
      "username": "user1",
      "email": "user1@example.com",
      "role": "user",
      "tokens": 100,
      "active": true,
      "created_at": "2024-01-01T00:00:00Z"
    }
  ]
}</div>
                    </div>
                </div>
            </div>

            <div class="endpoint-card" id="cluster_tokens">
                <div class="endpoint-header">
                    <span class="method">GET</span>
                    <h3>/admin/api/cluster_tokens</h3>
                </div>
                <div class="endpoint-content">
                    <p class="endpoint-description">
                        <i class="fas fa-network-wired text-warning"></i>
                        List all cluster tokens for distributed processing management.
                    </p>

                    <div class="curl-section">
                        <h4><i class="fas fa-terminal"></i> Curl Example</h4>
                        <div class="code-block">curl -H "Authorization: Bearer YOUR_ADMIN_API_TOKEN" \
  {{ request.host_url }}admin/api/cluster_tokens</div>
                    </div>

                    <div class="response-section">
                        <h4><i class="fas fa-reply"></i> Response</h4>
                        <div class="code-block">{
  "tokens": [
    {
      "id": 1,
      "name": "Worker Token",
      "token": "abc123...",
      "active": true,
      "created_at": "2024-01-01T00:00:00Z"
    }
  ]
}</div>
                    </div>
                </div>
            </div>

            <div class="endpoint-card" id="cluster_clients">
                <div class="endpoint-header">
                    <span class="method">GET</span>
                    <h3>/admin/api/cluster_clients</h3>
                </div>
                <div class="endpoint-content">
                    <p class="endpoint-description">
                        <i class="fas fa-server text-info"></i>
                        List all connected cluster clients with their GPU capabilities and status.
                    </p>

                    <div class="curl-section">
                        <h4><i class="fas fa-terminal"></i> Curl Example</h4>
                        <div class="code-block">curl -H "Authorization: Bearer YOUR_ADMIN_API_TOKEN" \
  {{ request.host_url }}admin/api/cluster_clients</div>
                    </div>

                    <div class="response-section">
                        <h4><i class="fas fa-reply"></i> Response</h4>
                        <div class="code-block">{
  "clients": [
    {
      "client_id": "abc123...",
      "connected_at": 1640995200.0,
      "last_seen": 1640995300.0,
      "gpu_info": {
        "cuda_available": true,
        "rocm_available": false,
        "cuda_devices": 1,
        "rocm_devices": 0,
        "available_backends": ["cuda"]
      },
      "processes": [
        {
          "name": "analysis_cuda",
          "status": "active",
          "weight": 10,
          "model": "Qwen/Qwen2.5-VL-7B-Instruct"
        }
      ]
    }
  ]
}</div>
                    </div>
                </div>
            </div>

            <div class="endpoint-card" id="cluster_nodes">
                <div class="endpoint-header">
                    <span class="method">GET</span>
                    <h3>/api/admin/cluster_nodes</h3>
                </div>
                <div class="endpoint-content">
                    <p class="endpoint-description">
                        <i class="fas fa-network-wired text-success"></i>
                        Get detailed information about all cluster nodes, including connected and recently disconnected nodes.
                    </p>

                    <div class="curl-section">
                        <h4><i class="fas fa-terminal"></i> Curl Example</h4>
                        <div class="code-block">curl -H "Authorization: Bearer YOUR_ADMIN_API_TOKEN" \
  {{ request.host_url }}api/admin/cluster_nodes</div>
                    </div>

                    <div class="response-section">
                        <h4><i class="fas fa-reply"></i> Response</h4>
                        <div class="code-block">{
  "master_stats": {
    "total_nodes": 3,
    "connected_nodes": 2,
    "total_workers": 6,
    "total_active_jobs": 1,
    "total_completed_jobs": 15,
    "uptime_seconds": 3600.5
  },
  "nodes": [
    {
      "token": "abc123...",
      "token_name": "Worker Node 1",
      "hostname": "worker1.example.com",
      "weight": 100,
      "gpus": 1,
      "gpu_memory": ["CUDA Device 0: 8GB VRAM"],
      "total_memory": 8,
      "workers_available": 2,
      "workers_summary": "Analysis (CUDA), Training (ROCm)",
      "ip_address": "192.168.1.100",
      "connected": true,
      "last_seen": 1640995300.0,
      "uptime_seconds": 1800.5,
      "active_jobs": 1,
      "completed_jobs": 5,
      "is_local": false
    },
    {
      "token": "local",
      "token_name": "Local Analysis Worker (CUDA)",
      "hostname": "localhost",
      "weight": 0,
      "gpus": 1,
      "gpu_memory": ["CUDA Device 0: 8GB VRAM"],
      "total_memory": 8,
      "workers_available": 1,
      "ip_address": "127.0.0.1",
      "connected": true,
      "last_seen": 1640995300.0,
      "uptime_seconds": 3600.0,
      "active_jobs": 0,
      "completed_jobs": 0,
      "is_local": true,
      "backend": "cuda"
    }
  ]
}</div>
                    </div>
                </div>
            </div>

            <div class="endpoint-card" id="set_driver">
                <div class="endpoint-header">
                    <span class="method">POST</span>
                    <h3>/api/admin/cluster_nodes/set_driver</h3>
                </div>
                <div class="endpoint-content">
                    <p class="endpoint-description">
                        <i class="fas fa-cogs text-warning"></i>
                        Set the preferred GPU driver (CUDA or ROCm) for a specific cluster node. This preference is saved and reused for future connections from the same hostname + token combination.
                    </p>

                    <div class="params-section">
                        <h4><i class="fas fa-cogs"></i> Parameters</h4>
                        <div class="params-list">
                            <div class="param-item">
                                <span class="param-name">hostname</span>
                                <span class="param-type">string (required)</span>
                                <div class="param-desc">Hostname of the cluster node</div>
                            </div>
                            <div class="param-item">
                                <span class="param-name">token</span>
                                <span class="param-type">string (required)</span>
                                <div class="param-desc">Authentication token for the node</div>
                            </div>
                            <div class="param-item">
                                <span class="param-name">driver</span>
                                <span class="param-type">string (required)</span>
                                <div class="param-desc">Preferred driver: "cuda" or "rocm"</div>
                            </div>
                        </div>
                    </div>

                    <div class="curl-section">
                        <h4><i class="fas fa-terminal"></i> Curl Example</h4>
                        <div class="code-block">curl -X POST -H "Authorization: Bearer YOUR_ADMIN_API_TOKEN" \
  -F "hostname=worker1.example.com" \
  -F "token=abc123..." \
  -F "driver=cuda" \
  {{ request.host_url }}api/admin/cluster_nodes/set_driver</div>
                    </div>

                    <div class="response-section">
                        <h4><i class="fas fa-reply"></i> Response</h4>
                        <div class="code-block">{
  "success": true
}</div>
                    </div>
                </div>
            </div>
        </div>
    </div>
</div>
{% endblock %}