1

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

docs/devdocs/02-网维报修系统/index.md

@@ -2,6 +2,11 @@
 网维的新报修系统 
 
 
+网维原来的老报修系统从13年开始开发，16年完成的第二版一直用到了现在2025年，确实有必要更新了，本文档是新报修系统的文档，暂时还没写好，可以先参考。
+
+如果你想加入报修系统的开发工作，或者对功能有建议，可以联系开发组组长。
+
+
 import DocCardList from '@theme/DocCardList';
 
 <DocCardList  className="docs-card" />

docs/devdocs/02-网维报修系统/数据库设计/index.md

@@ -0,0 +1,9 @@
+# 数据库设计
+本项目高度捆绑PostgreSQL，采用了大量pgsql特定的功能，如枚举，视图等
+
+
+
+import DocCardList from '@theme/DocCardList';
+
+<DocCardList  className="docs-card" />
+

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`：最不优先，适用于长期顽疾，例如移动交换机等问题工程师长期不来修

docs/devdocs/02-网维报修系统/数据库设计/表结构.md

@@ -0,0 +1,6 @@
+---
+
+description: 数据库的schema与表结构
+
+---
+# 表结构