Jonah
2177922678
- Move USER_GUIDE, planning docs, and session logs to docs/ - Untrack FedexAPI.txt (contains live API credentials) and OnPart_inv.csv (large data file) - Update .gitignore to cover FedexAPI.txt and *_inv.csv going forward - Delete junk files: =1.23.0, Address.txt, stale screenshot Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
43 lines
3.5 KiB
Markdown
43 lines
3.5 KiB
Markdown
# Session Hand-off Log — Parts & Invoice Lookup
|
|
|
|
> [!IMPORTANT]
|
|
> **To the next Claude Session:** Read this log to see all modifications. The facts details section is collapsible, resize performance is optimized, desktop icons are fully compiled and configured, and a thorough Stamps.com integration research report is available.
|
|
|
|
## Summary of Changes
|
|
|
|
### 1. Collapsible Details Dropdown & Preserved Left-Alignment
|
|
- **Component:** `_CollapsibleFrame` added in [app/ui_parts_tab.py](file:///c:/Users/mario/OneDrive/Documents/Claude/Projects/Part%20Lookup%20Program%20%281%29/app/ui_parts_tab.py).
|
|
- **Behavior:** Wraps facts grid; starts **collapsed (closed)** by default. Preserves standard w-alignment (left-aligned) for maximum scan reading speed.
|
|
|
|
### 2. Resize Performance Optimization (Smooth Dragging)
|
|
- **Problem:** Resizing the window caused high-frequency flashing/lag.
|
|
- **Solution:** Swapped `fg_color="transparent"` for solid `fg_color=T.PANEL_BG` inside scrollable frames `self._results_scroll` and `self._detail`. It completely bypasses expensive recursive canvas calculations during resize ticks, resulting in zero-flash smooth resizing (fully visually transparent to users).
|
|
|
|
### 3. Desktop Icon Integration & Standalone Executable Custom Icon
|
|
- **Task:** Integrate `icon_large.png` and `icon_small.png` into the app.
|
|
- **Implementation Strategy:**
|
|
1. **Assets Directory:** Copied the icons to `app/assets/`.
|
|
2. **Automated Conversion:** Updated both `build.bat` and `run_dev.bat` to automatically convert `icon_small.png` into a high-quality Windows multi-resolution icon `icon.ico` using Pillow at execution time.
|
|
3. **Window Icon (Runtime):** Programmed [app/ui.py](file:///c:/Users/mario/OneDrive/Documents/Claude/Projects/Part%20Lookup%20Program%20%281%29/app/ui.py) to automatically load and display the native icon (preferring the `.ico` file, falling back to `.png` using `ImageTk`) on the main window title bar.
|
|
4. **Executable Icon (Windows Explorer):** Configured [PartsLookup.spec](file:///c:/Users/mario/OneDrive/Documents/Claude/Projects/Part%20Lookup%20Program%20%281%29/PartsLookup.spec) to use the generated `icon.ico` as the system icon for `PartsLookup.exe` under Windows File Explorer (`icon="app/assets/icon.ico"`), and corrected PyInstaller bundling destination paths.
|
|
|
|
### 4. Robust & Lock-Proof Scripting
|
|
- **Improvements:** `build.bat` and `run_dev.bat` auto-activate `.venv` or `venv` virtual environments, select standard python commands automatically, force-kill any running background app processes to prevent PermissionErrors, and prompt users with a retry dialog if the output folder is locked by an open File Explorer window.
|
|
|
|
### 5. Stamps.com Shipping Integration Research
|
|
- **Request:** Investigate the feasibility of adding Stamps.com connectivity to the Shipping Tab.
|
|
- **Result:** Conducted research and compiled a detailed report at `C:\Users\mario\.gemini\antigravity\brain\b9bbe4ff-e586-4a85-a0b8-98f43d9ac965\stamps_integration_research.md`. It outlines direct API integration (REST/SOAP) and compares it to highly recommended middleware multi-carrier APIs (EasyPost/Shippo) with Python code blocks, Mermaid architecture diagrams, and development roadmap stages.
|
|
|
|
---
|
|
|
|
## How to Verify
|
|
1. Run development server:
|
|
```cmd
|
|
run_dev.bat
|
|
```
|
|
2. Build standalone executable:
|
|
```cmd
|
|
build.bat
|
|
```
|
|
3. Verify that `dist\PartsLookup\PartsLookup.exe` displays the custom icon in Windows Explorer, and the running window displays the icon on the top-left taskbar natively.
|