ComplianceNFs/TODOs-and-Roadmap.md
Giuliano Paschoalino 606b841435 feat: Add ComplianceNFs.Infrastructure.Tests project and implement unit tests for various services
- Added ComplianceNFs.Infrastructure.Tests project to the solution.
- Implemented unit tests for AccessDbRepository, ArchivingService, AttachmentRepository, InvoiceIngestionService, MailListener, MonitorViewModel, and Worker.
- Enhanced existing tests with additional assertions and mock setups.
- Updated TODOs and roadmap documentation to reflect changes in service implementations and testing coverage.
- Modified ComplianceNFs.sln to include new test project and adjust solution properties.
2025-06-18 16:34:44 -03:00

106 lines
3.8 KiB
Markdown

# ComplianceNFs TODOs and Roadmap
## TODOs in Codebase
### ComplianceNFs.Infrastructure/Archiving/FileArchiver.cs
- [x] FileArchiver.ArchiveAsync: Create subfolder for invoice.Status, move file
### ComplianceNFs.Infrastructure/Mail/MailListener.cs
- [x] MailListener.StartListening: Connect to Outlook app, filter by allowlist, support account/folder selection, recursively process subfolders, raise NewMailReceived
- [x] Add logging and error handling for Outlook interop failures
### ComplianceNFs.Infrastructure/Parsers/PdfParser.cs
- [x] PdfParser.Parse: Use iTextSharp or PdfSharp to extract text/numbers via regex
### ComplianceNFs.Infrastructure/Parsers/XmlParser.cs
- [x] XmlParser.Parse: Use System.Xml to parse known elements
### ComplianceNFs.Infrastructure/Repositories/AccessDbRepository.cs
- [x] AccessDbRepository.GetByUnidade: Implement actual query to Access DB
- [x] AccessDbRepository.GetByUnidadeAndMonth: Implement actual query to Access DB
### ComplianceNFs.Infrastructure/Repositories/AttachmentRepository.cs
- [x] AttachmentRepository.SaveRawAsync: Implement actual insert into Postgres attachments table
- [x] AttachmentRepository.UpdateMatchAsync: Implement actual update in Postgres
### ComplianceNFs.Core/Application/Services
- [x] InvoiceIngestionService: Implement ingestion logic and subscribe to NewMailReceived
- [x] MatchingService: Implement invoice matching logic
- [x] Add fallback and multi-invoice sum logic in MatchAsync
- [x] ComplianceService: Implement compliance validation logic
- [x] NotificationService: Implement notification logic for mismatches
- [x] ArchivingService: Implement archiving logic for final status
### ComplianceNFs.Monitor/MonitorViewModel.cs
- [ ] MonitorViewModel: Inject IInvoiceStatusStream and subscribe to updates
- [ ] MonitorViewModel.ForceScan: Call service to force ingestion cycle
### ComplianceNFs.Service/Program.cs
- [x] Register application services (InvoiceIngestionService, MatchingService, etc.)
---
## Roadmap to Finish the App
### 1. Infrastructure Layer
- [x] **FileArchiver**: Implement logic to create subfolders by `InvoiceStatus` and move files accordingly.
- [x] **MailListener**: Use Outlook Interop to connect to local Outlook, filter by allowlist, support account/folder selection, recursively process subfolders, and raise `NewMailReceived` event.
- [x] **PdfParser**: Integrate iTextSharp or PdfSharp, extract invoice data using regex.
- [x] **XmlParser**: Use System.Xml to parse invoice XMLs and map to `ParsedInvoice`.
- [x] **AccessDbRepository**: Implement queries to Access DB for buying records.
- [x] **AttachmentRepository**: Implement Postgres insert/update for invoice attachments.
- [ ] Add robust logging and error handling for all infrastructure components.
### 2. Application Layer
- [x] Implement and register:
- InvoiceIngestionService
- MatchingService
- ComplianceService
- NotificationService
- ArchivingService
- [x] Wire up these services in DI in `Program.cs`.
- [x] Add fallback and multi-invoice sum logic in `MatchingService.MatchAsync`.
### 3. Service Host
- [x] Ensure all services are registered and started in the Worker.
- [ ] Implement polling and retry logic as per configuration.
### 4. WPF Monitor
- [ ] Inject and subscribe to `IInvoiceStatusStream` in `MonitorViewModel`.
- [ ] Implement `ForceScan` to trigger ingestion from UI.
- [ ] Bind UI to show recent invoice status updates.
### 5. Configuration & Testing
- [ ] Test all configuration values from `appsettings.json`.
- [ ] Add error handling, logging, and validation.
- [ ] Write integration tests for end-to-end flow.
---
**Tip:**
- Tackle infrastructure TODOs first, then application services, then UI and orchestration.
- Use comments in code for any business logic or mapping details that need clarification.