kawa
ed0f0a0607
- 04-02-SUMMARY.md: TDD execution, 3 commits, 6 files, 75 tests green - STATE.md: advanced to 04-02 complete, added 3 new decisions - ROADMAP.md: phase 4 marked complete (2/2 plans done) - REQUIREMENTS.md: SCRPT-02 and SCRPT-03 marked complete
122 lines
5.1 KiB
Markdown
122 lines
5.1 KiB
Markdown
# Requirements: ImpTune
|
|
|
|
**Defined:** 2026-04-10
|
|
**Core Value:** Generate a complete, working printer deployment package (script + drivers + icon) in minutes instead of manually scripting each printer setup.
|
|
|
|
## v1 Requirements
|
|
|
|
Requirements for initial release. Each maps to roadmap phases.
|
|
|
|
### Driver Management
|
|
|
|
- [x] **DRV-01**: User can upload a driver package (ZIP containing INF + supporting files)
|
|
- [x] **DRV-02**: System parses uploaded INF files and extracts valid driver names (DriverDesc)
|
|
- [x] **DRV-03**: User can select driver name from parsed INF dropdown (no free-text)
|
|
- [x] **DRV-04**: Driver packages are persisted on Docker volume across container restarts
|
|
- [x] **DRV-05**: System flags unused files in driver packages to help reduce package size
|
|
|
|
### Printer Configuration
|
|
|
|
- [x] **PRNT-01**: User can set printer display name
|
|
- [x] **PRNT-02**: User can set printer IP address or hostname
|
|
- [x] **PRNT-03**: System auto-suggests port name from IP (user can override)
|
|
- [x] **PRNT-04**: User can set duplex mode (one-sided, long-edge, short-edge)
|
|
- [x] **PRNT-05**: User can set color vs. grayscale default
|
|
- [x] **PRNT-06**: User can set paper size (A4, Letter, Legal at minimum)
|
|
- [x] **PRNT-07**: User can set collate on/off
|
|
- [x] **PRNT-08**: User can assign printer to a client/tenant label
|
|
- [x] **PRNT-09**: Printer configurations are persisted in SQLite across sessions
|
|
- [x] **PRNT-10**: User can regenerate a package from saved config without re-uploading drivers
|
|
|
|
### Script Generation
|
|
|
|
- [x] **SCRPT-01**: System generates PowerShell install script (pnputil staging + Add-PrinterPort + Add-PrinterDriver + Add-Printer + Set-PrintConfiguration)
|
|
- [x] **SCRPT-02**: System generates PowerShell uninstall script (Remove-Printer + Remove-PrinterDriver + Remove-PrinterPort)
|
|
- [x] **SCRPT-03**: System generates Intune detection script (registry check for printer name)
|
|
- [x] **SCRPT-04**: Generated install script detects SYSTEM vs. user context and self-elevates via UAC when run by user
|
|
- [x] **SCRPT-05**: Generated install script includes 64-bit WOW64 relaunch guard for Intune's 32-bit execution context
|
|
|
|
### Package Export
|
|
|
|
- [ ] **PKG-01**: User can export a complete .intunewin package (script + drivers + detection + metadata)
|
|
- [ ] **PKG-02**: .intunewin is generated natively in Python (no IntuneWinAppUtil.exe dependency)
|
|
- [ ] **PKG-03**: User can export a NinjaRMM ZIP package (install script + driver folder)
|
|
- [ ] **PKG-04**: User can upload a custom PNG icon for Intune app display (256x256, max 750KB)
|
|
- [ ] **PKG-05**: User can preview and copy Intune install/uninstall command strings before export
|
|
|
|
### Infrastructure
|
|
|
|
- [x] **INFRA-01**: Application runs as a single Docker container
|
|
- [x] **INFRA-02**: Application has minimal runtime dependencies (no Node.js, no external DB)
|
|
|
|
## v2 Requirements
|
|
|
|
Deferred to future release. Tracked but not in current roadmap.
|
|
|
|
### Bulk Operations
|
|
|
|
- **BULK-01**: User can import multiple printers from CSV
|
|
- **BULK-02**: User can export all printers for a client as a batch
|
|
|
|
### Advanced Features
|
|
|
|
- **ADV-01**: Package version history per printer
|
|
- **ADV-02**: API / CLI mode for CI/CD integration
|
|
- **ADV-03**: Print server migration path (Printbrm import)
|
|
|
|
## Out of Scope
|
|
|
|
| Feature | Reason |
|
|
|---------|--------|
|
|
| User authentication / logins | Internal tool on private network; simplicity over security |
|
|
| Direct Intune API push | Requires per-tenant OAuth, multi-tenant app registration — scope explosion |
|
|
| Direct NinjaRMM API push | Same as Intune API push — keep the tool as a package generator |
|
|
| Real-time printer status / monitoring | Requires SNMP polling and network access to client sites — different product |
|
|
| Universal Print integration | Different deployment model, requires Azure subscription |
|
|
| Mobile / tablet UI | Target users are at workstations; no validated demand |
|
|
| Multi-language / localization | English only for v1; no demand signal |
|
|
| Full audit log / deployment history | MSPs already have Intune/RMM logs |
|
|
|
|
## Traceability
|
|
|
|
Which phases cover which requirements. Updated during roadmap creation.
|
|
|
|
| Requirement | Phase | Status |
|
|
|-------------|-------|--------|
|
|
| INFRA-01 | Phase 1 | Complete |
|
|
| INFRA-02 | Phase 1 | Complete |
|
|
| DRV-01 | Phase 2 | Complete |
|
|
| DRV-02 | Phase 2 | Complete |
|
|
| DRV-03 | Phase 2 | Complete |
|
|
| DRV-04 | Phase 2 | Complete |
|
|
| DRV-05 | Phase 2 | Complete |
|
|
| PRNT-01 | Phase 3 | Complete |
|
|
| PRNT-02 | Phase 3 | Complete |
|
|
| PRNT-03 | Phase 3 | Complete |
|
|
| PRNT-04 | Phase 3 | Complete |
|
|
| PRNT-05 | Phase 3 | Complete |
|
|
| PRNT-06 | Phase 3 | Complete |
|
|
| PRNT-07 | Phase 3 | Complete |
|
|
| PRNT-08 | Phase 3 | Complete |
|
|
| PRNT-09 | Phase 3 | Complete |
|
|
| PRNT-10 | Phase 3 | Complete |
|
|
| SCRPT-01 | Phase 4 | Complete |
|
|
| SCRPT-02 | Phase 4 | Complete |
|
|
| SCRPT-03 | Phase 4 | Complete |
|
|
| SCRPT-04 | Phase 4 | Complete |
|
|
| SCRPT-05 | Phase 4 | Complete |
|
|
| PKG-01 | Phase 5 | Pending |
|
|
| PKG-02 | Phase 5 | Pending |
|
|
| PKG-03 | Phase 5 | Pending |
|
|
| PKG-04 | Phase 5 | Pending |
|
|
| PKG-05 | Phase 5 | Pending |
|
|
|
|
**Coverage:**
|
|
- v1 requirements: 27 total
|
|
- Mapped to phases: 27
|
|
- Unmapped: 0
|
|
|
|
---
|
|
*Requirements defined: 2026-04-10*
|
|
*Last updated: 2026-04-10 after roadmap creation*
|