Skip to content

feat(core): start wxPython scaffold with migration parity checklist #27

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
Orinks wants to merge 1 commit into
base: dev
Choose a base branch
from
Open

feat(core): start wxPython scaffold with migration parity checklist #27

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -127,6 +127,10 @@ Settings are stored in:
- Linux: `~/.config/AccessiClock/config.json`
- Portable mode: `./data/config.json`

## Migration Notes

- Current migration parity checklist: `docs/wxpython-migration-parity-checklist.md`

## Development

### Running Tests
Expand Down
52 changes: 52 additions & 0 deletions docs/wxpython-migration-parity-checklist.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,52 @@
# AccessiClock wxPython Migration: Feature Inventory + Parity Checklist

Branch: `rewrite/wxpython-core-manual`
Base: `dev`

## Scope for this phase (must-have)

These are the baseline behaviors required for a usable first wxPython version.

- [x] Native wxPython app entrypoint (`accessiclock.main:main`)
- [x] Main window opens and can be navigated with keyboard only
- [x] Predictable startup focus (initial focus lands on a stable control)
- [x] Config path setup (portable + normal mode)
- [x] Logging setup (file + console)
- [x] Settings load/save scaffold with safe defaults
- [x] Startup/shutdown flow scaffold in app class
- [x] Initial keyboard shortcut map documented in code and README
- [x] Smoke tests for settings/shortcuts/logging scaffolding

## Existing feature inventory

### Core clock behavior
- [x] Time display updates every second
- [x] Hourly chime logic
- [x] Half-hour chime logic
- [x] Quarter-hour chime logic
- [x] Quiet hours in clock service

### Audio + voice
- [x] Sound playback through `AudioPlayer`
- [x] Clock pack sound lookup
- [x] Test chime action
- [x] TTS announce current time

### Accessibility + UX
- [x] Keyboard reachable controls (Tab order + mnemonics)
- [x] Screen-reader-friendly labels/names on key controls
- [x] Status text updates for user feedback
- [x] Focus-safe startup behavior

## Later phase items (not required for this run)

- [ ] Full settings dialog parity audit and cleanup
- [ ] Clock manager UX polish and validation messaging
- [ ] Better accessibility pass for dialog content and error states
- [ ] Structured app state object (if needed after more features land)
- [ ] CI matrix that runs GUI smoke checks on Windows
- [ ] Packaging polish (PyInstaller/win installer flow)

## Notes

This phase intentionally keeps architecture lean: minimal new modules for logging, settings persistence, and shortcut mapping. No new heavy framework layer was introduced.
Loading