txw/docs/功能说明书.md

739 lines
21 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 碳信网项目功能说明书
> 本文档基于代码实现分析生成排除干扰项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
│ └── CCERZC03
├── 价格区间筛选
└── 有效期筛选
查看资产详情
└── [联系/申请]
```
**资产发布字段:**
| 字段 | 说明 |
|------|------|
| 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*
*基于代码实现分析生成,排除干扰项*