import { NextRequest, NextResponse } from 'next/server'

// 神射手开放API文档 - OpenAPI 3.0 格式
const OPENAPI_SPEC = {
  openapi: '3.0.3',
  info: {
    title: '神射手数据中台 API',
    description: `
神射手是一个用户资产数字化平台，提供用户画像、AI标签、RFM评分等数据服务。

## 认证方式
所有API请求需要在Header中携带API密钥：
- **Authorization**: Bearer YOUR_API_KEY（必需）
- **X-API-Secret**: YOUR_API_SECRET（可选，增强安全性）

## 基础信息
- 基础URL: https://your-domain.com/api/shensheshou
- 请求格式: JSON
- 响应格式: JSON
- 字符编码: UTF-8

## 计费说明
- 每次API调用消耗积分（credits）
- 不同接口消耗积分不同
- 批量接口享受折扣

## 字段权限
返回字段根据API密钥配置的字段权限决定，可在开放API管理中配置。
    `.trim(),
    version: '1.0.0',
    contact: {
      name: '神射手技术支持',
      email: 'support@shensheshou.com',
    },
  },
  servers: [
    {
      url: '{protocol}://{host}/api/shensheshou',
      description: '神射手API服务器',
      variables: {
        protocol: { default: 'https', enum: ['https', 'http'] },
        host: { default: 'your-domain.com' },
      },
    },
  ],
  tags: [
    { name: 'user', description: '用户查询服务 - 查询用户画像和基本信息' },
    { name: 'tag', description: '标签服务 - 获取、应用和管理用户标签' },
    { name: 'ai', description: 'AI服务 - AI对话、智能分析和自动打标' },
    { name: 'data', description: '数据服务 - 数据流入和同步' },
    { name: 'package', description: '流量包 - 创建和导出用户流量包' },
  ],
  paths: {
    '/': {
      get: {
        tags: ['user'],
        operationId: 'queryUser',
        summary: '用户画像查询',
        description: '根据手机号或QQ查询完整用户画像。返回字段根据API密钥权限决定。',
        parameters: [
          { name: 'endpoint', in: 'query', required: true, schema: { type: 'string', enum: ['user'] }, description: '固定值: user' },
          { name: 'phone', in: 'query', required: false, schema: { type: 'string', pattern: '^1[3-9]\\d{9}$' }, description: '11位手机号' },
          { name: 'qq', in: 'query', required: false, schema: { type: 'string', pattern: '^[1-9]\\d{4,10}$' }, description: 'QQ号码（5-11位）' },
          { name: 'fields', in: 'query', required: false, schema: { type: 'string' }, description: '指定返回字段（逗号分隔）: phone,qq,rfm_score,user_level,tags,behavior,location' },
        ],
        responses: {
          '200': {
            description: '查询成功',
            content: {
              'application/json': {
                schema: { $ref: '#/components/schemas/UserResponse' },
                example: {
                  success: true,
                  data: {
                    phone: '138****8000',
                    rfm_score: 85,
                    user_level: 'A',
                    tags: ['高价值', '活跃用户', '电商偏好'],
                    last_active: '2026-01-30',
                  },
                  credits_used: 5,
                  credits_remaining: 995,
                },
              },
            },
          },
          '401': { $ref: '#/components/responses/Unauthorized' },
          '404': { $ref: '#/components/responses/NotFound' },
        },
        security: [{ bearerAuth: [] }],
      },
      post: {
        tags: ['user', 'data', 'ai'],
        operationId: 'postEndpoint',
        summary: '通用POST端点',
        description: '根据endpoint参数调用不同服务：users/batch（批量查询）、ingest（数据流入）、ai/chat（AI对话）、ai/tag（AI打标）等',
        requestBody: {
          required: true,
          content: {
            'application/json': {
              schema: { $ref: '#/components/schemas/PostRequest' },
              examples: {
                batch_query: {
                  summary: '批量用户查询',
                  value: {
                    endpoint: 'users/batch',
                    phones: ['13800138001', '13800138002'],
                    fields: ['rfm_score', 'tags', 'user_level'],
                  },
                },
                data_ingest: {
                  summary: '数据流入',
                  value: {
                    endpoint: 'ingest',
                    source: 'cunkebao',
                    users: [
                      { phone: '13800138001', name: '张三', tags: ['高意向'] },
                      { phone: '13800138002', name: '李四' },
                    ],
                  },
                },
                ai_chat: {
                  summary: 'AI对话',
                  value: {
                    endpoint: 'ai/chat',
                    message: '帮我查询13800138000的用户画像',
                  },
                },
                ai_tag: {
                  summary: 'AI智能打标',
                  value: {
                    endpoint: 'ai/tag',
                    phones: ['13800138001', '13800138002'],
                    strategy: 'rfm',
                  },
                },
              },
            },
          },
        },
        responses: {
          '200': {
            description: '请求成功',
            content: {
              'application/json': {
                schema: { $ref: '#/components/schemas/GenericResponse' },
              },
            },
          },
          '401': { $ref: '#/components/responses/Unauthorized' },
          '400': { $ref: '#/components/responses/BadRequest' },
        },
        security: [{ bearerAuth: [] }],
      },
    },
    '/tags': {
      get: {
        tags: ['tag'],
        operationId: 'listTags',
        summary: '获取标签列表',
        description: '获取系统中所有可用标签及其统计信息',
        parameters: [
          { name: 'category', in: 'query', required: false, schema: { type: 'string', enum: ['value', 'behavior', 'preference', 'custom'] }, description: '标签分类' },
        ],
        responses: {
          '200': {
            description: '成功',
            content: {
              'application/json': {
                example: {
                  success: true,
                  data: {
                    tags: [
                      { id: 'tag_001', name: '高价值用户', category: 'value', count: 125000 },
                      { id: 'tag_002', name: '活跃用户', category: 'behavior', count: 450000 },
                    ],
                    total: 45,
                  },
                },
              },
            },
          },
        },
        security: [{ bearerAuth: [] }],
      },
    },
    '/packages': {
      get: {
        tags: ['package'],
        operationId: 'listPackages',
        summary: '获取流量包列表',
        description: '获取已创建的流量包列表',
        responses: {
          '200': {
            description: '成功',
            content: {
              'application/json': {
                example: {
                  success: true,
                  data: {
                    packages: [
                      { id: 'pkg_001', name: '高价值用户包', count: 5000, created_at: '2026-01-30' },
                    ],
                    total: 10,
                  },
                },
              },
            },
          },
        },
        security: [{ bearerAuth: [] }],
      },
      post: {
        tags: ['package'],
        operationId: 'createPackage',
        summary: '创建流量包',
        description: '根据筛选条件创建用户流量包',
        requestBody: {
          required: true,
          content: {
            'application/json': {
              example: {
                endpoint: 'packages/create',
                name: '高价值用户包',
                filters: {
                  user_level: ['S', 'A'],
                  tags: ['高价值'],
                },
              },
            },
          },
        },
        responses: {
          '200': {
            description: '创建成功',
            content: {
              'application/json': {
                example: {
                  success: true,
                  data: {
                    package_id: 'pkg_002',
                    name: '高价值用户包',
                    count: 3500,
                  },
                },
              },
            },
          },
        },
        security: [{ bearerAuth: [] }],
      },
    },
  },
  components: {
    securitySchemes: {
      bearerAuth: {
        type: 'http',
        scheme: 'bearer',
        description: 'API密钥，格式: sk-xxx',
      },
      apiSecret: {
        type: 'apiKey',
        in: 'header',
        name: 'X-API-Secret',
        description: 'API密钥Secret（可选，增强安全性）',
      },
    },
    schemas: {
      UserResponse: {
        type: 'object',
        properties: {
          success: { type: 'boolean' },
          data: {
            type: 'object',
            properties: {
              phone: { type: 'string', description: '脱敏手机号' },
              qq: { type: 'string', description: 'QQ号' },
              rfm_score: { type: 'integer', minimum: 0, maximum: 100, description: 'RFM综合评分' },
              user_level: { type: 'string', enum: ['S', 'A', 'B', 'C', 'D'], description: '用户等级' },
              tags: { type: 'array', items: { type: 'string' }, description: '用户标签列表' },
              behavior: { type: 'object', description: '行为数据' },
              location: { type: 'object', description: '位置信息' },
              last_active: { type: 'string', format: 'date', description: '最后活跃时间' },
            },
          },
          credits_used: { type: 'integer', description: '本次消耗积分' },
          credits_remaining: { type: 'integer', description: '剩余积分' },
        },
      },
      PostRequest: {
        type: 'object',
        required: ['endpoint'],
        properties: {
          endpoint: { type: 'string', description: '端点名称' },
        },
        additionalProperties: true,
      },
      GenericResponse: {
        type: 'object',
        properties: {
          success: { type: 'boolean' },
          data: { type: 'object' },
          message: { type: 'string' },
          credits_used: { type: 'integer' },
          credits_remaining: { type: 'integer' },
        },
      },
      Error: {
        type: 'object',
        properties: {
          success: { type: 'boolean', example: false },
          error: { type: 'string' },
          code: { type: 'string' },
        },
      },
    },
    responses: {
      Unauthorized: {
        description: '认证失败',
        content: {
          'application/json': {
            schema: { $ref: '#/components/schemas/Error' },
            example: { success: false, error: '无效的API密钥', code: 'INVALID_API_KEY' },
          },
        },
      },
      NotFound: {
        description: '资源不存在',
        content: {
          'application/json': {
            schema: { $ref: '#/components/schemas/Error' },
            example: { success: false, error: '用户不存在', code: 'USER_NOT_FOUND' },
          },
        },
      },
      BadRequest: {
        description: '请求参数错误',
        content: {
          'application/json': {
            schema: { $ref: '#/components/schemas/Error' },
            example: { success: false, error: '缺少必要参数', code: 'MISSING_PARAMS' },
          },
        },
      },
    },
  },
}

// Markdown格式的API文档
const MARKDOWN_DOC = `# 神射手数据中台 API 文档

> 版本: 1.0.0 | 更新时间: 2026-01-31

## 概述

神射手是一个**用户资产数字化平台**，提供用户画像、AI标签、RFM评分等数据服务。通过本API，第三方应用可以：

- 查询用户画像和标签
- 批量导入用户数据并自动完善标签
- 使用AI进行智能对话和分析
- 创建和导出用户流量包

---

## 认证方式

所有API请求需要在Header中携带API密钥：

\`\`\`
Authorization: Bearer YOUR_API_KEY
X-API-Secret: YOUR_API_SECRET  # 可选，增强安全性
Content-Type: application/json
\`\`\`

### 获取API密钥

1. 登录神射手管理后台
2. 进入「数据市场 → 开放接口」
3. 添加接入方并获取API Key和Secret

---

## 基础URL

\`\`\`
https://your-domain.com/api/shensheshou
\`\`\`

---

## 接口列表

### 1. 用户画像查询

查询单个用户的完整画像信息。

**请求**

\`\`\`http
GET /api/shensheshou?endpoint=user&phone=13800138000
\`\`\`

**参数**

| 参数 | 类型 | 必需 | 说明 |
|------|------|:----:|------|
| endpoint | string | 是 | 固定值: user |
| phone | string | 否 | 11位手机号（与qq二选一） |
| qq | string | 否 | QQ号码（与phone二选一） |
| fields | string | 否 | 指定返回字段，逗号分隔 |

**可用字段**: phone, qq, wechat, rfm_score, user_level, tags, behavior, location

**响应示例**

\`\`\`json
{
  "success": true,
  "data": {
    "phone": "138****8000",
    "rfm_score": 85,
    "user_level": "A",
    "tags": ["高价值", "活跃用户", "电商偏好"],
    "last_active": "2026-01-30"
  },
  "credits_used": 5,
  "credits_remaining": 995
}
\`\`\`

---

### 2. 批量用户查询

批量查询多个用户画像，最多100个/次。

**请求**

\`\`\`http
POST /api/shensheshou
Content-Type: application/json

{
  "endpoint": "users/batch",
  "phones": ["13800138001", "13800138002"],
  "fields": ["rfm_score", "tags", "user_level"]
}
\`\`\`

**响应示例**

\`\`\`json
{
  "success": true,
  "data": {
    "users": [
      {"phone": "138****8001", "rfm_score": 78, "tags": ["活跃"], "user_level": "B"},
      {"phone": "138****8002", "rfm_score": 92, "tags": ["高价值"], "user_level": "A"}
    ],
    "found": 2,
    "not_found": []
  },
  "credits_used": 8
}
\`\`\`

---

### 3. 数据流入

将外部系统用户数据导入神射手，自动完善标签。

**请求**

\`\`\`http
POST /api/shensheshou
Content-Type: application/json

{
  "endpoint": "ingest",
  "source": "cunkebao",
  "users": [
    {"phone": "13800138001", "name": "张三", "tags": ["高意向"]},
    {"phone": "13800138002", "name": "李四"}
  ]
}
\`\`\`

**响应示例**

\`\`\`json
{
  "success": true,
  "data": {
    "total": 2,
    "processed": 2,
    "enriched": 2,
    "new_tags_added": 8
  }
}
\`\`\`

---

### 4. AI对话

与神射手AI进行自然语言对话，支持用户查询、数据分析等。

**请求**

\`\`\`http
POST /api/shensheshou
Content-Type: application/json

{
  "endpoint": "ai/chat",
  "message": "帮我查询13800138000的用户画像"
}
\`\`\`

**响应示例**

\`\`\`json
{
  "success": true,
  "data": {
    "reply": "该用户是A级高价值用户，RFM评分85分，标签包括：高价值、活跃用户、电商偏好。最近30天内有5次互动记录。",
    "user_data": {...}
  }
}
\`\`\`

---

### 5. AI智能打标

使用AI为用户批量打标签。

**请求**

\`\`\`http
POST /api/shensheshou
Content-Type: application/json

{
  "endpoint": "ai/tag",
  "phones": ["13800138001", "13800138002"],
  "strategy": "rfm"
}
\`\`\`

**策略选项**: rfm（RFM评分）, behavior（行为分析）, preference（偏好分析）

---

### 6. 获取标签列表

获取系统中所有可用标签。

**请求**

\`\`\`http
GET /api/shensheshou?endpoint=tags&category=value
\`\`\`

---

### 7. 创建流量包

根据条件筛选用户并创建流量包。

**请求**

\`\`\`http
POST /api/shensheshou
Content-Type: application/json

{
  "endpoint": "packages/create",
  "name": "高价值用户包",
  "filters": {
    "user_level": ["S", "A"],
    "tags": ["高价值"]
  }
}
\`\`\`

---

## 错误码

| 错误码 | 说明 |
|--------|------|
| INVALID_API_KEY | API密钥无效或已过期 |
| PERMISSION_DENIED | 无权限访问该接口 |
| FIELD_NOT_ALLOWED | 无权限访问该字段 |
| QUOTA_EXCEEDED | 调用配额已用尽 |
| RATE_LIMITED | 请求频率超限 |
| USER_NOT_FOUND | 用户不存在 |
| MISSING_PARAMS | 缺少必要参数 |
| INVALID_PARAMS | 参数格式错误 |

---

## 计费说明

| 接口 | 单价（积分/次） |
|------|----------------|
| 用户画像查询 | 1 |
| 批量用户查询 | 0.8/人 |
| 数据流入 | 0.5/人 |
| AI对话 | 5 |
| AI智能打标 | 2/人 |
| 流量包创建 | 10 |
| 流量包导出 | 0.1/人 |

---

## SDK示例

### Python

\`\`\`python
import requests

API_KEY = "sk-archer-xxxxx"
BASE_URL = "https://your-domain.com/api/shensheshou"

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

# 查询用户画像
response = requests.get(
    f"{BASE_URL}?endpoint=user&phone=13800138000",
    headers=headers
)
print(response.json())

# 批量查询
response = requests.post(BASE_URL, headers=headers, json={
    "endpoint": "users/batch",
    "phones": ["13800138001", "13800138002"]
})
print(response.json())
\`\`\`

### JavaScript

\`\`\`javascript
const API_KEY = "sk-archer-xxxxx";
const BASE_URL = "https://your-domain.com/api/shensheshou";

// 查询用户画像
const response = await fetch(\`\${BASE_URL}?endpoint=user&phone=13800138000\`, {
  headers: {
    "Authorization": \`Bearer \${API_KEY}\`,
  }
});
const data = await response.json();
console.log(data);

// 批量查询
const batchResponse = await fetch(BASE_URL, {
  method: "POST",
  headers: {
    "Authorization": \`Bearer \${API_KEY}\`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    endpoint: "users/batch",
    phones: ["13800138001", "13800138002"]
  })
});
\`\`\`

### cURL

\`\`\`bash
# 查询用户画像
curl -X GET "https://your-domain.com/api/shensheshou?endpoint=user&phone=13800138000" \\
  -H "Authorization: Bearer sk-archer-xxxxx"

# 批量查询
curl -X POST "https://your-domain.com/api/shensheshou" \\
  -H "Authorization: Bearer sk-archer-xxxxx" \\
  -H "Content-Type: application/json" \\
  -d '{"endpoint":"users/batch","phones":["13800138001","13800138002"]}'
\`\`\`

---

## 联系支持

- 技术支持邮箱: support@shensheshou.com
- 在线文档: https://docs.shensheshou.com

---

*文档版本 1.0.0 - 最后更新: 2026-01-31*
`

export async function GET(request: NextRequest) {
  const { searchParams } = new URL(request.url)
  const format = searchParams.get('format') || 'json'
  
  // 获取当前域名作为服务器URL
  const host = request.headers.get('host') || 'localhost:3000'
  const protocol = request.headers.get('x-forwarded-proto') || 'http'
  
  // 更新服务器URL
  const spec = {
    ...OPENAPI_SPEC,
    servers: [
      {
        url: `${protocol}://${host}/api/shensheshou`,
        description: '神射手API服务器',
      },
    ],
  }
  
  if (format === 'openapi' || format === 'json') {
    return NextResponse.json(spec, {
      headers: {
        'Content-Type': 'application/json',
        'Access-Control-Allow-Origin': '*',
        'Cache-Control': 'public, max-age=3600',
      },
    })
  }
  
  if (format === 'markdown' || format === 'md') {
    return new NextResponse(MARKDOWN_DOC, {
      headers: {
        'Content-Type': 'text/markdown; charset=utf-8',
        'Content-Disposition': 'attachment; filename="shensheshou-api-docs.md"',
        'Access-Control-Allow-Origin': '*',
      },
    })
  }
  
  if (format === 'download') {
    return NextResponse.json(spec, {
      headers: {
        'Content-Type': 'application/json',
        'Content-Disposition': 'attachment; filename="shensheshou-openapi.json"',
        'Access-Control-Allow-Origin': '*',
      },
    })
  }
  
  // 返回简化版文档信息
  return NextResponse.json({
    name: '神射手数据中台 API',
    version: '1.0.0',
    description: '用户资产数字化平台API，提供用户画像、AI标签、RFM评分等数据服务',
    docs: {
      openapi: `${protocol}://${host}/api/docs?format=openapi`,
      markdown: `${protocol}://${host}/api/docs?format=markdown`,
      download: `${protocol}://${host}/api/docs?format=download`,
      web: `${protocol}://${host}/data-market/api/docs`,
    },
    endpoints: {
      base: `${protocol}://${host}/api/shensheshou`,
      auth: 'Header: Authorization: Bearer YOUR_API_KEY',
    },
    quick_start: {
      step1: '获取API密钥：登录管理后台 → 数据市场 → 开放接口',
      step2: '阅读文档：访问上方 docs.web 链接',
      step3: '测试调用：使用curl或SDK调用API',
    },
  }, {
    headers: {
      'Access-Control-Allow-Origin': '*',
    },
  })
}

// 支持CORS
export async function OPTIONS() {
  return new NextResponse(null, {
    headers: {
      'Access-Control-Allow-Origin': '*',
      'Access-Control-Allow-Methods': 'GET, OPTIONS',
      'Access-Control-Allow-Headers': 'Content-Type, Authorization',
    },
  })
}