# lab-website

**Repository Path**: sparkstudiosju/lab-website

## Basic Information

- **Project Name**: lab-website
- **Description**: 实验室形象展示网站设计项目
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 创新实验室官网

创新实验室的官方网站，专注于嵌入式系统、智能小车和技术竞赛。

## 📋 文档指南

所有项目文档已整理到 `docs/` 目录下：

### 🟢 快速开始（必读）

- **docs/getting-started/ENVIRONMENT_SETUP.md** - **环境安装详细指南** ⭐
- **docs/getting-started/GITEE_BACKUP_STEPS.md** - Gitee 备份操作步骤
- **docs/getting-started/PRINT_THIS_TO_WALL.md** - 打印贴电脑旁的快速参考

### 🟡 快速参考

- **docs/reference/USAGE_GUIDE.md** - 使用指南
- **docs/reference/TROUBLESHOOTING.md** - **故障排除指南** ⭐
- **docs/reference/QUICK_BACKUP_GUIDE.md** - 备份快速指南

### 🟠 详细指南

- **docs/guides/TEACHER_GUIDE.md** - 指导老师操作指南
- **docs/guides/MEDIA_MANAGEMENT.md** - 多媒体资源管理
- **docs/guides/DIRECTORY_STRUCTURE.md** - 目录结构说明
- **docs/guides/MAINTENANCE_GUIDE.md** - 维护指南
- **docs/guides/STYLE_GUIDE.md** - 样式修改指南

### 🟡 模板文件

- **docs/templates/MAINTENANCE_LOG_TEMPLATE.md** - 维护日志模板

### 🔵 高级/技术文档

- **docs/advanced/AUTHENTICATION_GUIDE.md** - 身份认证方案
- **docs/advanced/QUICK_BACKUP_GUIDE.md** - 备份快速指南

### 📞 文档使用建议

**第一次使用（新电脑环境）：**

1. 环境安装：`docs/getting-started/ENVIRONMENT_SETUP.md` ⭐
2. 或使用自动安装脚本：`scripts/setup.bat` (Windows) / `scripts/setup.sh` (macOS/Linux)
3. 项目备份：`docs/getting-started/GITEE_BACKUP_STEPS.md`
4. 操作指南：`docs/guides/TEACHER_GUIDE.md`

**日常使用：**

1. 常用操作：查看 `docs/reference/USAGE_GUIDE.md`
2. 遇到问题：查看 `docs/reference/TROUBLESHOOTING.md` ⭐
3. 需要备份：查看 `docs/getting-started/GITEE_BACKUP_STEPS.md`

**学习新功能：**

1. 根据需要查看相应指南

---

## 📋 环境要求

### 必需软件

| 软件 | 版本要求 | 说明 |
|------|---------|------|
| **Node.js** | 18.0.0 或更高 | 运行环境 |
| **npm** | 9.0.0 或更高（随Node.js自动安装） | 包管理器 |
| **Git** | 2.0 或更高 | 版本控制（可选） |

### 快速环境安装

**自动安装（推荐）：**

```bash
# Windows
scripts\setup.bat

# macOS/Linux
chmod +x scripts/setup.sh && ./scripts/setup.sh
```

**手动安装：**

1. 安装 Node.js：https://nodejs.org（选择 LTS 版本）
2. 验证安装：
   ```bash
   node --version
   npm --version
   ```

详细环境配置指南请查看：`docs/getting-started/ENVIRONMENT_SETUP.md`

---

## 🚀 快速开始

### 安装依赖

```bash
npm install
```

如果安装失败，尝试使用国内镜像：
```bash
npm install --registry=https://registry.npmmirror.com
```

### 开发模式

```bash
npm run dev
```

访问 [http://localhost:3000](http://localhost:3000) 查看网站。

### 构建生产版本

```bash
npm run build
npm start
```

---

## 🛠️ 常用命令

```bash
# 安装依赖
npm install

# 开发模式（支持热重载）
npm run dev

# 构建生产版本
npm run build

# 启动生产服务器
npm start

# 代码检查
npm run lint
```

---

## 📂 项目结构

```
src/
├── app/                # Next.js 应用目录
│   ├── [locale]/       # 国际化路由
│   ├── globals.css     # 全局样式
│   ├── layout.tsx      # 根布局
│   └── template.tsx    # 模板布局
├── components/         # React 组件
│   ├── common/         # 通用组件
│   └── sections/       # 页面区块
├── lib/               # 工具函数
└── messages/          # 翻译文件
    ├── zh-CN.json       # 中文翻译
    └── en-US.json       # 英文翻译
docs/                 # 项目文档（已整理）
```

---

## ⚙️ 功能特性

- [x] 响应式设计
- [x] 中英文双语支持
- [x] 深色/浅色主题切换
- [x] 页面动画效果
- [x] 回到顶部按钮
- [x] SEO 优化

---

## 📄 页面

- 首页
- 实验室介绍
- 比赛活动
- 学习资源
- 成员风采
- 加入我们

---

## 🎨 自定义

### 修改实验室信息

编辑 `src/messages/zh-CN.json` 和 `src/messages/en-US.json` 文件：

```json
{
  "common": {
    "labName": "创新实验室",
    "university": "XX大学",
    "email": "contact@lab.edu.cn",
    "address": "XX大学创新大楼301室"
  }
}
```

### 修改主题颜色

编辑 `tailwind.config.ts` 中的颜色配置。

### 添加新图片

- 将图片放入 `public/images/` 对应子目录
- 在组件中引用路径

### 添加新页面

在 `src/app/[locale]/` 目录下创建新的页面文件。

---

## 🔄 维护更新

### 日常维护

详细的维护指南请查看：`docs/guides/MAINTENANCE_GUIDE.md`

### 备份管理

- **推荐方式**: Gitee + 云盘
- **详细步骤**: `docs/advanced/GITEE_BACKUP_GUIDE.md`

---

## 📞 技术支持

### 常见问题

查看：`docs/reference/FAQ_QUICK_REFERENCE.md`

### 遇到问题

1. 先查阅 `docs/reference/FAQ_QUICK_REFERENCE.md`
2. 查阅 `docs/reference/QUICK_REFERENCE.md` 中的快速参考
3. 如无法解决，联系技术负责人

---

## 📄 License

MIT