Contract Entities¶
Why This Exists¶
This document defines Contract Domain entities with identity.
Owner¶
The owner is the Chief Product Officer and Enterprise Architect.
Business Value¶
Clear entities support contract delivery tracking, financial visibility, supplier coordination, risk management, closeout, and learning.
Entity Catalogue¶
| Entity | Purpose | Key attributes | Business rules | Relationships | MVP status |
|---|---|---|---|---|---|
| Contract Workspace | Main contract delivery workspace. | ContractWorkspaceId, OrganizationId, award reference, status. | Must start from award or creation event. | Owns delivery state. | MVP |
| Delivery Plan | Delivery plan. | DeliveryPlanId, dates, owner, status. | Must define milestones or deliverables. | Belongs to workspace. | MVP |
| Milestone | Delivery checkpoint. | MilestoneId, title, due date, status. | Must have due date or planned sequence. | Belongs to plan. | MVP |
| Deliverable | Contract output. | DeliverableId, description, owner, status. | Must link to contract scope. | Belongs to plan/workspace. | MVP |
| Supplier Coordination Record | Supplier coordination item. | CoordinationId, supplier ref, action, status. | Must be contract-specific. | References Supplier/Marketplace. | Later |
| Variation | Scope, cost, or schedule change. | VariationId, type, impact, approval status. | Must be approved before baseline change. | Belongs to workspace. | MVP |
| Invoice | Invoice record. | InvoiceId, amount, due date, status. | Must link to contract/work milestone where applicable. | Belongs to financial tracking. | MVP |
| Payment | Payment record. | PaymentId, invoice ID, amount, status, date. | Must reference invoice. | Belongs to financial tracking. | MVP |
| Performance Record | Performance measurement. | PerformanceId, metric, value, period. | Must have metric definition. | Feeds contract health. | Later |
| Contract Risk | Contract risk. | RiskId, severity, cause, mitigation, owner. | Must have status and mitigation where possible. | Belongs to risk register. | MVP |
| Closeout Record | Closure record. | CloseoutId, checklist, final status, date. | Required before final closure. | Belongs to workspace. | MVP |
| Contract Lesson Learned | Learning record. | LessonId, category, insight, action. | Must link to contract context. | Feeds memory. | MVP |
Entity Rule¶
Contract entities must preserve contract context and must not overwrite Bid, Organization, Supplier, Funding, or Intelligence source facts.