docs-piam/references/gap-analysis-module-2-todo.md

Module 2 Remediation TODOs

Action items derived from docs/references/gap-analysis-module-2.md. Track each task until the requirement transitions to ✅ in the gap analysis.

2.1 Purchase Requisition

• Extend PR DTOs/entities/UI to capture supplier, VAT type, procurement method, company code, contract number (piam-api PR DTOs & piam-web form).
• Surface last purchase price, stock on hand, and packaging units in the PR item picker (piam-web procurement form + item services).
• Remove automatic approve-on-submit flow; route submissions to workflow reviewers only (piam-web purchase-requisition form logic).
• Add PR search filters for company/vendor and expose those columns in the workspace list.
• Support manual PR numbering and contract metadata persistence (piam-api domain + repository).
• Enforce editable-price permissions, automated vendor pricing guardrails, and inventory threshold controls.

2.2 Request for Quotation

• Block supplier bids submitted after submissionDeadlineUtc in portal services (SupplierPortalService).
• Deliver side-by-side bid comparison UI with automatic best-price highlighting (piam-web RFQ detail component).

2.3 Purchase Orders

• Introduce VAT type/department fields in PO header DTOs and Angular form.
• Add VAT modes (gross/net toggles) and per-line tax splits to item grid (PurchaseOrderItemDto + UI).
• Implement manual/templated PO numbering and VAT schema configuration (PurchaseOrderRepository + UI).
• Add support for multi-schedule milestones, freebies, discounts, and per-line tax calculations (PO domain model & UI).
• Require explicit approval workflow steps in the UI instead of auto-submit, and implement spend-based controls/gates (purchase-order-form component + approval routing).
• Provide PDF/email distribution workflows and e-signature capture for approved POs.
• Persist change-order history and expose PO revision logs (revision tracking and document versioning).
• Enhance PO inquiries with PO-type filters and due-date alerting.
• Create financial postings (AP, GL, withholding tax, deposit tracking) and attachment storage for PO documents.

2.4 Goods Receipt Note

• Build real procurement UI for GRN drafts tied to backend services (replace placeholder component in procurement-goods-receipts.component).
• Allow non-PO receiving paths and add receiving warehouse/delivery note fields (header capture).
• Capture packaging conversions, freebies, discounts, and VAT values per received item (item grid enhancements).
• Add role-based permissions/audit logging for GRN operations (beyond generic API authorization).
• Support direct-to-department receipts that bypass inventory storage.
• Provide GRN print/export endpoints and barcode label generation.
• Persist and calculate receipt-level VAT/discount totals (financial calculations on GRN).

2.5 Return to Supplier

• Implement complete return-to-supplier backend workflow (API, repository, domain models).
• Replace mock UI data in return-to-supplier-workspace.component with live integrations.

2.6 Procurement Documents & Reports

• Deliver canned PR/PO/GRN reports with PDF/Excel export in the procurement workspace.
• Surface module-specific procurement dashboards (not just generic analytics) summarizing pipeline by method/status as described in the spec.
• Create dedicated UI to slice and filter procurement results by procurement method in real-time.

2.7 Integrations & Automation

• Integrate procurement events with GL and asset capitalization modules for financial postings.
• Provide cross-module audit workspace consolidating budget, procurement, accounting, and inventory data.

2.8 Additional Features

• Add configurable reorder points/alerts and UI around AI requisition suggestions.
• Enrich PO data with VAT breakdowns, deposits, guarantees, and discount aggregates.
• Capture procurement timeline metadata (submission deadlines, officials, automatic workday calendars, and payment scheduling) with holiday-aware calculations.