@extends('layouts.app')
@section('title','API · Configuración · Taks')
@section('body-class','board-page api-settings-page')
@section('content')
@php($project = null)
@php($viewMode = 'board')
@php($month = now()->startOfMonth())
<main class="workspace-main settings-workspace">
@include('partials.workspace-header', ['settingsPage'=>true])
<div class="board-toolbar"><h1>Configuración</h1><span class="settings-current">API</span></div>
<div class="api-content-scroll"><div class="api-settings"><h2>Conecta tu agente</h2><p>Permite que tu agente lea el trabajo pendiente y, si lo eliges, reciba reportes, publique resultados y envíe tarjetas a Revisión.</p>
@if(session('new_api_token'))<section class="api-secret"><h3>Tu nuevo token</h3><p>Cópialo ahora. No volverá a mostrarse.</p><code>{{ session('new_api_token') }}</code><button type="button" data-copy-token class="btn btn-outline-secondary">Copiar token</button></section>@endif
@if($errors->any())<p role="alert">{{ $errors->first() }}</p>@endif
<section class="api-panel"><h3>Crear token</h3><form method="post" action="{{ url('/settings/api/tokens') }}">@csrf<div class="api-form-grid"><label>Nombre<input class="form-control" name="name" required maxlength="100" placeholder="Agente de mi proyecto"></label><label>Tablero<select class="form-select" name="project_id"><option value="">Todos los tableros</option>@foreach($projects as $project)<option value="{{ $project->id }}">{{ $project->name }} (#{{ $project->id }})</option>@endforeach</select></label><label>Permisos<select class="form-select" name="access"><option value="write">Leer, recibir reportes, comentar y revisar</option><option value="read">Solo lectura</option></select></label><label>Caduca en<input class="form-control" type="number" name="days" min="1" max="365" value="90" required> días</label></div><button class="btn btn-primary">Crear token</button></form></section>
<section class="api-panel"><h3>Mis tokens</h3>@forelse($tokens as $token)<div class="api-token"><div><strong>{{ $token->name }}</strong><p>{{ $token->can_write ? 'Lectura, reportes, comentarios y revisión' : 'Solo lectura' }} · {{ $token->project_id ? 'Tablero #'.$token->project_id : 'Todos los tableros' }}</p><small>{{ \Illuminate\Support\Carbon::parse($token->expires_at)->isPast() ? 'Caducado' : 'Caduca' }}: {{ $token->expires_at }} · Último uso: {{ $token->last_used_at ?? 'Sin usar' }}</small></div><form method="post" action="{{ url('/settings/api/tokens/'.$token->id) }}">@csrf @method('DELETE')<button class="btn btn-outline-secondary">Revocar</button></form></div>@empty<p>Aún no tienes tokens.</p>@endforelse</section>
<section class="api-panel"><h3>Cómo conectarlo</h3><p>Configura estas variables en el entorno del agente, fuera del repositorio:</p><pre>TAKS_API_URL={{ url('/api/v1') }}
TAKS_API_TOKEN=tu_token</pre><p>Autenticación: <code>Authorization: Bearer TOKEN</code>. No compartas el token en comentarios ni commits.</p><h3>Instrucción para tu agente</h3><blockquote>Lee todas las páginas del tablero de este proyecto en Taks. Revisa descripción, comentarios, etiquetas, checklist y descarga las imágenes para inspeccionarlas. Trabaja sobre el repositorio abierto y verifica las correcciones. Al finalizar, publica el resumen de cambios, pruebas y pasos para revisar mediante la ruta de revisión. Déjame la tarjeta en Revisión; yo la completaré.</blockquote><h3>Rutas disponibles</h3><ul><li>GET /boards — buscar tableros.</li><li>GET /boards/{id}/tasks?completed=0&amp;archived=0 — tarjetas completas, 20 por página.</li><li>GET /tasks/{id} — detalle completo.</li><li>GET /files/{id} — descargar imágenes y archivos con el token.</li><li>POST /boards/{id}/reports — recibir un reporte pendiente con captura opcional.</li><li>POST /tasks/{id}/comments — publicar un comentario.</li><li>POST /tasks/{id}/review — publicar informe y mover a Revisión.</li></ul><p>Sigue <code>next_page_url</code> en tableros y <code>tasks.next_page_url</code> en tarjetas. Para las imágenes del contenido utiliza las URLs de <code>files.url</code>, con el mismo token y solo en este servidor.</p><p>Comentarios y revisión reciben JSON. Usa un UUID distinto por operación y repítelo solo al reintentarla:</p><pre>{"request_id": "UUID", "body": "Cambios, pruebas y pasos para revisar"}</pre><p>Reportes: <code>request_id</code> UUID, <code>title</code>, <code>message</code>, <code>type</code> (bug, improvement, idea), contexto JSON opcional y captura PNG/JPEG opcional de hasta 5 MB y 4096 × 4096. Usa multipart si adjuntas captura. Requiere escritura y tablero activo; queda en Reportes de clientes (crea esa lista si falta), sin ejecutar agentes automáticamente.</p><p>401: token inválido o caducado · 403: sin escritura · 404: recurso fuera del alcance · 409: conflicto · 429: límite de peticiones.</p></section></div></div>
@include('partials.mobile-dock', ['catalogDock'=>true])
</main>
@endsection