davide.trentin/nc_program_manager
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
nc_program_manager/.paul/ROADMAP.md
dtrentin 68c5a555f3 chore(paul): close v0.6 Fagor Support milestone, log ISS-012..017 
PAUL bookkeeping per chiusura milestone v0.6 (Phase 16: 16-01 + 16-02):
- STATE.md — sezione v0.6 + Phase 16-01 + 16-02 fixup post-review.
- ROADMAP.md — Milestone v0.6 + Phase 16 (2 plans).
- paul.json — version 0.6.0, milestone Fagor Support, phase 16
  fagor-ftp.
- phases/16-fagor-ftp/ — 16-01-PLAN.md + 16-01-SUMMARY.md (impl
  iniziale), 16-02-PLAN.md + 16-02-SUMMARY.md (fix post-review).
- ISSUES.md — ISS-012..ISS-017 derivati da code review v0.6:
  - ISS-012: Fagor ReadActiveProgramAsync/SelectMainProgram non impl
  - ISS-013: Program.Invia accoppia FanucProgram a tutti i produttori
  - ISS-014: ResolvePath null-folder NRE pattern (Siemens/Mitsubishi/Fagor)
  - ISS-015: encoding source-file rischio codepage Windows non-UTF8
  - ISS-016: WriteProgramAsync validator riceve path se Name null
  - ISS-017: FagorFtpClient.Ping swallow senza log

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-25 20:27:44 +02:00

8.2 KiB
Raw Blame History

Roadmap: FanucProgramManager

Overview

Console tool for CNC program transfer and file management. Fanuc FOCAS base, expanding to multi-CN (Heidenhain LSV2, Siemens FTP, Mitsubishi FTP) with NC program validation.

Current Milestone

v0.1 Multi-CN Release (v0.1.0) Status: ✅ Complete Phases: 5 of 5 complete Completed: 2026-05-13

Phases

Phase Name Plans Status Completed
1 cnc-abstraction 1 ✅ Complete 2026-05-13
2 heidenhain 1 ✅ Complete 2026-05-13
3 siemens 1 ✅ Complete 2026-05-13
4 program-wiring 1 ✅ Complete 2026-05-13
5 nc-validator 1 ✅ Complete 2026-05-13

Phase Details

Phase 1: cnc-abstraction ✅

Goal: Fix namespace, add all Cnc/ files to csproj, complete ICncMachine + IFanucMachine with 3-file support Completed: 2026-05-13

Delivered:

  • Namespace Fanuc_integration.Cnc.* → FanucProgramManager.Cnc.* (29 files)
  • IFocasDialect extended: UploadStart/DownloadStart accept short fileType
  • IFanucMachine interface: extends ICncMachine with tool offset + work zero R/W
  • CncManufacturer enum: Fanuc, Heidenhain, Siemens
  • All 29 Cnc/**/*.cs files added to csproj

Phase 2: heidenhain ✅

Goal: Implement ICncMachine for Heidenhain TNC via LSV2 protocol Completed: 2026-05-13

Delivered:

  • HeidenhainConnectionConfig — IP, port 19000, credentials, timeout
  • Lsv2Client — TCP framing, CRC-16/CCITT, login (SELECT+LOG_IN), ReceiveFile/SendFile
  • HeidenhainMachine : ICncMachine — RunGuardedAsync pattern, state machine

Phase 3: siemens ✅

Goal: Implement ICncMachine for Siemens Sinumerik via FTP Completed: 2026-05-13

Delivered:

  • SiemensConnectionConfig — IP, port 21, creds, program dir /_N_MPF_DIR/
  • SiemensFtpClient — FtpWebRequest wrapper, ASCII mode, passive
  • SiemensMachine : ICncMachine

Bonus (post-apply):

  • MitsubishiConnectionConfig / MitsubishiFtpClient / MitsubishiMachine : ICncMachine
  • CncManufacturer.Mitsubishi added to enum + factory + CLI

Phase 4: program-wiring ✅

Goal: Wire all manufacturers into Program.cs + InputArgs Completed: 2026-05-13

Delivered:

  • CncMachineFactory — creates right ICncMachine from InputArgs
  • InputArgs — added manufacturer, username, password fields
  • Program.cs — full rewrite using ICncMachine factory; Fanuc 3-file via IFanucMachine cast

Phase 5: nc-validator ✅

Goal: Per-manufacturer NC program validator runs inside WriteProgramAsync before upload Completed: 2026-05-13

Delivered:

  • ValidationSeverity / ValidationError / ValidationResult model types
  • INcProgramValidator + NcProgramValidator with universal + per-manufacturer rules
  • Validator injected into all 4 machine classes
  • NcProgramValidatorTests — 30+ NUnit tests

Next Milestone

v0.2 NcProgramManager ✅ Complete Status: Complete Phases: 4 of 4 complete Completed: 2026-05-17

Phase Name Plans Status Completed
06 rename-cleanup 1 ✅ Complete 2026-05-17
07 license-core 1 ✅ Complete 2026-05-17
08 license-integration 1 ✅ Complete 2026-05-17
09 license-generator 1 ✅ Complete 2026-05-17

Phase 06: rename-cleanup ✅

Goal: Rename FanucProgramManager → NcProgramManager (namespace, project files, test folder). Delete dead FANUCMachine.cs. Completed: 2026-05-17 Plans: [x] 06-01: Namespace + file rename

Phase 07: license-core ✅

Goal: IMachineFingerprint, ILicenseValidator, RSA signature verification, .lic file model Completed: 2026-05-17 Plans: [x] 07-01: RSA core + interfaces + 6 unit tests

Phase 08: license-integration ✅

Goal: Wire license system into Program.cs, delete checkLicense, remove -chiave=, hardcode license.lic next to EXE Completed: 2026-05-17 Plans: [x] 08-01: Program.cs wiring

Phase 09: license-generator ✅

Goal: Separate generator console app — reads machine fingerprint, signs, writes .lic file Completed: 2026-05-17 Plans: [x] 09-01: LicenseGenerator standalone tool + real public key embedded

Standalone Phases (post-v0.2)

Phase Name Plans Status
10 readme-docs 1 ✅ Complete

Phase 10: readme-docs ✅

Goal: Write Italian README for NcProgramManager and LicenseGenerator repos — describe what each does, prerequisites, setup, CLI usage, license workflow. Depends on: Phase 09 (license workflow complete) Plans: [x] 10-01: Italian READMEs for both repos

Milestone v0.3 — Code Quality ✅

Status: Complete Phases: 2 of 2 complete Completed: 2026-05-18

Phase Name Plans Status Completed
11 refactor 2 ✅ Complete 2026-05-18
12 docs-cli 1 ✅ Complete 2026-05-18

Phase 11: refactor ✅

Goal: Clean Architecture refactor of Program.cs — extract ArgParser, fix error handling in Scarica/Invia (try/finally, surface CncResult.Errors), remove AesCrypt dead code. Completed: 2026-05-18 Plans:

  • 11-01: Extract ArgParser + clean Program.cs structure
  • 11-02: Fix Scarica/Invia error handling

Phase 12: docs-cli ✅

Goal: Complete README parameter table — all 16 CLI args with descriptions; error codes with causa + soluzione. Completed: 2026-05-18 Plans:

  • 12-01: README complete CLI reference + error codes table

Milestone v0.4 — Robustness ✅

Status: Complete Phases: 2 of 2 complete Completed: 2026-05-18

Phase Name Plans Status Completed
13 robustness-fixes 1 ✅ Complete 2026-05-18
14 test-hardening 1 ✅ Complete 2026-05-18

Phase 13: robustness-fixes ✅

Goal: Fix ISS-001, ISS-005, ISS-006 — null guard on MachineFingerprint WMI properties, dispose SHA256CryptoServiceProvider, fix Lsv2Client connect timeout to actually abort hung task. Issues addressed: ISS-001, ISS-005, ISS-006 Completed: 2026-05-18 Plans:

  • 13-01: Null guard WMI, SHA256 dispose, LSV2 timeout abort

Phase 14: test-hardening ✅

Goal: Fix ISS-007, ISS-008 — env-var-gated hardware test scaffolding for all 3 machine types; LicenseFile edge-case unit tests; empty-fingerprint guard in LicenseValidator. Issues addressed: ISS-007 (closed), ISS-008 (scaffold complete; full closure requires Windows hardware run) Completed: 2026-05-18 Plans:

  • 14-01: HardwareTestHelper + LicenseFileTests + Validate_EmptyFingerprint

Milestone v0.5 — Operational Quality ✅

Status: Complete Phases: 1 of 1 complete Completed: 2026-05-18

Phase Name Plans Status Completed
15 logging 2 ✅ Complete 2026-05-18

Phase 15: logging ✅

Goal: Add structured logging (ISS-004), surface silent catch blocks (ISS-003), route all operator output through NLog. Issues addressed: ISS-003 (closed), ISS-004 (closed) Completed: 2026-05-18 Plans:

  • 15-01: NLog 5.2.8 + nlog.config + logger fields in 5 classes + event handler catches + Program.cs error logging
  • 15-02: Replace all Console.Write/WriteLine with _log.Info; console target Info-only plain layout

Milestone v0.6 — Fagor Support ✅

Status: Complete Phases: 1 of 1 complete Completed: 2026-05-25

Phase Name Plans Status Completed
16 fagor-ftp 2 ✅ Complete 2026-05-25

Phase 16: fagor-ftp ✅

Goal: Aggiungere supporto Fagor CNC via FTP. Riuso pattern Siemens/Mitsubishi. Refactor validator per gating per-produttore. Modelli supportati: 8060/8065/8070 nativi, 8055 con opzione Ethernet. Issues addressed: — Completed: 2026-05-25 Plans:

  • 16-01: Fagor FTP machine + validator gating + CLI integration + test scaffold
  • 16-02: Fagor fixup post-review (validator extension fix, ñ escape, lock tests Siemens/Heidenhain, factory test)

Roadmap updated: 2026-05-25 — v0.6 milestone complete; Phase 16 (fagor-ftp) 16-01 + 16-02 complete.