mirror of
https://github.com/ZSCNetSupportDept/website.git
synced 2025-12-26 21:11:12 +08:00
1
This commit is contained in:
@@ -11,4 +11,3 @@
|
||||
## 关于
|
||||
|
||||
如果对文档有任何问题，请在GitHub页面提交Issue或者PR,或联系组长
|
||||
|
||||
|
||||
@@ -1,7 +1,19 @@
|
||||
---
|
||||
|
||||
description: 项目的概述
|
||||
description: 快速了解报修系统项目
|
||||
|
||||
---
|
||||
# 概述
|
||||
网维原来的老报修系统从13年开始开发，16年完成的第二版一直用到了现在2025年，确实有必要更新了 ，
|
||||
|
||||
本文档描述的“报修系统”，是网维历史上第三版报修系统，代号"wts3",采用前后端分离架构。与前任系统相同，该系统在用户前端上主要依托于微信公众号(服务号)作为流量入口，亦可以作为网页访问，其后端采用Go语言编写，使用的数据库为PostgreSQL
|
||||
|
||||
## 技术栈
|
||||
### 前端
|
||||
- 开发框架：SvelteKit
|
||||
- UI框架：Carbon Design System (Carbon Design Svelte)
|
||||
- HTTP框架：Axios
|
||||
|
||||
### 后端
|
||||
- 语言：Go
|
||||
- HTTP框架：Echo
|
||||
- 数据库：PostgreSQL
|
||||
|
||||
@@ -2,6 +2,11 @@
|
||||
网维的新报修系统
|
||||
|
||||
|
||||
网维原来的老报修系统从13年开始开发，16年完成的第二版一直用到了现在2025年，确实有必要更新了，本文档是新报修系统的文档，暂时还没写好，可以先参考。
|
||||
|
||||
如果你想加入报修系统的开发工作，或者对功能有建议，可以联系开发组组长。
|
||||
|
||||
|
||||
import DocCardList from '@theme/DocCardList';
|
||||
|
||||
<DocCardList className="docs-card" />
|
||||
|
||||
9
docs/devdocs/02-网维报修系统/数据库设计/index.md
Normal file
9
docs/devdocs/02-网维报修系统/数据库设计/index.md
Normal file
@@ -0,0 +1,9 @@
|
||||
# 数据库设计
|
||||
本项目高度捆绑PostgreSQL，采用了大量pgsql特定的功能，如枚举，视图等
|
||||
|
||||
|
||||
|
||||
import DocCardList from '@theme/DocCardList';
|
||||
|
||||
<DocCardList className="docs-card" />
|
||||
|
||||
84
docs/devdocs/02-网维报修系统/数据库设计/枚举.md
Normal file
84
docs/devdocs/02-网维报修系统/数据库设计/枚举.md
Normal file
@@ -0,0 +1,84 @@
|
||||
---
|
||||
|
||||
description: 数据库的枚举类型说明
|
||||
|
||||
---
|
||||
# 枚举
|
||||
数据库中有如下枚举：
|
||||
|
||||
## wts.block
|
||||
该枚举代表宿舍楼栋：
|
||||
- `1`: 凤翔1栋
|
||||
- `2`: 凤翔2栋
|
||||
- `3`: 凤翔3栋
|
||||
- `4`: 凤翔4栋
|
||||
- `5`: 凤翔5栋
|
||||
- `6`: 凤翔6栋
|
||||
---
|
||||
- `7`: 北门7栋
|
||||
- `8`: 北门8栋
|
||||
- `9`: 北门9栋
|
||||
- `10`: 北门10栋
|
||||
- `11`: 北门11栋
|
||||
---
|
||||
- `12`: 东门12栋
|
||||
- `13`: 东门13栋
|
||||
- `14`: 东门14栋
|
||||
- `15`: 东门15栋
|
||||
- `20`: 东门20栋
|
||||
- `21`: 东门21栋
|
||||
- `22`: 东门22栋
|
||||
---
|
||||
- `16`: 歧头16栋
|
||||
- `17`: 歧头17栋
|
||||
- `18`: 歧头18栋
|
||||
- `19`: 歧头19栋
|
||||
---
|
||||
- `XHA`: 香晖A栋
|
||||
- `XHB`: 香晖B栋
|
||||
- `XHC`: 香晖C栋
|
||||
- `XHD`: 香晖D栋
|
||||
---
|
||||
- `ZH`: 朝晖
|
||||
- `other`: 其它楼栋，适用于未定义的情况。
|
||||
## wts.isp
|
||||
该枚举代表运营商的种类：
|
||||
- `telecom`：中国电信
|
||||
- `unicom `：中国联通
|
||||
- `mobile`：中国移动
|
||||
- `others`：其它运营商，适用于未定义的情况或用户格式不符合的情况。
|
||||
- `broadnet`：中国广电，万一以后来学校了呢？
|
||||
|
||||
## wts.access
|
||||
该枚举代表用户权限：
|
||||
- `dev`：开发组组长或其他有最高控制权限的人
|
||||
- `chief`：科长和科助等有着超级权限的人
|
||||
- `api`：API等有着进阶管理权限的人
|
||||
- `group-leader`：值班组长和其他独立小组长等有着一般管理权限的人
|
||||
- `formal-member`：正式成员
|
||||
- `informal-member`：实习成员
|
||||
- `per-member`：由于各种原因已经退出网维的前任成员
|
||||
- `user`：普通用户(即已经绑定了学号的用户)
|
||||
- `unregistered`：未绑定自己学号的微信用户
|
||||
## wts.status
|
||||
该枚举代表工单的状态：
|
||||
- `fresh`：新报修，待解决
|
||||
- `scheduled`：已预约，指定一个时间让网维成员上门解决
|
||||
- `no-present`：没人
|
||||
- `reported`：已经上报
|
||||
- `solved`：已解决
|
||||
- `canceled`：已取消，用户取消报修或被长期无人系统自动打回
|
||||
## wts.priority
|
||||
该枚举代表工单的优先级：
|
||||
|
||||
- `highest`：最高优先级，适用于用户投诉，长期未解决等工单。`(非常紧急！)`
|
||||
|
||||
- `assigned`：手动指派，适用于学校或运营商派发的工单，此类工单通常由管理人员手动创建。`(请优先解决)`
|
||||
|
||||
- `mainline`：主线任务，指当天的新报修，预约的报修等
|
||||
|
||||
- `normal`：一般优先级，默认的优先级
|
||||
|
||||
- `in-passing`：维修过程中顺便看一下，适用于上报单等..
|
||||
|
||||
- `least`：最不优先，适用于长期顽疾，例如移动交换机等问题工程师长期不来修
|
||||
6
docs/devdocs/02-网维报修系统/数据库设计/表结构.md
Normal file
6
docs/devdocs/02-网维报修系统/数据库设计/表结构.md
Normal file
@@ -0,0 +1,6 @@
|
||||
---
|
||||
|
||||
description: 数据库的schema与表结构
|
||||
|
||||
---
|
||||
# 表结构
|
||||
@@ -49,4 +49,6 @@ graph LR
|
||||
### 其它
|
||||
暂无
|
||||
## 注意事项
|
||||
部分房间可能会有AP,如果用户说网速很慢可以先看主线连接的是不是AP
|
||||
- 部分房间可能会有AP,如果用户说网速很慢可以先看主线连接的是不是AP
|
||||
|
||||
- 部分房间的墙线会有老化的情况，而导致速率很慢（甚至使用Wi-Fi都比用网线快），更严重的还有连接不稳定，甚至根本没法连接。除了让用户用Wi-Fi忍忍之外，也可以建议用户飞线，但是注意，网维不参与宿舍内飞线操作。
|
||||
|
||||
@@ -48,14 +48,14 @@ graph LR
|
||||
### 其它
|
||||
暂无
|
||||
## 注意事项
|
||||
进门可以看见一个梯子，
|
||||
- 进门可以看见一个梯子，
|
||||
记得带梯子去值班，不管有没有单，每天下班时都要拍一张梯子的照片给值班组长
|
||||
**记得拍梯子!!**
|
||||
|
||||
电信机房并不是每一层都有的.\
|
||||
- 电信机房并不是每一层都有的.\
|
||||
宿舍床位有两个端口，如果上面的标识难以辨别哪个是移动，哪个是电信的话，可以顺着电信小交换机的端口找到哪个是电信端口，剩下的就是移动端口了.
|
||||
|
||||
|
||||
- 部分房间的墙线会有老化的情况，而导致速率很慢（甚至使用Wi-Fi都比用网线快），更严重的还有连接不稳定，甚至根本没法连接。除了让用户用Wi-Fi忍忍之外，也可以建议用户飞线，但是注意，网维不参与宿舍内飞线操作。
|
||||
|
||||
|
||||
|
||||
|
||||
@@ -56,4 +56,6 @@ graph LR
|
||||
### 其它
|
||||
## 注意事项
|
||||
|
||||
机房没办法进去，运营商只有电信，光纤入户
|
||||
- 机房没办法进去，运营商只有电信，光纤入户
|
||||
|
||||
- 部分房间的墙线会有老化的情况，而导致速率很慢（甚至使用Wi-Fi都比用网线快），更严重的还有连接不稳定，甚至根本没法连接。除了让用户用Wi-Fi忍忍之外，也可以建议用户飞线，但是注意，网维不参与宿舍内飞线操作。
|
||||
|
||||
@@ -46,4 +46,4 @@ graph LR
|
||||
### 其它
|
||||
暂无
|
||||
## 注意事项
|
||||
记得在宿管阿姨处借钥匙
|
||||
- 记得在宿管阿姨处借钥匙
|
||||
|
||||
@@ -56,4 +56,4 @@ graph LR
|
||||
### 其它
|
||||
暂无
|
||||
## 注意事项
|
||||
暂无
|
||||
- 部分房间的墙线会有老化的情况，而导致速率很慢（甚至使用Wi-Fi都比用网线快），更严重的还有连接不稳定，甚至根本没法连接。除了让用户用Wi-Fi忍忍之外，也可以建议用户飞线，但是注意，网维不参与宿舍内飞线操作。
|
||||
|
||||
@@ -55,4 +55,4 @@ graph LR
|
||||
### 其它
|
||||
暂无
|
||||
## 注意事项
|
||||
记得在宿管阿姨处借钥匙
|
||||
- 记得在宿管阿姨处借钥匙
|
||||
|
||||
@@ -66,3 +66,5 @@ T568A或T568B标准规定了双绞线的8根线接入RJ-45接口时的线序。
|
||||
模式B:用1,2,3,6传输数据，用4,5,7,8运送电力，这适合对网速要求不高的情况
|
||||
|
||||
4PPoE:使用全部的4对线传输电力，通常需要用在高性能设备上
|
||||
|
||||
(为什么绞在一起？ 为什么只需要1236（线的作用）？ 为什么有线序？ PoE是什么？（网线的妙用）)
|
||||
|
||||
@@ -1,8 +1,3 @@
|
||||
# ip查不到
|
||||
:::warning 注意
|
||||
|
||||
🚧施工中🚧
|
||||
|
||||
这篇文章还没有写完呢！😛
|
||||
|
||||
:::
|
||||
*（移步：[这里](/docs/wiki/技能/电脑技能/查看ip#无地址的情况)）*
|
||||
|
||||
Reference in New Issue
Block a user