txw/docs/功能说明书.md

21 KiB
Raw Blame History

碳信网项目功能说明书

本文档基于代码实现分析生成排除干扰项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 基于代码实现分析生成,排除干扰项