有范云协作

让项目的协作姿势更有范儿!

交互阶段说明

交互阶段主要由交互设计师根据产品方的需求对产品进行行为设计和界面设计的阶段,这个阶段的主要产出物为交互设计稿,在这个阶段开发工程师需要做的事情是针对产品需求、交互设计稿中的内容进行技术评审,为产品方、交互设计师提供可行技术实现解决方案,对于多种不同解决方案需针对各种解决方案做分析说明,务必准确传达各种方案的优缺点,并根据需求给出建议方案。

系统设计说明

系统设计阶段主要是各端开发工程师针对产品需求说明、交互设计稿开始设计系统架构、拆分子系统、划分子系统模块、协调端与端之间的接口规范,这个阶段各端根据实际情况输出若干系统设计说明书等文档,除此之外更重要的是输出端与端之间通信的接口规范,而这个规范则可以借助 NEI 平台 来完成。

NEI 平台介绍
  • 规范管理
    1. · 提供页面、接口、数据规范化定义和管理
    2. · 提供页面、接口、数据文档化的浏览视图
  • 自动生成
    1. · 结合构建工具自动生成项目结构及代码
    2. · 根据定义的数据规范自动生成模拟数据
  • 高效协作
    1. · 结合本地模拟容器完全独立前后端开发
    2. · 各端根据定义的规范分工协作降低沟通成本
NEI 页面和资源库

NEI 推荐以页面为单位来管理项目。

进入某个项目后,默认选中的是“页面管理”选项卡, 点击右上角的“新建”按钮,按说明填写表单, 其中页面的名称和地址是必填项,同时可以指定该页面会使用到的模板和异步接口。同个地址的页面,按照业务逻辑,展示结果有可能不同,每个不同的展示结果就对应一个模板。异步接口是指在展示该页面时可能会用到的接口。

点击“资源管理”选项卡,会看到异步接口、数据类型、模板资源等选项卡,创建它们的过程和创建页面的类似。

编码阶段说明

编码阶段主要是开发工程师根据系统设计阶段的输出,用代码来实现这样的系统,包括技术方案的选型、项目框架的搭建、工具及环境的配置等,其中有些工作可以借助于有范云协作提供的自动化工具 NEI-Toolkit 来完成,比如项目的初始结构代码、在 NEI平台 上定义好的接口规范等。

构建工具介绍

NEI-Toolkit 提供了 NEI 平台配套的自动化功能,主要功能有:

  1. · 根据 NEI 平台定义的工程规范,生成工程的初始化目录结构
  2. · 自动集成在 NEI 上定义的资源: 页面、异步接口、数据模型、页面模板、业务分组等
  3. · 本地模拟容器
本地模拟容器

通过运行命令 nei server,可以运行由构建工具生成的项目,可以很方便地调试在 NEI 平台中定义的数据类型和接口,使得前端工程师在开发的时候能完全脱离后端工程师,并行开发大大地提升了工作效率。

自测阶段说明

自测阶段主要是各个端的工程师验证自己编写的代码的正确性,按角色不同,测试方式也有所有不同。比如对于前端和移动端工程师来说,主要是需要测试各种可能的值会不会影响界面展示。对于服务端工程师来说,主要是测试提供给客户端工程师使用的接口的正确性,对于不同的输入参数是否返回了预期的结果。

前端、后端自测

前端工程师通过修改 Mock 数据即可模拟不同数据的展示情形,也可以模拟大多数的业务逻辑。

后端工程师可以在 NEI 平台上测试接口,还可以将测试用例保存下来

联调阶段说明

联调阶段主要是连测试环境进行测试。对于前端和移动端工程师来说,主要是需要将本地容器提供的接口换成测试环境的接口。

前端工程师修改路由配置文件 server.config.js,可以将接口地址指向不同的服务器,大大地降低了和后端工程师的联调成本。

测试阶段说明

测试阶段是指开发工程师开发完成后提测的过程,是产品上线前的最后环节。此阶段测试工程师会对接 NEI 平台生成接口测试用例代码并集成到自动化测试平台运行,如果NEI平台的接口定义与实际提测的项目不符则此次提测失败,需由开发对照 NEI 平台检查接口实现情况,所以可以保证 NEI 平台上的接口定义始终与线上保持一致。

使用构建工具 NEI-Toolkit 生成测试用例,将测试用例集成到持续集成环境,自动验证此次提测的代码是否和NEI平台上定义的接口规范相符。