Skip to content

A Collection of application ideas which can be used to improve your coding skills.

Feature: Add Sales Receipt app specification

jdmedlock2fc1fa6be00b
diff --git a/Projects/Sales-DB-App.md b/Projects/Sales-DB-App.md
new file mode 100644
index 00000000..16eee137
--- /dev/null
+++ b/Projects/Sales-DB-App.md
@@ -0,0 +1,87 @@
+# Sales Reciepts
+
+**Tier:** 2-Intermediate
+
+In the [First DB App](./First-DB-App.md) you were able to learn the basics of
+how to use the IndexedDB database that's built into the browser. In Sales
+Reciepts you'll take this a step further by creating an app that records
+point of sales receipts, presumably for subsequent balancing against cash in
+the stores cash register.
+
+The objective of Sales Receipts is to implement point-of-sale functionality for
+a merchant and to make a record of all sales in a database.
+
+### Requirements & Constraints
+
+- Developer should implement this app as a frontend application that uses the
+IndexedDB database in the browser to record all sales receipts.
+
+- Developer may implement the inventory of items available for sale as an
+array of objects in the application source. Each item should be defined with
+the following attributes:
+ - Item number (unique)
+ - Description
+ - Unit price
+
+- Developer should use her UI/UX skills to create a pleasant and efficient
+window layout that makes it easy for the user to purchase items and display
+purchase history.
+
+- The primary use case for a browser based database is to maintain state or
+status information that needs to persist across sessions, or as a work area for
+temporary data. For example, data retrieved from a server that must be
+reformatted or cleansed before it's presented to the user.
+
+- It is important to keep in mind that since the client-side browser environment
+cannot be secured you should not maintain any confidential or personal
+identifying information (PII) in a browser based database.
+
+## User Stories
+
+- [ ] User can see an purchase panel containing buttons for each item containing
+the item number, description, and unit price, as well as a 'Clear' and a
+'Checkout' button.
+- [ ] User can click an item button to make a purchase.
+- [ ] User can see an field displaying the total sale amount incremented as
+items are purchased.
+- [ ] User can see a reciept panel displaying the date and time of the sale,
+as well as all items selected for purchase. This includes the item number,
+description, and unit price.
+- [ ] User can click the 'Clear' button to clear all purchases at any time
+before checking out.
+- [ ] User can click the 'Checkout' button to complete purchase all selected
+items. The final total purchase amount will be added to the end of the reciept
+panel and all selected items will be added to the database.
+- [ ] User can see the receipt panel cleared after all items have been added
+to the database.
+- [ ] User can see a 'Daily Sales' and a 'Clear All' button at the bottom of
+the app window.
+- [ ] User can click the 'Daily Sales' button to display all items purchased
+by all customers in the receipt panel along with the total of them all.
+- [ ] User can click the 'Clear All' button to clear the receipt panel and
+delete the record of all purchases from the database.
+
+## Bonus features
+
+- [ ] User can see an thumbnail image of the items on the item buttons.
+- [ ] User can see the 'Clear' button replaced by 'Clear Entry' and 'Cancel
+All' buttons under the purchase panel
+- [ ] User can click the 'Clear Entry' button to clear the last selected item
+from the receipt panel. This has the effect of unselecting that item.
+- [ ] User can click the 'Cancel All' button to clear all purchases made
+before checking out.
+- [ ] User can see an input field in the input panel the user may enter the
+name of the customer into when a purchase is made. The customer name will be
+added to all items purchased by that customer in the receipt panel and in the
+rows added to the database.
+
+## Useful links and resources
+
+- [IndexedDB Concepts (MDN)](http://tinyw.in/7TIr)
+- [Using IndexedDB (MDN)](http://tinyw.in/w6k0)
+- [IndexedDB API (MDN)](http://tinyw.in/GqnF)
+- [IndexedDB Browser Support](https://caniuse.com/#feat=indexeddb)
+
+## Example projects
+
+- N/a
diff --git a/README.md b/README.md
index 32dc6cea..53d11f5d 100644
--- a/README.md
+++ b/README.md
@@ -88,6 +88,7 @@ required to complete them.
| [🌟Podcast Directory](./Projects/Podcast-Directory-App.md) | Directory of favorite podcasts | 2-Intermediate |
| [🌟QR Code Badge Generator](./Projects/QRCode-Badge-App.md) | Encode badge info in a QRcode | 2-Intermediate |
| [Regular Expression Helper](./Projects/RegExp-Helper-App.md) | Test Regular Expressions | 2-Intermediate |
+| [🌟Sales Reciepts App](./Projects/Sales-DB-App.md) | Record Sales Receipts in a DB | 2-Intermediate |
| [🌟Simple Online Store](./Projects/Simple-Online-Store.md) | Simple Online Store | 2-Intermediate |
| [Sports Bracket Generator](./Projects/Sports-Bracket-Generator.md) | Generate a sports bracket diagram | 2-Intermediate |
| [String Art](./Projects/String-Art.md) | An animation of moving, colored strings | 2-Intermediate |