Skip to content

Commit 377d817

Browse files
niuweiliniuweili
authored andcommitted
feat: 值班新增连续轮换
1 parent 81d53fc commit 377d817

2 files changed

Lines changed: 66 additions & 6 deletions

File tree

en/on-call/configuration/schedule.mdx

Lines changed: 34 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -28,12 +28,9 @@ Understanding these concepts before configuration will help you better plan your
2828
| **Rotation** | Determines how on-call personnel hand off. For example, "handoff every Monday at 10 AM" |
2929
| **Override** | Temporarily adjust the on-call person for a specific time period without modifying permanent rules (commonly used for leave, temporary coverage) |
3030
| **Date Mask** | Select which days to participate in on-call, e.g., Team A on-call Monday to Friday, Team B on weekends |
31+
| **Continuous Rotation** | When enabled, rotation boundaries are calculated based on shift start time, preventing shifts from being split at 00:00. Only supported when date mask is configured. See [Date mask and continuous rotation](#date-mask-and-continuous-rotation) for details |
3132

32-
<Tab>
33-
<Frame>
34-
<img src="https://docs-cdn.flashcat.cloud/images/png/30e98e6bb99dff3585427a1500b65005.png" alt="Schedule" />
35-
</Frame>
36-
</Tab>
33+
![Schedule Concepts](https://docs-cdn.flashcat.cloud/images/png/3423a4f3133d5caa1f0aaebca970d404.png)
3734

3835
## Configuration Process
3936

@@ -86,7 +83,38 @@ When on-call personnel need leave or have temporary conflicts, **don't modify pe
8683
We recommend having a brief sync meeting between outgoing and incoming on-call personnel before official handoff to confirm outstanding issues and current system status—this is safer than just system notifications.
8784
</Tip>
8885

89-
## Common Scheduling Scenarios
86+
## Date mask and continuous rotation
87+
88+
---
89+
90+
### Date mask
91+
92+
Date mask controls which days of the week an on-call rule takes effect. By selecting different day combinations, you can flexibly implement differentiated scheduling between weekdays and weekends.
93+
94+
Common use cases:
95+
- **Weekday/weekend separation**: Team A on-call during weekdays, Team B on weekends
96+
- **Specific day scheduling**: Assign certain personnel only on Monday, Wednesday, and Friday
97+
- **Day/night shift by day**: Configure day and night shift rules for weekdays, and full-day on-call rules for weekends
98+
99+
### Continuous rotation
100+
101+
By default, schedules are divided at 00:00 each calendar day. If a shift spans midnight, it will be split into separate time segments.
102+
103+
![Default Rotation](https://docs-cdn.flashcat.cloud/images/png/695199d7990bf99cafab58ed10be75a1.png)
104+
105+
When **continuous rotation** is enabled, rotation boundaries are calculated based on shift start time rather than the 00:00 cutoff. Each on-call member will complete a full rotation cycle without being split at midnight.
106+
107+
![Continuous Rotation](https://docs-cdn.flashcat.cloud/images/png/d56eca56d65aa17df67110ad4a0c61a7.png)
108+
109+
<Note>
110+
Consider enabling continuous rotation in the following scenarios:
111+
- Rotation cycle is 24 hours
112+
- Shift start time is not 00:00
113+
- Day-of-week date mask is configured
114+
- Different rotation rules for weekdays and weekends
115+
</Note>
116+
117+
## Common scheduling scenarios
90118

91119
---
92120

zh/on-call/configuration/schedule.mdx

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -29,6 +29,7 @@ Flashduty On-call 提供极具灵活性的值班编排能力,支持按天、
2929
| **轮换** | 决定了值班人员如何交接。例如"每周一上午 10 点交接" |
3030
| **临时调班** | 在不修改长期规则的前提下,临时调整某一段时间的值班人(常用于请假、临时顶班) |
3131
| **日期掩码** | 选择参与值班的时期,比如周一到周五时 A 团队值班,周末是 B 团队值班 |
32+
| **连续轮换** | 开启后,轮换边界以班次开始时间为基准计算,避免班次在 00:00 被拆分。仅在配置日期掩码时支持,详见[日期掩码与连续轮换](#日期掩码与连续轮换) |
3233

3334
![值班表概念图](https://docs-cdn.flashcat.cloud/images/png/3423a4f3133d5caa1f0aaebca970d404.png)
3435

@@ -83,6 +84,37 @@ Flashduty On-call 提供极具灵活性的值班编排能力,支持按天、
8384
建议在正式交接班前,新旧值班人员进行一次简短的同步会,确认遗留问题和当前系统状态,这比单纯的系统通知更安全。
8485
</Tip>
8586

87+
## 日期掩码与连续轮换
88+
89+
---
90+
91+
### 日期掩码
92+
93+
日期掩码用于控制值班规则在一周中的哪些天生效。通过选择不同的星期组合,可以灵活实现工作日与周末的差异化排班。
94+
95+
常见使用场景:
96+
- **工作日/周末分离**:工作日由 A 团队值班,周末由 B 团队值班
97+
- **特定日期值班**:仅在周一、三、五安排某组人员值班
98+
- **白班/夜班按天区分**:工作日配置白班和夜班规则,周末配置全天值班规则
99+
100+
### 连续轮换
101+
102+
默认情况下,排班按照自然日 00:00 进行切分。如果班次跨越午夜,将被拆分为多个时间段。
103+
104+
![简单轮换](https://docs-cdn.flashcat.cloud/images/png/695199d7990bf99cafab58ed10be75a1.png)
105+
106+
开启**连续轮换**后,轮换边界将以班次开始时间为基准计算,而不再以 00:00 为切分点。每位值班成员将完整执行一个轮换周期,不会因 00:00 被拆分。
107+
108+
![连续轮换](https://docs-cdn.flashcat.cloud/images/png/d56eca56d65aa17df67110ad4a0c61a7.png)
109+
110+
<Note>
111+
以下场景建议开启连续轮换:
112+
- 轮换周期为 24 小时
113+
- 班次开始时间不是 00:00
114+
- 配置了按星期掩码排班
115+
- 工作日与周末采用不同轮换规则
116+
</Note>
117+
86118
## 常见排班场景
87119

88120
---

0 commit comments

Comments
 (0)