Debug

README.md

@@ -2,10 +2,11 @@
   <img src="https://bu.dusays.com/2025/03/21/67dc3ca22d617.jpg" alt="InSUEP Logo" width="200">
   <h1>✨ InSUEP - 上海电力大学信息直通车 ✨</h1>
 
-  ![VuePress](https://img.shields.io/badge/VuePress-2.0.0--rc.0-4FC08D?style=for-the-badge&logo=vue.js&logoColor=white)
-  ![Vue](https://img.shields.io/badge/Vue-3.0.0-4FC08D?style=for-the-badge&logo=vue.js&logoColor=white)
+  ![VuePress](https://img.shields.io/badge/VuePress-2.0.0--rc.24-4FC08D?style=for-the-badge&logo=vue.js&logoColor=white)
+  ![Vue](https://img.shields.io/badge/Vue-3.4.0-4FC08D?style=for-the-badge&logo=vue.js&logoColor=white)
   ![TypeScript](https://img.shields.io/badge/TypeScript-4.9.5-3178C6?style=for-the-badge&logo=typescript&logoColor=white)
   ![pnpm](https://img.shields.io/badge/pnpm-8.15.0-F69220?style=for-the-badge&logo=pnpm&logoColor=white)
+  ![Docker](https://img.shields.io/badge/Docker-支持-2496ED?style=for-the-badge&logo=docker&logoColor=white)
   [![CC BY-NC-ND 4.0][cc-by-nc-nd-shield]][cc-by-nc-nd]
 
   <p>💫 信息共享，让上电更美好 💫</p>
@@ -28,21 +29,32 @@
 
 InSUEP（上海电力大学信息直通车）是一个由上海电力大学学生共同编写的信息平台，旨在为新老学生提供校园生活的方方面面的信息指南。该项目使用 VuePress 2.0 构建，提供了清晰直观的界面，整合了 [SUEP-Book](https://github.com/SUEP-Plus/SUEP-Book) 的优质内容，力求打造最全面的上电校园攻略。
 
+### 📊 项目状态
+
+- ✅ **基础框架**: VuePress 2.0 + Vue 3 + TypeScript
+- ✅ **主题设计**: 基于 vuepress-theme-hope 的现代化主题
+- ✅ **文档结构**: 完整的校园生活指南体系
+- ✅ **开发流程**: 完整的 CI/CD 自动化部署
+- ✅ **容器化**: Docker 支持，便于部署
+- 🔄 **内容完善**: 持续更新中，欢迎贡献
+
 ## ✨ 特性
 
 - 🚀 基于 VuePress 2.0 构建，性能优异
 - 📱 响应式设计，适配各种设备
 - 🔍 内置搜索功能，快速找到所需信息
 - 🎨 现代简洁的主题设计
 - 📝 增强的 Markdown 支持
-- 🌐 支持自动部署
+- 🌐 支持自动部署到腾讯云
 - 📚 涵盖上电校园生活的方方面面
+- 🐳 Docker 容器化支持
+- 🔄 完整的 CI/CD 流程
 
 ## 🚀 开始使用
 
 ### 🛠️ 环境要求
 
-- Node.js (推荐 LTS 版本)
+- Node.js >= 22 (推荐 LTS 版本)
 - pnpm 8.15.0 或更高版本
 
 ### 📥 安装与运行
@@ -77,50 +89,78 @@ InSUEP（上海电力大学信息直通车）是一个由上海电力大学学
    pnpm deploy
    ```
 
+### 🐳 Docker 部署
+
+项目支持 Docker 容器化部署：
+
+```bash
+# 构建镜像
+docker build -t insuep .
+
+# 运行容器
+docker run -dp 8080:80 --name insuep_container insuep
+
+# 访问 http://localhost:8080
+```
+
 ## 📁 项目结构
 
 ```
 InSUEP/
 ├── docs/                    # 文档源文件
 │   ├── 新生你好/           # 新生入学指南
-│   │   ├── 团组织转接.md
-│   │   ├── 宿舍指南.md
-│   │   └── QQ群/
+│   │   ├── 学校介绍.md     # 学校概况
+│   │   ├── 校区介绍/       # 临港、杨浦校区介绍
+│   │   ├── 入学准备/       # 入学物品、宿舍了解
+│   │   ├── 入学活动/       # 军训、报道、入学教育
+│   │   ├── 校园网/         # 校园网上网指南
+│   │   ├── 需带物品/       # 电子产品类等
+│   │   └── QQ群/           # 新生交流群
 │   ├── 上电指南/           # 校园生活指南
-│   │   ├── 防诈骗指南.md
-│   │   ├── 插班生.md
-│   │   ├── 0day.md
-│   │   └── 食堂指南/
+│   │   ├── 防诈骗指南.md   # 安全提醒
+│   │   ├── 美食指南/       # 各校区食堂指南
+│   │   ├── 数码产品建议/   # 电脑选购指南
+│   │   ├── 社团&学生组织/  # 各类社团介绍
+│   │   ├── 学生工作/       # 学生会、班级职务
+│   │   └── 0day.md         # 快速上手指南
 │   ├── 学院与专业介绍/     # 专业相关信息
-│   │   └── 计算机科学与技术学院.md
+│   │   └── 计算机科学与技术学院/
 │   ├── 学校机构/           # 学校机构信息
+│   │   └── 计算机科学与技术学院/
 │   ├── 老生入门/           # 高年级学生指南
-│   │   └── 考研指南/
+│   │   ├── 学习指南/       # 各专业学长学姐建议
+│   │   ├── 考研指南/       # 考研经验分享
+│   │   └── 转专业/         # 转专业流程和经验
 │   ├── 开发须知/           # 开发相关文档
-│   │   ├── 声明.md
-│   │   └── 开发者文档.md
+│   │   ├── 声明.md         # 项目声明
+│   │   ├── 开发者文档.md   # 开发指南
+│   │   ├── 文档编写指南.md # 文档编写规范
+│   │   └── 样式语法&例子/  # 样式组件说明
+│   ├── 序言/               # 项目介绍
 │   ├── static/             # 静态资源
+│   │   └── imgs/           # 图片资源
 │   ├── .vuepress/          # VuePress 配置文件
 │   ├── README.md           # 网站首页
 │   └── Preface.md          # 序言
+├── .github/                # GitHub Actions CI/CD
+│   └── workflows/
 ├── public/                 # 公共静态资源
-├── src/                    # 源代码
 ├── package.json            # 项目依赖和脚本
-├── vuepress.config.js      # VuePress 配置
-├── vite.config.ts          # Vite 配置
-└── tsconfig.json           # TypeScript 配置
+├── dockerfile              # Docker 配置
+└── README.md               # 项目说明
 ```
 
 ## 🧪 开发指南
 
 ### 🔧 技术栈
 
 - **VuePress 2.0**: 文档框架
-- **Vue 3**: 前端框架
+- **Vue 3.4.0**: 前端框架
 - **TypeScript**: 类型安全
 - **SASS**: 样式处理
-- **pnpm**: 包管理
+- **pnpm 8.15.0**: 包管理
 - **Vite**: 构建工具
+- **Docker**: 容器化部署
 
 ### 💻 开发环境设置
 
@@ -130,18 +170,19 @@ InSUEP/
 - ESLint
 - Prettier
 
-### 📋 环境要求
-
-- Node.js >= 21
-- pnpm >= 8.15.0
-- Vue 3.0.0
-
 ### 🔌 已安装插件
 
 - @vuepress/bundler-vite
 - vuepress-plugin-md-enhance
 - vuepress-theme-hope
 - @vuepress/plugin-search
+- @vueuse/core
+
+### 📋 环境要求
+
+- Node.js >= 22
+- pnpm >= 8.15.0
+- Vue 3.4.0
 
 ## 🤝 贡献指南
 
@@ -155,6 +196,17 @@ InSUEP/
 4. 推送到分支 (`git push origin feature/amazing-feature`)
 5. 开启一个 Pull Request
 
+### 📝 Commit 规范
+
+请遵循以下 commit 规范：
+
+- **fix**: 修复问题
+- **feat**: 新增功能
+- **update**: 内容更新
+- **refactor**: 结构调整
+- **style**: 样式变更
+- **ci**: 流水线变更
+
 ### ⚠️ 注意事项
 
 - **请将 PR 提交到 `debug` 分支**，而不是 `main` 分支
@@ -170,18 +222,22 @@ InSUEP/
 - [ ] 🏗️ 改进主页设计和功能
 - [ ] 📝 完善各学院专业介绍
 - [ ] 🏢 补充学校机构信息
+- [ ] 🔧 优化 Docker 配置
+- [ ] 📊 添加访问统计功能
 
 ## 📞 联系我们
 
 - **💬 QQ 交流群**:
   - 726427904 (上电算法竞赛交流群)
 - **🐞 GitHub Issues**: 如有问题或建议，请在 GitHub 仓库中提出 issue
+- **📧 邮箱**: 可通过 GitHub Issues 联系
 
 ## 🙏 致谢
 
 - 感谢所有提出意见的同学和帮助完善界面、文档的朋友
 - 特别感谢 [SUEP-Book](https://github.com/SUEP-Plus/SUEP-Book) 的创作者分享了宝贵的文档内容
 - 项目灵感来源于 [innenu](https://innenu.com/)
+- 感谢所有为项目贡献内容的学长学姐们
 
 ## 📝 许可协议
 

docs/上电指南/数码产品建议/电脑选购指南.md

@@ -221,6 +221,9 @@ graph TD
 :::
 
 点击链接传送:
+
 [笔吧测评室-电脑选购指南-2025-07-18](https://mp.weixin.qq.com/s/hM4Kf-erU6YFSgFDBPcCHA)
+
 [2025年8月笔记本电脑推荐-逆狱。](https://www.bilibili.com/video/BV1ez8Cz6E6a)
+
 [百度贴吧-笔记本吧-给高考生的电脑选购建议](https://tieba.baidu.com/p/9780169174)

docs/上电指南/生活缴费/寝室电费充值指南.md

@@ -0,0 +1,123 @@
+---
+title: 寝室电费充值指南
+author:
+  name: BraveBeter
+date: 2025-09-15
+category: 生活指南
+tag:
+  - 宿舍电费
+  - 生活指南
+  - 新生必读
+---
+
+## 1.关于寝室电费
+
+每个寝室的电费独立结算，电费通过学校提供的缴费平台充值，不支持现金，直接从缴费者的校园卡里扣钱，所以交电费之前需确保校园卡里有足够的余额。  
+我们学校电费响应速度极快，没电费了立刻断电，充值电费之后几秒内立刻来电。 这就是上每力大学。
+
+## 2.如何缴纳电费
+::: tip
+
+由于10号宿舍楼为新宿舍，其不同于老宿舍的缴纳电费方式，有专门的缴费接口。
+
+所以本小节分为两部分，分别介绍新老宿舍的缴纳方式。
+
+:::
+
+::: warning
+
+无论是新宿舍还是老宿舍，在缴纳电费时都需要**先接入校园网**，请先完成这一步，再继续以后的步骤。
+
+如何接入校园网，可以参看本站中的《上海电力大学校园网上网手册》，这里不再赘述。
+
+值得一提的是，寝室里自己办理使用的网络不是校园网，不能直接访问缴费平台，需要借助VPN接入校园网，关于VPN的使用也已在《上网手册》中说明。
+
+:::
+
+::: warning
+
+由于涉及到金钱交易，请在充值前仔细核对**寝室楼号、寝室号、充值金额**是否合理正确！！！
+
+一旦缴费，不予退款。
+
+如果交错寝室了，可以自行协商或者寻求宿管帮助。
+
+:::
+
+### 新宿舍楼的缴费方式
+
+新宿舍楼即2025投入使用的10号宿舍，其有不同于旧宿舍充值的专门接口。
+
+1. 微信端搜索并关注公众号：电力E后勤  
+<div align=center><img src="https://bu.dusays.com/2025/09/17/68ca66651fac8.png"></div>
+
+2. 点击“临港10号公寓充电”
+<div align=center><img src="https://bu.dusays.com/2025/09/17/68ca66653a76b.png"></div>
+
+3. 在线支付登录页： 选择“校区”，搜索“宿舍号”（A区则输入‘A’点击搜索，B区同理，不然可能默认显示空白）。登录
+<div align=center><img src="https://bu.dusays.com/2025/09/17/68ca666521a61.png"></div>
+
+
+4. 进入宿舍详情页面
+可以查看仪表能耗、仪表费用状态、仪表剩余金额等信息。
+<div align=center><img src="https://bu.dusays.com/2025/09/17/68ca66651eb83.png"></div>
+
+5. 每日能耗情况查看
+<div align=center><img src="https://bu.dusays.com/2025/09/17/68ca6665257e3.png"></div>
+
+6. 充值
+选择金额点击充值后，会弹出一卡通学号和一卡通付费密码，需要学生输入认证
+<div align=center><img src="https://bu.dusays.com/2025/09/17/68ca66654e1a9.png"></div>
+
+### 老宿舍楼的缴费方式
+::: tip  
+
+得益于移动端界面没有自适应，选择宿舍楼的时候，下拉列表不知道会飘到哪去，所以为了体验、准确和方便，
+
+建议优先使用电脑端来完成充值动作。
+
+:::
+1. 直接在浏览器输入网址  **10.50.2.206**,或者直接点击[电费充值](http://10.50.2.206)，进入登陆界面
+<div align=center><img src="https://bu.dusays.com/2025/09/17/68ca666601495.png"></div>
+
+
+2. 登陆成功后，即可进入电费能源管理界面。
+<div align=center><img src="https://bu.dusays.com/2025/09/17/68ca66657c3e8.png"></div>
+
+
+3. 充值界面，可以自行选择“寝室楼号”、“寝室号”、“充值电费度数”。 点击“本人房”系统会自动输入登陆者的宿舍信息，并默认填写充值度数为100度。
+<div align=center><img src="https://bu.dusays.com/2025/09/17/68ca666547d64.png"></div>
+
+4. 账单页面，目前仅可以查看本人的缴费记录，不能查到同寝室其他人的缴费，是以个人为范围查询的。
+<div align=center><img src="https://bu.dusays.com/2025/09/17/68ca666531eae.png"></div>
+
+
+5. 电表，可以查看电表状态以及相关参数信息
+<div align=center><img src="https://bu.dusays.com/2025/09/17/68ca66787dd36.png"></div>
+
+
+### 可能遇到的问题
+
+在老宿舍缴费时，输入10.50.2.206进入登陆界面之后，正确的输入了账号密码，可能会直接跳转到undefined页面，如图. 解决方案是删除网址上的/undefined重新刷新，或者直接重新输入10.50.2.206。
+<div align=center><img src="https://bu.dusays.com/2025/09/17/68ca667aade36.png"></div>
+
+
+## 3.额外的tip——断电制度
+学期初和学期末不断电，一般情况下在开学后两周实行断电制度直到考试周（期末考试前两周）停止。
+
+| 时间         |   说明       |
+| ------------ |  ---------- |
+| 学期开始之后两周内 |  不断电 |
+| 二者之间  |  断电 |
+| 学期结束之前两周内 |  不断电 |
+
+实行断电制度期间：  
+
+| 时间         |   说明       |
+| ------------ |  ---------- |
+| 周一到周四、周日 | 晚23点断电熄灯  |
+| 周五到周六 | 晚24点断电熄灯  |
+
+这一点与寝室关门时间吻合。
+
+学期初，什么时候开始断电；学期末，什么时候开始不断电，都会有明确的通知，具体时间请以通知为准。