Files
gh-omkamal-pypict-claude-skill/examples/atm-specification.md
Zhongwei Li 1769b9d042
Some checks failed
CI / validate (push) Has been cancelled
Initial commit
2025-11-30 08:45:26 +08:00

148 lines
5.0 KiB
Markdown

# ATM Machine Specification Document
## 1. System Overview
**Product Name:** SecureBank ATM Model SB-5000
**Version:** 1.0
**Purpose:** Self-service banking terminal for cash withdrawal, deposits, balance inquiries, and basic account transactions
## 2. Functional Requirements
### 2.1 Core Functions
- **Cash Withdrawal:** Support withdrawals in denominations of $20, $50, and $100 (configurable)
- **Cash Deposit:** Accept cash deposits with bill validation and counting
- **Balance Inquiry:** Display current account balance for checking and savings accounts
- **Fund Transfer:** Enable transfers between customer's own accounts
- **PIN Change:** Allow customers to change their PIN securely
- **Mini Statement:** Print last 10 transactions
### 2.2 Transaction Limits
- Maximum withdrawal per transaction: $500
- Maximum withdrawal per day: $1,000 (configurable)
- Maximum deposit per transaction: $5,000
- Transaction timeout: 60 seconds of inactivity
## 3. Hardware Requirements
### 3.1 Physical Components
- **Card Reader:** EMV chip card and magnetic stripe reader (ISO 7816 compliant)
- **Cash Dispenser:** 4-cassette system, capacity 2,000 bills per cassette
- **Cash Acceptor:** Bill validator with counterfeit detection
- **Receipt Printer:** Thermal printer, 80mm width
- **Display:** 15-inch touchscreen LCD (1024x768 resolution)
- **Keypad:** Encrypted PIN pad with physical keys
- **Camera:** Two surveillance cameras (customer-facing and cash area)
### 3.2 Physical Specifications
- **Dimensions:** 1600mm (H) x 800mm (W) x 600mm (D)
- **Weight:** Approximately 250 kg
- **Safe Rating:** UL 291 Level 1 certified
- **Power Requirements:** 110-240V AC, 50/60Hz, 500W maximum
## 4. Software Requirements
### 4.1 Operating System
- Hardened Windows 10 IoT Enterprise or Linux-based embedded OS
- Real-time monitoring and health check capabilities
### 4.2 Application Software
- ATM controller software with multi-language support (minimum 3 languages)
- Transaction processing engine
- Remote monitoring and diagnostics software
- Automated software update capability
- Comprehensive audit logging system
### 4.3 Communication Protocols
- ISO 8583 messaging standard for financial transactions
- TCP/IP network protocol
- SSL/TLS encryption for all communications
- Support for NDC+ and DDC protocols
## 5. Security Requirements
### 5.1 Physical Security
- Anti-skimming devices on card reader
- Tamper-evident sensors and alarms
- Reinforced steel safe with time-delay lock
- Anchor bolts for secure installation
- Anti-vandalism coating and materials
### 5.2 Data Security
- Triple DES or AES-256 encryption for PIN blocks
- End-to-end encryption for all sensitive data
- PCI-DSS compliance for payment card data
- Secure key management system (DUKPT)
- No storage of card magnetic stripe data
### 5.3 Authentication
- Customer authentication via PIN (minimum 4 digits, maximum 6 digits)
- Card authentication via EMV chip validation
- Maximum 3 incorrect PIN attempts before card retention
## 6. User Interface Requirements
### 6.1 Display Interface
- Clear, intuitive menu navigation
- High contrast for outdoor visibility
- Accessibility features for visually impaired users (audio guidance option)
- Transaction progress indicators
- Clear error messages and instructions
### 6.2 Response Time
- Card insertion to welcome screen: < 3 seconds
- Transaction authorization: < 10 seconds
- Cash dispensing: < 15 seconds from authorization
## 7. Network and Connectivity
### 7.1 Network Requirements
- Primary: Secure broadband connection (minimum 1 Mbps)
- Backup: 4G/LTE cellular connection
- Automatic failover between primary and backup
- VPN tunnel to host processor
### 7.2 Availability
- System uptime: 99.5% excluding scheduled maintenance
- Maximum network latency: 500ms to host
- Automatic reconnection after network disruption
## 8. Environmental Requirements
- **Operating Temperature:** 10°C to 40°C (50°F to 104°F)
- **Storage Temperature:** -20°C to 60°C (-4°F to 140°F)
- **Humidity:** 20% to 80% non-condensing
- **Installation:** Indoor or outdoor (with weather-resistant enclosure)
## 9. Compliance and Standards
- ADA (Americans with Disabilities Act) compliant
- PCI-PTS certified for secure payment terminals
- EMV Level 1 and Level 2 certified
- ISO 9001 quality management standards
- Local banking regulations and Central Bank requirements
## 10. Maintenance and Support
### 10.1 Monitoring
- 24/7 remote monitoring and alerting
- Automated cash level tracking
- Predictive maintenance alerts
- Transaction success rate monitoring
### 10.2 Maintenance Schedule
- Preventive maintenance: Quarterly
- Cash replenishment: As needed (low cash alert at 20% capacity)
- Receipt paper replacement: As needed
- Software updates: Monthly security patches
## 11. Service Level Agreements
- Critical issue response time: 4 hours
- Hardware repair completion: 24 hours
- Parts availability: 48 hours
- Mean time between failures (MTBF): > 20,000 hours
---
This specification provides a comprehensive framework for an ATM system that can be used for test case design and validation.