# space0

**Repository Path**: hu-jihui-1/space0

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-02
- **Last Updated**: 2026-04-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 社交App - 开发环境

一个基于 React + TypeScript + Vite 前端和 Go + Gin + SQLite 后端的社交应用。

## 技术栈

### 前端
- **框架**: React 18
- **语言**: TypeScript 5
- **构建工具**: Vite 5
- **UI 组件库**: Ant Design Mobile 5
- **状态管理**: Zustand
- **数据获取**: TanStack Query (React Query)
- **路由**: React Router 6
- **动画**: Framer Motion
- **HTTP 客户端**: Axios

### 后端
- **语言**: Go 1.21+
- **Web 框架**: Gin 1.9
- **ORM**: GORM 1.25
- **数据库**: SQLite 3
- **认证**: JWT v5
- **日志**: Zap
- **配置**: Viper
- **验证**: go-playground/validator

## 目录结构

```
.
├── frontend/                 # 前端项目
│   ├── src/
│   │   ├── components/      # 组件
│   │   │   ├── ui/         # UI 组件
│   │   │   ├── business/   # 业务组件
│   │   │   └── layout/     # 布局组件
│   │   ├── pages/          # 页面
│   │   ├── hooks/          # 自定义 Hooks
│   │   ├── stores/         # 状态管理
│   │   ├── services/       # API 服务
│   │   ├── utils/          # 工具函数
│   │   ├── types/          # TypeScript 类型
│   │   ├── styles/         # 样式文件
│   │   ├── assets/         # 静态资源
│   │   └── router/         # 路由配置
│   ├── package.json
│   ├── vite.config.ts
│   └── tsconfig.json
├── backend/                  # 后端项目
│   ├── cmd/api/            # 应用程序入口
│   ├── internal/           # 内部包
│   │   ├── config/        # 配置管理
│   │   ├── handlers/      # HTTP 处理器
│   │   ├── middleware/    # 中间件
│   │   ├── models/        # 数据模型
│   │   ├── repository/    # 数据访问层
│   │   ├── services/      # 业务逻辑层
│   │   ├── utils/         # 工具函数
│   │   └── websocket/     # WebSocket 服务
│   ├── pkg/               # 可复用包
│   │   ├── response/      # 统一响应封装
│   │   ├── errors/        # 自定义错误类型
│   │   └── logger/        # 日志工具
│   ├── migrations/        # 数据库迁移脚本
│   ├── storage/           # 文件存储目录
│   ├── config.yaml        # 配置文件
│   ├── go.mod
│   └── Makefile
├── scripts/                 # 开发脚本
│   ├── setup.ps1          # 环境搭建脚本
│   ├── dev.ps1            # 启动开发服务器
│   └── reset-db.ps1       # 重置数据库
└── .trae/                   # Trae IDE 配置
    └── rules/              # 项目规则
```

## 开发环境搭建

### 前置要求

- **Node.js**: 18.0.0+
- **pnpm**: 8.0.0+
- **Go**: 1.21+

### 快速开始

1. **运行环境搭建脚本**
   ```powershell
   .\scripts\setup.ps1
   ```

2. **启动开发服务器**
   ```powershell
   .\scripts\dev.ps1
   ```

3. **访问应用**
   - 前端: http://localhost:3000
   - 后端: http://localhost:8080

### 手动搭建

#### 前端

```powershell
cd frontend
pnpm install
pnpm dev
```

#### 后端

```powershell
cd backend
go mod download
go mod tidy
make dev
```

## 开发命令

### 前端

```bash
# 启动开发服务器
pnpm dev

# 构建生产版本
pnpm build

# 代码检查
pnpm lint

# 自动修复代码
pnpm lint:fix

# 格式化代码
pnpm format
```

### 后端

```bash
# 启动开发服务器
make dev

# 构建可执行文件
make build

# 运行测试
make test

# 代码检查
make lint

# 格式化代码
make fmt

# 数据库迁移
make migrate

# 清理构建文件
make clean
```

## 设计规范

本项目严格遵循以下设计规范：

- **设计风格**: 柔和渐变 · 圆角卡片 · 插画点缀 · 温暖社交
- **色彩系统**: 品牌紫 #8B5CF6，辅助粉 #F472B6
- **间距系统**: 8pt Grid
- **圆角规范**: 4px ~ 20px
- **字体规范**: -apple-system, PingFang SC

设计令牌位于 `frontend/src/styles/tokens.ts` 和 `frontend/src/styles/tokens.css`。

## API 设计

RESTful API 规范，详见 `.trae/rules/api-design.md`。

### 主要端点

- `POST   /api/v1/auth/register` - 用户注册
- `POST   /api/v1/auth/login` - 用户登录
- `GET    /api/v1/users/me` - 获取当前用户
- `GET    /api/v1/posts` - 获取帖子列表
- `POST   /api/v1/posts` - 创建帖子
- `POST   /api/v1/posts/:id/like` - 点赞帖子

## 数据库模型

### 核心表

- **users** - 用户表
- **posts** - 帖子表
- **follows** - 关注关系表
- **likes** - 点赞表
- **comments** - 评论表
- **messages** - 消息表
- **notifications** - 通知表

## 贡献指南

1. 遵循项目的编码规范和设计令牌
2. 提交前运行代码检查和格式化
3. 保持代码简洁，避免过度设计

## 许可证

MIT