# officialWebsite

**Repository Path**: wygkhcsc/official-website

## Basic Information

- **Project Name**: officialWebsite
- **Description**: ICT协会官网 —— 聚集热爱技术的同学，在实践中打磨工程能力
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: http://101.35.133.202/
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-08
- **Last Updated**: 2026-03-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ICT协会官网前端

> ICT协会官网 —— 聚集热爱技术的同学，在实践中打磨工程能力

**在线访问**: http://101.35.133.202/

## 快速开始

```sh
#克隆代码库
git clone https://gitee.com/wygkhcsc/official-website.git

#进入项目目录
cd official-website

#安装依赖
npm i

#启动调试服务器
npm run dev

#docker 镜像构建
docker build -t ictweboffice:v1.0 -f ./DockerFile .
```



## 技术栈

- VUE3

## 项目结构

- public                          公共资源目录
  - image 		          图片目录

- src
  - components		公共组件
  - pages					页面
  - router                    路由
  - styles                     公共样式

## 全局样式规范

核心原则：为保证可复用性，全局样式不得影响子组件的内部布局

### 全局样式命名规范

自定义属性命名：

```css
--element-name
```

## 第三方包

- axios@1.13.2

## 开发规范

### 文件创建标记

文件顶部写：

```javascript
<!--
    @author:名称
    @date: yyyy-mm-dd
    @description：描述
-->
```

### 命名规范

vue组件命名规范：大驼峰命名法

子组件命名：父组件名称-子组件名称

### 资源引用规范

vite.config.ts中配置：

```ts
alias: {
      '@': fileURLToPath(new URL('./src', import.meta.url))
    }
```

其他文件引用资源时，使用

```javascript
import xxx from  '@/Path'
```

### git提交信息规范

| 类型       | 说明     | 使用场景                     |
| ---------- | -------- | ---------------------------- |
| `feat`     | 新功能   | 新增特性、功能模块           |
| `fix`      | 修复     | Bug 修复                     |
| `docs`     | 文档     | 仅修改文档                   |
| `style`    | 格式     | 代码格式调整（不影响功能）   |
| `refactor` | 重构     | 代码重构（非新增功能或修复） |
| `perf`     | 性能     | 性能优化                     |
| `test`     | 测试     | 添加或修改测试代码           |
| `chore`    | 构建     | 构建过程或辅助工具变动       |
| `ci`       | 持续集成 | CI 配置修改                  |
| `revert`   | 回退     | 撤销之前的提交               |

## TODO

| 任务                                  | 执行人员             | 完成情况 | 创建日期  | 完成日期  | 说明                                                         | 备注                       |
| ------------------------------------- | -------------------- | -------- | --------- | --------- | ------------------------------------------------------------ | -------------------------- |
| 删除个人展示页的增加和删除功能        | 小唐                 | 已完成   | 2026/2/22 | 2026/2/22 |                                                              |                            |
| 组件名称按规范重命名                  | 小唐、人间归落离、東 | 未完成   | 2026/2/22 |           |                                                              | 暂缓                       |
| 成员网站目录和奖项的后端API接口的实现 | 『Passion』          | 未完成   | 2026/2/22 |           |                                                              |                            |
| 个人展示页与奖项与后端API的对接       | 小唐                 | 未完成   | 2026/2/22 |           |                                                              |                            |
| 个人展示页与奖项与后端的API定义       | 『Passion』          | 未完成   | 2026/2/22 |           |                                                              |                            |
| 全局样式问题                          | 小唐、人间归落离、東 | 未完成   | 2026/2/22 |           | 1.当前global.css 仅仅被Home页面使用<br /> 2.违反了"全局样式不得影响子组件的内部布局"，具体为Header组件和RegistrationForm组件受影 响 <br /> 3.全局样式里面定义的自定义属性，在除了Home及其子组件之外的其他组件中，几乎未使用。 <br /> 4.global.css 中污染了原生 HTML 标签，如（section、main、a、img），导致新组件不可避免的被影响，会降低后续组件的自定义性。 <br /> 5.高度具体的类名如：section-title-wrap 被放在了全局样式中，全局样式与相应组件的耦合性高。 | 暂缓                       |
| 文件头信息                            | 小唐、人间归落离、東 | 未完成   | 2026/3/2  |           | @author:<br />@date:<br />@description                       | 每一个创建的私有文件都要写 |
|                                       |                      |          |           |           |                                                              |                            |
|                                       |                      |          |           |           |                                                              |                            |
|                                       |                      |          |           |           |                                                              |                            |

## 团队人员

| 职责           | 负责人               |
| -------------- | -------------------- |
| 项目统筹与管理 | gkhcsc               |
| 前端开发       | 小唐、人间归落离、東 |
| 后端开发       | 『Passion』          |
| 服务器运维     | gkhcsc               |

## FAQ

## 更新日志