# 勋章与低碳账户管理后台需求说明

## 1. 后台目标

管理后台用于支撑 App 端五维勋章系统的运营配置、规则发布、碳计算、奖品兑换、弹窗海报和数据监控。后台对应昨晚版本 App 原型，即 `prototypes/` 目录内的页面风格和功能结构。

后台原型入口：`admin_prototypes/index.html`

## 2. 页面清单

| 页面 | 文件 | 用途 |
| --- | --- | --- |
| 运营总览 | `admin_prototypes/01_dashboard.html` | 查看发放量、减碳量、积分、兑换、异常 |
| 勋章配置 | `admin_prototypes/02_badge_config.html` | 配置五维勋章门槛、名称、事件、发放策略 |
| 碳规则配置 | `admin_prototypes/03_carbon_rules.html` | 配置减碳公式、树木换算、积分和会员系数 |
| 兑换商城 | `admin_prototypes/04_rewards_store.html` | 配置碳积分奖品、库存、限兑和上下架 |
| 弹窗与海报 | `admin_prototypes/05_popup_poster.html` | 配置获得弹窗、分享海报、变量文案 |
| 埋点监控 | `admin_prototypes/06_event_monitor.html` | 查看触发日志、重复拦截和补发链路 |

## 3. 碳计算配置

### 3.1 基础减碳公式

后台应支持配置每公里减碳系数，不在 App 端写死。

```text
本次减碳 kg = 本次有效骑行公里数 × 每公里减碳系数
```

示例配置：

| 配置项 | 示例值 | 说明 |
| --- | --- | --- |
| 每公里减碳系数 | 0.120 kg/km | 可由运营根据城市交通替代口径调整 |
| 最小计入里程 | 0.1 km | 低于该值不计入减碳 |
| kg 展示精度 | 保留 2 位 | 用于 App 展示 |
| g 积分精度 | 取整数 | 用于碳积分发放 |

### 3.2 1 棵树等于多少碳

后台需要提供“树木固碳量”配置项，用于 App 端趣味类比文案。

默认建议：

```text
1 棵树 = 0.5 kg CO₂ / 天
```

计算公式：

```text
树木等效数量 = 用户累计减碳量 kg ÷ 单棵树固碳量 kg
```

示例：

```text
累计减碳 12.8kg ÷ 0.5kg/棵/天 = 25.6 棵
App 文案：相当于种植 25.6 棵大树
```

后台配置字段：

| 字段 | 类型 | 示例 | 说明 |
| --- | --- | --- | --- |
| `tree_carbon_value` | number | 0.5 | 单棵树固碳量 |
| `tree_carbon_unit` | enum | kg_per_tree_per_day | kg/棵/天 或 kg/棵/年 |
| `tree_copy_period` | enum | day | 按日或按年口径展示 |
| `tree_rounding_rule` | enum | smart_1_decimal | 小于 1 保留 1 位，大于等于 1 取整数 |
| `tree_copy_template` | string | 相当于种植 {tree_count} 棵大树 | App 展示模板 |

说明：0.5kg/棵/天是运营展示口径，应在后台可配置。后续如采用乌兰巴托本地林业、公益林项目或 ESG 审计口径，只需要调整后台参数和版本生效时间。

## 4. 碳积分规则

```text
本次碳积分 = 本次减碳克数 × 会员系数
```

默认配置：

| 用户等级 | 碳积分系数 |
| --- | --- |
| 普通用户 | 1.0 |
| 白银会员 | 1.0 |
| 黄金会员 | 1.0 |
| 黑钻会员 | 1.2 |

示例：

```text
普通用户减碳 320g，获得 320 碳积分
黑钻用户减碳 320g，获得 384 碳积分
```

## 5. 后台发布机制

规则配置需要支持版本管理：

| 能力 | 说明 |
| --- | --- |
| 保存草稿 | 编辑后不影响线上 |
| 立即发布 | 发布后新骑行订单按新规则计算 |
| 定时发布 | 指定生效时间 |
| 回滚版本 | 出现配置错误时回滚到上一版本 |
| 操作审计 | 记录操作人、时间、变更字段 |

## 6. 验收标准

1. 运营可在后台调整每公里减碳系数。
2. 运营可配置 1 棵树对应多少 kg CO₂，以及按日/按年展示口径。
3. App 的树木类比文案从后台配置读取，不在客户端写死。
4. 运营可配置黑钻会员碳积分 1.2 倍加成。
5. 勋章门槛、名称、达成文案和触发事件可配置。
6. 兑换奖品支持库存、限兑、会员范围和上下架。
7. 弹窗与分享海报支持变量模板。
8. 埋点监控能查询触发日志、重复拦截和补发记录。