murmurationlabs/rodeo

complaints-portal 镜像文档

镜像概述

complaints-portal是一个基于React构建的投诉评估工具，旨在提供投诉事务的处理与评估功能。该项目使用Create React App进行初始化，支持开发、测试和生产环境的运行，并提供远程部署示例（[***]

核心功能与特性

• 开发模式支持：通过脚本快速启动开发服务器，支持热重载和实时代码编辑
• 测试功能：集成测试运行器，支持交互式观察模式下的测试执行
• 生产构建：优化的生产构建流程，生成最小化、带哈希值的静态文件
• 配置自定义：支持通过eject命令导出完整配置文件，实现深度自定义

使用场景与适用范围

• 投诉处理系统的前端界面开发与测试
• 投诉评估流程的Web应用部署
• 需要快速构建和部署的React前端项目

使用方法与配置说明

前提条件

• 已安装Node.js和Yarn
• Docker环境（如需容器化部署）

主要脚本说明

yarn start

启动开发模式，在浏览器中打开http://localhost:3000查看应用。代码修改后页面会自动重载，控制台会显示 lint 错误。

bash
yarn start

yarn test

启动交互式观察模式的测试运行器。详细信息可参考https://***.github.io/create-react-app/docs/running-tests。

bash
yarn test

yarn build

构建生产版本到build文件夹。该命令会以生产模式正确打包React，并优化构建以获得最佳性能。构建文件已最小化，文件名包含哈希值，可直接用于部署。详细信息可参考https://***.github.io/create-react-app/docs/deployment。

bash
yarn build

yarn eject

注意：这是单向操作，执行后无法恢复！

如果对构建工具和配置选择不满意，可随时执行eject命令。该命令会移除项目中的单一构建依赖，将所有配置文件（webpack、Babel、ESLint等）和传递依赖复制到项目中，使您获得完全控制权。除eject外的所有命令仍可使用，但会指向复制的脚本以便自定义。

bash
yarn eject

Docker部署示例

Dockerfile

dockerfile
# 构建阶段
FROM node:16-alpine as build
WORKDIR /app
COPY package*.json ./
RUN yarn install
COPY . .
RUN yarn build

# 部署阶段
FROM nginx:alpine
COPY --from=build /app/build /usr/share/nginx/html
EXPOSE 80
CMD ["nginx", "-g", "daemon off;"]

docker-compose.yml

yaml
version: '3'
services:
  complaints-portal:
    build: .
    ports:
      - "80:80"
    restart: always

学习资源

• https://***.github.io/create-react-app/docs/getting-started
• React 文档