综合能源用能计费系统需求说明书.pdf

用能计费系统用能计费系统需求说明书需求说明书文件编号生效日期受控编号保密级别二级版 本 号V1.00修改状态V1.00总 页 数正文附录编制审核批准评审评审记录记录评审记录：评审人员签字：问题修改验证结果：验证人签字：时间：年月日变更日志编号版本修改内容修改人修改日期12目录目录1引言.11.1目的.12概述.12.1产品/版本描述.12.2系统功能需求结构图.23具体需求.23.1微信公众号.23.1.1个人中心.23.1.2营业厅.33.2后付费电表分时计费功能.63.2.1账户管理.63.2.2账单管理.73.2.3仪表管理.83.2.4参数管理.83.3充值加密.103.3.1系统充值加密.103.3.2外部接口校验.103.4主要技术指标【V1.4.2-014】.103.5非功能性要求.11用能计费系统需求说明书11 引言引言1.1目的目的本文的描述对象是用能计费系统 V1.4.2 需求，用于产品部定义产品、研发部作需求规格说明书及软件设计的指导说明，提供了产品的范围、界定及系统功能描述。该文档使用对象包括与该项目相关的产品经理、产品工程师、架构师、需求分析专员、研发工程师、测试工程师及项目经理等。2 概述概述2.1产品产品/版本描述版本描述V1.4.2 基于 V1.4.1 的基础，主要规划微信自助查询缴费、后付费电表分时计费和系统充值加密的功能，同时基于 V1.4.1 做一些功能优化，主要是系统查询功能优化、首页组件优化及新增组件、充缴管理优化、外部充值接口增加校验。有越来越多的目标客户、售前同事反馈了希望商户能通过移动端进行自助充值缴费、自助用能查询的需求。移动端的应用目前最主流的有 APP 与微信公众号。由于微信公众号开发和维护成本低、不占手机内存、不需要不断升级、借助于微信的账户和生态体系容易推广等优点，最终选用微信公众号的方式实现移动端的充值缴费功能。V1.4.2 亮点主要是：1.增加了移动端自助查询和充值缴费的功能，为商户交费提供了便利；2.增加了后付费电表分时计费的功能，满足现有市场的需求；3.增加了系统充值加密功能，提高系统的安全性，为客户提供全面的安全保障。其中 V1.4.2 在开发过程中将软件切分成最小的独立单元模块，开发时按单元模块逐一进行开发与测试，在开发过程中遇到项目上有定制需求时，要求能迅速完成当前单元模块的开发测试工作，然后切换到定制需求的开发中，定制需求完成后，开发团队可回到 1.4.2 版本继续新的单元模块的开发工作。若因定制需求较多影响了项目进度，则可申请项目延期。用能计费系统需求说明书22.2系统功能需求结构图系统功能需求结构图其中一级标题为 V1.4.2，二级标题为微信、后付费电表分时计费、系统充值加密、功能优化。二级标题前面的数字代表此功能计划在 V1.4.2 的哪个阶段实现，三级标题前面的数字代表此功能在二级标题的哪个阶段实现。以上内容以最终稿为准。3 具体需求具体需求3.1微信公众号微信公众号3.1.1个人中心个人中心3.1.1.1我的账号我的账号【V1.4.2-001】功能说明功能说明微信用户通过微信浏览器窗口使用微信公众号提供的菜单，不同的菜单类型操作方式不同。如果要查看某用户某一天的用量、账单等账户信息，需进行身份验证，将用户的微信号与要查看的账户信息绑定。微信号与账户信息绑定是用户通过微信查看账户信息的前提条件，微信号与账户信息绑定的入口提供两种方式：第一种，用户尚未绑定时，点击微信菜单“营业厅”下“用量查询”、“账单查询”、“充值缴费”、“充缴记录”菜单时，跳转到账户绑定的界面；第二种，用户尚未绑定时，点击微信菜单“个人中心”下“我的账户”菜单时，以回复绑定链接的方式提示用户，用户点击链接可以进入到账户绑定的页面。用户初次绑定账户信息，需要输入账号（计费系统中已经开户的账号），手机号，点击获取验证码，输入 6 位数字验证码后，点击确认绑定，系统会对用户提交的身份信息进行验证，若验证成功，则提示：“绑定成功，您可以到微信继续使用服务！”若验证失败，提示验证失败的原因。验证成功或者失败页面，提供返回按钮方便用户返回到微信对话界面。绑定用能计费系统需求说明书3成功后，点击个人中心等页面，均无需再重新登录。账户信息包括账号、账户名称、联系电话、通讯地址。一个用户支持绑定多个账户信息，支持将其中某一个账户信息作为默认账户，支持删除某个账户信息。一个用户绑定多个账户信息时，点击“绑定新账户”，输入账号、手机号及验证码即可。用户同时只能显示一个账户的信息。微信号与账户信息的解绑可通过取消关注微信公众号后自动解除绑定，也可通过在个人中心删除对应的账户信息手动解除绑定。如在计费系统中做过加绑、解绑操作，实时更新在微信端，如在计费系统中销户，则在微信端绑定的账户关系自动解除。对微信公众号重新关注后，仍保留之前绑定过的账户信息，显示默认账户的信息，如该账户在计费系统中已销户，重新关注后则不再显示该账户的信息。如需新增账户信息，进入我的账户页面，点击“绑定新账户”。3.1.2营业厅营业厅3.1.2.1充值缴费充值缴费【V1.4.2-002】功能说明点击充值缴费进入充值缴费查询页面，提供“结算类型”的查询条件。“结算类型”为预付费和后付费。预付费结算类型支持能源类型为电的充值操作，后付费结算类型支持能源类型为电、水、气的缴费操作。若结算类型选择预付费，则查询结果页面为预付费充值页面，预付费支持合并充值，进入充值页面默认所有房间全部勾选，用户可根据需要反勾选不需要充值的房间，每个房间的预存金额根据输入充值金额和选择的分配策略实时变化，确保选中房间的预存金额之和等于输入充值金额。查询结果上方提供输入充值金额以及选择分配策略，充值金额需大于零且不得低于系统判断精度，分配策略分为“按三个月比例分摊、平均分摊、无”；查询结果下方分别显示该账户绑定预付费电表的房间名称、当前余额以及预存金额。充值金额分配完成后，点击微信支付，输入支付密码确认支付。充值命令下发后，需保证系统在 24 小时内充值成功，若充值异常/失败，则进入计费系统待处理事项页面，系统页面不提供人工重试，24 小时（可配置）内系统自动重试，24 小时内系统未重试成功，则认为本次充值失败，充值金额将原路退回，此操作由微信端实现。充值异常/失败需要发送短信给物业管理人员，提醒物业排查充值异常/失败的原因并及时处理。若结算类型选择后付费，则查询结果页面为后付费缴费页面，后付费支持合并缴费，查询结果上方提供账单费用总计、钱包余额、应缴总金额，账单费用总计统计勾选的账单的总金额，应缴总金额为账单费用总计减去钱包余额的费用；查询结果下方分别显示该账户绑定后付费仪表的房间名称、账单费用及能源类型，默认勾选所有账单。确认需要缴费的账单后，点击微信支付，输入支付密码确认支付。缴费命令下发后，需保证系统在 24 小时内缴费成功！若缴费失败，则页面提示缴费失败，请稍后重试！用能计费系统需求说明书4充值缴费成功后均在系统中生成相应的充缴记录。充值缴费功能在每天晚上十点十点，关闭充值缴费入口，点击微信页面“充值缴费”，提示支持充值缴费的时间；每天早晨六点六点，打开充值缴费入口，支持充值缴费操作，时间可设置。3.1.2.2充缴记录充缴记录【V1.4.2-003】功能说明点击充缴记录进入充缴记录查询页面，提供“结算类型”、“房间名称”、“查询时间”的查询条件。“结算类型”为预付费和后付费。“查询时间”提供快捷查询近一个月的充缴记录，也提供可供选择时间范围的开始时间和结束时间，支持最多查询一年（一年为顺延年）的充缴记录。用户查询的充缴记录为系统中所有的充缴记录，包含系统充缴记录和微信充缴记录，不包含扣费记录。若结算类型选择预付费，选中需要查询的房间名称，选择要查询的时间范围，点击查询，页面显示查询时间范围内的充值记录，列表包含房间名称、操作金额、操作来源以及操作时间。若结算类型选择后付费，选中需要查询的房间名称，选择要查询的时间范围，点击查询，页面显示查询时间范围内的缴费记录，列表包含房间名称、操作来源、操作金额以及操作时间。点击单行可查看此条缴费记录的详情，再次点击关闭此条缴费记录的详情。缴费记录详情列表包含账单周期、能源类型、账单费用三个字段。若输入查询条件未查询到相关信息，页面需反馈“未搜索到与查询条件匹配的结果！”3.1.2.3账单查询账单查询【V1.4.2-004】功能说明点击账单查询进入账单查询页面，提供“房间名称”、“结算类型”、“能源类型”以及查询时间的查询条件。“房间名称”为该账户绑定的房间名称，“结算类型”为预付费和后付费，“能源类型”为电、水、气，查询时间跨度不能超过一年（一年为顺延年）。预付费结算类型只支持查询能源类型为电的账单信息，后付费结算类型支持查询能源类型为电、水、气的账单信息。选中房间名称后，若结算类型选择预付费，则能源类型只显示电，选择要查询的时间范围，点击查询，页面显示账户基础信息，包括账号、账户名称以及房间名称，账户基础信息下方显示查询时间范围内的预付费用电账单，点击单行可查看此条账单的详情，再次点击关闭此条账单的详情。账单列表包含账单时间、当期电量（千瓦时）、当期电费（元）三个字段，账单详情的列表包含账单周期，分类、期初示数、期末示数、本期用量、单价、本期费用字段，分类主要是尖、峰、平、谷与合计，若分类为合计，则单价列显示“-”。如有调价的情况，则以调价前后的时间区间生成两条账单详情，详见交互。若结算类型选择后付费，能源类型选择电，选择要查询的时间范围，点击查询，页面显示账户基础信息，包括账号、账户名称以及房间名称，账户基础信息下方显示查询时间范围内的后付费用电账单，点击单行可查看此条账单的详情，再次点击关闭此条账单的详情。用能计费系统需求说明书5账单列表包含账单时间、当期电量（千瓦时）、当期电费（元）三个字段，账单详情的列表包含账单周期，分类、期初示数、期末示数、本期用量、单价、本期费用字段，分类主要是尖、峰、平、谷、滞纳金、公摊费以及合计，滞纳金和公摊费的金额根据计费系统发布的账单为准，分类为合计，则单价列显示“-”，分类为滞纳金和公摊费时，只在本期费用栏显示，其他栏显示“-”。如有调价的情况，则以调价前后的时间区间生成两条账单详情，详见交互。针对计费系统中后付费配置平价模板的情况，微信页面的后付费账单详情列表包含账单周期，分类、期初示数、期末示数、本期用量、单价、本期费用字段，分类主要是总、滞纳金、公摊费以及合计，滞纳金和公摊费的金额根据计费系统发布的账单为准，分类为合计、滞纳金和公摊费时，只在本期费用栏显示，其他栏显示“-”。如有调价的情况，则以调价前后的时间区间生成两条账单详情，详见交互。若结算类型选择后付费，能源类型选择水，选择要查询的时间范围，点击查询，页面显示账户基础信息，包括账号、账户名称以及房间名称，账户基础信息下方显示查询时间范围内的后付费用水账单，点击单行可查看此条账单的详情，再次点击关闭此条账单的详情。账单列表包含账单时间、当期水量（吨）、当期水费（元）三个字段，账单详情的列表包含账单周期，分类、期初示数、期末示数、本期用量、单价、本期费用字段，分类主要是总、滞纳金、公摊费以及合计，滞纳金和公摊费的金额根据计费系统发布的账单为准，分类为合计、滞纳金和公摊费时，只在本期费用栏显示，其他栏显示“-”。如有调价的情况，则以调价前后的时间区间生成两条账单详情，详见交互。若结算类型选择后付费，能源类型选择气，选择要查询的时间范围，点击查询，页面显示账户基础信息，包括账号、账户名称以及房间名称，账户基础信息下方显示查询时间范围内的后付费用气账单，点击单行可查看此条账单的详情，再次点击关闭此条账单的详情。账单列表包含账单时间、当期气量（立方米）、当期气费（元）三个字段，账单详情的列表包含账单周期，分类、期初示数、期末示数、本期用量、单价、本期费用字段，分类主要是总、滞纳金、公摊费以及合计，滞纳金和公摊费的金额根据计费系统发布的账单为准，分类为合计、滞纳金和公摊费时，只在本期费用栏显示，其他栏显示“-”。如有调价的情况，则以调价前后的时间区间生成两条账单详情，详见交互。若输入查询条件未查询到相关信息，页面需反馈“未搜索到与查询条件匹配的结果！”3.1.2.4用量查询用量查询【V1.4.2-005】功能说明点击用量查询进入用量查询页面，显示账户基本信息，提供“房间名称”、“结算类型”、“能源类型”以及“查询时间”的查询条件。“结算类型”为预付费和后付费，“能源类型”为电、水、气，“，查询时间跨度不能超过一个月（一个月为非自然月）。预付费结算类型只支持查询能源类型为电的用量信息，后付费结算类型支持查询能源类型为电、水、气的用量信息。选中房间名称后，若结算类型选择预付费，则能源类型只显示电，输入开始时间和结束时间，点击查询，页面显示查询时间范围内总的用电量折线图，点击尖、峰、平、谷、总五用能计费系统需求说明书6个字，折线图会根据选择显示相应的用电量，支持多选，默认显示总；折线图下方显示查询时间范围内每日尖、峰、平、谷、总的用电量，通过列表的形式展示；列表下方提示：以上数据信息仅供参考，如出现某日无用电量的现象，可能是由于网络等原因导致系统未采集到数据。若结算类型选择后付费，能源类型选择电，输入开始时间和结束时间，点击查询，页面显示查询时间范围内总的用电量折线图，点击尖、峰、平、谷、总五个字，折线图会根据选择显示相应的用电量，支持多选，默认显示总；折线图下方显示查询时间范围内每日尖、峰、平、谷、总的用电量，通过列表的形式展示；列表下方提示：以上数据信息仅供参考，如出现某日无用电量的现象，可能是由于网络等原因导致系统未采集到数据。针对计费系统中后付费配置平价模板的情况，微信页面的后付费用量查询页面显示查询时间范围内的用电量折线图，折线图下方显示查询时间范围内每日的用电量，通过列表的形式展示，列表下方提示：以上数据信息仅供参考，如出现某日无用电量的现象，可能是由于网络等原因导致系统未采集到数据。若选择结算类型为后付费，能源类型选择水，输入开始时间和结束时间，点击查询，页面显示查询时间范围内的用水量折线图，折线图下方显示查询时间范围内每日的用水量，通过列表的形式展示，列表下方提示：以上数据信息仅供参考，如出现某日无用水量的现象，可能是由于网络等原因导致系统未采集到数据。若选择结算类型为后付费，能源类型选择气，输入开始时间和结束时间，点击查询，页面显示查询时间范围内的用气量折线图，折线图下方显示查询时间范围内每日的用气量，通过列表的形式展示，列表下方提示：以上数据信息仅供参考，如出现某日无用气量的现象，可能是由于网络等原因导致系统未采集到数据。若输入查询条件未查询到相关信息，页面需反馈“未搜索到与查询条件匹配的结果！”3.2后付费电表后付费电表分时计费功能分时计费功能3.2.1账户管理账户管理3.2.1.1账户查询账户查询【V1.4.2-007】功能说明功能说明根据系统配置的后付费电表费率类型，若是平价则只显示总的实时能耗读数，若是分时，则显示分时计费的实时能耗读数；交互图交互图分时计费实时能耗读数查询：用能计费系统需求说明书7注：交互原型只是粗略的初设，后期成品可能会有微调。3.2.2账单管理账单管理3.2.2.1账单查询账单查询【V1.4.2-008】功能说明功能说明后付费自定义账单查询列表增加操作，点击操作可以查看后付费电表分时详情；后付费客户结算账单详情页面增加查看分时详情，点击分时详情可以查看后付费电表分时详情；若是配置后付费平价模板，则维持 V1.4.1 的页面展示状态。交互图交互图后付费能源类型为电的自定义账单增加操作，点击操作内查看更多显示分时详情：分时详情展示形式参照预付费电表的弹出框内容：用能计费系统需求说明书8后付费能源类型为电的客户结算账单详情页增加查看分时详情，点击可查看账单时间内该房间能源类型为电的分时详情：分时详情展示形式参照预付费电表的弹出框内容。3.2.3仪表管理仪表管理3.2.3.1实时抄表实时抄表【V1.4.2-009】功能说明功能说明仪表管理的实时抄表页面增加查询后付费电表分时计费的查询结果列表；若是配置后付费平价模板，则维持 V1.4.1 的页面展示状态。交互图交互图3.2.4参数管理参数管理3.2.4.1费率模板费率模板【V1.4.2-010】功能说明功能说明费率模板管理的筛选条件增加结算类型，结算类型分为全部、预付费、后付费，费率模板列表增加结算类型，结算类型选预付费时，能源类型只有电，模板类型只支持分时模板；用能计费系统需求说明书9结算类型选后付费时，能源类型可选全部、电、水、气，能源类型选电时，模板类型可选择平价模板、也可选择分时模板，能源类型选择水、气时，模板类型只支持平价模板。新增模板页面增加校验，当费率设置和费率时段不一致时，点击“确认”按钮，模板保存失败，比如设置了尖的费率，时段类型均为尖，则保存成功，如果设置尖峰平谷的费率，时段类型均为尖，则保存失败。3.2.4.2参数设置参数设置【V1.4.2-011】功能说明功能说明增加模板类型的选择，模板类型分为平价模板和分时模板。后付费电表可绑定分时模板；交互图交互图用能计费系统需求说明书103.3充值加密充值加密3.3.1系统充值加密系统充值加密3.3.1.1系统充值加密系统充值加密【V1.4.2-012】功能说明功能说明Web 到 WebService 之间通过 MD5 消息摘要算法实现，WebService 到电表之间通过硬件优盘加密实现；3.3.2外部外部接口校验接口校验3.3.2.1外部接口校验外部接口校验【V1.4.2-013】功能说明功能说明外部接口增加校验的实现方式是在代码中增加账户校验。3.4主要技术指标主要技术指标【V1.4.2-014】性能描述性能描述备注备注1 1、系统系统容量容量N/AN/A1实时数据库支持的数据点总数（单套服务器）300,000 点2实时数据库支持的遥控15,000 点3实时数据库支持的计算量10,000 点4历史数据库采样数据点个数100,000 点5存储时间5 年6数据采集器数量50 个超过50个场景可通过级联或者后续版本改进方式完成；2 2、数据数据采 集 与采 集 与展示展示数据数据采集采集1开关量变位传送时间（采集器到系统页面）3 s需保证通讯正常2模拟量数据刷新时间（采集器到系统页面）3 s需保证通讯正常3告警刷新时间（采集器到系统页面）3 s需保证通讯正常4采样数据储存最小间隔5min5能耗数据储存最小间隔10min页面页面响应响应1页面切换、调用响应时间3 s2统计性数据查询响应时间10 s3分析性数据查询响应时间10 s4诊断性数据查询响应时间10 s用能计费系统需求说明书113 3、控制控制类类N/AN/A1充值执行时间10s单个设备，需保证通讯正常2控制执行时间8 s需保证通讯正常3控制操作正确率100%需保证通讯正常4控制成功率99%需保证通讯正常4 4、负荷负荷率率N/AN/A1服务器 CPU 平均负荷率（正常运行任意30min 内）302服务器 CPU 平均负荷率（系统故障 10s 内）503网络负荷率（正常运行任意 30min 内）304网络负荷率（系统故障 10s 内）403.5非功能性要求非功能性要求3.5.1.1接口要求接口要求【V1.4.2-015】账户绑定、账单查询、用量查询、充值缴费、充缴记录查询等业务需要系统提供对应的服务接口。对未来可能新增的业务种类有计划预留技术接口。3.5.1.2模块化开发测试要求模块化开发测试要求【V1.4.1-017】V1.4.2 在开发过程中需将软件切分成最小的独立单元模块，开发时按单元模块逐一进行开发与测试，在开发过程中遇到项目上有定制需求时，要求能迅速完成当前单元模块的开发测试工作，然后切换到定制需求的开发中；定制需求完成后，开发团队可回到 V1.4.2 版本继续新的单元模块的开发工作。若因定制需求较多影响了项目进度，则可申请项目延期。3.5.1.3系统升级维护要求系统升级维护要求【V1.4.1-018】后续版本升级优化时需能实现平滑升级；若遇到项目定制需求将就在该主版本基础上定制，可对相关的最小独立单元模块进行定制修改，并替换原有单元模块实现系统无缝对接，绝对不能再出现版本之间不兼容、定制版本数量太多难以维护等情况。