# personalWeb

**Repository Path**: huangchongyao/personalWeb

## Basic Information

- **Project Name**: personalWeb
- **Description**: 个人网站
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# PersonalWeb

这是一个现代化的个人作品集网站，采用前后端分离架构，包含博客、项目展示、简历等功能模块。

## 技术栈

### 前端
- **框架**: Next.js 14 (App Router)
- **语言**: TypeScript
- **样式**: Tailwind CSS
- **组件库**: React
- **主题**: 深色/浅色模式支持

### 后端
- **框架**: Spring Boot
- **语言**: Java
- **数据库**: (待配置)
- **API**: RESTful

## 项目结构

```
personalWeb/
├── backend/                 # Spring Boot 后端项目
│   ├── src/main/java/com/personalweb/backend/
│   │   ├── BackendApplication.java    # 启动类
│   │   ├── HelloController.java       # 测试控制器
│   │   ├── Project.java               # 项目实体类
│   │   └── ProjectController.java     # 项目管理接口
│   └── src/main/resources/
│       └── application.properties     # 配置文件
├── frontend/               # Next.js 前端项目
│   ├── src/app/
│   │   ├── about/         # 关于我页面
│   │   ├── blog/          # 博客页面
│   │   ├── contact/       # 联系方式页面
│   │   ├── projects/      # 项目展示页面
│   │   ├── resume/        # 简历页面
│   │   ├── globals.css    # 全局样式
│   │   ├── layout.tsx     # 布局组件
│   │   └── page.tsx       # 首页
│   ├── src/components/    # 公共组件
│   │   ├── Header.tsx     # 头部导航
│   │   ├── ThemeProvider.tsx  # 主题提供者
│   │   └── ThemeToggle.tsx    # 主题切换按钮
│   ├── tailwind.config.ts # Tailwind 配置
│   └── package.json
└── .gitignore
```

## 功能特性

### 已实现功能
- ✨ **首页**: 个人网站主页面
- 👤 **关于我**: 个人介绍页面
- 📝 **博客**: 博客文章列表和分类
- 💼 **项目展示**: 个人项目作品展示
- 📄 **简历**: 个人简历页面
- 📧 **联系方式**: 联系信息页面
- 🌓 **主题切换**: 支持深色/浅色模式切换

### API 接口

#### 后端接口
- `GET /api/hello` - 测试接口
- `GET /api/projects` - 获取所有项目列表

#### 跨域配置
后端已配置 CORS，允许前端跨域访问。

## 快速开始

### 环境要求
- Node.js 18+
- Java 17+
- Maven 或 Gradle

### 后端配置

1. 进入后端目录：
```bash
cd backend
```

2. 安装依赖：
```bash
mvn install
```

3. 启动后端服务：
```bash
mvn spring-boot:run
```

后端服务默认运行在 `http://localhost:8080`

### 前端配置

1. 进入前端目录：
```bash
cd frontend
```

2. 安装依赖：
```bash
npm install
# 或
yarn install
# 或
pnpm install
```

3. 启动开发服务器：
```bash
npm run dev
```

前端服务默认运行在 `http://localhost:3000`

## 使用说明

### 开发模式
同时启动前后端服务：
```bash
# 终端1 - 后端
cd backend && mvn spring-boot:run

# 终端2 - 前端
cd frontend && npm run dev
```

### 生产部署

#### 构建前端
```bash
cd frontend
npm run build
npm start
```

#### 构建后端
```bash
cd backend
mvn package
java -jar target/backend-*.jar
```

## 主题定制

网站支持深色和浅色两种主题，可以通过页面右上角的主题切换按钮进行切换。主题设置会保存在浏览器本地存储中。

## 项目模型

### Project 实体
| 字段 | 类型 | 说明 |
|------|------|------|
| id | Long | 项目唯一标识 |
| name | String | 项目名称 |
| description | String | 项目描述 |
| techStack | List<String> | 技术栈列表 |
| githubLink | String | GitHub 链接 |
| demoLink | String | 演示链接 |
| tag | String | 项目标签 |

## License

本项目仅供学习和个人使用。

## 贡献

欢迎提出 Issue 和 Pull Request 来改进这个项目。