# cardsysTest

**Repository Path**: lixiangyang1024/cardsys-test

## Basic Information

- **Project Name**: cardsysTest
- **Description**: AI 驱动的卡系统交易测试平台（FastAPI + React）本项目是一个基于 **FastAPI + React + AI Prompt 工程驱动** 的卡系统交易模拟平台

- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-07-10
- **Last Updated**: 2025-07-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 卡系统测试平台

## 部署问题排查记录

### 已解决问题

1. **Nginx 代理配置问题**

   - 问题：`proxy_pass` 配置不正确，导致 FastAPI 路由无法正确匹配
   - 解决方案：将 `proxy_pass http://127.0.0.1:8116/` 修改为 `proxy_pass http://127.0.0.1:8116/api/`
   - 文件：`nginx_cardsys_test.conf`

2. **后端依赖不完整**
   - 问题：`requirements.txt` 中的依赖版本不匹配实际环境
   - 解决方案：使用 `pip freeze > requirements.txt.backup` 导出完整依赖，并更新 `requirements.txt`
   - 注意：部署前请确保依赖版本与开发环境一致

## 前端部署脚本

为了方便前端的独立更新，提供了以下脚本：

### 1. 完整的前端构建和部署脚本

```bash
./frontend_build_deploy.sh
```

该脚本会执行以下操作：

- 安装前端依赖
- 构建前端
- 备份服务器上的当前前端文件
- 部署新的前端文件到服务器

### 2. 仅构建前端

```bash
./frontend_build_local.sh
```

该脚本仅在本地构建前端，不包含部署步骤。构建结果位于 `./frontend/dist` 目录。

### 3. 仅部署前端

```bash
./frontend_deploy_only.sh
```

该脚本假设前端已经构建完成，仅执行部署步骤。使用前请确保 `./frontend/dist` 目录存在。

### 使用说明

1. 所有脚本必须在项目根目录下运行
2. 部署脚本会提示输入服务器信息
3. 部署前会自动备份服务器上的当前文件
4. 如果部署失败，可以选择恢复备份
5. **SSH 端口**: 脚本默认使用**6022**端口进行 SSH 连接，而非标准的 22 端口。可以在部署过程中根据提示修改端口号

卡系统测试平台是一个用于测试卡系统交易的 Web 应用程序，包括前端界面和后端 API 服务。

## 项目概述

本项目提供以下功能：

- 消费交易 (CEP)
- 退货交易 (CEF)
- 余额查询 (CEQ)
- 交易状态查询 (FES)
- 交易历史记录查询

## 技术栈

- **前端**: React + TypeScript + Vite + Tailwind CSS
- **后端**: FastAPI + SQLite
- **部署**: Nginx + Uvicorn/Gunicorn

## 部署说明

详细的部署指南请参考 [部署文档](docs/deployment_guide.md)。

简要步骤：

1. 运行 `./deploy_frontend.sh` 部署前端
2. 运行 `./upload_nginx_config.sh` 配置 Nginx
3. 上传后端文件并在服务器上配置环境
4. 启动后端服务

## 项目结构

```
cardsysTest/
├── backend/                # 后端代码
│   ├── app/                # FastAPI应用
│   ├── health_check.sh     # 健康检查脚本
│   ├── start_service.sh    # 启动脚本
│   └── stop_service.sh     # 停止脚本
├── deploy_frontend.sh      # 前端部署脚本
├── docs/                   # 文档
│   └── deployment_guide.md # 部署指南
├── frontend/               # 前端代码
│   └── src/                # React源代码
└── upload_nginx_config.sh  # Nginx配置脚本
```

## 访问应用

部署完成后，可通过以下地址访问应用:

```
http://222.128.36.213:8800
```