v2.1.0

Release 2.1.0

This major update introduces significant architectural improvements, new productivity features, and enhanced visualization tools, marking a transition to a more robust and feature-rich platform for internship management.

New Features

• Calendar View: Integrated a new calendar component for supervising meetings and visits, providing a clear chronological overview of scheduled activities.
• Communication Suite: Added direct integration for WhatsApp and Email. A new phone column has been added to the intern records to facilitate rapid communication.
• Batch Operations: Implemented batch document approval functionality, significantly reducing the time required for administrative tasks.
• Enhanced Monitoring: Introduced progress bar delegates and automated time-progress calculations to track internship completion status at a glance.
• Advanced Filtering: Added comprehensive filtering capabilities for documents and meetings within the dashboard and main window for better data navigation.

Improvements & Fixes

• Grade Management: Updated the approval threshold to 6.0 and implemented dynamic color coding in the grade dialog to provide immediate visual feedback on performance.
• UI Refinement: Refactored the action panel layout and global styling to ensure a more consistent and modern user interface.
• Database Integrity: Fixed query conditions in venue tracking and standardized record retrieval methods across all service layers.
• Documentation: Extensively updated the project README and user guides to reflect the new architecture and core features.

Technical Changes

• Architectural Overhaul: Migrated the data layer to SQLAlchemy (ORM) and Alembic for robust, versioned database migrations.
• Automated Migrations: Introduced MigrationService to handle automated database schema upgrades seamlessly during application updates.
• Repository Pattern Refinement: Refactored repository classes to optimize session lifecycle management and improve data access efficiency.
• Service Layer Standardization: Standardized naming conventions and interface methods across all service modules to improve maintainability and code readability.

---

Installation & Update

Windows

1. Download InternManager_Win.zip.
2. Extract the archive (optimized for your Ryzen 5 7600 setup).
3. Run InternManager.exe.

macOS

1. Download InternManager_Mac.zip.
2. Extract the archive and move InternManager.app to your Applications folder.

Note: Since this application is not signed with an Apple Developer ID, macOS may block the execution. To open it: Right-click the app > Open > Click 'Open' in the dialog box.

Update Procedure (All Platforms)

1. Recommended: Use the "Export Data" feature in your current version to create a safety backup of your SQLite database.
2. Delete your old application folder (or .app file on macOS).
3. Extract the new version to the same location.

Note: Your database and settings are stored in your user profile (%APPDATA% on Windows) and will persist after the update.

v2.0.0

Bump version to 2.0.0 and update related documentation and references

v1.2.3

Release 1.2.3

This is a critical hotfix to resolve a database interface error where a class instance was improperly passed to the SQLite engine instead of a primitive integer.

Fixes

• Meeting Management: Fixed the InterfaceError: Error binding parameter 1 that caused application crashes when attempting to delete records from the supervision list.
• UI Selection: Corrected the row-selection logic in the meeting table to accurately extract the unique identifier (ID) before initiating the deletion process.

Technical Changes

• MeetingDialog Refactoring: Removed redundant "dummy" Meeting object creation. The component now extracts the meeting_id directly from the QTableWidget as an integer.
• Service Layer Synchronization: Updated MeetingService to utilize the polymorphic delete method from BaseService, ensuring architectural consistency and proper ID handling across all modules.

---

Installation & Update

Windows

1. Download InternManager_Win.zip.
2. Extract the archive (optimized for your Ryzen 5 7600 setup).
3. Run InternManager.exe.

macOS

1. Download InternManager_Mac.zip.
2. Extract the archive and move InternManager.app to your Applications folder.

Note: Since this application is not signed with an Apple Developer ID, macOS may block the execution. To open it: Right-click the app > Open > Click 'Open' in the dialog box.

Update Procedure (All Platforms)

1. Recommended: Use the "Export Data" feature in your current version to create a safety backup of your SQLite database.
2. Delete your old application folder (or .app file on macOS).
3. Extract the new version to the same location.

Note: Your database and settings are stored in your user profile (%APPDATA% on Windows) and will persist after the update.

v1.2.2 - Hotfix: Update Parser & Versioning

This is a minor hotfix to address an issue with the internal update checker that prevented the application from correctly identifying new versions due to tag formatting inconsistencies.

Fixes

• Update Checker: Fixed a bug where the version parser failed to handle tags containing leading dots (e.g., v.1.2.1).
• String Normalization: Improved version string sanitization to ensure compatibility between GitHub tags and the packaging library.

Technical Changes

• Refactored check_for_updates to use removeprefix("v").lstrip(".") for more robust version comparison.
• Added explicit normalization for both local and remote version strings to prevent future mismatches.

---

Installation & Update

Windows

1. Download InternManager_Win.zip.
2. Extract the archive.
3. Run InternManager.exe.

macOS

1. Download InternManager_Mac.zip.
2. Extract the archive and move InternManager.app to your Applications folder.

Note: Since this application is not signed with an Apple Developer ID, macOS may block the execution. To open it: Right-click the app > Open > Click 'Open' in the dialog box.

Update Procedure (All Platforms)

1. Recommended: Open your current version and use the "Export Data" feature to create a backup.
2. Delete your old application folder (or .app file on macOS).
3. Extract the new version to the same location.

Note: Your database and settings are stored in your user profile (%APPDATA% on Windows, ~/InternManager on macOS) and will persist after the update.

v.1.2.1

Fixed a bug where dates were not showing properly when adding a new v…

v1.2.0

v1.2.0 - Technical Visits & Batch Operations

Intern Manager Pro v1.2.0 brings a major functional expansion with the new Technical Visits module, allowing supervisors to track on-site visits with photographic evidence. This update also introduces "smart" context menus and batch export capabilities to boost productivity.

New Features

Technical Visits Module

• On-Site Tracking: Register supervision visits with Date, Venue, and Observations.
• Photo Evidence: Attach photos to visit records. Files are securely managed, sanitized, and stored in the user's AppData.
• Auto-Cleanup: Deleting a visit record automatically removes the associated photo file from the disk to prevent storage bloat.

Productivity & Batch Operations

• Smart Context Menu: The right-click menu now adapts to your selection:
  • Single Select: Standard actions (Edit, Grades, Docs).
  • Multi-Select (Ctrl/Shift+Click): Batch actions appear (e.g., "Export Photos for selected students").
• Batch Photo Backup: New option in Settings to export ALL photos from the database at once.

UI & UX Improvements

• Extended Selection: Enabled Ctrl+Click and Shift+Click on the main student list.
• Visual Clarity: Added grid lines to dialog tables and optimized column widths for better readability.
• Defensive UI: The "Venue" dropdown in visits now auto-selects the intern's current workplace but allows overrides.

Fixes & Refactoring

• Date Handling: Refactored date formatting logic (moved from ReportService to Intern model) to reduce code duplication (DRY).
• Database Migrations: Added CREATE TABLE IF NOT EXISTS for the visits table, ensuring seamless updates for existing users.
• Error Handling: Fixed a crash when trying to delete non-existent physical files.

Technical Details

• New Service: VisitService added to the dependency injection container.
• Architecture: VisitRepository implements the standard repository pattern.
• Dependencies: Updated internal logic to use pathlib for robust file path handling across OS.

---

Installation & Update

Windows

1. Download InternManager-v1.1.0.zip.
2. Extract the archive.
3. Run InternManager.exe.

macOS

1. Download InternManager-Mac-Build.zip.
2. Extract the archive and move InternManager.app to your Applications folder.

Note: Since this application is not signed with an Apple Developer ID, macOS may block the execution. To open it: Right-click the app > Open > Click 'Open' in the dialog box.

Update Procedure (All Platforms)

1. Recommended: Open your current version and use the "Export Data" feature to create a backup.
2. Delete your old application folder (or .app file on macOS).
3. Extract the new version to the same location.

Note: Your database and settings are stored in your user profile (%APPDATA% on Windows, ~/InternManager on macOS) and will persist after the update.

v1.1.0

Intern Manager Pro v1.1.0

Update v1.1.0 of Intern Manager Pro. This release focuses on usability improvements, critical bug fixes regarding grading logic, and a major architectural refactoring of the data access layer.

Key Features & Improvements

• Context Menus: Added right-click functionality to the student list for quick access to actions (Edit, Grades, Documents).
• Workflow Optimization: The system now prompts the user to open PDF reports immediately after generation.
• UI Integration: Fixed application icon rendering on the Windows taskbar.

Bug Fixes

• Grading Logic: Fixed calculation issue where imported grades could exceed the maximum defined weight.
• Report Status: Adjusted logic to ensure only documents marked as "Approved" count towards completion status.
• Import Engine: Improved stability and detection algorithms for Excel and CSV file imports.

Technical Details

• Architecture: Deep refactoring of the Repository Layer for improved maintainability and transaction safety.
• Dependencies: Updated core libraries to latest stable versions.

Installation & Update

Windows

1. Download InternManager-v1.1.0.zip.
2. Extract the archive.
3. Run InternManager.exe.

macOS

1. Download InternManager-Mac-Build.zip.
2. Extract the archive and move InternManager.app to your Applications folder.

Note: Since this application is not signed with an Apple Developer ID, macOS may block the execution. To open it: Right-click the app > Open > Click 'Open' in the dialog box.

Update Procedure (All Platforms)

1. Recommended: Open your current version and use the "Export Data" feature to create a backup.
2. Delete your old application folder (or .app file on macOS).
3. Extract the new version to the same location.

Note: Your database and settings are stored in your user profile (%APPDATA% on Windows, ~/InternManager on macOS) and will persist after the update.

v1.0.0 - Official Release (Windows & macOS)

Intern Manager Pro v1.0.0

First stable release of Intern Manager Pro. This is a desktop application designed to streamline the management of academic internships, replacing spreadsheet-based workflows with a centralized database solution.

Key Features

• Dashboard: Real-time overview of active interns, pending documents, and status distribution using Matplotlib.
• CRUD Management: Complete system for managing Interns, Venues (Hospitals/Clinics), and Evaluation Criteria.
• PDF Reporting: Generates detailed PDF reports including grades, attendance records, and supervisor signatures.
• Excel/CSV Support: Native import and export capabilities for interoperability with other administrative tools.
• Academic Tools: Modules for tracking Internship Documents (contracts, plans), Supervisor Meetings, and weighted grading systems.
• UX: Context menus, system tray integration, and responsive layouts.

Technical Details

• Language: Python 3.12+
• GUI Framework: PySide6 (Qt for Python)
• Database: SQLite (Raw SQL implementation via Repository Pattern)
• Architecture: MVC (Model-View-Controller)
• Dependencies: pandas, openpyxl, matplotlib, qtawesome

Installation & Usage

Windows

1. Download InternManager.zip.
2. Extract the archive.
3. Run InternManager.exe.

macOS

1. Download InternManager-Mac-Build.zip.
2. Run the application.

Note: Since this application is not signed with an Apple Developer ID, macOS may block the execution. To open it: Right-click the app > Open > Click 'Open' in the dialog box.