diff --git a/docs/devdocs/01-首页.md b/docs/devdocs/01-首页.md index c38a5e8..dc25080 100644 --- a/docs/devdocs/01-首页.md +++ b/docs/devdocs/01-首页.md @@ -11,4 +11,3 @@ ## 关于 如果对文档有任何问题,请在GitHub页面提交Issue或者PR,或联系组长 - diff --git a/docs/devdocs/02-网维报修系统/01-概述.md b/docs/devdocs/02-网维报修系统/01-概述.md index 1a0be8c..47225b3 100644 --- a/docs/devdocs/02-网维报修系统/01-概述.md +++ b/docs/devdocs/02-网维报修系统/01-概述.md @@ -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 diff --git a/docs/devdocs/02-网维报修系统/index.md b/docs/devdocs/02-网维报修系统/index.md index 989e885..f0ce536 100644 --- a/docs/devdocs/02-网维报修系统/index.md +++ b/docs/devdocs/02-网维报修系统/index.md @@ -2,6 +2,11 @@ 网维的新报修系统 +网维原来的老报修系统从13年开始开发,16年完成的第二版一直用到了现在2025年,确实有必要更新了,本文档是新报修系统的文档,暂时还没写好,可以先参考。 + +如果你想加入报修系统的开发工作,或者对功能有建议,可以联系开发组组长。 + + import DocCardList from '@theme/DocCardList'; diff --git a/docs/devdocs/02-网维报修系统/数据库设计/index.md b/docs/devdocs/02-网维报修系统/数据库设计/index.md new file mode 100644 index 0000000..5afa602 --- /dev/null +++ b/docs/devdocs/02-网维报修系统/数据库设计/index.md @@ -0,0 +1,9 @@ +# 数据库设计 +本项目高度捆绑PostgreSQL,采用了大量pgsql特定的功能,如枚举,视图等 + + + +import DocCardList from '@theme/DocCardList'; + + + diff --git a/docs/devdocs/02-网维报修系统/数据库设计/枚举.md b/docs/devdocs/02-网维报修系统/数据库设计/枚举.md new file mode 100644 index 0000000..e13b8cd --- /dev/null +++ b/docs/devdocs/02-网维报修系统/数据库设计/枚举.md @@ -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`:最不优先,适用于长期顽疾,例如移动交换机等问题工程师长期不来修 diff --git a/docs/devdocs/02-网维报修系统/数据库设计/表结构.md b/docs/devdocs/02-网维报修系统/数据库设计/表结构.md new file mode 100644 index 0000000..ad02a7c --- /dev/null +++ b/docs/devdocs/02-网维报修系统/数据库设计/表结构.md @@ -0,0 +1,6 @@ +--- + +description: 数据库的schema与表结构 + +--- +# 表结构 diff --git a/docs/wiki/04-片区介绍/东门.md b/docs/wiki/04-片区介绍/东门.md index 45a5ea0..129feb7 100644 --- a/docs/wiki/04-片区介绍/东门.md +++ b/docs/wiki/04-片区介绍/东门.md @@ -49,4 +49,6 @@ graph LR ### 其它 暂无 ## 注意事项 -部分房间可能会有AP,如果用户说网速很慢可以先看主线连接的是不是AP +- 部分房间可能会有AP,如果用户说网速很慢可以先看主线连接的是不是AP + +- 部分房间的墙线会有老化的情况,而导致速率很慢(甚至使用Wi-Fi都比用网线快),更严重的还有连接不稳定,甚至根本没法连接。除了让用户用Wi-Fi忍忍之外,也可以建议用户飞线,但是注意,网维不参与宿舍内飞线操作。 diff --git a/docs/wiki/04-片区介绍/凤翔.md b/docs/wiki/04-片区介绍/凤翔.md index ef9854c..6a76936 100644 --- a/docs/wiki/04-片区介绍/凤翔.md +++ b/docs/wiki/04-片区介绍/凤翔.md @@ -48,14 +48,14 @@ graph LR ### 其它 暂无 ## 注意事项 -进门可以看见一个梯子, +- 进门可以看见一个梯子, 记得带梯子去值班,不管有没有单,每天下班时都要拍一张梯子的照片给值班组长 **记得拍梯子!!** -电信机房并不是每一层都有的.\ +- 电信机房并不是每一层都有的.\ 宿舍床位有两个端口,如果上面的标识难以辨别哪个是移动,哪个是电信的话,可以顺着电信小交换机的端口找到哪个是电信端口,剩下的就是移动端口了. - +- 部分房间的墙线会有老化的情况,而导致速率很慢(甚至使用Wi-Fi都比用网线快),更严重的还有连接不稳定,甚至根本没法连接。除了让用户用Wi-Fi忍忍之外,也可以建议用户飞线,但是注意,网维不参与宿舍内飞线操作。 diff --git a/docs/wiki/04-片区介绍/北门.md b/docs/wiki/04-片区介绍/北门.md index 5ac1cf1..fd84c2c 100644 --- a/docs/wiki/04-片区介绍/北门.md +++ b/docs/wiki/04-片区介绍/北门.md @@ -56,4 +56,6 @@ graph LR ### 其它 ## 注意事项 -机房没办法进去,运营商只有电信,光纤入户 +- 机房没办法进去,运营商只有电信,光纤入户 + +- 部分房间的墙线会有老化的情况,而导致速率很慢(甚至使用Wi-Fi都比用网线快),更严重的还有连接不稳定,甚至根本没法连接。除了让用户用Wi-Fi忍忍之外,也可以建议用户飞线,但是注意,网维不参与宿舍内飞线操作。 diff --git a/docs/wiki/04-片区介绍/朝晖.md b/docs/wiki/04-片区介绍/朝晖.md index 14b3665..2bf8e15 100644 --- a/docs/wiki/04-片区介绍/朝晖.md +++ b/docs/wiki/04-片区介绍/朝晖.md @@ -46,4 +46,4 @@ graph LR ### 其它 暂无 ## 注意事项 -记得在宿管阿姨处借钥匙 +- 记得在宿管阿姨处借钥匙 diff --git a/docs/wiki/04-片区介绍/歧头.md b/docs/wiki/04-片区介绍/歧头.md index 0422043..c32acf1 100644 --- a/docs/wiki/04-片区介绍/歧头.md +++ b/docs/wiki/04-片区介绍/歧头.md @@ -56,4 +56,4 @@ graph LR ### 其它 暂无 ## 注意事项 -暂无 +- 部分房间的墙线会有老化的情况,而导致速率很慢(甚至使用Wi-Fi都比用网线快),更严重的还有连接不稳定,甚至根本没法连接。除了让用户用Wi-Fi忍忍之外,也可以建议用户飞线,但是注意,网维不参与宿舍内飞线操作。 diff --git a/docs/wiki/04-片区介绍/香晖.md b/docs/wiki/04-片区介绍/香晖.md index 980f5e8..e9b855d 100644 --- a/docs/wiki/04-片区介绍/香晖.md +++ b/docs/wiki/04-片区介绍/香晖.md @@ -55,4 +55,4 @@ graph LR ### 其它 暂无 ## 注意事项 -记得在宿管阿姨处借钥匙 +- 记得在宿管阿姨处借钥匙 diff --git a/docs/wiki/05-基础知识/09-科普/网线是什么.md b/docs/wiki/05-基础知识/09-科普/网线是什么.md index bf7b1df..693f94b 100644 --- a/docs/wiki/05-基础知识/09-科普/网线是什么.md +++ b/docs/wiki/05-基础知识/09-科普/网线是什么.md @@ -66,3 +66,5 @@ T568A或T568B标准规定了双绞线的8根线接入RJ-45接口时的线序。 模式B:用1,2,3,6传输数据,用4,5,7,8运送电力,这适合对网速要求不高的情况 4PPoE:使用全部的4对线传输电力,通常需要用在高性能设备上 + +(为什么绞在一起? 为什么只需要1236(线的作用)? 为什么有线序? PoE是什么?(网线的妙用)) diff --git a/docs/wiki/08-故障/01-通用/ip查不到.md b/docs/wiki/08-故障/01-通用/ip查不到.md index 6ea0eb5..87fbe77 100644 --- a/docs/wiki/08-故障/01-通用/ip查不到.md +++ b/docs/wiki/08-故障/01-通用/ip查不到.md @@ -1,8 +1,3 @@ # ip查不到 -:::warning 注意 -🚧施工中🚧 - -这篇文章还没有写完呢!😛 - -::: +*(移步:[这里](/docs/wiki/技能/电脑技能/查看ip#无地址的情况))*