CS 215 Spring 2018 Project 2

Transcription

1 1 CS 215 Spring 2018 Project 2 Learning Objectives: - Use of parallel arrays to store data - Writing functions from a detailed design document - Reading data from files and writing data to files - More problem solving with variables, decisions and loops General Description: You are to implement an Automatic Teller Machine (ATM) for a small bank. Each day, the machine is started up by the bank s IT support. At this time, the ATM reads a list of current accounts, Personal Id Numbers (PINs), and account balances from a file. Once started, customers use the ATM to make deposits, withdrawals and balance inquiries. For each customer, the ATM asks for and validates the account number and PIN number, then performs the deposit/withdrawal/balance-inquiry for the customer. For each successful withdrawal and deposit, the ATM maintains a list of transactions, including account number and amount for each, and updates the account s current balance. The ATM is limited to a maximum number of total withdrawal/deposit transactions it can process per day, and will refuse to do deposits and withdrawals once this limit is surpassed. At the end of the day, IT support enters a secret account number and PIN (10000 and 1000). Once entered, the ATM shuts down, writing the list of transactions to a file. About the data: - Account Numbers are length 12 or less, made up of any characters, but no white space. - PINs are integers of four digits. - Balances are assumed to not exceed $ Detailed Description: Start Up: - The logo is displayed, and a startup message printed. - The account file is read in. When there is an error reading the file, an error message is printed and the shutdown process (see below) is completed. When there is not an error, a report of the account data read from the file is printed. File format: - File name: accounts.txt - First Line: the number of accounts - Each following line, one per account: account# pin and balance, separated by a space. - The ATM then proceeds to processing customers.

2 2 Processing a Customer: this process is repeated until the shutdown account and PIN are entered. - The logo is displayed. - The user is asked to enter an account number and PIN. When an invalid account/pin are entered (not on the list read at startup, and not the shutdown code), the ATM reports an error and this process is finished. When a valid account/pin are entered, the ATM proceeds to the next step. - When the secret shutdown codes are entered, the ATM proceeds to the shutdown process. - When a valid account/pin is entered: A menu with options Deposit, Withdraw, and Balance Inquiry is presented. The user selects one of the options (D,W,B). The user may enter an entire string (ie. Withdraw) but the ATM only looks at the first character entered. It also accepts both upper and lower case entries. When an invalid entry is made, an error message is printed and the menu repeats until the user enters a valid option. - Withdrawal: The customer is asked for a withdrawal amount. When the amount is: o less than 0.00: print Invalid amount! Enter a value 0.00 or greater o greater than the account s balance: print Your account only has $ currentbalance o 0: print Transaction canceled and end the process for this customer o Valid (more than 0 and less/equal the Balance): the account balance is updated a Transaction is added to the ATM s transaction list with account number and (negative) amount. Prints: Transaction complete. Your new balance is now: $ newcurrentbalance Except: If the maximum number of transactions for the ATM is exceeded, just print: Transaction cannot be done. Contact IT Support. - Deposit: The customer is asked for a deposit amount. When the amount is: o less than 0.00: print Invalid amount! Enter a value 0.00 or greater o 0: print Transaction canceled and end the process for this customer o Valid (0 or more): the account balance is updated a Transaction is added to the transaction list with account number and (positive) amount. Prints: Transaction complete. Your new balance is now: $ newcurrentbalance Except: If the maximum number of transactions for the ATM is exceeded, just print: Transaction cannot be done. Contact IT Support. - Balance Inquiry: The customer is asked for a deposit amount. When the amount is: Simply prints Your current balance is: $ currentbalance

3 3 Shutdown: Shutdown of the ATM occurs when the secret account number (10000) and PIN (1000) are entered at the beginning of processing a customer. The ATM prints a transaction report, writes the transactions to a file (see below), and prints a report of the current accounts. This is followed by the normal System Pause before the program exits. Output file format: (image is the file opened in MSVS editor) - File name: transactions.txt - First line: number of transactions - Each following line, one per transaction: account number and amount, separated by a space. Style and Coding Standards: As usual, you are required to follow the rules in the Style and Coding Standards document on the course website. Of particular concern: - Style for commenting functions - NO GLOBAL VARIABLES (global constants are always OK) - No function should exceed 25 lines in length (not counting comments) unless there is a very good reason. Submission: Submit your.cpp file in Canvas. You do not need to submit your accounts.txt or transactions.txt files.

4 4 Coding Specifications Data Structures: These should be declared in main(), then passed to invoked functions as needed. - Accounts: Partial Parallel Arrays of Accounts consisting of: o A list of account numbers (strings) o A list of PIN numbers (integers) o A list of current balances (doubles) o A number of accounts o A maximum of 100 accounts Data for these arrays is read from a file called accounts.txt. Only the balances will change during execution of the ATM. - Transactions: Partial Parallel Arrays of Transactions consisting of: o A list of account numbers o A list of amounts (withdrawals negative, deposits positive) o A number of transactions since the ATM started [starts with 0] o A maximum of 5 transactions (for testing) For each successful Deposit or Withdrawal, a new transaction is added to these lists, incrementing the number of transactions each time. This data is written to a file called transactions.txt during the shutdown process. - Important Note: you are required to use these data structures. Do NOT use C structs or C++ classes, even if you know how to use them!!! Structure Chart: Detailed Function Designs: main 0 - Declares and initializes the program data structures. - Invokes startup() - Repeats processcust() until shutdown is returned - Invokes shutdown() - Does System Pause

5 5 printlogo - Prints the logo. It should contain the programmer s (your) name. readaccts Accounts When successful: number of accounts read from the input file On failure: -1 (READ_ERROR) - Opens the file accounts.txt (described above) and reads the account data. printaccts Accounts - Prints the given account data in the format shown above. startup Accounts true when the startup fails (read error) false when the startup is successful (no errors) - Prints logo and start up message - Invokes readaccts() - When the read is successful: Invokes printaccts() - When the read fails: prints Error reading accounts! custlogin Accounts When login successful: index into the parallel arrays of the account logged in. When shutdown account number and pin entered: -2 (SHUT_DOWN) When login fails: -1 (INVALID_ACCT_PIN) - Asks the user to enter the Account Number and PIN - If the shutdown code is entered, return the SHUT_DOWN code (-2) - Search the Accounts arrays for a valid account number and PIN combination. - Return the result of the search as described above. askaction Character W, D or B - Displays the menu as shown above and asks the user to input their selection (a string, no spaces) - Converts the first character of the string entered to upper case. Hint: char action = toupper(useranswer[0]); // where useranswer is a string var - When an invalid answer is given, prints: Invalid option...please enter W, D or B! - Repeats these steps until a valid answer is given.

6 6 addtransaction Transaction Amount amount of this transaction Account Index index into the Accounts arrays of the current account Accounts (updates the balance of the current account) Transactions (adds a new transaction to the list) - When the Maximum Number of Transactions is exceeded (the Transactions arrays are already full), print Transaction cannot be done. Contact IT Support - Otherwise: o Append a new Transaction to the parallel arrays o Update the balance of the current account in Accounts o Print: Transaction complete. Your new balance is now: $ newcurrentbalance dowithdrawal Account Index index into the Accounts arrays of the current account Accounts (may update the balance of the current account) Transactions (may add a new transaction to the list) - Asks the user to enter the withdrawal amount - When the amount is negative, prints: Invalid amount! Enter a value 0.00 or greater. - When the amount is more than the current balance: Your account only has $ CurrBalance - Repeats the above until a valid withdrawal amount is entered. 0 is valid. - When the valid amount is zero, print: Transaction canceled. - When the valid amount is more than zero, invoke addtransaction() with the negative of the amount. dodeposit Account Index index into the Accounts arrays of the current account Accounts (may update the balance of the current account) Transactions (may add a new transaction to the list) - Asks the user to enter the deposit amount - When the amount is negative, prints: Invalid amount! Enter a value 0.00 or greater. - Repeats the above until a valid withdrawal amount is entered. 0 is valid. - When the valid amount is zero, print: Transaction canceled. - When the valid amount is more than zero, invoke addtransaction() with the deposit amount. processcust Accounts (may update the balance of the current account) Transactions (may add a new transaction to the list) true the shutdown code was entered false the shutdown code was NOT entered - Invokes printlogo() - Invokes custlogin() to get the account index (or other code) - (continued next page)

7 7 - When the account index is: o -2 (SHUT_DOWN): return true o -1 (account/pin invalid): print Invalid account number/pin combination. o Otherwise: Invokes askaction() to get the selected action When the action returned is: W Invokes dowithdrawal() D Invokes dodeposit() B Prints Your current balance is $ CurrBalance printtrans Transactions - Prints the transaction report as shown above. Formatting tip: cout << left << setw(12) << transacctno[i] << " $ " << right << setw(8) << transamount[i] << endl; writetrans Transactions - Writes the Transactions data to a file called transactions.txt in the format given above. - When the file fails to open, prints Unable to open transaction output file. - When the data is written successfully, prints Transactions written to file. shutdown Accounts Transactions - Prints Shutting down ATM... - Invokes printtrans(), writetrans() and printaccts() - Prints Shut down complete.