Configuration Error
Provider: unknown
Health Diagnostics

Source Mapping

Metric-to-source registry aligned to Project Data Map, OPG templates and Data Map Tagup inputs.

Level 3 — Admin / Governance · Source Mapping — metric decisions & audit

Audience: PMO, Finance, IT. Not the PM daily default — use project routes for operational summary.

PPMP Operating Model

Capture once · Validate once · Use operationally · Export / integrate cleanly

Every capability: view · input · validate · audit · output

  • No feature added only because data exists
  • No simulated/demo values in production export
  • Missing source = no export
  • UAT seed must be marked and excluded from production export
  • Every warning has one clear CTA
  • PM routes default to Operational UX level
Capability Registry (24 capabilities)
Operational: 12Investigation: 6Governance: 6
IDNameLevelPMV·I·Va·A·OFusionPBIOutboundStatus
cost.health-summaryCost HealthOperational5✓·✓·✓DeferredtrueNeeds transformationPartial
cost.itdITD CostOperational5✓✓✓✓✓truetrueReady for Power BIPartial
cost.etcETC CostOperational4✓✓✓✓✓Manual onlytrueReady for Power BIPartial
cost.eacEAC CostOperational5✓·✓·✓truetrueNeeds transformationPartial
cost.variance-baselineVariance vs BaselineOperational5✓·✓·✓truetrueReady for Power BIPartial
cost.forecast-accuracyForecast AccuracyOperational4✓·✓·✓falsetrueReady for Power BIPartial
cost.top-driverTop Cost DriverOperational4✓·✓·✓falsetrueReady for Power BIPartial
cost.exceptions-actionsExceptions & Recommended ActionsOperational5✓·✓··falsefalse—Ready
cost.monthly-monitoringMonthly MonitoringInvestigation3✓·✓·✓falsetrueReady for Power BIPartial
cost.forecast-vs-actualForecast vs ActualInvestigation4✓·✓·✓falsetrueReady for Power BIPartial
cost.eac-viewEAC ViewInvestigation3✓·✓·✓truetrueNeeds transformationPartial
cost.cbs-matrixCBS MatrixInvestigation4✓✓✓✓✓truetrueReady for Power BIPartial
cost.source-detailsSource DetailsInvestigation3✓····falsefalse—Ready
cost.controls-tableCost Controls (12 metrics)Investigation3✓·✓·✓truetrueReady for Power BIPartial
cost.input-cbs-actualAdd CBS ActualOperational5✓✓✓✓✓truetrueReady for Power BIReady
cost.import-actualsImport Cost ActualsOperational5✓·✓✓✓truetrueReady for Power BIReady
forecast.summaryForecast Operational SummaryOperational5✓✓✓✓✓Manual onlytrueReady for Power BIPartial
forecast.importForecast ImportOperational4✓·✓✓✓Manual onlytrueReady for Power BIPartial
governance.source-mappingSource MappingGovernance1✓✓·✓·truefalseReady for Fusion mappingReady
governance.fusion-readinessFusion ReadinessGovernance1✓✓·✓·truefalseReady for Fusion mappingReady
governance.powerbi-modelPower BI Data ModelGovernance1✓····falsetrueReady for Power BIPartial
cost.field-readinessField ReadinessGovernance1✓····falsefalseNot worth exportingReady
cost.audit-logCost Input Audit LogGovernance1✓··✓✓falsefalseManual onlyPartial
governance.data-qualityData QualityGovernance2✓·✓··falsetrueNeeds transformationPartial
Output entities & export gatekeeper
  • Block UAT seed rows from production export (Notes/Justification markers)
  • Missing source = no export row for that metric
  • Graph connection failure = export job fails — no fallback data
  • No simulated or demo values in export payloads
  • Validation status Blocked prevents export commit
  • Warning allows export with quality flags in metadata
  • Needs owner / Needs mapping = human sign-off before production feed
EntityGrainFusionPBIExport gateReadiness
CostActualCbsProjectKey + PeriodMonth + CBSCodetrueYesWarningReady for Power BI
FactFinancialActualsMonthlyProjectKey + Month + MetrictrueYesWarningReady for Power BI
FactForecastProjectKey + PeriodMonth + ForecastLineId + MetricTypeManual onlyYesWarningReady for Power BI
FactCostControlsProjectKey + AsOfMonth + CostControlMetrictrueYesNeeds mappingNeeds transformation
FactCommitmentsProjectKey + POId + AsOfDatetrueYesNeeds ownerReady for Fusion mapping
FactContingencyProjectKey + ContingencyMetric + AsOfDateManual onlyYesNeeds ownerManual only
FactCostVarianceProjectKey + PeriodMonth + CBSCode (optional)trueYesWarningReady for Power BI
RevenueDiscountProjectKey + PeriodMonthDeferredYesBlockedDeferred
FxRatesCurrencyPair + EffectiveDatefalseYesWarningReady for Power BI
FactCashflowMonthlyProjectKey + PeriodMonth + CashflowType + SourceRecordIdManual onlyYesWarningNeeds transformation
FactReceivablesTimingProjectKey + BillingRecordId + ExpectedCollectionMonthManual onlyYesWarningNeeds transformation
FactCostOutflowTimingProjectKey + POId + ExpectedOutflowMonthManual onlyYesWarningNeeds transformation
FactCashflowVarianceProjectKey + PeriodMonth + MetricfalseYesWarningNeeds transformation
FactFinancialResultsVsAOPMonthlyProjectKey + POId + PeriodMonth + Metric + Scenario + RevenueBasisManual onlyYesWarningNeeds transformation
Input → outbound mappings (6)
ScreenSource listAudit eventExport targetOutbound
Financial > Cost → Input → Add CBS ActualPPMP_Contract_Monthly_SnapshotsFINANCIAL_COST_INPUT → PPMP_Audit_Log (CREATE/UPDATE)FactFinancialActualsMonthlyReady for Power BI
Financial > Cost → Input → Import Cost ActualsPPMP_Contract_Monthly_SnapshotsFINANCIAL_COST_INPUT → PPMP_Audit_Log (IMPORT)FactFinancialActualsMonthlyReady for Power BI
Financial > Forecast → ImportPPMP_Forecast_CurvesFINANCIAL_FORECAST_INPUT → PPMP_Audit_Log (IMPORT)FactForecastReady for Power BI
Financial > FX Rates → ImportPPMP_FX_Rates_MonthlyFINANCIAL_FX_INPUT → PPMP_Audit_Log (IMPORT)DimFxRateReady for Power BI
Financial > Cashflow → Input wizardPPMP_Billing_Register (payments) / manual timingFINANCIAL_CASHFLOW_INPUT → PPMP_Audit_Log (CREATE/UPDATE)FactCashflowMonthlyNeeds transformation
Financial > Cashflow → ImportPPMP_Billing_Register / timing overlaysFINANCIAL_CASHFLOW_INPUT → PPMP_Audit_Log (IMPORT)FactCashflowMonthlyNeeds transformation
Export / integration specs (11)
ExportSourceTarget tableValidationOutbound
Cost Actuals (CBS)PPMP_Contract_Monthly_SnapshotsFactFinancialActualsMonthlyWarningReady for Power BI
Forecast CurvesPPMP_Forecast_CurvesFactForecastWarningReady for Power BI
Actuals Monitoring (JP)PPMP_Contract_Monthly_Snapshots, PPMP_PO_Monthly_ConsumptionFactFinancialActualsMonthlyWarningReady for Power BI
Cost Controls SnapshotComputed FinancialCostControlsServiceFactCostControlsNeeds mappingNeeds transformation
PO CommitmentsPPMP_PO_MasterFactCommitmentsNeeds ownerReady for Fusion mapping
Contingency MetricsPPMP_ContractsFactContingencyNeeds ownerManual only
FX RatesPPMP_FX_RatesDimFxRateWarningReady for Power BI
Revenue DiscountPPMP_Contracts / billing contextFactRevenueDiscountBlockedDeferred
Cashflow MonthlyPPMP_Billing_Register, PPMP_PO_Monthly_ConsumptionFactCashflowMonthlyWarningNeeds transformation
Receivables TimingPPMP_Billing_RegisterFactReceivablesTimingWarningNeeds transformation
Cashflow Forecast vs ActualDerived (FinancialCashflowService)FactCashflowVarianceWarningNeeds transformation

No live Fusion connector — specs define feeder readiness only. API routes document read sources for export jobs.

Official Source Registry Validation
Official domain → list mapping
DomainOfficial env varsLists
FinancialsSHAREPOINT_CONTRACTS_LIST_ID, SHAREPOINT_CONTRACT_MONTHLY_SNAPSHOTS_LIST_ID, SHAREPOINT_FORECAST_CURVES_LIST_ID, SHAREPOINT_PO_MASTER_LIST_ID, SHAREPOINT_PO_MONTHLY_CONSUMPTION_LIST_ID, SHAREPOINT_BILLING_REGISTER_LIST_IDPPMP_Contracts, PPMP_Contract_Monthly_Snapshots, PPMP_Forecast_Curves, PPMP_PO_Master, PPMP_PO_Monthly_Consumption, PPMP_Billing_Register
ScheduleSHAREPOINT_PROJECT_SCHEDULE_WBS_LIST_ID, SHAREPOINT_PROJECT_MILESTONES_LIST_ID, SHAREPOINT_PROJECT_EXECUTION_TASKS_LIST_IDPPMP_Project_Schedule_WBS, PPMP_Project_Milestones, PPMP_Project_Execution_Tasks
RisksSHAREPOINT_RISK_REGISTER_LIST_ID, SHAREPOINT_RISKS_LIST_IDPPMP_Risk_Register, PPMP_Risks (legacy secondary)
ClarificationsSHAREPOINT_CLARIFICATIONS_LOG_LIST_IDPPMP_Clarifications_Log
Actions / Decisions / Follow-upsSHAREPOINT_ACTIONS_LIST_IDPPMP_Actions
MeetingsSHAREPOINT_MEETINGS_LIST_IDPPMP_Meetings
MDRSHAREPOINT_MDR_DOCUMENTS_LIST_IDPPMP_MDR_Documents
QualitySHAREPOINT_QUALITY_RECORDS_LIST_ID, SHAREPOINT_LESSONS_LEARNED_LIST_IDPPMP_Quality_Records, PPMP_Lessons_Learned
HSSESHAREPOINT_HSSE_RECORDS_LIST_IDPPMP_HSSE_Records
Billing / QtCSHAREPOINT_BILLING_CYCLES_LIST_ID, SHAREPOINT_BILLING_REGISTER_LIST_ID, SHAREPOINT_PSR_RECORDS_LIST_IDPPMP_Billing_Cycles, PPMP_Billing_Register, PPMP_PSR_Records
VariationsSHAREPOINT_VARIATIONS_LIST_ID, SHAREPOINT_CONTRACT_SCENARIOS_LIST_ID, SHAREPOINT_CONTRACT_ALERTS_LIST_IDPPMP_Variations, PPMP_Contract_Scenarios, PPMP_Contract_Alerts
AuditSHAREPOINT_AUDIT_LOG_LIST_IDPPMP_Audit_Log
Project lookup (fallback order)SHAREPOINT_PROJECT_REGISTER_LIST_ID, SHAREPOINT_PROJECTS_LIST_ID, SHAREPOINT_PROJECT_GATE_LOG_LIST_ID, SHAREPOINT_PROJECT_CONTRACT_REVIEW_LIST_ID, SHAREPOINT_JOB_CREATION_REQUEST_LIST_IDPPMP_Project_Register, PPMP_Projects, PPMP_Project_Gate_Log, PPMP_Project_Contract_Review, PPMP_Job_Creation_Request
Financial → Cost (Renata 12 controls)
MetricRenata / PPMP sourceFuture sourceAutomation decisionOwnerPM / Leadership valueEffortDecision
As Bid CostRenata: PPSFT · PPMP: PPMP_Contracts (AsBidCost); fallback PPMP_Contract_Line_ItemsOracle Fusion Project Budget / PPSFT bid extractDefer to FusionFinanceEstimated cost from bid activities. PM value 2/5 · Leadership 3/5.HighDefer
Baseline CostRenata: PPSFT · PPMP: PPMP_Contracts (BaselineCost, BaselineVersion, BaselineApprovedBy)Oracle Fusion Project Budget — Approved BaselineKeep and automateFinanceApproved baseline budget incl. approved VOs. PM value 3/5 · Leadership 5/5.HighAutomate Later
ITD CostRenata: PPSFT · PPMP: PPMP_Contract_Monthly_Snapshots (CBS ActualCost)Oracle Fusion / PPSFT actual cost extractKeep and automateFinanceInception-to-date materialized actual costs. PM value 4/5 · Leadership 5/5.MediumAutomate Later
CommitmentsRenata: PPSFT · PPMP: PPMP_PO_Master; PPMP_PO_Monthly_ConsumptionOracle Fusion Purchasing / PPSFT PO commitmentKeep and automateSCM / FinanceFuture cost obligations committed contractually. PM value 2/5 · Leadership 3/5.MediumAutomate Later
ETC CostRenata: Manual · PPMP: PPMP_Forecast_Curves (ForecastCost)Oracle Fusion forecast / PPMP_Forecast_Curves bridgeKeep manual for pilotPM / FinanceEstimated projected cost to complete. PM value 3/5 · Leadership 4/5.HighKeep
EAC / Actual CostRenata: WDA · PPMP: Derived: FinancialCostControlsService (ITD + ETC)WDA / Oracle Fusion EACKeep and automateFinanceTotal projected or actual cost at completion. PM value 4/5 · Leadership 5/5.LowAutomate Later
As Bid ContingencyRenata: Manual · PPMP: PPMP_Contracts (AsBidContingency)Fusion contingency / manual FinanceKeep ad hoc onlyFinanceContingency in cost estimate. PM value 2/5 · Leadership 2/5.HighNeeds Data Source Confirmation
Allocated ContingencyRenata: Manual · PPMP: PPMP_Contracts; PPMP_Risk_Register fallbackFusion + PPMP_Risk_Register bridgeKeep manual for pilotRisk / FinanceContingency allocated to risks. PM value 2/5 · Leadership 3/5.HighKeep
Unallocated ContingencyRenata: Manual · PPMP: Derived: AsBid − AllocatedDerived from Fusion contingency fieldsKeep and automateFinanceRemaining contingency not allocated. PM value 3/5 · Leadership 3/5.LowKeep
Contingency RemainingRenata: Manual · PPMP: PPMP_Contracts (ContingencyUsed); derivedFusion contingency consumptionKeep manual for pilotFinanceContingency not yet spent. PM value 3/5 · Leadership 3/5.MediumKeep
Cost Variance Total + Per ActivityRenata: Manual · PPMP: Derived; PPMP_Contract_Line_Items + snapshotsFusion EAC vs Baseline; CBS actualsKeep and automateFinanceEAC vs Baseline; CBS breakdown. PM value 3/5 · Leadership 5/5.LowAutomate Later
Cost Over TimeRenata: Manual · PPMP: PPMP_Contract_Monthly_Snapshots; PPMP_Forecast_CurvesFusion actual cost by periodKeep and automateFinance / PMMonthly spend actual + forecast monitoring. PM value 4/5 · Leadership 5/5.MediumAutomate Later

Domain: Financial / Cost · 12 controls mapped (no new SharePoint lists or fields).

Decision defaults reference (config baseline)
MetricDomainAvailabilityAutomationDecisionNew list?Next action
Project health domain scoreGovernancePartialPartialKeepNoPopulate missing list records for CLTST domains
EAC / revenue weighted portfolio scoreFinancialNot ReadyNot ReadyDeferNoConfirm contract snapshots for active projects
Risk register completenessRiskReadyPartialKeepNoResolve DQ findings (owner, response plan)
Portfolio rotation scheduleMeetingsPartialPartialNeeds Data Source ConfirmationNoLucas approve PPMP_Project_Register field extension
Meeting input persistenceMeetingsPartialReadyAutomate LaterNoComplete Check-in UAT on CLTST
Health trend historyGovernanceNot ReadyNot ReadyDeferNoDecide snapshot vs audit-only approach
List reuse strategy
Proposed listStatusReuseRationale
PPMP_Meeting_Typesconfig—Meeting type definitions are stable reference data — versioned in meeting-cadences.ts.
PPMP_Meeting_CyclesextendPPMP_MeetingsEach meeting instance is a cycle occurrence — extend PPMP_Meetings with cadenceId and cycleStatus.
PPMP_Meeting_InputsextendPPMP_MeetingsPreparation inputs map to agenda + structured narrative fields on meeting rows; generator drafts from live project data.
PPMP_Meeting_ActionsreusePPMP_ActionsActions already have owner, due date, status — link via sourceReference to meetingId.
PPMP_Decision_LogextendPPMP_Meetings + PPMP_ActionsDecisions field on PPMP_Meetings for narrative; escalated decisions become PPMP_Actions with category Decision.
PPMP_Project_Health_Snapshotsproposed—Computed on read today via ProjectHealthService; snapshot list only needed when historical trending is required.
PPMP_Data_Source_Mapconfig—Source mapping registry in lib/pm-os/source-mapping-registry.ts — promote to SharePoint when governance workflow requires approval.
PPMP_KPI_Dictionaryconfig—KPI definitions align to metricsRegistry / source-mapping — shared with admin Source Mapping page.
PPMP_Project_PrioritiesreusePPMP_ActionsWeekly priorities are high-priority open actions filtered by projectKey.
PPMP_Portfolio_Rotationconfig—Monthly overview rotation schedule in MEETING_ROTATION_SCHEDULE — no separate list until multi-BU rotation is live.
PPMP_Quarterly_KPI_ActionsreusePPMP_ActionsImprovement actions from quarterly review map to PPMP_Actions with sourceType Quarterly KPI Review.
Capability reuse assessment
CapabilityDomainCurrentPPMP listReuseGapActionNew list?Why requiredMeetingsDashboardsEffortAutomationDecision
Meeting inputs (draft narrative)MeetingsMeeting input generator + PPMP_Meetings.agendaPPMP_Meetings (SHAREPOINT_MEETINGS_LIST_ID)PartialEvidenceUrl, ReviewedBy/At lack dedicated columns — JSON in agenda/openQuestions onlyPersist drafts via meeting cycle API; extend list only after approvalNoPM must prepare and submit meeting input each cycleAll four meeting workspacesPM Daily BriefMediumPartialKeep
Meeting cycles / lifecycle statusMeetingsPPMP_Meetings.status + meetingTypePPMP_MeetingsYesStatuses Draft/Submitted map to field_4; Prepared/Reviewed/Closed use same fieldUse meeting cycle service — one row per projectKey + cadenceId + dateNo—————Keep
Meeting actions / follow-upsMeetingsPPMP_ActionsPPMP_ActionsYesDuplicate prevention via ProjectKey + MeetingType + Title + DueDateCreate follow-up actions from meeting workspaceNo—————Keep
Decision logGovernancePPMP_Actions (isDecisionLinked / sourceType / title prefix)PPMP_ActionsPartialNo RelatedRisk/RelatedClarification structured links — use description/notesUse decision log view; structured field extension optionalNo—————Keep
Project health (current)HealthProjectHealthService computed on readMultiple PPMP lists (aggregate)YesNo historical snapshot listUse /health/* and performance domain pagesNo—————Keep
Health history / trendsHealthNot persistedNoneNoRequires new list or gate log extrapolation — not sufficient todayPropose PPMP_Project_Health_Snapshots — do not auto-createYes—————Defer
KPI dictionaryKPIsource-mapping-registry.ts + meeting cadencesConfig (no list)PartialNo PPMP_KPI_Dictionary list — KPIs derived from billing/contracts/healthQuarterly KPI uses generator + lessons/actionsNo—————Defer
Data source mapAdminlib/pm-os/source-mapping-registry.tsConfigYesIn-app registry onlyAdmin Source Mapping pageNo—————Keep
Portfolio rotationPortfolioPPMP_Project_Register → PPMP_Projects → demo fallbackPPMP_Project_RegisterYesDemo config used when no active projectsPopulate project register with active projectsNo—————Keep
Quarterly improvement actionsKPIPPMP_Actions + PPMP_Lessons_Learned recommendationsPPMP_ActionsYesNo KPI-specific action category — use sourceType quarterlyCreate actions from quarterly KPI workspaceNo—————Keep
Performance domain cardsPerformancePerformance domain API aggregating list candidatesPer-domain PPMP listsPartialSome .env list IDs missing per domainGrey health + missing data warnings on each domain pageNo—————Keep
Financial dashboardsFinancialsContracts, snapshots, forecast, billing register, POPPMP_Contracts + relatedPartialRequires contract list configured per projectLink to /performance/financials and /contractNo—————Keep
Billing / QtC dashboardBillingPPMP_Billing_Cycles, PPMP_Billing_Register, PPMP_PSR_RecordsPPMP_Billing_CyclesYesNone if lists configuredUse /performance/billingNo—————Keep
MDR / documentation dashboardDocumentationPPMP_MDR_DocumentsPPMP_MDR_DocumentsYesNone if list configuredUse /performance/mdrNo—————Keep
HSSE dashboardHSSEPPMP_HSSE_RecordsPPMP_HSSE_RecordsYesRecords may be empty for new projectsUse /performance/hsseNo—————Keep
Quality dashboardQualityPPMP_Quality_Records + PPMP_Lessons_LearnedPPMP_Quality_RecordsYesNone if list configuredUse /performance/qualityNo—————Keep
Risk / opportunity dashboardRiskPPMP_Risk_Register (+ legacy PPMP_Risks)PPMP_Risk_RegisterYesLegacy risks list optionalGate 10 + /performance/risksNo—————Keep
Schedule / progress dashboardSchedulePPMP_Project_Schedule_WBS, PPMP_Project_Milestones, PPMP_Project_Execution_TasksPPMP_Project_MilestonesPartialWBS/execution tasks require list IDs in .envUse /performance/scheduleNo—————Keep
Proposed new lists (not auto-created)
ListReasonMinimum fields
PPMP_Meeting_InputsOnly if PPMP_Meetings cannot store structured meeting input after schema reviewProjectKey, CadenceId, MeetingDate, Status, SubmittedInput, EvidenceUrl
PPMP_Project_Health_SnapshotsHealth history / trends — current health is computed on read onlyProjectKey, SnapshotDate, DomainScores JSON, OverallRag
PPMP_Decision_LogOnly if PPMP_Actions decision fields prove insufficient after field extension reviewDecisionTitle, Context, Owner, DueDate, Status, RelatedMeeting
PPMP_KPI_DictionaryStructured KPI definitions if config file governance is insufficientKpiId, Name, Formula, SourceList, Cadence
Metrics source map
MetricDomainCurrentFutureOwnerQualityMeetingsDashboardDecision
Baseline CostCost ManagementPCMS ExcelOracle FusionProject ControlsNeeds cleanupYesYesKeep
ITD Cost / EACCost ManagementPeopleSoft + PCMSOracle FusionFinanceReadyYesYesKeep
Revenue EarnedRevenue ManagementPeopleSoftOracle FusionFinanceReadyYesYesKeep
Hours by Activity CodeLabor / HoursWDA / PPSFTOracle FusionProject ControlsNeeds cleanupYesNoKeep
Document OTDDocumentation / MDRExcel MDR localMDR corporativoDocument ControlNeeds cleanupYesYesKeep
COPQQualityQuality BIQuality BIQuality LeadReadyYesYesKeep
TRIR / LSR ViolationsHSSEHSE BIHSE BIHSE LeadReadyYesYesKeep
Pending VO AgingVariationsProject VO Register ExcelFusion + VO RegisterCommercialNeeds cleanupYesYesKeep
VOC ScoreQualityGlobal VOCGlobal VOCQualityReadyYesYesDefer
Vessel Days (ad hoc)OperationsPlanilha localTo confirmOperations LeadTo confirmYesNoTo Confirm