init ana page with apis

app/api/analytics/device-analysis/route.ts

@@ -0,0 +1,28 @@
+import { NextRequest, NextResponse } from 'next/server';
+import { getDeviceAnalysis } from '@/lib/analytics';
+
+export async function GET(request: NextRequest) {
+  try {
+    // 获取请求参数
+    const { searchParams } = new URL(request.url);
+    const linkId = searchParams.get('linkId') || undefined;
+    const startDate = searchParams.get('startDate') || undefined;
+    const endDate = searchParams.get('endDate') || undefined;
+    
+    // 获取设备分析详情
+    const analysisData = await getDeviceAnalysis(
+      startDate,
+      endDate,
+      linkId
+    );
+    
+    // 返回数据
+    return NextResponse.json(analysisData);
+  } catch (error) {
+    console.error('Error in device-analysis API:', error);
+    return NextResponse.json(
+      { error: 'Failed to fetch device analysis data' },
+      { status: 500 }
+    );
+  }
+} 

app/api/analytics/funnel/route.ts

@@ -0,0 +1,36 @@
+import { NextRequest, NextResponse } from 'next/server';
+import { getConversionFunnel } from '@/lib/analytics';
+
+export async function GET(request: NextRequest) {
+  try {
+    // 获取请求参数
+    const { searchParams } = new URL(request.url);
+    const linkId = searchParams.get('linkId');
+    const startDate = searchParams.get('startDate') || undefined;
+    const endDate = searchParams.get('endDate') || undefined;
+    
+    // 验证必要参数
+    if (!linkId) {
+      return NextResponse.json(
+        { error: 'Missing required parameter: linkId' },
+        { status: 400 }
+      );
+    }
+    
+    // 获取转化漏斗数据
+    const funnelData = await getConversionFunnel(
+      linkId,
+      startDate || undefined,
+      endDate || undefined
+    );
+    
+    // 返回数据
+    return NextResponse.json(funnelData);
+  } catch (error) {
+    console.error('Error in funnel API:', error);
+    return NextResponse.json(
+      { error: 'Failed to fetch funnel data' },
+      { status: 500 }
+    );
+  }
+} 

app/api/analytics/link-performance/route.ts

@@ -0,0 +1,36 @@
+import { NextRequest, NextResponse } from 'next/server';
+import { getLinkPerformance } from '@/lib/analytics';
+
+export async function GET(request: NextRequest) {
+  try {
+    // 获取请求参数
+    const { searchParams } = new URL(request.url);
+    const linkId = searchParams.get('linkId');
+    const startDate = searchParams.get('startDate') || undefined;
+    const endDate = searchParams.get('endDate') || undefined;
+    
+    // 验证必要参数
+    if (!linkId) {
+      return NextResponse.json(
+        { error: 'Missing required parameter: linkId' },
+        { status: 400 }
+      );
+    }
+    
+    // 获取链接表现数据
+    const performanceData = await getLinkPerformance(
+      linkId,
+      startDate || undefined,
+      endDate || undefined
+    );
+    
+    // 返回数据
+    return NextResponse.json(performanceData);
+  } catch (error) {
+    console.error('Error in link-performance API:', error);
+    return NextResponse.json(
+      { error: 'Failed to fetch link performance data' },
+      { status: 500 }
+    );
+  }
+} 

app/api/analytics/link-status-distribution/route.ts

@@ -0,0 +1,28 @@
+import { NextRequest, NextResponse } from 'next/server';
+import { getLinkStatusDistribution } from '@/lib/analytics';
+
+export async function GET(request: NextRequest) {
+  try {
+    // 获取请求参数
+    const { searchParams } = new URL(request.url);
+    const projectId = searchParams.get('projectId') || undefined;
+    const startDate = searchParams.get('startDate') || undefined;
+    const endDate = searchParams.get('endDate') || undefined;
+    
+    // 获取链接状态分布数据
+    const distributionData = await getLinkStatusDistribution(
+      startDate,
+      endDate,
+      projectId
+    );
+    
+    // 返回数据
+    return NextResponse.json(distributionData);
+  } catch (error) {
+    console.error('Error in link-status-distribution API:', error);
+    return NextResponse.json(
+      { error: 'Failed to fetch link status distribution data' },
+      { status: 500 }
+    );
+  }
+} 

app/api/analytics/overview-cards/route.ts

@@ -0,0 +1,28 @@
+import { NextRequest, NextResponse } from 'next/server';
+import { getOverviewCards } from '@/lib/analytics';
+
+export async function GET(request: NextRequest) {
+  try {
+    // 获取请求参数
+    const { searchParams } = new URL(request.url);
+    const projectId = searchParams.get('projectId') || undefined;
+    const startDate = searchParams.get('startDate') || undefined;
+    const endDate = searchParams.get('endDate') || undefined;
+    
+    // 获取概览卡片数据
+    const cardsData = await getOverviewCards(
+      startDate,
+      endDate,
+      projectId
+    );
+    
+    // 返回数据
+    return NextResponse.json(cardsData);
+  } catch (error) {
+    console.error('Error in overview-cards API:', error);
+    return NextResponse.json(
+      { error: 'Failed to fetch overview cards data' },
+      { status: 500 }
+    );
+  }
+} 

app/api/analytics/overview/route.ts

@@ -0,0 +1,36 @@
+import { NextRequest, NextResponse } from 'next/server';
+import { getLinkOverview } from '@/lib/analytics';
+
+export async function GET(request: NextRequest) {
+  try {
+    // 获取请求参数
+    const { searchParams } = new URL(request.url);
+    const linkId = searchParams.get('linkId');
+    const startDate = searchParams.get('startDate') || undefined;
+    const endDate = searchParams.get('endDate') || undefined;
+    
+    // 验证必要参数
+    if (!linkId) {
+      return NextResponse.json(
+        { error: 'Missing required parameter: linkId' },
+        { status: 400 }
+      );
+    }
+    
+    // 获取链接概览数据
+    const overviewData = await getLinkOverview(
+      linkId,
+      startDate || undefined,
+      endDate || undefined
+    );
+    
+    // 返回数据
+    return NextResponse.json(overviewData);
+  } catch (error) {
+    console.error('Error in overview API:', error);
+    return NextResponse.json(
+      { error: 'Failed to fetch overview data' },
+      { status: 500 }
+    );
+  }
+} 

app/api/analytics/platform-distribution/route.ts

@@ -0,0 +1,28 @@
+import { NextRequest, NextResponse } from 'next/server';
+import { getPlatformDistribution } from '@/lib/analytics';
+
+export async function GET(request: NextRequest) {
+  try {
+    // 获取请求参数
+    const { searchParams } = new URL(request.url);
+    const linkId = searchParams.get('linkId') || undefined;
+    const startDate = searchParams.get('startDate') || undefined;
+    const endDate = searchParams.get('endDate') || undefined;
+    
+    // 获取平台分布数据
+    const distributionData = await getPlatformDistribution(
+      startDate,
+      endDate,
+      linkId
+    );
+    
+    // 返回数据
+    return NextResponse.json(distributionData);
+  } catch (error) {
+    console.error('Error in platform-distribution API:', error);
+    return NextResponse.json(
+      { error: 'Failed to fetch platform distribution data' },
+      { status: 500 }
+    );
+  }
+} 

app/api/analytics/popular-links/route.ts

@@ -0,0 +1,32 @@
+import { NextRequest, NextResponse } from 'next/server';
+import { getPopularLinks } from '@/lib/analytics';
+
+export async function GET(request: NextRequest) {
+  try {
+    // 获取请求参数
+    const { searchParams } = new URL(request.url);
+    const projectId = searchParams.get('projectId') || undefined;
+    const startDate = searchParams.get('startDate') || undefined;
+    const endDate = searchParams.get('endDate') || undefined;
+    const sortBy = searchParams.get('sortBy') as 'visits' | 'uniqueVisitors' | 'conversionRate' || 'visits';
+    const limit = searchParams.get('limit') ? parseInt(searchParams.get('limit') as string, 10) : 10;
+    
+    // 获取热门链接数据
+    const linksData = await getPopularLinks(
+      startDate,
+      endDate,
+      projectId,
+      sortBy,
+      limit
+    );
+    
+    // 返回数据
+    return NextResponse.json(linksData);
+  } catch (error) {
+    console.error('Error in popular-links API:', error);
+    return NextResponse.json(
+      { error: 'Failed to fetch popular links data' },
+      { status: 500 }
+    );
+  }
+} 

app/api/analytics/popular-referrers/route.ts

@@ -0,0 +1,32 @@
+import { NextRequest, NextResponse } from 'next/server';
+import { getPopularReferrers } from '@/lib/analytics';
+
+export async function GET(request: NextRequest) {
+  try {
+    // 获取请求参数
+    const { searchParams } = new URL(request.url);
+    const linkId = searchParams.get('linkId') || undefined;
+    const startDate = searchParams.get('startDate') || undefined;
+    const endDate = searchParams.get('endDate') || undefined;
+    const type = searchParams.get('type') as 'domain' | 'full' || 'domain';
+    const limit = searchParams.get('limit') ? parseInt(searchParams.get('limit') as string, 10) : 10;
+    
+    // 获取热门引荐来源数据
+    const referrersData = await getPopularReferrers(
+      startDate,
+      endDate,
+      linkId,
+      type,
+      limit
+    );
+    
+    // 返回数据
+    return NextResponse.json(referrersData);
+  } catch (error) {
+    console.error('Error in popular-referrers API:', error);
+    return NextResponse.json(
+      { error: 'Failed to fetch popular referrers data' },
+      { status: 500 }
+    );
+  }
+} 

app/api/analytics/qr-code-analysis/route.ts

@@ -0,0 +1,30 @@
+import { NextRequest, NextResponse } from 'next/server';
+import { getQrCodeAnalysis } from '@/lib/analytics';
+
+export async function GET(request: NextRequest) {
+  try {
+    // 获取请求参数
+    const { searchParams } = new URL(request.url);
+    const linkId = searchParams.get('linkId') || undefined;
+    const qrCodeId = searchParams.get('qrCodeId') || undefined;
+    const startDate = searchParams.get('startDate') || undefined;
+    const endDate = searchParams.get('endDate') || undefined;
+    
+    // 获取QR码分析数据
+    const analysisData = await getQrCodeAnalysis(
+      startDate,
+      endDate,
+      linkId,
+      qrCodeId
+    );
+    
+    // 返回数据
+    return NextResponse.json(analysisData);
+  } catch (error) {
+    console.error('Error in qr-code-analysis API:', error);
+    return NextResponse.json(
+      { error: 'Failed to fetch QR code analysis data' },
+      { status: 500 }
+    );
+  }
+} 

app/api/analytics/track/route.ts

@@ -0,0 +1,68 @@
+import { NextRequest, NextResponse } from 'next/server';
+import { trackEvent, EventType, ConversionType } from '@/lib/analytics';
+
+export async function POST(request: NextRequest) {
+  try {
+    // 解析请求体
+    const body = await request.json();
+    
+    // 验证必要字段
+    if (!body.linkId) {
+      return NextResponse.json(
+        { error: 'Missing required field: linkId' },
+        { status: 400 }
+      );
+    }
+    
+    if (!body.eventType || !Object.values(EventType).includes(body.eventType)) {
+      return NextResponse.json(
+        { 
+          error: 'Invalid or missing eventType',
+          validValues: Object.values(EventType)
+        },
+        { status: 400 }
+      );
+    }
+    
+    // 验证转化类型（如果提供）
+    if (
+      body.conversionType && 
+      !Object.values(ConversionType).includes(body.conversionType)
+    ) {
+      return NextResponse.json(
+        { 
+          error: 'Invalid conversionType',
+          validValues: Object.values(ConversionType)
+        },
+        { status: 400 }
+      );
+    }
+    
+    // 添加客户端IP
+    const clientIp = request.headers.get('x-forwarded-for') || 
+                     request.headers.get('x-real-ip') || 
+                     '0.0.0.0';
+    
+    // 添加用户代理
+    const userAgent = request.headers.get('user-agent') || '';
+    
+    // 合并数据
+    const eventData = {
+      ...body,
+      ipAddress: body.ipAddress || clientIp,
+      userAgent: body.userAgent || userAgent,
+    };
+    
+    // 追踪事件
+    const result = await trackEvent(eventData);
+    
+    // 返回结果
+    return NextResponse.json(result);
+  } catch (error) {
+    console.error('Error in track API:', error);
+    return NextResponse.json(
+      { error: 'Failed to track event' },
+      { status: 500 }
+    );
+  }
+} 

app/api/analytics/trends/route.ts

@@ -0,0 +1,50 @@
+import { NextRequest, NextResponse } from 'next/server';
+import { getVisitTrends, TimeGranularity } from '@/lib/analytics';
+
+export async function GET(request: NextRequest) {
+  try {
+    // 获取请求参数
+    const { searchParams } = new URL(request.url);
+    const linkId = searchParams.get('linkId');
+    const startDate = searchParams.get('startDate') || undefined;
+    const endDate = searchParams.get('endDate') || undefined;
+    const granularity = searchParams.get('granularity') as TimeGranularity || TimeGranularity.DAY;
+    
+    // 验证必要参数
+    if (!linkId) {
+      return NextResponse.json(
+        { error: 'Missing required parameter: linkId' },
+        { status: 400 }
+      );
+    }
+    
+    // 验证粒度参数
+    const validGranularities = Object.values(TimeGranularity);
+    if (granularity && !validGranularities.includes(granularity)) {
+      return NextResponse.json(
+        { 
+          error: 'Invalid granularity value',
+          validValues: validGranularities
+        },
+        { status: 400 }
+      );
+    }
+    
+    // 获取访问趋势数据
+    const trendsData = await getVisitTrends(
+      linkId,
+      startDate || undefined,
+      endDate || undefined,
+      granularity
+    );
+    
+    // 返回数据
+    return NextResponse.json(trendsData);
+  } catch (error) {
+    console.error('Error in trends API:', error);
+    return NextResponse.json(
+      { error: 'Failed to fetch trends data' },
+      { status: 500 }
+    );
+  }
+} 

app/api/links/[linkId]/details/route.ts

@@ -0,0 +1,28 @@
+import { NextRequest, NextResponse } from 'next/server';
+import { getLinkDetailsById } from '@/app/api/links/service';
+
+export async function GET(
+  request: NextRequest,
+  context: { params: { linkId: string } }
+) {
+  try {
+    const params = await context.params;
+    const linkId = params.linkId;
+    const link = await getLinkDetailsById(linkId);
+
+    if (!link) {
+      return NextResponse.json(
+        { error: 'Link not found' },
+        { status: 404 }
+      );
+    }
+
+    return NextResponse.json(link);
+  } catch (error) {
+    console.error('Failed to fetch link details:', error);
+    return NextResponse.json(
+      { error: 'Failed to fetch link details', message: (error as Error).message },
+      { status: 500 }
+    );
+  }
+} 

app/api/links/[linkId]/route.ts

@@ -0,0 +1,27 @@
+import { NextRequest, NextResponse } from 'next/server';
+import { getLinkById } from '../service';
+
+export async function GET(
+  request: NextRequest,
+  { params }: { params: { linkId: string } }
+) {
+  try {
+    const { linkId } = params;
+    const link = await getLinkById(linkId);
+
+    if (!link) {
+      return NextResponse.json(
+        { error: 'Link not found' },
+        { status: 404 }
+      );
+    }
+
+    return NextResponse.json(link);
+  } catch (error) {
+    console.error('Failed to fetch link details:', error);
+    return NextResponse.json(
+      { error: 'Failed to fetch link details', message: (error as Error).message },
+      { status: 500 }
+    );
+  }
+} 

app/api/links/repository.ts

@@ -0,0 +1,157 @@
+import { executeQuery, executeQuerySingle } from '@/lib/clickhouse';
+import { Link, LinkQueryParams } from '../types';
+
+/**
+ * Find links with filtering options
+ */
+export async function findLinks({
+  limit = 10,
+  offset = 0,
+  searchTerm = '',
+  tagFilter = '',
+  isActive = null,
+}: LinkQueryParams) {
+  // Build WHERE conditions
+  const conditions = [];
+  
+  if (searchTerm) {
+    conditions.push(`
+      (lower(title) LIKE lower('%${searchTerm}%') OR 
+       lower(original_url) LIKE lower('%${searchTerm}%'))
+    `);
+  }
+  
+  if (tagFilter) {
+    conditions.push(`hasAny(tags, ['${tagFilter}'])`);
+  }
+  
+  if (isActive !== null) {
+    conditions.push(`is_active = ${isActive ? 'true' : 'false'}`);
+  }
+  
+  const whereClause = conditions.length > 0 
+    ? `WHERE ${conditions.join(' AND ')}` 
+    : '';
+  
+  // Get total count
+  const countQuery = `
+    SELECT count() as total
+    FROM links
+    ${whereClause}
+  `;
+  
+  const countData = await executeQuery<{ total: number }>(countQuery);
+  const total = countData.length > 0 ? countData[0].total : 0;
+  
+  // 使用左连接获取链接数据和统计信息
+  const linksQuery = `
+    SELECT 
+      l.link_id, 
+      l.original_url, 
+      l.created_at, 
+      l.created_by, 
+      l.title, 
+      l.description, 
+      l.tags, 
+      l.is_active, 
+      l.expires_at, 
+      l.team_id, 
+      l.project_id,
+      count(le.event_id) as visits,
+      count(DISTINCT le.visitor_id) as unique_visits
+    FROM links l
+    LEFT JOIN link_events le ON l.link_id = le.link_id
+    ${whereClause}
+    GROUP BY 
+      l.link_id, 
+      l.original_url, 
+      l.created_at, 
+      l.created_by, 
+      l.title, 
+      l.description, 
+      l.tags, 
+      l.is_active, 
+      l.expires_at, 
+      l.team_id, 
+      l.project_id
+    ORDER BY l.created_at DESC
+    LIMIT ${limit}
+    OFFSET ${offset}
+  `;
+  
+  const links = await executeQuery<Link>(linksQuery);
+  
+  return {
+    links,
+    total,
+    limit,
+    offset,
+    page: Math.floor(offset / limit) + 1,
+    totalPages: Math.ceil(total / limit)
+  };
+}
+
+/**
+ * Find a single link by ID
+ */
+export async function findLinkById(linkId: string): Promise<Link | null> {
+  const query = `
+    SELECT 
+      l.link_id, 
+      l.original_url, 
+      l.created_at, 
+      l.created_by, 
+      l.title, 
+      l.description, 
+      l.tags, 
+      l.is_active, 
+      l.expires_at, 
+      l.team_id, 
+      l.project_id,
+      count(le.event_id) as visits,
+      count(DISTINCT le.visitor_id) as unique_visits
+    FROM links l
+    LEFT JOIN link_events le ON l.link_id = le.link_id
+    WHERE l.link_id = '${linkId}'
+    GROUP BY 
+      l.link_id, 
+      l.original_url, 
+      l.created_at, 
+      l.created_by, 
+      l.title, 
+      l.description, 
+      l.tags, 
+      l.is_active, 
+      l.expires_at, 
+      l.team_id, 
+      l.project_id
+    LIMIT 1
+  `;
+  
+  return await executeQuerySingle<Link>(query);
+}
+
+/**
+ * Find a single link by ID - only basic info without statistics
+ */
+export async function findLinkDetailsById(linkId: string): Promise<Omit<Link, 'visits' | 'unique_visits'> | null> {
+  const query = `
+    SELECT 
+      link_id, 
+      original_url, 
+      created_at, 
+      created_by, 
+      title, 
+      description, 
+      tags, 
+      is_active, 
+      expires_at, 
+      team_id, 
+      project_id
+    FROM links
+    WHERE link_id = '${linkId}'
+    LIMIT 1
+  `;
+  
+  return await executeQuerySingle<Omit<Link, 'visits' | 'unique_visits'>>(query);
+} 

app/api/links/route.ts

@@ -0,0 +1,32 @@
+import { NextRequest, NextResponse } from 'next/server';
+import { LinkQueryParams } from '../types';
+import { getLinks } from './service';
+
+export async function GET(request: NextRequest) {
+  try {
+    const searchParams = request.nextUrl.searchParams;
+    
+    // Parse request parameters
+    const params: LinkQueryParams = {
+      limit: searchParams.has('limit') ? Number(searchParams.get('limit')) : 10,
+      page: searchParams.has('page') ? Number(searchParams.get('page')) : 1,
+      searchTerm: searchParams.get('search') || '',
+      tagFilter: searchParams.get('tag') || '',
+    };
+    
+    // Handle active status filter
+    const activeFilter = searchParams.get('active');
+    if (activeFilter === 'true') params.isActive = true;
+    if (activeFilter === 'false') params.isActive = false;
+
+    // Get link data
+    const result = await getLinks(params);
+    return NextResponse.json(result);
+  } catch (error) {
+    console.error('Failed to fetch links:', error);
+    return NextResponse.json(
+      { error: 'Failed to fetch links', message: (error as Error).message },
+      { status: 500 }
+    );
+  }
+} 

app/api/links/service.ts

@@ -0,0 +1,42 @@
+import { Link, LinkQueryParams, PaginatedResponse } from '../types';
+import { findLinkById, findLinkDetailsById, findLinks } from './repository';
+
+/**
+ * Get links with pagination information
+ */
+export async function getLinks(params: LinkQueryParams): Promise<PaginatedResponse<Link>> {
+  // Convert page number to offset
+  const { page, limit = 10, ...otherParams } = params;
+  const offset = page ? (page - 1) * limit : params.offset || 0;
+  
+  const result = await findLinks({
+    ...otherParams,
+    limit,
+    offset
+  });
+  
+  return {
+    data: result.links,
+    pagination: {
+      total: result.total,
+      limit: result.limit,
+      offset: result.offset,
+      page: result.page,
+      totalPages: result.totalPages
+    }
+  };
+}
+
+/**
+ * Get a single link by ID with full details (including statistics)
+ */
+export async function getLinkById(linkId: string): Promise<Link | null> {
+  return await findLinkById(linkId);
+}
+
+/**
+ * Get a single link by ID - only basic info without statistics
+ */
+export async function getLinkDetailsById(linkId: string): Promise<Omit<Link, 'visits' | 'unique_visits'> | null> {
+  return await findLinkDetailsById(linkId);
+} 

app/api/stats/repository.ts

@@ -0,0 +1,21 @@
+import { executeQuerySingle } from '@/lib/clickhouse';
+import { StatsOverview } from '../types';
+
+/**
+ * Get overview statistics for links
+ */
+export async function findStatsOverview(): Promise<StatsOverview | null> {
+  const query = `
+    WITH 
+      toUInt64(count()) as total_links,
+      toUInt64(countIf(is_active = true)) as active_links
+    FROM links
+    SELECT
+      total_links as totalLinks,
+      active_links as activeLinks,
+      (SELECT count() FROM link_events) as totalVisits,
+      (SELECT count() FROM link_events) / NULLIF(total_links, 0) as conversionRate
+  `;
+  
+  return await executeQuerySingle<StatsOverview>(query);
+}

app/api/stats/route.ts

@@ -0,0 +1,15 @@
+import { NextResponse } from 'next/server';
+import { getStatsOverview } from './service';
+
+export async function GET() {
+  try {
+    const stats = await getStatsOverview();
+    return NextResponse.json(stats);
+  } catch (error) {
+    console.error('获取统计概览失败:', error);
+    return NextResponse.json(
+      { error: '获取统计概览失败', message: (error as Error).message },
+      { status: 500 }
+    );
+  }
+} 

app/api/stats/service.ts

@@ -0,0 +1,21 @@
+import { StatsOverview } from '../types';
+import { findStatsOverview } from './repository';
+
+/**
+ * Get link statistics overview
+ */
+export async function getStatsOverview(): Promise<StatsOverview> {
+  const stats = await findStatsOverview();
+  
+  // Return default values if no data
+  if (!stats) {
+    return {
+      totalLinks: 0,
+      activeLinks: 0,
+      totalVisits: 0,
+      conversionRate: 0
+    };
+  }
+  
+  return stats;
+} 

app/api/tags/repository.ts

@@ -0,0 +1,19 @@
+import { executeQuery } from '@/lib/clickhouse';
+import { Tag } from '../types';
+
+/**
+ * Get all tags with usage counts
+ */
+export async function findAllTags(): Promise<Tag[]> {
+  const query = `
+    SELECT 
+      tag, 
+      count() as count
+    FROM links
+    ARRAY JOIN tags as tag
+    GROUP BY tag
+    ORDER BY count DESC
+  `;
+  
+  return await executeQuery<Tag>(query);
+} 

app/api/tags/route.ts

@@ -0,0 +1,15 @@
+import { NextResponse } from 'next/server';
+import { getAllTags } from './service';
+
+export async function GET() {
+  try {
+    const tags = await getAllTags();
+    return NextResponse.json(tags);
+  } catch (error) {
+    console.error('Failed to fetch tags:', error);
+    return NextResponse.json(
+      { error: 'Failed to fetch tags', message: (error as Error).message },
+      { status: 500 }
+    );
+  }
+} 

app/api/tags/service.ts

@@ -0,0 +1,9 @@
+import { Tag } from '../types';
+import { findAllTags } from './repository';
+
+/**
+ * Get all available tags
+ */
+export async function getAllTags(): Promise<Tag[]> {
+  return await findAllTags();
+} 

app/api/types.ts

@@ -0,0 +1,221 @@
+// 链接数据类型
+export interface Link {
+  link_id: string;
+  original_url: string;
+  created_at: string;
+  created_by: string;
+  title: string;
+  description: string;
+  tags: string[];
+  is_active: boolean;
+  expires_at: string | null;
+  team_id: string;
+  project_id: string;
+  visits: number;
+  unique_visits: number;
+}
+
+// 分页响应类型
+export interface PaginatedResponse<T> {
+  data: T[];
+  pagination: {
+    total: number;
+    limit: number;
+    offset: number;
+    page: number;
+    totalPages: number;
+  }
+}
+
+// 链接查询参数
+export interface LinkQueryParams {
+  limit?: number;
+  offset?: number;
+  page?: number;
+  searchTerm?: string;
+  tagFilter?: string;
+  isActive?: boolean | null;
+}
+
+// 标签类型
+export interface Tag {
+  tag: string;
+  count: number;
+}
+
+// 统计概览类型
+export interface StatsOverview {
+  totalLinks: number;
+  activeLinks: number;
+  totalVisits: number;
+  conversionRate: number;
+}
+
+// Analytics数据类型
+export interface LinkOverviewData {
+  totalVisits: number;
+  uniqueVisitors: number;
+  averageTimeSpent: number;
+  bounceCount: number;
+  conversionCount: number;
+  uniqueReferrers: number;
+  deviceTypes: {
+    mobile: number;
+    tablet: number;
+    desktop: number;
+    other: number;
+  };
+  qrScanCount: number;
+  totalConversionValue: number;
+}
+
+export interface FunnelStep {
+  name: string;
+  value: number;
+  percent: number;
+}
+
+export interface ConversionFunnelData {
+  steps: FunnelStep[];
+  totalConversions: number;
+  conversionRate: number;
+}
+
+export interface TrendPoint {
+  timestamp: string;
+  visits: number;
+  uniqueVisitors: number;
+}
+
+export interface VisitTrendsData {
+  trends: TrendPoint[];
+  totals: {
+    visits: number;
+    uniqueVisitors: number;
+  };
+}
+
+export interface TrackEventRequest {
+  linkId: string;
+  eventType: string;
+  visitorId?: string;
+  sessionId?: string;
+  referrer?: string;
+  userAgent?: string;
+  ipAddress?: string;
+  timeSpent?: number;
+  conversionType?: string;
+  conversionValue?: number;
+  customData?: Record<string, unknown>;
+  isQrScan?: boolean;
+  qrCodeId?: string;
+  utmSource?: string;
+  utmMedium?: string;
+  utmCampaign?: string;
+}
+
+export interface TrackEventResponse {
+  success: boolean;
+  eventId: string;
+  timestamp: string;
+}
+
+// 链接表现数据
+export interface LinkPerformanceData {
+  totalClicks: number;
+  uniqueVisitors: number;
+  averageTimeSpent: number;
+  bounceRate: number;
+  uniqueReferrers: number;
+  conversionRate: number;
+  activeDays: number;
+  lastClickTime: string | null;
+  deviceDistribution: {
+    mobile: number;
+    desktop: number;
+  };
+}
+
+// 平台分布数据
+export interface PlatformItem {
+  name: string;
+  count: number;
+  percent: number;
+}
+
+export interface PlatformDistributionData {
+  totalVisits: number;
+  platforms: PlatformItem[];
+  browsers: PlatformItem[];
+}
+
+// 设备分析数据
+export interface DeviceItem {
+  name: string;
+  count: number;
+  percent: number;
+}
+
+export interface DeviceModelItem {
+  type: string;
+  brand: string;
+  model: string;
+  count: number;
+  percent: number;
+}
+
+export interface DeviceAnalysisData {
+  totalVisits: number;
+  deviceTypes: DeviceItem[];
+  deviceBrands: DeviceItem[];
+  deviceModels: DeviceModelItem[];
+}
+
+// 热门引荐来源数据
+export interface ReferrerItem {
+  source: string;
+  visitCount: number;
+  uniqueVisitors: number;
+  conversionCount: number;
+  conversionRate: number;
+  averageTimeSpent: number;
+  percent: number;
+}
+
+export interface PopularReferrersData {
+  referrers: ReferrerItem[];
+  totalVisits: number;
+}
+
+// QR码分析数据
+export interface LocationItem {
+  city: string;
+  country: string;
+  scanCount: number;
+  percent: number;
+}
+
+export interface DeviceDistributionItem {
+  type: string;
+  count: number;
+  percent: number;
+}
+
+export interface HourlyDistributionItem {
+  hour: number;
+  scanCount: number;
+  percent: number;
+}
+
+export interface QrCodeAnalysisData {
+  overview: {
+    totalScans: number;
+    uniqueScanners: number;
+    conversionCount: number;
+    conversionRate: number;
+    averageTimeSpent: number;
+  };
+  locations: LocationItem[];
+  deviceDistribution: DeviceDistributionItem[];
+  hourlyDistribution: HourlyDistributionItem[];
+}