# 碳信网项目功能说明书

> 本文档基于代码实现分析生成，排除干扰项（Axure原型文件、node_modules、部署脚本等），专注于实际功能。

---

## 一、项目定位

碳信网是一个**碳排放管理、碳资产交易及相关服务的综合平台**，包含：
- **公众门户**（txw-gxzx-web）：面向企业提供碳服务供需、碳金融、碳交易等功能
- **碳门户主页**（txw-mhzc-web）：面向用户的碳服务平台首页
- **运营管理后台**（txw-yygl-web）：运营人员使用的管理后台

---

## 二、功能模块层级图

```
├─ P0 认证模块
│   ├─ 用户名密码登录
│   ├─ 短信验证码登录
│   ├─ OAuth2第三方登录
│   ├─ 登出
│   └─ 会话初始化
│
├─ P0 碳服务供需模块（gxzx）
│   ├─ 供需大厅浏览
│   ├─ 供需信息发布（供给/需求）
│   ├─ 供需收藏
│   └─ 企业标签筛选
│
├─ P0 碳金融模块（lsjr/lsxd）
│   ├─ 金融机构列表（银行/保险）
│   ├─ 金融产品列表
│   ├─ 产品详情查看
│   └─ 金融产品申请（信贷/保险）
│
├─ P0 碳交易模块（lsjy）
│   ├─ 碳资产列表浏览
│   ├─ 碳资产详情
│   ├─ 碳资产发布
│   └─ 碳资产上下架
│
├─ P0 企业入驻模块
│   ├─ 企业注册申请
│   ├─ 企业认证审核
│   └─ 企业入驻审核
│
├─ P1 用户中心
│   ├─ 工作台首页
│   ├─ 账号管理
│   ├─ 我的供给
│   ├─ 我的需求
│   ├─ 绿色交易管理
│   └─ 消息中心
│
├─ P1 运营管理
│   ├─ 用户管理
│   ├─ 轮播图管理
│   ├─ 公告发布管理
│   ├─ 服务供给审核
│   ├─ 需求审核
│   ├─ 绿色金融产品管理
│   ├─ 绿色交易审批
│   └─ 企业审批管理
│
├─ P1 搜索模块
│   ├─ 全局搜索
│   ├─ 热门搜索词
│   ├─ 搜索建议
│   └─ 搜索历史
│
├─ P2 企业出海模块
│   ├─ 电池法案解读
│   ├─ CBAM政策指引
│   └─ 航运燃料专题
│
├─ P2 碳能力平台
│   ├─ 碳核算平台
│   ├─ 碳认证机构
│   ├─ 碳交易平台
│   ├─ 碳金融服务
│   └─ 碳技术咨询
│
└─ P2 勋章系统
    ├─ 勋章配置管理
    ├─ 勋章审核列表
    ├─ 明星管理
    └─ 抽奖记录管理
```

---

## 三、核心功能详解

### 3.1 认证模块（Authentication）

**功能流程：**

```
用户输入账号密码
       │
       ▼
┌─────────────────┐
│  登录表单验证   │ ← 检查图形验证码、短信验证码
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│  调用登录API    │ POST /sso/auth/login
└────────┬────────┘
         │
    成功 │ 失败
    ─────┼─────
         ▼
┌─────────────────┐
│  保存Token      │ 存储到sessionStorage
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│  初始化用户会话 │ POST /mhzc/user/init
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│  跳转首页/工作台 │
└─────────────────┘
```

**API清单：**
| 功能 | 接口 | 说明 |
|------|------|------|
| 账号密码登录 | `POST /sso/auth/login` | |
| 短信验证码登录 | `POST /sso/auth/loginBySMS` | |
| 第三方登录 | `POST /sso/starAuth/login` | mxlogin |
| OAuth2授权 | `POST /oauth2/authorize` | |
| 获取验证码 | `POST /sso/verify/get` | |
| 发送短信 | `POST /sso/auth/sendMsg` | |
| 登出 | `POST /sso/auth/logout` | |
| 会话初始化 | `POST /mhzc/user/init` | 获取用户信息和入驻状态 |

---

### 3.2 碳服务供需模块（供需大厅）

**功能流程：**

```
供需大厅首页
    │
    ├── [供给] ───┬── 服务类型筛选
    │            ├── 行业筛选
    │            ├── 地区筛选
    │            ├── 价格筛选
    │            └── 关键词搜索
    │
    ├── [需求] ───┬── 需求类型筛选（与供给类似）
    │
    └── [发布] ──┬── 检查企业认证状态
                 ├── 未认证 → 提示去认证
                 └── 已认证 → 显示发布表单
                              │
                              ├── 选择类型（供给/需求）
                              ├── 填写标题、服务类型、行业、价格等
                              ├── 设置有效期、联系人信息
                              └── 提交发布
```

**发布字段：**
| 字段 | 说明 | 必填 |
|------|------|------|
| ywlxDm | 业务类型（01供给/02需求） | 是 |
| title | 标题 | 是 |
| fwlx | 服务类型 | 是 |
| sshy | 所属行业 | 是 |
| price | 价格/预算 | 是 |
| qyuuid | 企业UUID | 是 |
| xzqh | 行政区划 | 否 |
| jzsj | 截止时间 | 否 |
| bq | 标签 | 否 |
| lxr | 联系人 | 否 |
| lxfs | 联系方式 | 否 |
| description | 详细描述 | 否 |

**API清单：**
| 功能 | 接口 | 说明 |
|------|------|------|
| 供需列表 | `POST /gxzx/gxdt/gxxxList` | 支持分页、类型筛选 |
| 发布供需 | `POST /gxzx/gxdt/gxfb` | |
| 收藏/取消收藏 | `POST /gxzx/gxdt/gxsc` | type: add/remove |
| 企业标签查询 | `POST /gxzx/gxdt/getQyuuidsByBq` | |
| 代码表查询 | `POST /yygl/cache/v1/list/${tableName}` | fwlx/xqlx/sshy等 |

**模块关系：**
- 供需大厅与企业入驻模块联动：未认证企业不能发布供需信息
- 供需信息需要审核后才能展示（通过运营后台tfwgj/tfwxq审核）

---

### 3.3 碳金融模块（绿色信贷/保险）

**功能流程：**

```
碳金融首页
    │
    ├── [绿色信贷] ───┬── 显示银行机构列表
    │                 └── 查看产品列表
    │
    └── [绿色保险] ───┬── 显示保险机构列表
                      └── 查看产品列表

查看产品详情
    │
    ├── 显示产品信息（额度、期限、利率/保费等）
    └── [立即申请]
            │
            ▼
        申请表单（3步）
            │
            ├── Step1: 填写信息
            │     ├── 企业信息
            │     ├── 联系人信息
            │     └── 碳数据来源选择
            │
            ├── Step2: 上传材料
            │     └── 支持文件上传
            │
            └── Step3: 提交成功
```

**产品详情字段：**
| 字段 | 信贷产品 | 保险产品 |
|------|---------|---------|
| cpname | 产品名称 | 产品名称 |
| cpleixing | 产品类型 | 产品类型 |
| fgje | 最高额度 | 最高保额 |
| qx | 期限 | 保障期限 |
| fl | 费率 | 保费 |
| cppj | 产品配件/附加服务 | |

**API清单：**
| 功能 | 接口 | 说明 |
|------|------|------|
| 金融机构列表 | `POST /gxzx/lsjr/queryJgList` | type: xd/bx |
| 产品列表 | `POST /gxzx/lsjr/queryXdbxcpList` | 分页查询 |
| 产品详情 | `GET /gxzx/lsjr/queryXdbxcpxq` | |
| 信贷申请 | `POST /gxzx/lsjr/saveTbsqxx` | multipart |
| 保险申请 | `POST /gxzx/lsjr/saveTbsqxx` | multipart |

**模块关系：**
- 金融产品管理在运营后台（yygl-web/lscp/LsjrIndex.vue）
- 申请记录查看在运营后台（yygl-web/lscp/LsjrXq.vue）

---

### 3.4 碳交易模块（绿色交易）

**功能流程：**

```
绿色交易大厅
    │
    ├── 资产类型筛选
    │     ├── 绿电绿证（ZC01）
    │     ├── 碳配额（ZC02）
    │     └── CCER（ZC03）
    │
    ├── 价格区间筛选
    │
    └── 有效期筛选

查看资产详情
    │
    └── [联系/申请]
```

**资产发布字段：**
| 字段 | 说明 |
|------|------|
| zclx | 资产类型 |
| sl | 数量 |
| dj | 单价 |
| yxrq | 有效期 |
| zcnf | 资产年份 |
| lxr | 联系人 |
| lxfs | 联系方式 |

**API清单：**
| 功能 | 接口 | 说明 |
|------|------|------|
| 资产类型列表 | `GET /gxzx/lsjy/queryZclxList` | |
| 资产列表 | `POST /gxzx/lsjy/queryZcxxList` | 分页 |
| 资产详情 | `GET /gxzx/lsjy/queryZcxxxq` | |
| 发布/更新资产 | `POST /gxzx/lsjy/saveOrUpdate` | |
| 上下架 | `POST /gxzx/lsjy/zcsxj` | |
| 审批 | `POST /gxzx/lsjy/zcSp` | |
| 删除 | `POST /gxzx/lsjy/delete/${zcid}` | |

**模块关系：**
- 交易资产需要审核（运营后台lsjy审批）
- 与运营后台的绿色交易管理联动

---

### 3.5 企业入驻模块

**功能流程：**

```
企业入口选择
    │
    ├── [企业认证] ← 已有企业资质，申请认证
    │     │
    │     ├── 填写企业信息
    │     │     ├── 企业名称
    │     │     ├── 统一社会信用代码
    │     │     └── 营业执照等资质
    │     └── 提交认证申请
    │           │
    │           ▼
    │     运营后台审核（通过/拒绝）
    │
    └── [企业入驻] ← 新企业申请入驻平台
          │
          ├── 填写入驻信息
          │     ├── 企业基本信息
          │     ├── 联系人信息
          │     └── 期望服务类型
          └── 提交入驻申请
                │
                ▼
          运营后台审核
```

**认证/入驻字段：**
| 字段 | 说明 |
|------|------|
| qymc | 企业名称 |
| tyshxydm | 统一社会信用代码 |
| frdb | 法定代表人 |
| lxr | 联系人 |
| lxfs | 联系方式 |
| qydz | 企业地址 |
| rzxs | 入驻形式 |
| qwlx | 期望服务类型 |

**API清单：**
| 功能 | 接口 | 说明 |
|------|------|------|
| 企业注册 | `POST /gxzx/qyrz/qyrzsq` | gxzx-web |
| 企业注册 | `POST /mhzc/company/register` | mhzc-web |
| 认证申请 | `POST /mhzc/company/register` | |
| 认证列表 | `POST /mhzc/company/getRegisterList` | 运营后台 |
| 认证审核 | `POST /mhzc/company/qyRzSp` | |
| 入驻列表 | `POST /gxzx/qyrz/qyrzList` | |
| 入驻审核 | `POST /gxzx/qyrz/qyrzsp` | |

**模块关系：**
- 企业认证/入驻状态决定用户可用功能
- 状态存储在init接口返回的`gxdtRzbz`字段

---

### 3.6 用户中心

**功能流程：**

```
用户中心首页（工作台）
    │
    ├── 概览统计
    │     ├── 供给数量
    │     ├── 需求数量
    │     └── 交易数量
    │
    ├── 快捷操作
    │     ├── 发布供给
    │     ├── 发布需求
    │     └── 查看更多
    │
    ├── 我的供给列表
    │
    ├── 我的需求列表
    │
    └── 政策新闻/公告
```

**用户中心子模块：**
| 模块 | 功能 |
|------|------|
| 工作台 | 统计概览、快捷操作、我的供给/需求 |
| 账号管理 | 个人信息、密码修改 |
| 企业认证 | 认证状态查询、认证申请 |
| 企业入驻 | 入驻状态查询、入驻申请 |
| 我的供给 | 查看我发布的供给信息 |
| 我的需求 | 查看我发布的需求信息 |
| 绿色交易 | 我发布的碳资产 |
| 消息中心 | 系统公告、我的消息 |

**API清单：**
| 功能 | 接口 | 说明 |
|------|------|------|
| 用户初始化 | `POST /mhzc/user/init` | 获取用户+企业信息 |
| 工作台统计 | `GET /gxzx/gxdt/getStats` | 获取统计数据 |
| 公告列表 | `POST /yygl/xx/getXxByXxflDmPage` | |
| 发布公告 | `POST /yygl/xx/xxfb` | |

---

### 3.7 运营管理模块

**功能流程：**

```
运营管理系统首页
    │
    ├── 企业管理
    │     ├── 企业认证审核 ← 审核企业资质
    │     └── 企业入驻审核 ← 审核入驻申请
    │
    ├── 用户管理
    │     ├── 用户列表 ← 查看所有用户
    │     ├── 冻结/解冻用户
    │     └── 重置密码
    │
    ├── 内容管理
    │     ├── 轮播图管理 ← 首页Banner配置
    │     └── 公告发布管理 ← 系统公告
    │
    ├── 碳服务管理
    │     ├── 服务供给审核 ← 审核供给信息
    │     └── 需求审核 ← 审核需求信息
    │
    ├── 绿色金融管理
    │     ├── 产品管理 ← 增删改金融产品
    │     └── 申请查看 ← 查看信贷/保险申请
    │
    └── 绿色交易管理
          ├── 交易管理 ← 查看/上下架资产
          └── 交易审批 ← 审核新发布资产
```

**审核流程：**
```
用户提交申请
    │
    ▼
运营后台显示待审核列表
    │
    ▼
运营人员查看详情
    │
    ├── [通过] → 更新状态为已通过
    │            信息公开展示
    │
    └── [拒绝] → 填写拒绝原因
                 更新状态为已拒绝
                 用户可修改后重新提交
```

**API清单：**
| 功能 | 接口 | 说明 |
|------|------|------|
| 认证审核 | `POST /mhzc/company/qyRzSp` | |
| 入驻审核 | `POST /gxzx/qyrz/qyrzsp` | |
| 服务审核 | `POST /gxzx/gxdt/gxsp` | ywlxDm=01 |
| 需求审核 | `POST /gxzx/gxdt/gxsp` | ywlxDm=02 |
| 交易审批 | `POST /gxzx/lsjy/zcSp` | |
| 用户列表 | `POST /mhzc/user/getAllUser` | |
| 冻结用户 | `POST /mhzc/user/lockUser` | |
| 解冻用户 | `POST /mhzc/user/unlockUser` | |
| 重置密码 | `POST /sso/auth/resetPassword` | |

---

### 3.8 搜索模块

**功能流程：**

```
搜索入口
    │
    ├── 输入关键词
    │     │
    │     ├── 显示搜索建议（下拉提示）
    │     │
    │     └── 回车/点击搜索
    │           │
    │           ▼
    │     搜索结果页
    │           │
    │           ├── 按类型分类展示
    │           │     ├── 资讯
    │           │     ├── 企业
    │           │     ├── 产品
    │           │     └──供需信息
    │           │
    │           └── 热门搜索词展示
    │
    └── 热门搜索词点击直接搜索
```

**API清单：**
| 功能 | 接口 | 说明 |
|------|------|------|
| 全局搜索 | `GET /mhzc/search` | keyword, categoryType |
| 热门搜索 | `GET /mhzc/search/hot` | |
| 搜索建议 | `GET /mhzc/search/suggest` | keyword |
| 搜索历史 | `GET /mhzc/search/history` | |
| 清除历史 | `DELETE /mhzc/search/history` | |

---

### 3.9 企业出海模块

**功能流程：**

```
企业出海专题页
    │
    ├── [电池法案] ← EU Battery Act
    │     ├── 政策要求
    │     ├── 合规指引
    │     └── 案例分享
    │
    ├── [CBAM] ← Carbon Border Adjustment Mechanism
    │     ├── 政策解读
    │     ├── 合规指引
    │     └── 案例分析
    │
    └── [航运燃料] ← Shipping Fuel
          ├── 政策要求
          ├── 合规指引
          └── 案例分享
```

**模块关系：**
- 企业出海模块与碳服务供需模块独立
- 不涉及交易流程，仅信息展示
- 提供合规服务申请入口

---

### 3.10 碳能力平台

**功能流程：**

```
碳能力平台首页
    │
    ├── [碳核算平台] ← 碳核算机构目录
    │
    ├── [碳认证机构] ← 碳认证服务目录
    │
    ├── [碳交易平台] ← 碳交易机构目录
    │
    ├── [碳金融服务] ← 碳金融服务机构
    │
    └── [碳技术咨询] ← 碳技术咨询服务
```

**模块关系：**
- 仅做机构展示
- 点击可查看机构详情
- 不涉及交易流程

---

### 3.11 勋章系统（mhcz-web特有）

**功能流程：**

```
勋章管理（运营后台）
    │
    ├── 勋章配置
    │     ├── 配置勋章名称、图标、规则
    │     └── 配置勋章状态（启用/停用）
    │
    ├── 勋章审核
    │     ├── 查看用户申请列表
    │     └── 审核通过/拒绝
    │
    └── 勋章模板
          ├── 管理勋章模板
          └── 模板明细查询

明星管理
    │
    ├── 明星列表
    │     ├── 明星基本信息
    │     └── 明星认证状态
    │
    └── 期望明星统计
          └── 统计分析用户期望的明星
```

**API清单：**
| 功能 | 接口 | 说明 |
|------|------|------|
| 勋章配置列表 | `POST /yhzxApi/xz/getXzpzList` | |
| 勋章审核列表 | `POST /yhzxApi/xz/getXzsqList` | |
| 明星列表 | `POST /yhzxApi/user/getStarList` | |
| 创建明星 | `POST /yhzxApi/user/createStar` | |
| 抽奖记录 | `POST /yhzxApi/shdz/getCjjlPage` | |

---

## 四、模块间关系图

```
                    ┌──────────────┐
                    │   SSO认证    │
                    │   系统       │
                    └──────┬───────┘
                           │ 所有模块依赖
            ┌──────────────┼──────────────┐
            ▼              ▼              ▼
     ┌──────────┐  ┌──────────┐  ┌──────────┐
     │ gxzx-web │  │ mhzc-web │  │ yygl-web │
     └────┬─────┘  └────┬─────┘  └────┬─────┘
          │             │             │
          ▼             ▼             ▼
    ┌──────────┐  ┌──────────┐  ┌──────────┐
    │ 供需大厅  │  │ 服务中心  │  │ 运营管理  │
    │ 碳金融    │  │ 用户中心  │  │ 企业审核  │
    │ 碳交易    │  │ 碳交易市场 │  │ 内容管理  │
    └──────────┘  └──────────┘  └──────────┘
                           │
                           ▼
                    ┌──────────────┐
                    │ 企业入驻模块  │
                    │ (共享)        │
                    └──────────────┘
```

**依赖关系说明：**

| 模块 | 依赖模块 | 说明 |
|------|---------|------|
| 供需大厅 | 企业入驻 | 未认证不能发布 |
| 碳金融 | 企业入驻 | 申请需要企业信息 |
| 碳交易 | 企业入驻 | 发布需要企业信息 |
| 用户中心 | 认证模块 | 需要登录态 |
| 运营管理 | 认证模块 | 需要管理员权限 |
| 运营管理 | 企业入驻 | 审核入驻申请 |

---

## 五、数据流概览

### 5.1 用户会话数据

```
登录 → sessionStorage['yhxx']
         │
         ├── userId
         ├── username
         ├── companyUuid
         ├── gxdtRzbz (企业认证状态)
         └── ... 其他用户信息
```

### 5.2 核心数据状态

| 状态字段 | 说明 | 影响功能 |
|---------|------|---------|
| gxdtRzbz | 企业认证状态 | 供需发布、金融申请 |
| qyrzSpzt | 入驻审核状态 | 企业入驻功能 |
| sjfwZt | 上下架状态 | 信息是否展示 |

### 5.3 审核流程数据

```
提交申请
    ↓
pending (待审核)
    ↓
approved/rejected (通过/拒绝)
    ↓
if approved → 公开显示
if rejected → 可修改重提交
```

---

## 六、功能优先级汇总

### P0 - 核心功能（系统运行必需）

| 模块 | 功能 | 说明 |
|------|------|------|
| 认证 | 账号密码登录 | 基础认证 |
| 认证 | 会话初始化 | 获取用户权限信息 |
| 供需 | 供需大厅浏览 | 核心业务入口 |
| 供需 | 供需发布 | 核心业务操作 |
| 金融 | 产品列表/详情 | 金融业务入口 |
| 金融 | 金融申请 | 核心业务操作 |
| 交易 | 碳资产交易 | 核心业务 |
| 企业入驻 | 企业注册/认证 | 基础业务 |

### P1 - 重要功能（业务完整性）

| 模块 | 功能 | 说明 |
|------|------|------|
| 运营管理 | 企业审核 | 运营基础功能 |
| 运营管理 | 内容管理 | 运营基础功能 |
| 运营管理 | 用户管理 | 运营基础功能 |
| 用户中心 | 工作台 | 用户入口 |
| 搜索 | 全局搜索 | 信息检索 |

### P2 - 扩展功能（增值服务）

| 模块 | 功能 | 说明 |
|------|------|------|
| 企业出海 | CBAM解读 | 增值服务 |
| 碳能力平台 | 机构目录 | 增值服务 |
| 勋章系统 | 勋章管理 | 用户激励 |

---

## 七、接口前缀汇总

| 前缀 | 后端服务 | 用途 |
|------|---------|------|
| `/sso/*` | txw-sso | 认证服务 |
| `/mhzc/*` | txw-mhzc | 碳门户服务 |
| `/gxzx/*` | txw-gxzx | 可信碳信息服务 |
| `/yygl/*` | txw-yygl | 运营管理服务 |
| `/yhzxApi/*` | txw-mhzc | 用户中心API |
| `/ggzcApi/*` | txw-common | 公共API |

---

*文档生成时间: 2026-05-03*
*基于代码实现分析生成，排除干扰项*