# tayaya-index

**Repository Path**: rabbitTang_admin/tayaya-index

## Basic Information

- **Project Name**: tayaya-index
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-15
- **Last Updated**: 2026-01-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 塔娅娅的个人网站 (taya_website_app)

欢迎来到塔娅娅的个人网站项目！这是一个使用 Next.js 构建的现代化、响应式的网站，旨在展示虚拟主播塔娅娅的个人信息、直播日程、作品以及与粉丝的互动功能。

## ✨ 主要功能

*   **首页展示**: 包含引人注目的英雄区域、最新动态、近期直播预告、最新作品展示和社交媒体链接。
*   **直播日程 (Schedule)**: 清晰展示每周的直播安排，方便粉丝查看。
*   **关于塔娅娅 (About)**: 提供塔娅娅的详细个人介绍、基本资料以及大航海回馈等信息。
*   **作品展示 (Works)**: 汇总展示塔娅娅在B站等平台的视频、音频或图片作品。
*   **粉丝互动 (Fans/积分兑换中心)**:
    *   用户登录/注册与B站UID绑定。
    *   查询中奖记录 (从 `prize.csv` 读取)。
    *   查询电子积分 (从 `电子卡积分汇总.csv` 读取)。
    *   电子礼物积分兑换功能 (通过 `/api/redeem` 接口与数据库交互)。
*   **后台管理 (Admin)**:
    *   电子礼物管理 (通过 `/admin/gift` 页面和 `/api/admin/gift-mysql` 接口管理 `electronic_gift` 数据库表中的礼物信息，包括名称、下载链接、提取码和兑换所需积分)。
    *   后台页面访问需要密码验证。

## 🛠️ 技术栈

*   **前端**: Next.js (React框架), TypeScript, Tailwind CSS
*   **后端 API**: Next.js API Routes (TypeScript)
*   **数据库**: MySQL (用于存储用户信息、电子礼物、兑换记录等)
*   **数据文件**: CSV 文件 (如 `prize.csv`, `电子卡积分汇总.csv` 用于存储部分中奖记录和原始积分数据)
*   **核心依赖**: `axios` (HTTP请求), `mysql2` (MySQL驱动), `csv-parse` (CSV文件解析), `react-hook-form`, `zod`, `lucide-react` (UI组件库 Shadcn/ui 依赖) 等。

## 🚀 如何开始

1.  **克隆仓库**:
    ```bash
    git clone <repository-url>
    cd taya_website_app
    ```

2.  **安装依赖**:
    项目使用 pnpm 作为包管理器。请确保已安装 pnpm。
    ```bash
    pnpm install
    ```

3.  **配置环境变量**:
    根据需要，在项目根目录下创建 `.env.local` 文件，并配置数据库连接等环境变量。例如：
    ```env
    DB_HOST=your_db_host
    DB_PORT=your_db_port
    DB_USER=your_db_user
    DB_PASSWORD=your_db_password
    DB_DATABASE=taya_website
    ```

4.  **数据库迁移**:
    根据 `migrations/0001_initial.sql` 文件中的SQL语句初始化数据库表结构。确保 `user`, `electronic_gift`, `redeem_record` 等表已创建。

5.  **准备数据文件**:
    *   将中奖记录数据放入 `public/prize.csv`。
    *   将电子卡积分汇总数据放入 `public/dianzika_sum/电子卡积分汇总.csv`。
    *   确保B站视频信息文件 `public/bilibili_videos_selenium.csv` 存在，用于作品页展示。

6.  **运行开发服务器**:
    ```bash
    pnpm dev
    ```
    应用将在 `http://localhost:3000` (或 `package.json` 中配置的端口) 上运行。

## 📦 构建与部署

*   **构建生产版本**:
    ```bash
    pnpm build
    ```
*   **启动生产服务器**:
    ```bash
    pnpm start
    ```

详细的部署指南请参考项目根目录下的 `deployment_guide.md` 文件。

## 📝 API 概览

*   `/api/prize`: 获取用户中奖记录和电子积分。
*   `/api/redeem`: 处理用户积分兑换电子礼物的请求。
*   `/api/user/lookup-or-bind`: 处理用户账号/UID的查找和绑定逻辑。
*   `/api/admin/gift-mysql`: 后台管理电子礼物的增删查改接口。

## 🤝 贡献

欢迎提交 Pull Requests 或 Issues 来改进本项目。

## 📄 许可证

本项目根据实际情况选择合适的开源许可证。