# Pharmaceutical Audit History ## Overview The Audit History feature provides a complete, tamper-proof record of every action performed on a pharmaceutical, store, or laboratory item. Every time an item is created, edited, activated, deactivated, or deleted, the system records who made the change, when it was made, and exactly what was changed. ## When to Use - Verify who created or last modified an item - Investigate unexpected changes to an item's details - Review the activation/deactivation history of an item - Support internal audits and compliance reviews - Confirm that a specific change was saved successfully ## How to View Audit History 1. Navigate to the item management page (see [Pharmaceutical Item Management](Pharmaceutical-Item-Management) for navigation steps) 2. Search for and select the item 3. Click **Audit History** or **History** (clock icon button) 4. The audit events page opens with the full change log ## Understanding the Audit Events Page ### Item Summary At the top of the page, a summary panel shows: - **Name** - the item's current name - **Code** - the item's code - **Barcode** - the item's barcode (if applicable) - **Status** - current status displayed as a green **Active** or red **Inactive** badge - **VMP** - the parent VMP (for AMPs) - **Total Audit Events** - the total number of recorded events ### Events Table The main table lists all audit events in chronological order with the following columns: | Column | Description | |---|---| | **Date / Time** | When the action was performed | | **Action** | The type of action, displayed as a colour-coded badge | | **User** | The name of the user who performed the action | | **Changes** | A detailed summary of what was changed (field-by-field differences) | | **Status** | Whether the action completed successfully or failed | | **IP Address** | The IP address from which the action was performed | ### Action Types Each action is shown with a colour-coded badge for quick identification: | Action | Colour | Meaning | |---|---|---| | **Create** | Green | A new item was added to the system | | **Update** | Orange | An existing item's details were modified | | **Delete** | Red | An item was permanently deleted | | **Activate** | Blue | An inactive item was reactivated | | **Deactivate** | Grey | An active item was deactivated | ### Pagination The table supports pagination for items with many audit events: - Use the page navigation controls at the top and bottom of the table - Change the number of rows displayed per page: **10**, **20**, **50**, or **100** - The current range is shown (e.g. "1-20 of 45 events") ## Page Controls - **Back to [Item Type] Management** - returns to the item management page - **Refresh Events** - reloads the audit events to show the latest data ## Best Practices - **Check audit history before editing** an item to understand its recent changes - **Use the Changes column** to see exactly which fields were modified in each update - **Review the User column** to confirm accountability for changes - **Look at the Status column** to verify that actions completed successfully ## FAQ **Q: Can audit records be edited or deleted?** A: No. Audit records are permanent and cannot be modified or removed by any user. **Q: How far back does the audit history go?** A: The audit history retains all events from the time the item was first created. There is no time limit. **Q: Why does the Changes column sometimes appear empty?** A: For actions like Activate or Deactivate, the only change is the status itself, so the detailed changes field may show just the status change. **Q: Is audit history available for all item types?** A: Yes. VTMs, ATMs, VMPs, AMPs, VMPPs, and AMPPs across all three categories (Pharmaceuticals, Store Items, Lab Items) all have audit history. ## Related Pages - [Pharmaceutical Item Management](Pharmaceutical-Item-Management) - [Pharmaceutical Management](Pharmaceutical-Management)