# Neil

**Repository Path**: gengminghe/neil

## Basic Information

- **Project Name**: Neil
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2025-05-10
- **Last Updated**: 2025-05-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Neil
## MAMBER
| Neil  | 郭书豪  |  2023905316 |
|---|---|---|


# 小型银行系统（MINI Banking System）

## 类描述（Class describe）

Account（账户基类）：抽象基类，定义了所有账户类型的共同接口和基本功能，包括账户信息获取、余额管理、交易记录和报告生成。通过纯虚函数实现多态，使得不同账户类型可以具有不同的行为特性。

Transaction（交易类）：记录系统中所有金融活动，包括存款、取款和转账操作。每笔交易都有唯一标识符、类型、金额、时间戳和相关账户信息，并提供格式化输出和报告功能。

SavingsAccount（储蓄账户）：继承自 Account，具有特定的业务规则限制，例如不能直接存款或取款，只能转账给同一客户的支票账户。

CheckingAccount（支票账户）：继承自 Account，支持全部交易操作，包括存款、取款和向任何账户转账，适合日常交易使用。

Customer（客户类）：管理客户信息及其关联的储蓄账户和支票账户，提供获取客户所有交易记录的功能，以及生成客户综合报告的能力。

BankingSystem（银行系统类）：作为核心控制器，协调整个系统的运作，管理客户和账户集合，处理各类交易操作，生成唯一账户号码，并执行业务规则验证。

UserInterface（用户界面类）：提供基于控制台的交互界面，处理用户输入和信息显示，引导用户完成各种银行操作，如开户、查询、交易和报告生成等。

## Banking System Design Overview

This is an object-oriented banking system design consisting of multiple classes that work together to simulate banking operations. Here are the detailed descriptions of each class:

### Account (Base Class)
-  **Type:** Abstract base class
-  **Functionality:** 
    - Defines common interfaces and basic functions for all account types
    - Provides account information retrieval methods
    - Implements balance management
    - Maintains transaction history
    - Generates reports
-  **Design Characteristics:** 
    - Uses pure virtual functions to achieve polymorphism
    - Allows different account types to have distinct behavioral characteristics

### Transaction (Transaction Class)
-  **Functionality:** 
    - Records all financial activities in the system
    - Supports deposit, withdrawal, and transfer operations
-  **Attributes:** 
    - Unique identifier
    - Transaction type
    - Transaction amount
    - Timestamp
    - Related account information
-  **Methods:** 
    - Provides formatted output
    - Generates transaction reports

### SavingsAccount (Savings Account)
-  **Inheritance: ** Inherits from Account
-  **Functionality:** 
    - Does not allow direct deposits or withdrawals
    - Can only transfer to checking accounts of the same customer
    - May include other savings-specific restrictions or benefits

### CheckingAccount (Checking Account)
-  **Inheritance:** Inherits from Account
-  **Functionality:** 
    - Supports all transaction operations
    - Includes deposits and withdrawals
    - Can transfer to any account
-  **Characteristics:** Suitable for daily transactions


### Customer (Customer Class)

-  **Functionality:** 
    - Manages customer personal information
    - Associates customer's savings and checking accounts
    - Provides access to all transaction records of the customer
    - Generates comprehensive customer reports

-  **Relationships:** 
    - A customer can have one savings account and one checking account


### BankingSystem (Banking System Class)
-  **Role:** Core controller
-  **Functionality:** 
    - Coordinates overall system operation
    - Manages collections of customers and accounts
    - Processes various transaction operations
    - Generates unique account numbers
    - Enforces business rule validation
-  **Design Characteristics:** 
    - Acts as the system's central hub
    - Ensures compliance with business rules

### UserInterface (User Interface Class)

-  **Functionality:** 
    - Provides console-based interactive interface
    - Handles user input
    - Displays system information


-  **Interaction Flow:** 
    - Guides users through account opening
    - Supports account inquiries
    - Transaction amount
    - Processes transaction operations
    - Generates various reports




## 整体架构的说明

采用面向对象的分层架构设计，将数据、业务逻辑和用户界面清晰分离。

底层是数据模型层，包括 Account、Transaction 等核心类；

中间是业务逻辑层，由 BankingSystem 处理所有业务规则和操作；

顶层是表示层，通过 UserInterface 与用户交互。

系统使用智能指针管理内存，通过继承和多态实现账户类型的差异化行为，确保代码的可维护性和可扩展性。整个系统围绕客户、账户和交易这三个核心概念构建，形成一个完整的银行业务模拟环境。

The system uses smart pointers to manage memory and achieves differentiated behavior for account types through inheritance and polymorphism, ensuring code maintainability and scalability. The entire system is built around the three core concepts of customers, accounts, and transactions, forming a complete banking business simulation environment

## 关键设计决策的描述（Description of Key Design Decisions）

 关键设计决策集中在账户体系、交易处理和数据管理三个方面。（The key design decisions focus on three aspects: the account system, transaction processing, and data management.）

账户采用抽象基类设计，通过纯虚函数定义不同类型账户的特殊行为，实现高度的代码复用同时保持业务规则的灵活性；交易处理设计为完整的记录机制，每笔操作都生成唯一的交易 ID 并保存在相关账户中，支持多角度的查询和报告生成；数据管理方面使用智能指针（shared_ptr）确保资源安全共享和自动释放，并通过容器和映射表高效组织客户、账户和交易数据，提供 O(1)复杂度的账户查找和 O(n)的报告生成能力。这些决策共同构建了一个健壮且高效的银行系统框架。（The account system adopts an abstract base class design, using pure virtual functions to define specialized behaviors for different account types, achieving high code reusability while maintaining flexibility in business rules. Transaction processing is designed as a comprehensive recording mechanism, where each operation generates a unique transaction ID and is stored in the relevant account, supporting multi-perspective queries and report generation. For data management, smart pointers (shared_ptr) are used to ensure safe resource sharing and automatic deallocation, while containers and mapping tables efficiently organize customer, account, and transaction data, providing O(1) complexity for account lookup and O(n) for report generation. These decisions collectively construct a robust and efficient banking system framework.）