hmcts/cmc-citizen-frontend

CMC前端应用

概述和主要用途

CMC前端应用是民事索赔（Civil Money Claims）的公民端Web界面，提供符合GDS（Government Digital Service）服务设计指南的HTML5网页序列。公民可通过该应用提交索赔、进行抗辩或请求缺席判决等相关操作。应用将大部分非UI职责委托给底层服务（如claim-store或pdf-service）处理。

核心功能和特性

• 符合GDS服务设计指南的用户界面，提供直观的操作流程
• 支持***索赔提交、抗辩提交、缺席判决请求等核心业务场景
• 前端与后端服务解耦，非UI逻辑由底层服务处理
• 集成代码质量检查工具（TSLint、StandardJS、sass-lint）
• 完善的测试体系，包括单元测试、功能测试、可访问性测试和端到端测试

使用场景和适用范围

• 公民通过网页提交***索赔申请
• 被告通过系统提交抗辩材料
• 用户请求对未回应的索赔进行缺席判决
• 开发和测试环境中部署前端应用进行功能验证

使用方法和配置说明

先决条件

• https://nodejs.org/ >= v8.0.0
• https://yarnpkg.com/
• Gulp
• https://www.docker.com

本地运行应用

1. 安装依赖：

   bash
   $ yarn install
   

2. 启动应用：

   bash
   $ gulp
   

3. 访问应用：https://localhost:3000

Docker集成环境运行

详见hmcts/cmc-integration-tests项目的README.md文件。

开发指南

代码风格

使用TSLint（配合StandardJS规则）和sass-lint进行代码检查。

运行代码检查：

bash
$ yarn lint

运行测试

使用Mocha框架进行测试：

• 常规测试：

  bash
  $ yarn test
  

• 功能测试：

  bash
  $ yarn test:routes
  

• 可访问性测试：

  bash
  $ yarn test:a11y
  

• 测试覆盖率：

  bash
  $ yarn test:coverage
  

• 仅单元测试覆盖率：

  bash
  $ yarn test:coverage-unit
  

运行端到端测试

集成测试基于CodeceptJS框架，位于src/integration-test目录，通过Docker执行：

1. 构建包含更新的Docker镜像：

   bash
   $ docker-compose build citizen-integration-tests
   

2. 进入integration-tests项目并运行测试：

   bash
   $ ./bin/run-local-citizen-tests.sh
   

3. （可选）手动启动Docker环境：

   bash
   $ ./bin/start-local-environment.sh
   

更多详情参见integration-tests仓库的https://github.com/hmcts/cmc-integration-tests/blob/master/README.md%E3%80%82

故障排除

yarn 1.0.1版本安装时的警告

当前存在已知问题：https://github.com/yarnpkg/yarn/issues/3751

示例警告：

warning The case-insensitive file ..\cmc-citizen-frontend\node_modules\nyc\node_modules shouldn't be copied twice in one bulk copy
warning The case-insensitive file ..\cmc-citizen-frontend\node_modules\nyc\node_modules\ansi-regex shouldn't be copied twice in one bulk copy

预览环境

每个拉取请求会在Azure Kubernetes (AKS)中生成功能齐全的环境。更多信息参见：[***]

许可证

本项目基于MIT许可证授权 - 详见LICENSE文件。