61 lines
3.3 KiB
Markdown
61 lines
3.3 KiB
Markdown
# DataLoom completion report
|
|
|
|
**Project status:** Initial release complete; future enhancements are pending.
|
|
|
|
## Delivered
|
|
|
|
- Offline Windows desktop application built with Python, PySide6, and Qt.
|
|
- Same-format Bitwarden JSON or CSV import for two or more files.
|
|
- Unencrypted-export validation and import warning.
|
|
- Conservative URL normalization, including case folding, trailing-slash removal, default-port handling, and `www.` equivalence.
|
|
- Automatic removal of exact login duplicates using item type, normalized username, password, and normalized URI values.
|
|
- Likely-duplicate review for same type, URL, and username with differing values.
|
|
- Structured side-by-side duplicate comparison.
|
|
- Newest-record recommendation when valid `revisionDate` values are available.
|
|
- Manual review choices to keep one selected record or keep both records.
|
|
- Same-format JSON/CSV export with CSV loss warnings.
|
|
- In-app and plain-text audit logging, with full-secret logging optional and disabled by default.
|
|
- Synthetic Bitwarden-style fixtures and automated tests.
|
|
- Portable Windows 11 executable built with PyInstaller.
|
|
- MIT license, security guidance, disclaimer, quick how-to, and README screenshot.
|
|
|
|
## Validation performed
|
|
|
|
- Local synthetic test suite: **6 passed**.
|
|
- Synthetic merge smoke test: 8 records loaded, 1 exact duplicate removed, 7 records retained, 2 review groups generated.
|
|
- JSON export round-trip verified.
|
|
- Windows 11 synthetic test suite: **6 passed**.
|
|
- Windows PyInstaller build completed successfully.
|
|
- Packaged executable launch check passed and remained running for 8 seconds.
|
|
- Interactive Windows 11 testing by Rob confirmed the application behavior was satisfactory.
|
|
|
|
## Release
|
|
|
|
- Version: `v0.1.0`
|
|
- Asset: `DataLoom-v0.1.0-windows-x64.exe`
|
|
- Target: Windows 11 x64
|
|
- Release URL: `https://gitea.ledrew.me/ledadmin/DataLoom/releases/tag/v0.1.0`
|
|
|
|
## Public-readiness review
|
|
|
|
A final read-only review was completed before publication. The tracked repository contains no real Bitwarden exports, credentials, API keys, SSH keys, personal identifiers, internal network addresses, or local machine paths. The fixtures contain synthetic data only. The Git author email `admin@ledrew.me` was reviewed and explicitly approved for public visibility.
|
|
|
|
Release and download URLs were verified to use `https://gitea.ledrew.me` rather than the internal Gitea address.
|
|
|
|
## Known limitations
|
|
|
|
- CSV cannot represent every Bitwarden JSON feature losslessly. DataLoom reports known CSV loss risks; JSON is preferred for complete preservation.
|
|
- The current UI is read-only apart from duplicate keep decisions; it does not edit individual vault records.
|
|
- Windows desktop interaction was validated manually; Linux GUI testing was intentionally skipped.
|
|
- The application is not affiliated with or endorsed by Bitwarden.
|
|
- Generated exports and audit logs are not encrypted or automatically deleted.
|
|
|
|
## Future enhancements
|
|
|
|
- Improve field-level difference highlighting beyond the current structured comparison.
|
|
- Add richer support for all Bitwarden item types, attachments, passkeys, linked fields, and nested custom data.
|
|
- Add explicit export preflight and stronger loss-detection for CSV.
|
|
- Add optional secure handling and retention controls for audit logs.
|
|
- Add application icons, screenshots, and polished packaging metadata.
|
|
- Add more comprehensive Windows UI automation.
|