# atm_machine

**Repository Path**: caixukun66666666/atm_machine

## Basic Information

- **Project Name**: atm_machine
- **Description**: 基于命令行的ATM机模拟系统，支持账户管理、存取款等基本功能，采用模块化设计实现。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-05
- **Last Updated**: 2025-09-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

```markdown
# ATM 机模拟系统

## 项目简介

`atm_machine` 是一个基于命令行的 ATM 机模拟系统，实现了银行自动柜员机的基本功能。该项目采用模块化设计，支持账户管理、存款、取款、查询余额等操作，为用户提供了一个简单而功能完备的 ATM 模拟体验。

项目仓库地址：[https://gitee.com/caixukun66666666/atm_machine](https://gitee.com/caixukun66666666/atm_machine)

---

## 功能特性

- **用户账户管理**：支持用户注册、登录和账户信息管理
- **存款功能**：模拟现金存款操作，更新账户余额
- **取款功能**：支持取款操作，包含余额检查机制
- **余额查询**：实时查看当前账户余额
- **交易记录**：记录所有存取款交易历史
- **命令行交互**：简洁易用的文本用户界面

---

## 技术栈

- **后端语言**：Python
- **前端技术**：JavaScript, HTML
- **应用框架**：JavaScript（前端交互框架）
- **运行环境**：Node.js（用于前端服务）和 Python 环境

---

## 安装指南

### 前置条件

确保你的系统已安装以下软件：
- Python 3.6 或更高版本
- Node.js（可选，用于前端部分）
- Git

### 安装步骤

1. **克隆项目**
   ```bash
   git clone https://gitee.com/caixukun66666666/atm_machine.git
   cd atm_machine
   ```

2. **安装 Python 依赖**
   ```bash
   pip install -r requirements.txt
   ```

3. （可选）**启动前端服务**
   ```bash
   npm install
   npm start
   ```

---

## 使用方法

### 启动系统

1. 运行主程序：
   ```bash
   python main.py
   ```

2. 按照命令行提示操作：
   ```
   *********************************
   *     欢迎使用 ATM 模拟系统     *
   *********************************
   请选择操作：
   1. 注册
   2. 登录
   3. 退出
   > 
   ```

### 操作示例

**用户注册**：
```
请输入用户名： testuser
请输入密码： ******
注册成功！
```

**存款操作**：
```
当前余额： 0.0元
请输入存款金额： 500
存款成功！当前余额： 500.0元
```

---

## 项目结构

```
atm_machine/
├── main.py              # 主程序入口
├── account.py           # 账户管理模块
├── transaction.py       # 交易处理模块
├── database/            # 数据存储目录
│   └── accounts.json    # 用户账户数据
├── static/              # 前端静态文件
│   ├── index.html       # 主页面
│   ├── style.css        # 样式表
│   └── script.js        # 前端逻辑
├── requirements.txt     # Python 依赖列表
└── README.md           # 项目说明文档
```

---

## 贡献指南

我们欢迎任何形式的贡献！请遵循以下步骤：

1. Fork 本仓库
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 开启 Pull Request

请确保你的代码符合项目的编码规范，并包含适当的测试。

---

## 许可证

本项目采用 MIT 许可证。详见 [LICENSE](LICENSE) 文件。

---

## 截图说明

由于这是一个命令行项目，界面主要为文本交互形式。主界面显示银行 Logo 和功能菜单，交易过程中会显示清晰的操作提示和结果反馈。前端页面采用简洁的银行风格设计，包含账户信息显示区和功能操作按钮。

```

*注：由于这是一个文本交互界面，实际截图无法在此展示，但系统会显示格式清晰的菜单和操作提示。*
```

---

**如有问题或建议**，请通过仓库 Issues 页面提交反馈。

感谢使用 ATM 机模拟系统！
```