From 8d74095a4819394e9d0fb6cbd65b2a5de55f7ee2 Mon Sep 17 00:00:00 2001 From: Clas Wen Date: Sat, 10 May 2025 13:38:35 +0800 Subject: [PATCH] save --- repair/weekend.md | 72 ++++++++++++++++++++++++++--------------------- 1 file changed, 40 insertions(+), 32 deletions(-) diff --git a/repair/weekend.md b/repair/weekend.md index 7703afb..9e12f63 100644 --- a/repair/weekend.md +++ b/repair/weekend.md @@ -104,6 +104,16 @@ sequenceDiagram 目前，新的维修事件会同步到 [Github Issue](https://github.com/nbtca/repair-tickets/issues) 中。成员可以在Github Issue中处理维修事件。 +### 为什么要使用Github Issue来管理维修？ + +- **成熟的工单系统**：Github Issue是一个成熟的工单系统，功能强大，易于使用。 +- **可追溯性**：所有的维修事件都可以在Github上查看，方便后续的查询和统计。 +- **协作**：Github Issue提供了良好的协作工具，成员可以在上面讨论和交流。 +- **自动化**：通过Github的Webhook，可以自动化处理一些事件，比如创建事件、更新事件等。 +- **社区参与**：Github是一个开放的平台，任何人都可以参与到维修事件中来，增加了社区的参与度。 +- **版本控制**：所有的事件都有版本记录，可以随时查看历史记录，方便追踪和审计。 +- **标签管理**：可以通过标签来管理事件的状态和类型，方便后续的查询和统计。 + ### 前提条件 在开始之前，你需要先关联你的Github账户。你可以前往 [MyId](https://myid.app.nbtca.space/account/connections) 关联你的Github账户。 @@ -124,9 +134,10 @@ sequenceDiagram ### 记录事件工作量 -通过在Github Issue中添加标签来记录工时。 ![issue-label](./assets/issue-label.png) +在Github Issue中，可以通过添加标签来记录工作量。标签的命名规则为 `size:xs`、`size:s`、`size:m`、`size:l`、`size:xl`，分别对应不同的工作量。工作量代表的是维修事件的复杂程度和所需时间。具体的工作量和对应的标签如下： + | 标签名 | 对应时长 | 示例维修任务（仅供参考） | 场景说明 | | --------- | -------- | ----------------------------------------------- | ------------------------------------------------ | | `size:xs` | 0.5 小时 | 重启系统、插拔键鼠、调整BIOS启动项 | 无需工具，仅简单排查或软件层级操作 | @@ -135,19 +146,13 @@ sequenceDiagram | `size:l` | 4 小时 | 主板故障检测与更换、电源模块更换 | 较复杂的拆装和测试流程，需熟练技能、多人协作可能 | | `size:xl` | 8 小时 | 批量电脑检修（5 台以上）、全室网卡/主板统一更换 | 工作量极大，涉及多个设备，需团队作业和详细记录 | - - ### 志愿者时长统计 -```typescript -type Record = { - studentId: string; - eventId: string; - tag: string; // e.g., "size:s" -}; +我们可以通过记录的工作量来统计志愿者时长。 -const BASE_TIME = 2; // hours -const MAX_TIME = 8; // hours +```typescript +const BASE_TIME = 2 // hours +const MAX_TIME = 8 // hours // Mapping from tag to time in hours const tagTimeMap: Record = { @@ -155,32 +160,34 @@ const tagTimeMap: Record = { 'size:m': 2, 'size:l': 4, 'size:xl': 8, -}; - -// Compute total time for a given student and event -function calculateTime(records: Record[], studentId: string): number { - const relevantRecords = records.filter( - (r) => r.studentId === studentId - ); - - let totalTime = BASE_TIME; - - for (const record of relevantRecords) { - const time = tagTimeMap[record.tag] || 0; - totalTime += time; - } - - return Math.min(MAX_TIME, totalTime); } +// Compute total time for a given student and event +function calculateTime(records: { + studentId: string + eventId: string + tag: string // e.g., "size:s" +}[], studentId: string): number { + const relevantRecords = records.filter( + r => r.studentId === studentId + ) + + let totalTime = BASE_TIME + + for (const record of relevantRecords) { + const time = tagTimeMap[record.tag] || 0 + totalTime += time + } + + return Math.min(MAX_TIME, totalTime) +} const records: Record[] = [ { studentId: '2333333333', eventId: '123456', tag: 'size:s' }, { studentId: '2333333333', eventId: '123456', tag: 'size:m' }, -]; -const time = calculateTime(records, '2333333333'); -console.log('Calculated time:', time); // Output: 5 - +] +const time = calculateTime(records, '2333333333') +console.log('Calculated time:', time) // Output: 5 ``` | Key | Value | Description | @@ -215,8 +222,9 @@ Authorization: {{bearer_token}} ``` ##### 示例 + ```bash curl -X GET "http://repair.nbtca.space/api/events/xlsx?start_time=2025-01-01&end_time=2025-05-31" \ -H "Authorization: {{bearer_token}}" \ -OJ -``` \ No newline at end of file +```