Pharmaceutical Audit History - hmislk/hmis GitHub Wiki
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
- Navigate to the item management page (see Pharmaceutical Item Management for navigation steps)
- Search for and select the item
- Click Audit History or History (clock icon button)
- 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.