web-next: herramientas de PD (transferir, comercio, códigos de promoción)

- /transfer-d-points: transferir PD a la cuenta dueña de un personaje
  (requiere token de seguridad; movimiento atómico con FOR UPDATE).
- /trade-points: comercio PD<->oro mediante códigos de 1 solo uso
  (contraseña + token + Turnstile; oro al creador por SOAP; expira 1h;
  lock de 5s tras canjear; rollback total si falla la entrega).
- /promo-code: canje de códigos por PD/PV (sensibles a mayúsculas/minúsculas,
  usos limitados, 1 canje por cuenta).
- /admin/promo: panel para crear / editar / activar / desactivar / borrar
  códigos de promoción.
- Tablas nuevas (sql/): home_tradecode, home_promocode, home_promoredemption.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

web-next/components/PromoCodeForm.tsx

@@ -0,0 +1,85 @@
+'use client'
+
+import { useState } from 'react'
+import { useRouter } from '@/i18n/navigation'
+
+function promoError(error?: string): string {
+  switch (error) {
+    case 'missingCode':
+      return 'Escribe un código de promoción.'
+    case 'notFound':
+      return 'El código no existe o ya no está disponible.'
+    case 'expired':
+      return 'Este código ha caducado.'
+    case 'exhausted':
+      return 'Este código ya ha alcanzado su límite de usos.'
+    case 'alreadyUsed':
+      return 'Ya has canjeado este código.'
+    case 'notAuthenticated':
+      return 'Tu sesión ha expirado. Inicia sesión de nuevo.'
+    default:
+      return 'No se pudo canjear el código. Inténtalo de nuevo.'
+  }
+}
+
+export function PromoCodeForm() {
+  const router = useRouter()
+  const [code, setCode] = useState('')
+  const [busy, setBusy] = useState(false)
+  const [message, setMessage] = useState<{ ok: boolean; text: string } | null>(null)
+
+  async function handleSubmit(e: React.FormEvent<HTMLFormElement>) {
+    e.preventDefault()
+    if (busy || !code.trim()) return
+    setBusy(true)
+    setMessage(null)
+    try {
+      const res = await fetch('/api/promo/redeem', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        credentials: 'same-origin',
+        body: JSON.stringify({ code: code.trim() }),
+      })
+      const data: { success?: boolean; error?: string; pd?: number; pv?: number } = await res.json()
+      if (data.success) {
+        const parts: string[] = []
+        if (data.pd) parts.push(`${data.pd} PD`)
+        if (data.pv) parts.push(`${data.pv} PV`)
+        const reward = parts.length ? parts.join(' y ') : 'la recompensa'
+        setMessage({ ok: true, text: `¡Código canjeado! Has recibido ${reward}.` })
+        setCode('')
+        router.refresh()
+      } else {
+        setMessage({ ok: false, text: promoError(data.error) })
+      }
+    } catch {
+      setMessage({ ok: false, text: promoError() })
+    } finally {
+      setBusy(false)
+    }
+  }
+
+  return (
+    <div className="centered">
+      <br />
+      <form onSubmit={handleSubmit} acceptCharset="utf-8">
+        <input
+          type="text"
+          maxLength={64}
+          placeholder="Escribe tu código de promoción"
+          value={code}
+          onChange={(e) => setCode(e.target.value)}
+          required
+        />
+        <br />
+        <button type="submit" className="dnt-button" disabled={busy || !code.trim()}>
+          {busy ? 'Canjeando…' : 'CANJEAR CÓDIGO'}
+        </button>
+      </form>
+      <hr />
+      <div className="alert-message" style={{ display: message ? 'block' : 'none' }}>
+        {message && <span className={message.ok ? 'ok-form-response' : 'red-form-response'}>{message.text}</span>}
+      </div>
+    </div>
+  )
+}