Usage

How to Use the Printing Shop Transaction System

This guide will walk you through the key functionalities of the Printing Shop Transaction System.

1. Main Transaction Screen

Upon launching the application, you'll see the main transaction screen, divided into several sections:

• Transaction Input: At the top, where you enter details for new printing jobs.
• Items in Transaction: A temporary list of items you're currently preparing for a single transaction.
• Record: A log of all confirmed past transactions.
• Quick Sales Summary: A snapshot of today's, this month's, and this year's sales figures.
• Sidebar: Contains navigation buttons ("Transaction", "Report", "Reset Records").

1.1 Adding a New Printing Item

1. Fill Details: In the "Transaction Input" section:

   • Paper Type: Select from "Short", "Long", "A4", or "PhotoPaper".
   • Color: Choose "Black" or "Colored".
   • Pages: Enter the number of pages (integers only).
   • Price/Page: Enter the price per page (numbers only).
   • Total: This field will automatically calculate Pages * Price/Page. You can also manually override it if needed.

2. Add Item to List: Once all required fields are filled, the "Add Item" button (green) will become enabled. Click it to add the current item to the "Items in Transaction" table below. The input fields will then clear.

1.2 Managing Items Before Confirming

The "Items in Transaction" table shows all jobs currently prepared for the pending transaction.

• Editing an Item:
  • Double-Click: Double-click any row in the "Items in Transaction" table. The details of that item will populate back into the input fields at the top. The "Add Item" button will change to "Update Item". Make your changes and click "Update Item".
  • Right-Click Menu: Right-click an item in the table, and select "Edit Item" from the context menu.
• Deleting an Item:
  • Right-Click Menu: Right-click an item in the table, and select "Delete Item" from the context menu. A confirmation dialog will appear.

1.3 Confirming a Transaction

Once you have added all items for a single customer's order to the "Items in Transaction" table:

1. Click the "Confirm Transaction" button (blue) located to the right of the "Items in Transaction" table.
2. This action will:
   • Generate a unique Transaction ID, Date, and Time.
   • Move all items from the "Items in Transaction" table into the main "Record" table.
   • Clear the "Items in Transaction" table.
   • Automatically save the updated records to database/records.csv.
   • Refresh the "Quick Sales Summary".

1.4 Managing Past Records

The "Record" table displays a comprehensive list of all confirmed transactions.

• Deleting a Transaction:
  • Right-click any row in the "Record" table.
  • Select "Delete Transaction" from the context menu. A confirmation dialog will appear.
  • Deleting a transaction here will permanently remove it from the records.csv file and update the sales summaries.
• Editing a Transaction:
  • Direct editing of confirmed transactions is currently not available via the GUI to maintain data integrity. If a change is needed, it must be manually edited in the records.csv file directly (not recommended for general users).

2. Sales Report Window

To view detailed sales analytics:

1. Click the "Report" button in the left sidebar. A new "Sales Report" window will open.
2. Filter by Date:
   • Enter "Date From" and "Date To" in MM/DD/YYYY format.
   • Click "Generate Report" to view transactions within that range.
3. Quick Date Filters: Use the "Today", "This Week", "This Month", or "This Year" buttons for quick predefined date ranges.
4. View Report Details: The main area displays individual transaction items within the selected date range.
5. Summary Statistics: At the bottom, view aggregate figures like Total Sales, Total Pages, Transactions, and page counts by paper type and color.
6. Export Report:
   • "Export as CSV": Saves the currently displayed report data to a CSV file in the reports/ folder.
   • "Export as PDF": (Currently not implemented, displays a message).

3. Reset Records

To completely clear all stored transaction data:

1. Click the "Reset Records" button located at the bottom-left of the sidebar.
2. A strong confirmation dialog will appear.
3. If confirmed, the records.csv file will be deleted, clearing all transaction history and resetting all summaries to zero. This action is irreversible.

---