# token-conf-iwut.app

**Repository Path**: TokenTeam/token-conf-iwut.app

## Basic Information

- **Project Name**: token-conf-iwut.app
- **Description**: Config repo of iwut app.
- **Primary Language**: Unknown
- **License**: GPL-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-03-17
- **Last Updated**: 2025-12-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 掌理配置库

## 概览

- 配置全部为json文件
- 通过key区分不同配置，在config文件夹下，每个key对应一个文件夹
- 每个key的默认配置文件为"{key}.json"
- 可通过添加platform配置为不同的平台添加不同的配置，如"{key}.ios.json"

## 文件层级

所有配置文件都存放在config目录的子目录中，如：

```
config
  - app
    - app.json
    - app.ios.json
  - schedule
    - schedule.json
```

config目录下每个子目录都被视为一个key，也是配置更新与获取的最小粒度。例如，'app'目录下的任何一个文件更改，都会触发端上对'app'配置的全量刷新。

> 出于以上更新策略，建议将常更新和不常更新的配置分到不同的key进行存储

## 平台特有配置

在每个子目录中，同名json为默认配置。除此之外，还可以添加若干平台特有配置，如`*.ios.json`, `*.android.json`, `*.harmony.json`等。平台id对应端上请求时的`iwut-platform`请求头。

配置中心在进行处理时，会将默认配置和平台特有配置进行合并。合并的行为有以下两种：

- 覆盖：值为数值、字符串、对象的，平台配置覆盖默认配置。但`null`不会覆盖掉默认配置；
- 合并：值为数组的，将平台配置和默认配置合并；

基本原则为平台配置优先于默认配置。当平台配置文件不存在时，则使用默认配置。

## 更新配置的流程
1. 拉取`main`分支最新配置
2. 新建分支，在分支上做配置修改
3. 提交新分支，通过PR合入`dev`分支
4. 等待测试环境自动更新配置，在测试环境进行测试
5. 若测试通过，通过PR合入`main`分支；若不通过，重新修改
6. 等待生产环境自动更新配置，监测生产环境状态，若发生异常，执行回滚