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

5.0 KiB

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.