# classweb

**Repository Path**: zi66chen/classweb

## Basic Information

- **Project Name**: classweb
- **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-06-10
- **Last Updated**: 2026-06-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 班级线上小站

一个基于 `Vue 3 + Vite + Tailwind CSS` 构建的班级线上小站前端项目。  
当前版本已完成多页面基础结构，包含首页、班级动态、时光相册、资料区等核心页面，并支持响应式布局、公告轮播、课表切换、投票反馈和相册灯箱预览。

## 项目特点

- 温馨暖色系视觉风格，适合班级氛围展示
- 基于 `vue-router` 的多页面导航结构
- 首页聚合公告、课表、投票、相册和倒计时信息
- 相册页支持分组筛选和 Lightbox 无刷新预览
- 资料区支持按分类展示课件、模板和复习资料
- 移动端与桌面端均可正常浏览

## 技术栈

- `Vue 3`
- `Vite`
- `Tailwind CSS`
- `Vue Router`

## 页面结构

- `首页`
  - 公告轮播
  - 今日课表 / 本周重点切换
  - 快捷投票
  - 相册预览
  - 毕业倒计时与班级标语
- `班级动态`
  - 活动时间线
  - 本周重点事项
  - 班级统计卡片
- `时光相册`
  - 瀑布流相册展示
  - 分类筛选
  - 灯箱预览
- `资料区`
  - 课程资料
  - 作业模板
  - 复习专区
  - 班级共享资料

## 项目启动

安装依赖：

```bash
npm install
```

启动开发环境：

```bash
npm run dev
```

构建生产版本：

```bash
npm run build
```

本地预览构建结果：

```bash
npm run preview
```

## 目录说明

```text
src/
  components/   公共组件
  data/         页面演示数据
  router/       路由配置
  views/        页面级视图
  App.vue       应用外层布局
  main.js       应用入口

public/
  images/       相册示例图片资源
```

## Git 规范

项目已补充 Git 提交规范文档：

- [docs/git-convention.md](./docs/git-convention.md)

推荐提交格式：

```text
<type>(<scope>): <subject>
```

示例：

```text
feat(home): 完成首页核心看板布局
fix(album): 修复相册灯箱切换问题
docs(readme): 更新项目使用说明
```

## 当前仓库说明

- 远程仓库：`https://gitee.com/zi66chen/classweb.git`
- 默认分支：`main`

## 后续可扩展方向

- 接入真实后端接口
- 增加登录与个人中心页面
- 接入 Pinia 做状态管理
- 增加公告详情页、资料详情页和上传功能