# user-feedback-system

**Repository Path**: ddgameshop/user-feedback-system

## Basic Information

- **Project Name**: user-feedback-system
- **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-07
- **Last Updated**: 2026-01-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 用户意见反馈信息收集系统

基于 Next.js 14 和 Supabase 构建的用户反馈管理平台。

## 技术栈

- **前端框架**: Next.js 14 (App Router)
- **UI 库**: React 18
- **样式**: Tailwind CSS
- **后端服务**: Supabase (PostgreSQL + Auth + Realtime)
- **表单验证**: Zod
- **测试框架**: Vitest + fast-check

## 开始使用

### 安装依赖

```bash
npm install
```

### 配置环境变量

复制 `.env.local.example` 到 `.env.local` 并填入你的 Supabase 配置：

```bash
cp .env.local.example .env.local
```

### 运行开发服务器

```bash
npm run dev
```

在浏览器中打开 [http://localhost:3000](http://localhost:3000) 查看应用。

### 运行测试

```bash
# 运行所有测试
npm test

# 监听模式
npm run test:watch

# UI 模式
npm run test:ui
```

## 项目结构

```
.
├── app/                    # Next.js App Router 页面
├── components/             # React 组件
├── lib/                    # 工具函数和配置
│   ├── actions/           # Server Actions
│   ├── supabase/          # Supabase 客户端
│   └── validations/       # Zod 验证模式
├── types/                  # TypeScript 类型定义
└── tests/                  # 测试文件
```

## 开发指南

查看 `.kiro/specs/user-feedback-system/` 目录下的规范文档：

- `requirements.md` - 需求文档
- `design.md` - 设计文档
- `tasks.md` - 实施计划