feat: add comprehensive keyboard shortcuts for improved navigation and productivity

docs/CHANGELOG.md

@@ -5,6 +5,40 @@ All notable changes to TheChart project are documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.7.0] - 2025-08-05
+
+### ⌨️ Keyboard Shortcuts System
+- **Added**: Comprehensive keyboard shortcuts for improved productivity
+- **Added**: File operations shortcuts (Ctrl+S, Ctrl+Q, Ctrl+E)
+- **Added**: Data management shortcuts (Ctrl+N, Ctrl+R, F5)
+- **Added**: Window management shortcuts (Ctrl+M, Ctrl+P)
+- **Added**: Table operation shortcuts (Delete, Escape)
+- **Added**: Help system shortcut (F1)
+- **Added**: Menu integration showing shortcuts next to menu items
+- **Added**: Button labels updated to show primary shortcuts
+- **Added**: In-app help dialog accessible via F1
+- **Added**: Status bar feedback for all keyboard operations
+- **Improved**: Button text shows shortcuts (e.g., "Add Entry (Ctrl+S)")
+- **Improved**: Case-insensitive shortcuts (Ctrl+S and Ctrl+Shift+S both work)
+
+#### Keyboard Shortcuts Added:
+- **Ctrl+S**: Save/Add new entry
+- **Ctrl+Q**: Quit application (with confirmation)
+- **Ctrl+E**: Export data
+- **Ctrl+N**: Clear entries
+- **Ctrl+R / F5**: Refresh data
+- **Ctrl+M**: Manage medicines
+- **Ctrl+P**: Manage pathologies
+- **Delete**: Delete selected entry (with confirmation)
+- **Escape**: Clear selection
+- **F1**: Show keyboard shortcuts help
+
+### 📚 Documentation Updates
+- **Updated**: FEATURES.md with keyboard shortcuts section
+- **Added**: KEYBOARD_SHORTCUTS.md with comprehensive shortcut reference
+- **Updated**: In-app help system with shortcut information
+- **Updated**: About dialog with keyboard shortcut mention
+
 ## [1.6.1] - 2025-07-31
 
 ### 📚 Documentation Overhaul

docs/FEATURES.md

@@ -159,6 +159,37 @@ Professional testing infrastructure with high code coverage.
 - **Real-time Updates**: Immediate feedback and data updates
 - **Error Handling**: Comprehensive error messages and recovery options
 
+### ⌨️ Keyboard Shortcuts
+Comprehensive keyboard shortcuts for efficient navigation and data entry.
+
+#### File Operations:
+- **Ctrl+S**: Save/Add new entry - Quickly save current entry data
+- **Ctrl+Q**: Quit application - Exit with confirmation dialog
+- **Ctrl+E**: Export data - Open export dialog window
+
+#### Data Management:
+- **Ctrl+N**: Clear entries - Clear all input fields for new entry
+- **Ctrl+R / F5**: Refresh data - Reload data from CSV and update displays
+
+#### Window Management:
+- **Ctrl+M**: Manage medicines - Open medicine management window
+- **Ctrl+P**: Manage pathologies - Open pathology management window
+
+#### Table Operations:
+- **Delete**: Delete selected entry - Remove selected table entry with confirmation
+- **Escape**: Clear selection - Clear current table selection
+- **Double-click**: Edit entry - Open edit dialog for selected entry
+
+#### Help System:
+- **F1**: Show keyboard shortcuts - Display help dialog with all shortcuts
+
+#### Integration Features:
+- **Menu Display**: All shortcuts shown in menu bar next to items
+- **Button Labels**: Primary buttons show their keyboard shortcuts
+- **Case Insensitive**: Both Ctrl+S and Ctrl+Shift+S work
+- **Focus Management**: Shortcuts work when main window has focus
+- **Status Feedback**: All operations provide status bar feedback
+
 ## Technical Architecture
 
 ### 🏗️ Modular Design

docs/KEYBOARD_SHORTCUTS.md

@@ -0,0 +1,71 @@
+# Keyboard Shortcuts
+
+TheChart application supports comprehensive keyboard shortcuts for improved productivity and efficient navigation.
+
+## File Operations
+- **Ctrl+S**: Save/Add new entry - Saves the current entry data to the database
+- **Ctrl+Q**: Quit application - Exits the application (with confirmation dialog)
+- **Ctrl+E**: Export data - Opens the export dialog window
+
+## Data Management
+- **Ctrl+N**: Clear entries - Clears all input fields to start a new entry
+- **Ctrl+R** or **F5**: Refresh data - Reloads data from the CSV file and updates the display
+
+## Window Management
+- **Ctrl+M**: Manage medicines - Opens the medicine management window
+- **Ctrl+P**: Manage pathologies - Opens the pathology management window
+
+## Table Operations
+- **Delete**: Delete selected entry - Deletes the currently selected entry in the table (with confirmation)
+- **Escape**: Clear selection - Clears the current selection in the table
+- **Double-click**: Edit entry - Opens the edit dialog for the selected entry
+
+## Help
+- **F1**: Show keyboard shortcuts help - Displays a dialog with all available keyboard shortcuts
+
+## Implementation Details
+
+### Menu Integration
+All keyboard shortcuts are displayed in the menu bar next to their corresponding menu items for easy reference.
+
+### Button Labels
+Primary action buttons show their keyboard shortcuts in the button text (e.g., "Add Entry (Ctrl+S)").
+
+### Case Sensitivity
+- Shortcuts are case-insensitive
+- Both `Ctrl+S` and `Ctrl+Shift+S` work
+- Uppercase and lowercase variants are supported
+
+### Focus Requirements
+- Keyboard shortcuts work when the main window has focus
+- Focus is automatically set to the main window on startup
+- Shortcuts work across all tabs and interface elements
+
+### Feedback System
+- All operations provide feedback through the status bar
+- Success and error messages are displayed
+- Confirmation dialogs are shown for destructive operations (quit, delete)
+
+## Usage Tips
+
+### Quick Workflow
+1. **Ctrl+N** - Clear fields for new entry
+2. Enter data in the form
+3. **Ctrl+S** - Save the entry
+4. **F5** - Refresh to see updated data
+
+### Navigation
+- Use **Ctrl+M** and **Ctrl+P** to quickly access management windows
+- Use **Delete** to remove unwanted entries from the table
+- Use **Escape** to clear selections when needed
+
+### Getting Help
+- Press **F1** anytime to see the keyboard shortcuts help dialog
+- All shortcuts are also visible in the menu bar
+- Button tooltips show additional keyboard shortcut information
+
+## Accessibility
+- Keyboard shortcuts provide full application functionality without mouse use
+- All critical operations have keyboard equivalents
+- Shortcuts follow standard application conventions (Ctrl+S for save, Ctrl+Q for quit)
+- Help system is easily accessible via F1

docs/README.md

@@ -11,6 +11,11 @@ Welcome to TheChart documentation! This guide will help you navigate the availab
   - Advanced Dose Tracking
   - Graph Visualizations
   - Data Management
+  - Keyboard Shortcuts
+- **[Keyboard Shortcuts](KEYBOARD_SHORTCUTS.md)** - Comprehensive shortcut reference
+  - File operations shortcuts
+  - Data management shortcuts
+  - Navigation shortcuts
 
 ### For Developers
 - **[Development Guide](DEVELOPMENT.md)** - Development setup and testing