trueppm-api 0.4.0b2__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- trueppm_api/__init__.py +14 -0
- trueppm_api/apps/access/__init__.py +0 -0
- trueppm_api/apps/access/apps.py +19 -0
- trueppm_api/apps/access/groups.py +518 -0
- trueppm_api/apps/access/management/__init__.py +0 -0
- trueppm_api/apps/access/management/commands/__init__.py +0 -0
- trueppm_api/apps/access/management/commands/create_admin.py +164 -0
- trueppm_api/apps/access/management/commands/migrate_locked.py +96 -0
- trueppm_api/apps/access/management/commands/revoke_api_tokens.py +209 -0
- trueppm_api/apps/access/migrations/0001_initial.py +61 -0
- trueppm_api/apps/access/migrations/0001_squashed_0012_programmembership_role_title.py +167 -0
- trueppm_api/apps/access/migrations/0002_alter_projectmembership_id.py +29 -0
- trueppm_api/apps/access/migrations/0003_projectmembership_soft_delete.py +24 -0
- trueppm_api/apps/access/migrations/0004_alter_projectmembership_role.py +34 -0
- trueppm_api/apps/access/migrations/0005_program_entity_and_membership.py +76 -0
- trueppm_api/apps/access/migrations/0006_role_ordinal_spacing.py +113 -0
- trueppm_api/apps/access/migrations/0007_projectmembership_joined_at_and_more.py +35 -0
- trueppm_api/apps/access/migrations/0008_projectmembership_source_group.py +25 -0
- trueppm_api/apps/access/migrations/0009_projectmembership_pm_proj_serverver_idx.py +20 -0
- trueppm_api/apps/access/migrations/0010_programmembership_joined_at_and_more.py +38 -0
- trueppm_api/apps/access/migrations/0011_alter_programmembership_unique_together_and_more.py +36 -0
- trueppm_api/apps/access/migrations/0012_programmembership_role_title.py +17 -0
- trueppm_api/apps/access/migrations/0013_userdefinedmentiongroup.py +82 -0
- trueppm_api/apps/access/migrations/0014_programmembership_progm_serverver_idx.py +19 -0
- trueppm_api/apps/access/migrations/0015_programuserdefinedmentiongroup.py +86 -0
- trueppm_api/apps/access/migrations/0016_externalstakeholder.py +67 -0
- trueppm_api/apps/access/migrations/0017_viewer_ordinal_one.py +132 -0
- trueppm_api/apps/access/migrations/0018_programmembership_sync_seq_and_more.py +52 -0
- trueppm_api/apps/access/migrations/0019_programmembership_reinstated_at_and_more.py +22 -0
- trueppm_api/apps/access/migrations/__init__.py +0 -0
- trueppm_api/apps/access/models.py +588 -0
- trueppm_api/apps/access/permissions.py +2837 -0
- trueppm_api/apps/access/serializers.py +946 -0
- trueppm_api/apps/access/services.py +667 -0
- trueppm_api/apps/access/signals.py +103 -0
- trueppm_api/apps/access/tasks.py +50 -0
- trueppm_api/apps/access/throttles.py +95 -0
- trueppm_api/apps/access/urls.py +191 -0
- trueppm_api/apps/access/views.py +1931 -0
- trueppm_api/apps/agents/__init__.py +6 -0
- trueppm_api/apps/agents/apps.py +11 -0
- trueppm_api/apps/agents/canonical.py +73 -0
- trueppm_api/apps/agents/deferred.py +108 -0
- trueppm_api/apps/agents/management/__init__.py +0 -0
- trueppm_api/apps/agents/management/commands/__init__.py +0 -0
- trueppm_api/apps/agents/management/commands/audit_prune.py +137 -0
- trueppm_api/apps/agents/management/commands/audit_verify.py +101 -0
- trueppm_api/apps/agents/middleware.py +44 -0
- trueppm_api/apps/agents/migrations/0001_initial.py +231 -0
- trueppm_api/apps/agents/migrations/0002_agentactioncheckpoint.py +71 -0
- trueppm_api/apps/agents/migrations/0003_agentactionrefusaldetail.py +58 -0
- trueppm_api/apps/agents/migrations/__init__.py +0 -0
- trueppm_api/apps/agents/models.py +371 -0
- trueppm_api/apps/agents/refusal.py +103 -0
- trueppm_api/apps/agents/serializers.py +85 -0
- trueppm_api/apps/agents/services.py +397 -0
- trueppm_api/apps/agents/signals.py +30 -0
- trueppm_api/apps/agents/urls.py +15 -0
- trueppm_api/apps/agents/views.py +108 -0
- trueppm_api/apps/csvimport/__init__.py +12 -0
- trueppm_api/apps/csvimport/apps.py +11 -0
- trueppm_api/apps/csvimport/mapping.py +363 -0
- trueppm_api/apps/csvimport/migrations/0001_initial.py +74 -0
- trueppm_api/apps/csvimport/migrations/0002_schedule_outline_batch_operations.py +37 -0
- trueppm_api/apps/csvimport/migrations/0003_csvimportrequest_date_order_and_more.py +26 -0
- trueppm_api/apps/csvimport/migrations/__init__.py +0 -0
- trueppm_api/apps/csvimport/models.py +111 -0
- trueppm_api/apps/csvimport/parser.py +1825 -0
- trueppm_api/apps/csvimport/services.py +48 -0
- trueppm_api/apps/csvimport/tasks.py +418 -0
- trueppm_api/apps/csvimport/template.py +37 -0
- trueppm_api/apps/csvimport/urls.py +50 -0
- trueppm_api/apps/csvimport/views.py +793 -0
- trueppm_api/apps/history/__init__.py +0 -0
- trueppm_api/apps/history/apps.py +12 -0
- trueppm_api/apps/history/changelog.py +359 -0
- trueppm_api/apps/history/diff_policy.py +177 -0
- trueppm_api/apps/history/serializers.py +104 -0
- trueppm_api/apps/history/signals.py +82 -0
- trueppm_api/apps/history/tasks.py +105 -0
- trueppm_api/apps/history/urls.py +38 -0
- trueppm_api/apps/history/views.py +443 -0
- trueppm_api/apps/idempotency/__init__.py +0 -0
- trueppm_api/apps/idempotency/apps.py +11 -0
- trueppm_api/apps/idempotency/migrations/0001_initial.py +71 -0
- trueppm_api/apps/idempotency/migrations/__init__.py +0 -0
- trueppm_api/apps/idempotency/mixins.py +226 -0
- trueppm_api/apps/idempotency/models.py +75 -0
- trueppm_api/apps/idempotency/tasks.py +61 -0
- trueppm_api/apps/integrations/__init__.py +13 -0
- trueppm_api/apps/integrations/apps.py +59 -0
- trueppm_api/apps/integrations/connections.py +806 -0
- trueppm_api/apps/integrations/encryption.py +92 -0
- trueppm_api/apps/integrations/external_sources.py +837 -0
- trueppm_api/apps/integrations/git_automation_services.py +231 -0
- trueppm_api/apps/integrations/git_webhook_auth.py +243 -0
- trueppm_api/apps/integrations/http.py +403 -0
- trueppm_api/apps/integrations/me_work.py +218 -0
- trueppm_api/apps/integrations/migrations/0001_initial.py +64 -0
- trueppm_api/apps/integrations/migrations/0001_squashed_0006_tasklink_description_tasklink_preview_type_and_more.py +187 -0
- trueppm_api/apps/integrations/migrations/0002_tasklink.py +67 -0
- trueppm_api/apps/integrations/migrations/0003_tasklink_tasklink_serverver_idx.py +17 -0
- trueppm_api/apps/integrations/migrations/0004_tasklink_custom_title_tasklink_labels.py +25 -0
- trueppm_api/apps/integrations/migrations/0005_boardautomation.py +56 -0
- trueppm_api/apps/integrations/migrations/0006_tasklink_description_tasklink_preview_type_and_more.py +40 -0
- trueppm_api/apps/integrations/migrations/0007_tasklink_created_at.py +23 -0
- trueppm_api/apps/integrations/migrations/0008_integrationcredential_config_externalworkitem.py +66 -0
- trueppm_api/apps/integrations/migrations/0009_externalsyncrequest_and_more.py +96 -0
- trueppm_api/apps/integrations/migrations/0010_externalworkitem_due_date.py +17 -0
- trueppm_api/apps/integrations/migrations/0011_tasklink_sync_seq_tasklink_tasklink_syncseq_idx.py +22 -0
- trueppm_api/apps/integrations/migrations/0012_boardautomation_last_delivery_at_and_more.py +42 -0
- trueppm_api/apps/integrations/migrations/0013_externalsyncrequest_attempt_count_and_more.py +26 -0
- trueppm_api/apps/integrations/migrations/__init__.py +0 -0
- trueppm_api/apps/integrations/models.py +622 -0
- trueppm_api/apps/integrations/notification_channels.py +57 -0
- trueppm_api/apps/integrations/opengraph.py +229 -0
- trueppm_api/apps/integrations/outgoing.py +201 -0
- trueppm_api/apps/integrations/providers.py +519 -0
- trueppm_api/apps/integrations/registry.py +345 -0
- trueppm_api/apps/integrations/serializers.py +453 -0
- trueppm_api/apps/integrations/services.py +171 -0
- trueppm_api/apps/integrations/tasks.py +731 -0
- trueppm_api/apps/integrations/throttles.py +165 -0
- trueppm_api/apps/integrations/urls.py +77 -0
- trueppm_api/apps/integrations/views.py +1106 -0
- trueppm_api/apps/jiraimport/__init__.py +8 -0
- trueppm_api/apps/jiraimport/apps.py +11 -0
- trueppm_api/apps/jiraimport/migrations/0001_initial.py +72 -0
- trueppm_api/apps/jiraimport/migrations/__init__.py +0 -0
- trueppm_api/apps/jiraimport/models.py +70 -0
- trueppm_api/apps/jiraimport/parser.py +350 -0
- trueppm_api/apps/jiraimport/services.py +46 -0
- trueppm_api/apps/jiraimport/tasks.py +277 -0
- trueppm_api/apps/jiraimport/urls.py +15 -0
- trueppm_api/apps/jiraimport/views.py +153 -0
- trueppm_api/apps/msproject/__init__.py +0 -0
- trueppm_api/apps/msproject/apps.py +11 -0
- trueppm_api/apps/msproject/dataclasses.py +153 -0
- trueppm_api/apps/msproject/exporter.py +500 -0
- trueppm_api/apps/msproject/extended_attributes.py +77 -0
- trueppm_api/apps/msproject/importer.py +1095 -0
- trueppm_api/apps/msproject/migrations/0001_import_request.py +77 -0
- trueppm_api/apps/msproject/migrations/0001_squashed_0002_importrequest_creates_project.py +80 -0
- trueppm_api/apps/msproject/migrations/0002_importrequest_creates_project.py +15 -0
- trueppm_api/apps/msproject/migrations/__init__.py +0 -0
- trueppm_api/apps/msproject/models.py +81 -0
- trueppm_api/apps/msproject/parser.py +1231 -0
- trueppm_api/apps/msproject/serializers.py +136 -0
- trueppm_api/apps/msproject/services.py +58 -0
- trueppm_api/apps/msproject/tasks.py +436 -0
- trueppm_api/apps/msproject/urls.py +39 -0
- trueppm_api/apps/msproject/views.py +531 -0
- trueppm_api/apps/notifications/__init__.py +7 -0
- trueppm_api/apps/notifications/apps.py +15 -0
- trueppm_api/apps/notifications/backfill.py +79 -0
- trueppm_api/apps/notifications/categories.py +112 -0
- trueppm_api/apps/notifications/delivery_limits.py +258 -0
- trueppm_api/apps/notifications/digests.py +447 -0
- trueppm_api/apps/notifications/email_backend.py +330 -0
- trueppm_api/apps/notifications/email_health.py +128 -0
- trueppm_api/apps/notifications/migrations/0001_initial.py +207 -0
- trueppm_api/apps/notifications/migrations/0001_squashed_0006_notification_task.py +294 -0
- trueppm_api/apps/notifications/migrations/0002_project_notification_preference.py +67 -0
- trueppm_api/apps/notifications/migrations/0003_projectnotificationpreference_paused.py +17 -0
- trueppm_api/apps/notifications/migrations/0004_clean_unknown_matrix_keys.py +30 -0
- trueppm_api/apps/notifications/migrations/0005_notification_body_notification_event_type_and_more.py +27 -0
- trueppm_api/apps/notifications/migrations/0006_notification_task.py +25 -0
- trueppm_api/apps/notifications/migrations/0007_workspaceemailsettings.py +80 -0
- trueppm_api/apps/notifications/migrations/0008_notification_snoozed_until.py +17 -0
- trueppm_api/apps/notifications/migrations/0009_usernotificationsettings.py +43 -0
- trueppm_api/apps/notifications/migrations/0010_projectnotificationpreference_schema_version.py +20 -0
- trueppm_api/apps/notifications/migrations/0011_usernotificationsettings_digest_hour_and_more.py +96 -0
- trueppm_api/apps/notifications/migrations/__init__.py +0 -0
- trueppm_api/apps/notifications/models.py +1197 -0
- trueppm_api/apps/notifications/receivers.py +155 -0
- trueppm_api/apps/notifications/schema_migrations.py +56 -0
- trueppm_api/apps/notifications/serializers.py +961 -0
- trueppm_api/apps/notifications/services.py +1451 -0
- trueppm_api/apps/notifications/tasks.py +711 -0
- trueppm_api/apps/notifications/throttles.py +98 -0
- trueppm_api/apps/notifications/urls.py +97 -0
- trueppm_api/apps/notifications/views.py +904 -0
- trueppm_api/apps/observability/__init__.py +0 -0
- trueppm_api/apps/observability/apps.py +31 -0
- trueppm_api/apps/observability/logging.py +213 -0
- trueppm_api/apps/observability/migrations/0001_initial.py +35 -0
- trueppm_api/apps/observability/migrations/0001_squashed_0003_alter_purgerun_trigger.py +154 -0
- trueppm_api/apps/observability/migrations/0002_purgerun_retentionpolicy_retentionschedule.py +131 -0
- trueppm_api/apps/observability/migrations/0003_alter_purgerun_trigger.py +21 -0
- trueppm_api/apps/observability/migrations/0004_alter_retentionpolicy_key.py +28 -0
- trueppm_api/apps/observability/migrations/__init__.py +0 -0
- trueppm_api/apps/observability/models.py +141 -0
- trueppm_api/apps/observability/otel/__init__.py +45 -0
- trueppm_api/apps/observability/otel/attributes.py +247 -0
- trueppm_api/apps/observability/otel/export_health.py +533 -0
- trueppm_api/apps/observability/otel/instrumentation.py +351 -0
- trueppm_api/apps/observability/otel/metrics.py +551 -0
- trueppm_api/apps/observability/otel/provider.py +511 -0
- trueppm_api/apps/observability/otel/request_attributes.py +204 -0
- trueppm_api/apps/observability/purge_registry.py +124 -0
- trueppm_api/apps/observability/retention.py +139 -0
- trueppm_api/apps/observability/selectors.py +969 -0
- trueppm_api/apps/observability/serializers.py +142 -0
- trueppm_api/apps/observability/services.py +407 -0
- trueppm_api/apps/observability/tasks.py +266 -0
- trueppm_api/apps/observability/urls.py +27 -0
- trueppm_api/apps/observability/views.py +523 -0
- trueppm_api/apps/profiles/__init__.py +0 -0
- trueppm_api/apps/profiles/apps.py +15 -0
- trueppm_api/apps/profiles/constants.py +54 -0
- trueppm_api/apps/profiles/migrations/0001_initial.py +55 -0
- trueppm_api/apps/profiles/migrations/0001_squashed_0004_userprofile_role_context.py +125 -0
- trueppm_api/apps/profiles/migrations/0002_userprofile_hidden_views.py +17 -0
- trueppm_api/apps/profiles/migrations/0003_projectvisit.py +63 -0
- trueppm_api/apps/profiles/migrations/0004_userprofile_role_context.py +26 -0
- trueppm_api/apps/profiles/migrations/0005_userprofile_schedule_in_deliver.py +20 -0
- trueppm_api/apps/profiles/migrations/0006_userprofile_date_format_userprofile_timezone.py +36 -0
- trueppm_api/apps/profiles/migrations/0007_userpin.py +91 -0
- trueppm_api/apps/profiles/migrations/0008_remove_userprofile_schedule_in_deliver.py +71 -0
- trueppm_api/apps/profiles/migrations/0009_auth_user_email_upper_idx.py +81 -0
- trueppm_api/apps/profiles/migrations/__init__.py +0 -0
- trueppm_api/apps/profiles/models.py +276 -0
- trueppm_api/apps/profiles/serializers.py +199 -0
- trueppm_api/apps/profiles/services.py +466 -0
- trueppm_api/apps/profiles/views.py +124 -0
- trueppm_api/apps/projects/__init__.py +0 -0
- trueppm_api/apps/projects/actual_date_rules.py +163 -0
- trueppm_api/apps/projects/amend.py +133 -0
- trueppm_api/apps/projects/apps.py +38 -0
- trueppm_api/apps/projects/asset_feed.py +459 -0
- trueppm_api/apps/projects/asset_views.py +317 -0
- trueppm_api/apps/projects/attachment_policy.py +278 -0
- trueppm_api/apps/projects/authentication.py +449 -0
- trueppm_api/apps/projects/backfill.py +287 -0
- trueppm_api/apps/projects/backlog_services.py +324 -0
- trueppm_api/apps/projects/backlog_views.py +302 -0
- trueppm_api/apps/projects/batch_operation_views.py +264 -0
- trueppm_api/apps/projects/blocker_services.py +510 -0
- trueppm_api/apps/projects/board_activity.py +462 -0
- trueppm_api/apps/projects/board_activity_views.py +186 -0
- trueppm_api/apps/projects/board_lanes.py +134 -0
- trueppm_api/apps/projects/bulk_settings.py +194 -0
- trueppm_api/apps/projects/bundled_templates.py +215 -0
- trueppm_api/apps/projects/calendar_settings.py +180 -0
- trueppm_api/apps/projects/ceremony_views.py +244 -0
- trueppm_api/apps/projects/commit_moment.py +204 -0
- trueppm_api/apps/projects/config_notice.py +1325 -0
- trueppm_api/apps/projects/custom_field_values.py +266 -0
- trueppm_api/apps/projects/decisions_services.py +93 -0
- trueppm_api/apps/projects/decisions_views.py +94 -0
- trueppm_api/apps/projects/estimation_scale.py +126 -0
- trueppm_api/apps/projects/export_bundle.py +353 -0
- trueppm_api/apps/projects/fixtures/seeds/atlas-platform-launch.json +4256 -0
- trueppm_api/apps/projects/fixtures/seeds/aurora-mobile-app.json +2000 -0
- trueppm_api/apps/projects/fixtures/seeds/bayside-civic-center.json +1825 -0
- trueppm_api/apps/projects/fixtures/seeds/ga-launch.json +1905 -0
- trueppm_api/apps/projects/fixtures/seeds/helios-crm-replacement.json +1409 -0
- trueppm_api/apps/projects/guardrail_policy_source.py +269 -0
- trueppm_api/apps/projects/inbound_sync.py +555 -0
- trueppm_api/apps/projects/iteration_label.py +85 -0
- trueppm_api/apps/projects/lifecycle.py +191 -0
- trueppm_api/apps/projects/management/__init__.py +0 -0
- trueppm_api/apps/projects/management/commands/__init__.py +0 -0
- trueppm_api/apps/projects/management/commands/backfill_in_progress_status.py +92 -0
- trueppm_api/apps/projects/management/commands/create_demo_share_link.py +368 -0
- trueppm_api/apps/projects/management/commands/export_program.py +50 -0
- trueppm_api/apps/projects/management/commands/import_seed.py +165 -0
- trueppm_api/apps/projects/management/commands/load_sample_project.py +247 -0
- trueppm_api/apps/projects/management/commands/seed_capacity.py +405 -0
- trueppm_api/apps/projects/management/commands/seed_integration_fixtures.py +178 -0
- trueppm_api/apps/projects/management/commands/shift_sample_dates.py +120 -0
- trueppm_api/apps/projects/mcp_settings.py +305 -0
- trueppm_api/apps/projects/methodology.py +178 -0
- trueppm_api/apps/projects/migrations/0001_initial.py +208 -0
- trueppm_api/apps/projects/migrations/0001_squashed_0094_project_decisions_policy.py +5595 -0
- trueppm_api/apps/projects/migrations/0002_alter_uuid_pk_serialize_false.py +57 -0
- trueppm_api/apps/projects/migrations/0003_rename_task_project_index.py +25 -0
- trueppm_api/apps/projects/migrations/0004_soft_delete_and_dependency_versioned.py +70 -0
- trueppm_api/apps/projects/migrations/0005_task_assignee.py +33 -0
- trueppm_api/apps/projects/migrations/0006_task_utilization_index.py +31 -0
- trueppm_api/apps/projects/migrations/0007_task_is_milestone.py +28 -0
- trueppm_api/apps/projects/migrations/0008_baseline.py +119 -0
- trueppm_api/apps/projects/migrations/0009_historicaldependency_historicalproject_and_more.py +210 -0
- trueppm_api/apps/projects/migrations/0010_risk.py +229 -0
- trueppm_api/apps/projects/migrations/0011_task_status.py +27 -0
- trueppm_api/apps/projects/migrations/0012_task_status.py +27 -0
- trueppm_api/apps/projects/migrations/0013_task_planned_start.py +24 -0
- trueppm_api/apps/projects/migrations/0014_short_hex_ids.py +74 -0
- trueppm_api/apps/projects/migrations/0015_backfill_short_ids.py +48 -0
- trueppm_api/apps/projects/migrations/0016_task_actual_dates.py +42 -0
- trueppm_api/apps/projects/migrations/0017_boardcolumnconfig.py +43 -0
- trueppm_api/apps/projects/migrations/0018_estimation_governance.py +62 -0
- trueppm_api/apps/projects/migrations/0019_backfill_wbs_paths.py +28 -0
- trueppm_api/apps/projects/migrations/0020_task_status_5col.py +65 -0
- trueppm_api/apps/projects/migrations/0021_boardsavedview.py +64 -0
- trueppm_api/apps/projects/migrations/0022_task_status_changed_at_priority_rank.py +35 -0
- trueppm_api/apps/projects/migrations/0023_risk_framework_fields.py +96 -0
- trueppm_api/apps/projects/migrations/0024_riskcomment.py +52 -0
- trueppm_api/apps/projects/migrations/0025_sprint.py +352 -0
- trueppm_api/apps/projects/migrations/0026_project_methodology.py +30 -0
- trueppm_api/apps/projects/migrations/0027_sprint_retro.py +89 -0
- trueppm_api/apps/projects/migrations/0028_normalize_notes_field.py +42 -0
- trueppm_api/apps/projects/migrations/0029_complete_implies_full_progress.py +38 -0
- trueppm_api/apps/projects/migrations/0030_review_implies_full_progress.py +37 -0
- trueppm_api/apps/projects/migrations/0031_task_remaining_points.py +22 -0
- trueppm_api/apps/projects/migrations/0032_task_is_subtask_and_sprint_scope_change.py +90 -0
- trueppm_api/apps/projects/migrations/0033_task_my_work_index.py +38 -0
- trueppm_api/apps/projects/migrations/0034_inbound_task_sync.py +313 -0
- trueppm_api/apps/projects/migrations/0035_retro_versioned_and_suggested_assignee.py +173 -0
- trueppm_api/apps/projects/migrations/0036_program_entity_and_membership.py +157 -0
- trueppm_api/apps/projects/migrations/0037_sprint_capacity_points.py +20 -0
- trueppm_api/apps/projects/migrations/0038_taskcomment_commentreaction_commentacknowledgement_and_more.py +233 -0
- trueppm_api/apps/projects/migrations/0039_apitoken_and_more.py +88 -0
- trueppm_api/apps/projects/migrations/0040_program_general_fields.py +119 -0
- trueppm_api/apps/projects/migrations/0041_ceremony_template_and_phase_gate_config.py +210 -0
- trueppm_api/apps/projects/migrations/0041_project_general_fields.py +106 -0
- trueppm_api/apps/projects/migrations/0042_merge_20260522_0410.py +12 -0
- trueppm_api/apps/projects/migrations/0042_program_rollup_config.py +95 -0
- trueppm_api/apps/projects/migrations/0042_workflow_color_and_custom_fields.py +94 -0
- trueppm_api/apps/projects/migrations/0043_merge_20260522_1118.py +10 -0
- trueppm_api/apps/projects/migrations/0044_merge_20260522_rollup.py +10 -0
- trueppm_api/apps/projects/migrations/0044_project_archive_program_close.py +119 -0
- trueppm_api/apps/projects/migrations/0045_program_risk_policy.py +78 -0
- trueppm_api/apps/projects/migrations/0046_merge_20260523_2248.py +12 -0
- trueppm_api/apps/projects/migrations/0047_apitokenauditentry_program_and_more.py +55 -0
- trueppm_api/apps/projects/migrations/0048_historicalprogram_color_program_color.py +32 -0
- trueppm_api/apps/projects/migrations/0049_backlog_item.py +112 -0
- trueppm_api/apps/projects/migrations/0050_backlog_item_trgm_search.py +26 -0
- trueppm_api/apps/projects/migrations/0051_alter_calendar_working_days_alter_dependency_lag_and_more.py +144 -0
- trueppm_api/apps/projects/migrations/0052_recurring_tasks.py +278 -0
- trueppm_api/apps/projects/migrations/0053_dependency_dep_pred_serverver_idx_and_more.py +56 -0
- trueppm_api/apps/projects/migrations/0054_sprintscopechange_goal_impact_and_more.py +117 -0
- trueppm_api/apps/projects/migrations/0055_historicaltask_sprint_pending_and_more.py +51 -0
- trueppm_api/apps/projects/migrations/0056_historicalproject_prioritization_model_and_more.py +276 -0
- trueppm_api/apps/projects/migrations/0057_historicalsprint_binding_committed_snapshot_and_more.py +58 -0
- trueppm_api/apps/projects/migrations/0058_historicaltask_delivery_mode_and_more.py +72 -0
- trueppm_api/apps/projects/migrations/0059_forecastsnapshot.py +80 -0
- trueppm_api/apps/projects/migrations/0060_historicalprojectsignalprivacypolicy_and_more.py +90 -0
- trueppm_api/apps/projects/migrations/0061_baselinetask_story_points.py +17 -0
- trueppm_api/apps/projects/migrations/0062_project_is_sample.py +22 -0
- trueppm_api/apps/projects/migrations/0063_historicalsprint_wip_limit_sprint_wip_limit.py +22 -0
- trueppm_api/apps/projects/migrations/0064_sprinttaskoutcome.py +97 -0
- trueppm_api/apps/projects/migrations/0065_historicalsprint_goal_outcome_sprint_goal_outcome.py +32 -0
- trueppm_api/apps/projects/migrations/0066_historicalproject_lead_project_lead.py +38 -0
- trueppm_api/apps/projects/migrations/0067_sprint_exclude_from_velocity.py +22 -0
- trueppm_api/apps/projects/migrations/0068_project_recalculated_at.py +23 -0
- trueppm_api/apps/projects/migrations/0069_iteration_label.py +22 -0
- trueppm_api/apps/projects/migrations/0070_historicalprogram_iteration_label_and_more.py +32 -0
- trueppm_api/apps/projects/migrations/0071_backfill_iteration_label_inherit.py +35 -0
- trueppm_api/apps/projects/migrations/0072_pulseresponse_retroboarditem.py +129 -0
- trueppm_api/apps/projects/migrations/0073_sprinttaskoutcome_demo_ready.py +17 -0
- trueppm_api/apps/projects/migrations/0074_historicaltask_blocked_reason_task_blocked_reason.py +30 -0
- trueppm_api/apps/projects/migrations/0075_risk_decimal_short_id.py +42 -0
- trueppm_api/apps/projects/migrations/0076_sprinttaskoutcome_review_polish.py +45 -0
- trueppm_api/apps/projects/migrations/0077_task_blocker_fields.py +111 -0
- trueppm_api/apps/projects/migrations/0078_alter_risktask_unique_together_and_more.py +22 -0
- trueppm_api/apps/projects/migrations/0079_historicalproject_status_date_project_status_date.py +22 -0
- trueppm_api/apps/projects/migrations/0080_alter_historicaltask_type_alter_task_type.py +46 -0
- trueppm_api/apps/projects/migrations/0081_historicalprogram_allow_guests_and_more.py +52 -0
- trueppm_api/apps/projects/migrations/0082_project_last_sync_version.py +90 -0
- trueppm_api/apps/projects/migrations/0083_historicalprogram_mc_history_attribution_audience_and_more.py +108 -0
- trueppm_api/apps/projects/migrations/0084_tasknote.py +71 -0
- trueppm_api/apps/projects/migrations/0085_sprint_ix_sprint_velocity.py +33 -0
- trueppm_api/apps/projects/migrations/0086_board_card_search_trgm.py +33 -0
- trueppm_api/apps/projects/migrations/0087_historicalprogram_task_duration_change_percent_policy_and_more.py +155 -0
- trueppm_api/apps/projects/migrations/0088_historicalprogram_allowed_attachment_types_and_more.py +61 -0
- trueppm_api/apps/projects/migrations/0089_signalceilingraiseproposal_signalceilingraisevote_and_more.py +157 -0
- trueppm_api/apps/projects/migrations/0090_historicaltask_proj_histdate_index.py +44 -0
- trueppm_api/apps/projects/migrations/0091_project_board_cadence.py +39 -0
- trueppm_api/apps/projects/migrations/0092_program_target_date.py +22 -0
- trueppm_api/apps/projects/migrations/0093_cross_project_dependency_consent.py +58 -0
- trueppm_api/apps/projects/migrations/0094_project_decisions_policy.py +90 -0
- trueppm_api/apps/projects/migrations/0095_poker_session_vote.py +127 -0
- trueppm_api/apps/projects/migrations/0095_squashed_0097_release_0_3.py +225 -0
- trueppm_api/apps/projects/migrations/0096_crossprojectslipconflict.py +91 -0
- trueppm_api/apps/projects/migrations/0097_backlogitem_backlogitem_tags_gin_and_more.py +32 -0
- trueppm_api/apps/projects/migrations/0098_historicalproject_show_baselines_and_more.py +52 -0
- trueppm_api/apps/projects/migrations/0099_apitoken_scopes.py +48 -0
- trueppm_api/apps/projects/migrations/0100_task_dep_serverver_idx_concurrent.py +61 -0
- trueppm_api/apps/projects/migrations/0101_dependency_deleted_at_task_deleted_at.py +22 -0
- trueppm_api/apps/projects/migrations/0102_project_deleted_at_project_proj_isdel_deletedat_idx.py +25 -0
- trueppm_api/apps/projects/migrations/0103_taskdurationchangeevent_task_dur_evt_sprint_idx.py +18 -0
- trueppm_api/apps/projects/migrations/0104_historicalproject_stale_task_threshold_days_and_more.py +32 -0
- trueppm_api/apps/projects/migrations/0104_trash_restore_1113.py +38 -0
- trueppm_api/apps/projects/migrations/0105_historical_changelog_indexes.py +62 -0
- trueppm_api/apps/projects/migrations/0106_boardsavedview_schema_version.py +20 -0
- trueppm_api/apps/projects/migrations/0107_task_activity_event.py +70 -0
- trueppm_api/apps/projects/migrations/0108_remove_apitoken_api_token_scope_xor_and_more.py +117 -0
- trueppm_api/apps/projects/migrations/0109_projectexportjob.py +82 -0
- trueppm_api/apps/projects/migrations/0110_sharelink.py +123 -0
- trueppm_api/apps/projects/migrations/0111_projectcalendarlayer.py +67 -0
- trueppm_api/apps/projects/migrations/0112_sharelink_expires_at_alter_sharelink_content_kind.py +31 -0
- trueppm_api/apps/projects/migrations/0113_alter_historicaltask_percent_complete_and_more.py +35 -0
- trueppm_api/apps/projects/migrations/0114_historicalproject_default_member_role_and_more.py +28 -0
- trueppm_api/apps/projects/migrations/0115_historicalproject_end_date_shift_threshold_days_and_more.py +22 -0
- trueppm_api/apps/projects/migrations/0116_alter_taskactivityevent_event_type.py +28 -0
- trueppm_api/apps/projects/migrations/0117_label_tasklabel_label_tasks_and_more.py +126 -0
- trueppm_api/apps/projects/migrations/0118_programexportjob.py +82 -0
- trueppm_api/apps/projects/migrations/0119_historicalprogram_calendar_program_calendar.py +36 -0
- trueppm_api/apps/projects/migrations/0120_alter_backlogitem_item_type.py +29 -0
- trueppm_api/apps/projects/migrations/0121_task_three_point_estimate_ordered.py +64 -0
- trueppm_api/apps/projects/migrations/0122_task_relation.py +173 -0
- trueppm_api/apps/projects/migrations/0123_remove_historicalproject_agile_features_and_more.py +20 -0
- trueppm_api/apps/projects/migrations/0124_dependency_is_driving.py +17 -0
- trueppm_api/apps/projects/migrations/0125_historicalprogram_estimation_scale_and_more.py +68 -0
- trueppm_api/apps/projects/migrations/0126_projectcustomfield_show_on_card_taskcustomfieldvalue.py +80 -0
- trueppm_api/apps/projects/migrations/0127_historicalprogram_mcp_enabled_and_more.py +32 -0
- trueppm_api/apps/projects/migrations/0128_acceptancecriterion_sync_seq_apitoken_sync_seq_and_more.py +192 -0
- trueppm_api/apps/projects/migrations/0129_sharelink_show_milestone_dates.py +20 -0
- trueppm_api/apps/projects/migrations/0130_programimportjob.py +85 -0
- trueppm_api/apps/projects/migrations/0131_historicalprogram_sprint_picker_ready_only_default_and_more.py +32 -0
- trueppm_api/apps/projects/migrations/0132_task_scheduled_start.py +17 -0
- trueppm_api/apps/projects/migrations/0133_project_status_date_floor_armed_at.py +17 -0
- trueppm_api/apps/projects/migrations/0134_task_edited_at_task_seeded_at_task_source_id_and_more.py +65 -0
- trueppm_api/apps/projects/migrations/0135_projecttemplate_templateapplication_and_more.py +175 -0
- trueppm_api/apps/projects/migrations/0136_schedule_outline_batch_operations.py +118 -0
- trueppm_api/apps/projects/migrations/0137_collapse_dual_scope_api_tokens.py +54 -0
- trueppm_api/apps/projects/migrations/0138_apitokenauditentry_api_token_audit_owner_idx.py +18 -0
- trueppm_api/apps/projects/migrations/0139_historicaltask_duration_unit_task_duration_unit.py +32 -0
- trueppm_api/apps/projects/migrations/0140_historicaltask_auto_container_and_more.py +113 -0
- trueppm_api/apps/projects/migrations/0141_historicalproject_draft_started_at_and_more.py +44 -0
- trueppm_api/apps/projects/migrations/0142_baseline_calendar_hours_per_day_and_more.py +31 -0
- trueppm_api/apps/projects/migrations/0143_sprintcloserequest_failure_reason_and_more.py +42 -0
- trueppm_api/apps/projects/migrations/0144_projecttemplate_source_project_and_more.py +35 -0
- trueppm_api/apps/projects/migrations/0145_seed_bundled_templates.py +65 -0
- trueppm_api/apps/projects/migrations/0146_historicaltask_board_lane_task_board_lane.py +32 -0
- trueppm_api/apps/projects/migrations/0147_structuraloperation.py +128 -0
- trueppm_api/apps/projects/migrations/0148_task_unique_task_wbs_path_per_project_live.py +76 -0
- trueppm_api/apps/projects/migrations/0149_drop_workshops_tables.py +42 -0
- trueppm_api/apps/projects/migrations/0150_clear_uncommitted_cpm_output.py +130 -0
- trueppm_api/apps/projects/migrations/0151_config_notice_request.py +70 -0
- trueppm_api/apps/projects/migrations/0152_aggregate_task_wbs_name_idx.py +20 -0
- trueppm_api/apps/projects/migrations/0153_program_sample_anchor_date.py +22 -0
- trueppm_api/apps/projects/migrations/__init__.py +0 -0
- trueppm_api/apps/projects/models.py +8946 -0
- trueppm_api/apps/projects/poker_services.py +154 -0
- trueppm_api/apps/projects/poker_views.py +398 -0
- trueppm_api/apps/projects/product_backlog_services.py +450 -0
- trueppm_api/apps/projects/program_label_services.py +94 -0
- trueppm_api/apps/projects/program_label_views.py +189 -0
- trueppm_api/apps/projects/program_rollup.py +575 -0
- trueppm_api/apps/projects/program_schedule.py +745 -0
- trueppm_api/apps/projects/program_views.py +3220 -0
- trueppm_api/apps/projects/project_templates.py +422 -0
- trueppm_api/apps/projects/receivers.py +234 -0
- trueppm_api/apps/projects/refusal_codes.py +140 -0
- trueppm_api/apps/projects/reorder_services.py +145 -0
- trueppm_api/apps/projects/restructure_hooks.py +54 -0
- trueppm_api/apps/projects/retro_board_services.py +368 -0
- trueppm_api/apps/projects/retro_services.py +285 -0
- trueppm_api/apps/projects/risk_import.py +396 -0
- trueppm_api/apps/projects/row_identity.py +113 -0
- trueppm_api/apps/projects/schema_migrations.py +228 -0
- trueppm_api/apps/projects/schemas/seed_v1.json +493 -0
- trueppm_api/apps/projects/schemas/seed_v2.json +892 -0
- trueppm_api/apps/projects/seed/__init__.py +61 -0
- trueppm_api/apps/projects/seed/exporter.py +1644 -0
- trueppm_api/apps/projects/seed/forecast_backfill.py +247 -0
- trueppm_api/apps/projects/seed/importer.py +2390 -0
- trueppm_api/apps/projects/seed/reanchor.py +551 -0
- trueppm_api/apps/projects/seed/reldates.py +126 -0
- trueppm_api/apps/projects/seed/replace.py +126 -0
- trueppm_api/apps/projects/seed/replay.py +1691 -0
- trueppm_api/apps/projects/seed/replay_ctx.py +41 -0
- trueppm_api/apps/projects/seed/samples.py +427 -0
- trueppm_api/apps/projects/seed/validation.py +1149 -0
- trueppm_api/apps/projects/serializers.py +12310 -0
- trueppm_api/apps/projects/services.py +6966 -0
- trueppm_api/apps/projects/share_serializers.py +132 -0
- trueppm_api/apps/projects/share_services.py +325 -0
- trueppm_api/apps/projects/share_views.py +374 -0
- trueppm_api/apps/projects/sharing_settings.py +187 -0
- trueppm_api/apps/projects/signal_privacy_services.py +909 -0
- trueppm_api/apps/projects/signal_privacy_views.py +476 -0
- trueppm_api/apps/projects/signals.py +132 -0
- trueppm_api/apps/projects/slip_conflict.py +266 -0
- trueppm_api/apps/projects/sprint_cadence.py +453 -0
- trueppm_api/apps/projects/sprint_picker_settings.py +132 -0
- trueppm_api/apps/projects/standup.py +304 -0
- trueppm_api/apps/projects/standup_views.py +99 -0
- trueppm_api/apps/projects/structural_operation_services.py +727 -0
- trueppm_api/apps/projects/structural_operation_views.py +311 -0
- trueppm_api/apps/projects/surface_visibility.py +126 -0
- trueppm_api/apps/projects/task_batch_services.py +379 -0
- trueppm_api/apps/projects/task_bulk.py +1152 -0
- trueppm_api/apps/projects/task_classification.py +561 -0
- trueppm_api/apps/projects/task_classification_defaults.py +95 -0
- trueppm_api/apps/projects/task_duration_settings.py +142 -0
- trueppm_api/apps/projects/task_grouping.py +754 -0
- trueppm_api/apps/projects/tasks.py +1917 -0
- trueppm_api/apps/projects/template_divergence.py +168 -0
- trueppm_api/apps/projects/template_services.py +160 -0
- trueppm_api/apps/projects/template_tasks.py +258 -0
- trueppm_api/apps/projects/template_views.py +799 -0
- trueppm_api/apps/projects/throttles.py +311 -0
- trueppm_api/apps/projects/urls.py +1011 -0
- trueppm_api/apps/projects/utilization.py +885 -0
- trueppm_api/apps/projects/views.py +20572 -0
- trueppm_api/apps/projects/wbs_paths.py +119 -0
- trueppm_api/apps/resources/__init__.py +0 -0
- trueppm_api/apps/resources/apps.py +8 -0
- trueppm_api/apps/resources/capacity.py +121 -0
- trueppm_api/apps/resources/migrations/0001_initial.py +68 -0
- trueppm_api/apps/resources/migrations/0001_squashed_0013_alter_projectresource_unique_together_and_more.py +281 -0
- trueppm_api/apps/resources/migrations/0002_alter_uuid_pk_serialize_false.py +36 -0
- trueppm_api/apps/resources/migrations/0003_resource_soft_delete.py +30 -0
- trueppm_api/apps/resources/migrations/0004_add_taskresource_resource_index.py +25 -0
- trueppm_api/apps/resources/migrations/0005_resource_job_role.py +20 -0
- trueppm_api/apps/resources/migrations/0006_skill.py +34 -0
- trueppm_api/apps/resources/migrations/0007_resource_skill.py +63 -0
- trueppm_api/apps/resources/migrations/0008_project_resource.py +63 -0
- trueppm_api/apps/resources/migrations/0009_task_skill_requirement.py +60 -0
- trueppm_api/apps/resources/migrations/0010_alter_resourceskill_options_and_more.py +20 -0
- trueppm_api/apps/resources/migrations/0011_alter_projectresource_notes.py +17 -0
- trueppm_api/apps/resources/migrations/0012_add_resource_user_fk.py +26 -0
- trueppm_api/apps/resources/migrations/0013_alter_projectresource_unique_together_and_more.py +53 -0
- trueppm_api/apps/resources/migrations/0014_projectresource_sync_seq_resource_sync_seq_and_more.py +37 -0
- trueppm_api/apps/resources/migrations/0015_projectresource_deactivated_with_resource.py +17 -0
- trueppm_api/apps/resources/migrations/__init__.py +0 -0
- trueppm_api/apps/resources/models.py +298 -0
- trueppm_api/apps/resources/serializers.py +426 -0
- trueppm_api/apps/resources/services.py +465 -0
- trueppm_api/apps/resources/urls.py +28 -0
- trueppm_api/apps/resources/views.py +1749 -0
- trueppm_api/apps/scheduling/__init__.py +0 -0
- trueppm_api/apps/scheduling/apps.py +153 -0
- trueppm_api/apps/scheduling/calendars.py +119 -0
- trueppm_api/apps/scheduling/deadletter.py +91 -0
- trueppm_api/apps/scheduling/forecast_history_settings.py +215 -0
- trueppm_api/apps/scheduling/forecast_staleness.py +313 -0
- trueppm_api/apps/scheduling/graph_guard.py +263 -0
- trueppm_api/apps/scheduling/management/__init__.py +0 -0
- trueppm_api/apps/scheduling/management/commands/__init__.py +0 -0
- trueppm_api/apps/scheduling/management/commands/prune_forecast_snapshots.py +53 -0
- trueppm_api/apps/scheduling/migrations/0001_failed_task.py +62 -0
- trueppm_api/apps/scheduling/migrations/0001_squashed_0007_projectforecastsnapshot.py +309 -0
- trueppm_api/apps/scheduling/migrations/0002_schedulerequest.py +78 -0
- trueppm_api/apps/scheduling/migrations/0003_add_schedule_request_reason.py +27 -0
- trueppm_api/apps/scheduling/migrations/0004_velocity_suggestion.py +94 -0
- trueppm_api/apps/scheduling/migrations/0005_montecarlorun.py +61 -0
- trueppm_api/apps/scheduling/migrations/0006_montecarlorun_distribution.py +17 -0
- trueppm_api/apps/scheduling/migrations/0007_projectforecastsnapshot.py +65 -0
- trueppm_api/apps/scheduling/migrations/0008_alter_schedulerequest_reason.py +28 -0
- trueppm_api/apps/scheduling/migrations/0008_folded_schedulerequest_reason.py +34 -0
- trueppm_api/apps/scheduling/migrations/0009_alter_schedulerequest_reason.py +29 -0
- trueppm_api/apps/scheduling/migrations/0010_failedtask_resolution_note_failedtask_resolved_at_and_more.py +43 -0
- trueppm_api/apps/scheduling/migrations/0011_failedtask_project.py +26 -0
- trueppm_api/apps/scheduling/migrations/0012_montecarlorun_diagnostic.py +17 -0
- trueppm_api/apps/scheduling/migrations/0013_montecarlorun_status_date.py +17 -0
- trueppm_api/apps/scheduling/migrations/0014_montecarlorun_plan_version.py +17 -0
- trueppm_api/apps/scheduling/migrations/__init__.py +0 -0
- trueppm_api/apps/scheduling/models.py +516 -0
- trueppm_api/apps/scheduling/receivers.py +160 -0
- trueppm_api/apps/scheduling/risk_premium.py +283 -0
- trueppm_api/apps/scheduling/serializers.py +564 -0
- trueppm_api/apps/scheduling/services.py +1182 -0
- trueppm_api/apps/scheduling/signals.py +56 -0
- trueppm_api/apps/scheduling/tasks.py +1984 -0
- trueppm_api/apps/scheduling/telemetry.py +80 -0
- trueppm_api/apps/scheduling/units.py +35 -0
- trueppm_api/apps/scheduling/urls.py +57 -0
- trueppm_api/apps/scheduling/views.py +2564 -0
- trueppm_api/apps/sso/__init__.py +0 -0
- trueppm_api/apps/sso/apps.py +19 -0
- trueppm_api/apps/sso/extensions.py +130 -0
- trueppm_api/apps/sso/management/__init__.py +0 -0
- trueppm_api/apps/sso/management/commands/__init__.py +0 -0
- trueppm_api/apps/sso/management/commands/seed_sso_keycloak.py +172 -0
- trueppm_api/apps/sso/migrations/0001_initial.py +119 -0
- trueppm_api/apps/sso/migrations/0002_remove_oidcprovider_workspace_ssoproviderpolicy_and_more.py +169 -0
- trueppm_api/apps/sso/migrations/__init__.py +0 -0
- trueppm_api/apps/sso/models.py +148 -0
- trueppm_api/apps/sso/serializers.py +437 -0
- trueppm_api/apps/sso/services.py +1385 -0
- trueppm_api/apps/sso/urls.py +47 -0
- trueppm_api/apps/sso/views.py +935 -0
- trueppm_api/apps/sync/__init__.py +0 -0
- trueppm_api/apps/sync/apps.py +15 -0
- trueppm_api/apps/sync/backfill.py +208 -0
- trueppm_api/apps/sync/broadcast.py +320 -0
- trueppm_api/apps/sync/conflict.py +262 -0
- trueppm_api/apps/sync/consumers.py +471 -0
- trueppm_api/apps/sync/migrations/0001_initial.py +59 -0
- trueppm_api/apps/sync/migrations/0001_squashed_0002_remove_syncbatch_syncbatch_project_client_batch_uniq_and_more.py +77 -0
- trueppm_api/apps/sync/migrations/0002_remove_syncbatch_syncbatch_project_client_batch_uniq_and_more.py +41 -0
- trueppm_api/apps/sync/migrations/0003_boardevent.py +46 -0
- trueppm_api/apps/sync/migrations/0004_seed_sync_seq.py +24 -0
- trueppm_api/apps/sync/migrations/0005_program_sync_sequence.py +35 -0
- trueppm_api/apps/sync/migrations/__init__.py +0 -0
- trueppm_api/apps/sync/models.py +225 -0
- trueppm_api/apps/sync/pagination.py +231 -0
- trueppm_api/apps/sync/sequence.py +371 -0
- trueppm_api/apps/sync/serializers.py +687 -0
- trueppm_api/apps/sync/tasks.py +260 -0
- trueppm_api/apps/sync/throttles.py +175 -0
- trueppm_api/apps/sync/upload.py +501 -0
- trueppm_api/apps/sync/urls.py +17 -0
- trueppm_api/apps/sync/views.py +930 -0
- trueppm_api/apps/sync/ws_auth.py +193 -0
- trueppm_api/apps/taskruns/__init__.py +0 -0
- trueppm_api/apps/taskruns/apps.py +11 -0
- trueppm_api/apps/taskruns/migrations/0001_initial.py +92 -0
- trueppm_api/apps/taskruns/migrations/__init__.py +0 -0
- trueppm_api/apps/taskruns/models.py +68 -0
- trueppm_api/apps/taskruns/serializers.py +92 -0
- trueppm_api/apps/taskruns/tasks.py +60 -0
- trueppm_api/apps/taskruns/tracker.py +286 -0
- trueppm_api/apps/taskruns/urls.py +46 -0
- trueppm_api/apps/taskruns/views.py +195 -0
- trueppm_api/apps/teams/__init__.py +8 -0
- trueppm_api/apps/teams/apps.py +16 -0
- trueppm_api/apps/teams/migrations/0001_initial.py +139 -0
- trueppm_api/apps/teams/migrations/0001_squashed_0002_default_teams.py +142 -0
- trueppm_api/apps/teams/migrations/0002_default_teams.py +62 -0
- trueppm_api/apps/teams/migrations/0003_team_sync_seq_teammembership_sync_seq.py +22 -0
- trueppm_api/apps/teams/migrations/__init__.py +0 -0
- trueppm_api/apps/teams/models.py +145 -0
- trueppm_api/apps/teams/permissions.py +149 -0
- trueppm_api/apps/teams/serializers.py +95 -0
- trueppm_api/apps/teams/services.py +434 -0
- trueppm_api/apps/teams/signals.py +61 -0
- trueppm_api/apps/teams/urls.py +34 -0
- trueppm_api/apps/teams/views.py +201 -0
- trueppm_api/apps/timetracking/__init__.py +0 -0
- trueppm_api/apps/timetracking/apps.py +9 -0
- trueppm_api/apps/timetracking/migrations/0001_initial.py +117 -0
- trueppm_api/apps/timetracking/migrations/0002_timesheetsubmission.py +46 -0
- trueppm_api/apps/timetracking/migrations/0003_timeentry_deleted_at_timeentry_deleted_by.py +31 -0
- trueppm_api/apps/timetracking/migrations/0004_timeentry_sync_seq_and_more.py +24 -0
- trueppm_api/apps/timetracking/migrations/__init__.py +0 -0
- trueppm_api/apps/timetracking/models.py +178 -0
- trueppm_api/apps/timetracking/serializers.py +175 -0
- trueppm_api/apps/timetracking/services.py +117 -0
- trueppm_api/apps/timetracking/urls.py +47 -0
- trueppm_api/apps/timetracking/views.py +526 -0
- trueppm_api/apps/webhooks/__init__.py +0 -0
- trueppm_api/apps/webhooks/apps.py +8 -0
- trueppm_api/apps/webhooks/backfill.py +90 -0
- trueppm_api/apps/webhooks/dispatch.py +144 -0
- trueppm_api/apps/webhooks/migrations/0001_initial.py +146 -0
- trueppm_api/apps/webhooks/migrations/0001_squashed_0007_sprint_lifecycle_events.py +243 -0
- trueppm_api/apps/webhooks/migrations/0002_alter_webhook_events.py +32 -0
- trueppm_api/apps/webhooks/migrations/0003_delivery_status_created_idx.py +17 -0
- trueppm_api/apps/webhooks/migrations/0004_webhook_program_alter_webhook_project_and_more.py +64 -0
- trueppm_api/apps/webhooks/migrations/0005_webhook_delivery_sequence_numbers.py +30 -0
- trueppm_api/apps/webhooks/migrations/0006_webhook_format_alter_webhook_events_and_more.py +61 -0
- trueppm_api/apps/webhooks/migrations/0007_sprint_lifecycle_events.py +63 -0
- trueppm_api/apps/webhooks/migrations/0008_risk_baseline_comment_events.py +73 -0
- trueppm_api/apps/webhooks/migrations/0009_encrypt_webhook_secret_and_failure_counters.py +90 -0
- trueppm_api/apps/webhooks/migrations/__init__.py +0 -0
- trueppm_api/apps/webhooks/models.py +372 -0
- trueppm_api/apps/webhooks/serializers.py +318 -0
- trueppm_api/apps/webhooks/tasks.py +663 -0
- trueppm_api/apps/webhooks/urls.py +22 -0
- trueppm_api/apps/webhooks/views.py +383 -0
- trueppm_api/apps/workflow_engine/__init__.py +0 -0
- trueppm_api/apps/workflow_engine/apps.py +23 -0
- trueppm_api/apps/workflow_engine/migrations/0001_initial.py +230 -0
- trueppm_api/apps/workflow_engine/migrations/0001_squashed_0002_remove_workflowhistoryevent_workflow_history_lookup_idx.py +234 -0
- trueppm_api/apps/workflow_engine/migrations/0002_remove_workflowhistoryevent_workflow_history_lookup_idx.py +16 -0
- trueppm_api/apps/workflow_engine/migrations/0003_workflowoutboxrow_workflow_outbox_recovery_idx.py +21 -0
- trueppm_api/apps/workflow_engine/migrations/__init__.py +0 -0
- trueppm_api/apps/workflow_engine/models.py +265 -0
- trueppm_api/apps/workflow_engine/tasks.py +368 -0
- trueppm_api/apps/workspace/__init__.py +0 -0
- trueppm_api/apps/workspace/apps.py +10 -0
- trueppm_api/apps/workspace/backfill.py +111 -0
- trueppm_api/apps/workspace/export.py +242 -0
- trueppm_api/apps/workspace/migrations/0001_initial.py +326 -0
- trueppm_api/apps/workspace/migrations/0001_squashed_0014_workspacemembership_availability_effective_from_and_more.py +829 -0
- trueppm_api/apps/workspace/migrations/0002_remove_workspace_fiscal_year_start_and_more.py +85 -0
- trueppm_api/apps/workspace/migrations/0003_workspaceexportjob.py +73 -0
- trueppm_api/apps/workspace/migrations/0004_alter_workspaceinvite_status.py +27 -0
- trueppm_api/apps/workspace/migrations/0005_workspace_iteration_label_and_more.py +26 -0
- trueppm_api/apps/workspace/migrations/0006_alter_groupmembership_unique_together_and_more.py +45 -0
- trueppm_api/apps/workspace/migrations/0007_workspace_public_sharing_override_policy.py +21 -0
- trueppm_api/apps/workspace/migrations/0008_workspace_mc_history_attribution_audience_and_more.py +44 -0
- trueppm_api/apps/workspace/migrations/0009_workspace_methodology_and_more.py +186 -0
- trueppm_api/apps/workspace/migrations/0010_workspace_logo.py +38 -0
- trueppm_api/apps/workspace/migrations/0011_historicalworkspace_task_duration_change_percent_override_policy_and_more.py +56 -0
- trueppm_api/apps/workspace/migrations/0012_historicalworkspace_allowed_attachment_types_and_more.py +64 -0
- trueppm_api/apps/workspace/migrations/0013_auditevent.py +70 -0
- trueppm_api/apps/workspace/migrations/0014_workspacemembership_availability_effective_from_and_more.py +39 -0
- trueppm_api/apps/workspace/migrations/0015_trash_restore_1113.py +34 -0
- trueppm_api/apps/workspace/migrations/0016_historicalworkspace_calendar_and_more.py +55 -0
- trueppm_api/apps/workspace/migrations/0017_historicalworkspace_estimation_scale_and_more.py +38 -0
- trueppm_api/apps/workspace/migrations/0018_historicalworkspace_feedback_enabled_and_more.py +32 -0
- trueppm_api/apps/workspace/migrations/0019_historicalworkspace_mcp_enabled_and_more.py +22 -0
- trueppm_api/apps/workspace/migrations/0020_viewer_ordinal_one.py +34 -0
- trueppm_api/apps/workspace/migrations/0021_group_sync_seq_groupmembership_sync_seq_and_more.py +27 -0
- trueppm_api/apps/workspace/migrations/0022_historicalworkspace_sprint_picker_ready_only_default_and_more.py +22 -0
- trueppm_api/apps/workspace/migrations/0023_alter_auditevent_event_type.py +32 -0
- trueppm_api/apps/workspace/migrations/0024_alter_auditevent_event_type.py +33 -0
- trueppm_api/apps/workspace/migrations/0025_alter_auditevent_event_type.py +36 -0
- trueppm_api/apps/workspace/migrations/0026_alter_auditevent_event_type.py +37 -0
- trueppm_api/apps/workspace/migrations/0027_alter_auditevent_event_type.py +42 -0
- trueppm_api/apps/workspace/migrations/__init__.py +0 -0
- trueppm_api/apps/workspace/models.py +857 -0
- trueppm_api/apps/workspace/permissions.py +187 -0
- trueppm_api/apps/workspace/serializers.py +590 -0
- trueppm_api/apps/workspace/services.py +919 -0
- trueppm_api/apps/workspace/signals.py +37 -0
- trueppm_api/apps/workspace/tasks.py +555 -0
- trueppm_api/apps/workspace/urls.py +113 -0
- trueppm_api/apps/workspace/views.py +1502 -0
- trueppm_api/asgi.py +42 -0
- trueppm_api/celery.py +31 -0
- trueppm_api/core/__init__.py +0 -0
- trueppm_api/core/admin_site.py +206 -0
- trueppm_api/core/auth_views.py +916 -0
- trueppm_api/core/constant_time.py +51 -0
- trueppm_api/core/csp.py +54 -0
- trueppm_api/core/db.py +87 -0
- trueppm_api/core/db_session.py +37 -0
- trueppm_api/core/exception_handlers.py +157 -0
- trueppm_api/core/export_downloads.py +56 -0
- trueppm_api/core/extension_providers.py +56 -0
- trueppm_api/core/extension_signals.py +147 -0
- trueppm_api/core/idempotent.py +260 -0
- trueppm_api/core/metadata.py +42 -0
- trueppm_api/core/middleware.py +51 -0
- trueppm_api/core/openapi.py +949 -0
- trueppm_api/core/password_reset.py +500 -0
- trueppm_api/core/protect_conflict.py +100 -0
- trueppm_api/core/ratelimit.py +148 -0
- trueppm_api/core/redis_throttle.py +82 -0
- trueppm_api/core/refresh_cookie_policy.py +156 -0
- trueppm_api/core/request_body.py +86 -0
- trueppm_api/core/security_checks.py +884 -0
- trueppm_api/core/storage_config.py +105 -0
- trueppm_api/core/text_decode.py +168 -0
- trueppm_api/core/throttling.py +344 -0
- trueppm_api/core/valkey.py +214 -0
- trueppm_api/core/valkey_cache.py +66 -0
- trueppm_api/core/valkey_checks.py +104 -0
- trueppm_api/core/valkey_config.py +39 -0
- trueppm_api/core/worker_broker_wait.py +149 -0
- trueppm_api/core/worker_heartbeat.py +134 -0
- trueppm_api/fields.py +36 -0
- trueppm_api/permissions.py +30 -0
- trueppm_api/py.typed +0 -0
- trueppm_api/routing.py +11 -0
- trueppm_api/settings/__init__.py +0 -0
- trueppm_api/settings/base.py +2455 -0
- trueppm_api/settings/dev.py +273 -0
- trueppm_api/settings/prod.py +228 -0
- trueppm_api/urls.py +153 -0
- trueppm_api/workflows/__init__.py +38 -0
- trueppm_api/workflows/backends/__init__.py +6 -0
- trueppm_api/workflows/backends/default.py +297 -0
- trueppm_api/workflows/consumers/__init__.py +11 -0
- trueppm_api/workflows/consumers/requeue_failed_task.py +65 -0
- trueppm_api/workflows/interface.py +148 -0
- trueppm_api/workflows/registry.py +106 -0
- trueppm_api/workflows/services.py +90 -0
- trueppm_api/wsgi.py +11 -0
- trueppm_api-0.4.0b2.dist-info/METADATA +70 -0
- trueppm_api-0.4.0b2.dist-info/RECORD +759 -0
- trueppm_api-0.4.0b2.dist-info/WHEEL +4 -0
|
@@ -0,0 +1,885 @@
|
|
|
1
|
+
"""Calendar-aware resource utilization computation.
|
|
2
|
+
|
|
3
|
+
Computes per-resource daily load for the resource view (issue #22).
|
|
4
|
+
|
|
5
|
+
Design decisions:
|
|
6
|
+
- Uses TaskResource assignments, not Task.assignee — TaskResource carries
|
|
7
|
+
units (fractional allocation) and the resource's own calendar.
|
|
8
|
+
- Load per working day = resource.calendar.hours_per_day × assignment.units.
|
|
9
|
+
This is the standard resource planning convention: full allocation rate
|
|
10
|
+
regardless of percent_complete; the scheduler decides what's "done".
|
|
11
|
+
- "Resource calendar wins": if a resource has its own calendar that differs
|
|
12
|
+
from the project calendar, the resource calendar governs which days are
|
|
13
|
+
working. The API response flags this as calendar_differs_from_project=true
|
|
14
|
+
so the frontend can show a tooltip.
|
|
15
|
+
- Sparse output: only days with load > 0 are emitted. The frontend expands
|
|
16
|
+
to a dense grid.
|
|
17
|
+
- Windowed by the task's SPAN (ADR-0752's ``scheduled_start``..``early_finish``),
|
|
18
|
+
not by ``early_start``..``early_finish`` (#2623). Since ADR-0132,
|
|
19
|
+
``early_start`` is the *remaining-work* window for an in-progress task —
|
|
20
|
+
it shrinks toward ``early_finish`` as ``percent_complete`` rises. Windowing
|
|
21
|
+
load on it made reporting progress look like shedding allocation: a person's
|
|
22
|
+
real-world commitment to a task does not shrink because they finished part
|
|
23
|
+
of it. ``scheduled_finish`` is identically ``early_finish`` in every task
|
|
24
|
+
state (ADR-0752 §2) and is not a separate column, so only the start side
|
|
25
|
+
needs to change. ``scheduled_start`` falls back to ``early_start`` via
|
|
26
|
+
``Coalesce`` for rows a CPM run has not yet populated it on (additive
|
|
27
|
+
migration, no data backfill) — where the two windows coincide anyway for
|
|
28
|
+
not-started and complete tasks.
|
|
29
|
+
"""
|
|
30
|
+
|
|
31
|
+
from __future__ import annotations
|
|
32
|
+
|
|
33
|
+
import dataclasses
|
|
34
|
+
import datetime
|
|
35
|
+
from collections import defaultdict
|
|
36
|
+
from collections.abc import Sequence
|
|
37
|
+
from decimal import Decimal
|
|
38
|
+
from typing import Any
|
|
39
|
+
|
|
40
|
+
from django.db.models import DateField, Exists, OuterRef, Prefetch
|
|
41
|
+
from django.db.models.functions import Coalesce
|
|
42
|
+
|
|
43
|
+
# weekday() returns 0=Mon, 1=Tue, …, 6=Sun.
|
|
44
|
+
# Calendar.working_days bitmask: Mon=1, Tue=2, Wed=4, Thu=8, Fri=16, Sat=32, Sun=64.
|
|
45
|
+
_DOW_BITS: list[int] = [1, 2, 4, 8, 16, 32, 64]
|
|
46
|
+
|
|
47
|
+
# Sentinel calendar used when no calendar is configured: Mon–Fri, 8 h/day.
|
|
48
|
+
_DEFAULT_WORKING_DAYS = 31 # 0b0011111 = Mon–Fri
|
|
49
|
+
_DEFAULT_HOURS_PER_DAY = 8.0
|
|
50
|
+
|
|
51
|
+
|
|
52
|
+
def _load_band(load_pct: float) -> str:
|
|
53
|
+
"""Daily load band — the server-owned overallocation verdict (#989 / #986).
|
|
54
|
+
|
|
55
|
+
Mirrors ``resourceUtils.loadColor`` (web rule 91) and the weekly heatmap's
|
|
56
|
+
``u > 100`` overallocation check exactly, so a headless/MCP client reads the
|
|
57
|
+
same verdict the board renders: ``>100`` critical, ``85–100`` at-risk, else
|
|
58
|
+
on-track. Hyphenated to match the web ``LoadColor`` literals verbatim.
|
|
59
|
+
"""
|
|
60
|
+
if load_pct > 100:
|
|
61
|
+
return "critical"
|
|
62
|
+
if load_pct >= 85:
|
|
63
|
+
return "at-risk"
|
|
64
|
+
return "on-track"
|
|
65
|
+
|
|
66
|
+
|
|
67
|
+
def _is_working_day(
|
|
68
|
+
working_days_mask: int,
|
|
69
|
+
exception_ranges: list[tuple[datetime.date, datetime.date]],
|
|
70
|
+
d: datetime.date,
|
|
71
|
+
) -> bool:
|
|
72
|
+
"""Return True if `d` is a working day under the given calendar parameters.
|
|
73
|
+
|
|
74
|
+
`exception_ranges` is a pre-fetched list of (exc_start, exc_end) tuples;
|
|
75
|
+
fetching it once per resource avoids repeated DB hits in the inner loop.
|
|
76
|
+
"""
|
|
77
|
+
if not (working_days_mask & _DOW_BITS[d.weekday()]):
|
|
78
|
+
return False
|
|
79
|
+
return not any(exc_s <= d <= exc_e for exc_s, exc_e in exception_ranges)
|
|
80
|
+
|
|
81
|
+
|
|
82
|
+
def _exception_ranges(
|
|
83
|
+
exceptions: Any, # CalendarException queryset (already prefetched)
|
|
84
|
+
) -> list[tuple[datetime.date, datetime.date]]:
|
|
85
|
+
return [(e.exc_start, e.exc_end) for e in exceptions.all()]
|
|
86
|
+
|
|
87
|
+
|
|
88
|
+
# Bound the scan so a degenerate calendar (no working day in its bitmask, or
|
|
89
|
+
# exceptions blanketing the window) can't spin to the date ceiling. Mirrors the
|
|
90
|
+
# scheduler engine's MAX_CALENDAR_SCAN_DAYS guard.
|
|
91
|
+
_MAX_FLOOR_SCAN_DAYS = 366
|
|
92
|
+
|
|
93
|
+
|
|
94
|
+
def first_working_day(project: Any) -> datetime.date:
|
|
95
|
+
"""Return the first working day on or after ``project.start_date``.
|
|
96
|
+
|
|
97
|
+
This is the *effective* schedule floor — the CPM forward pass clamps every
|
|
98
|
+
task's ``early_start`` to ``next_working_day(project.start_date)`` (see the
|
|
99
|
+
scheduler engine), so a ``planned_start`` on a non-working project start date
|
|
100
|
+
(e.g. a Saturday) is a ghost value the engine immediately pushes forward.
|
|
101
|
+
The project-start floor guard must therefore compare against this date, not
|
|
102
|
+
the literal ``start_date``, or "snap to project start" lands on a weekend and
|
|
103
|
+
re-trips the guard (#884, a #868 regression).
|
|
104
|
+
|
|
105
|
+
Uses the project's calendar (weekday bitmask + exception ranges); falls back
|
|
106
|
+
to the Mon–Fri default when no calendar is configured — matching the
|
|
107
|
+
scheduler's default and the API→scheduler conversion in scheduling/tasks.py.
|
|
108
|
+
"""
|
|
109
|
+
cal = getattr(project, "calendar", None)
|
|
110
|
+
mask = cal.working_days if cal is not None else _DEFAULT_WORKING_DAYS
|
|
111
|
+
ranges = _exception_ranges(cal.exceptions) if cal is not None else []
|
|
112
|
+
|
|
113
|
+
start: datetime.date = project.start_date
|
|
114
|
+
d = start
|
|
115
|
+
for _ in range(_MAX_FLOOR_SCAN_DAYS):
|
|
116
|
+
if _is_working_day(mask, ranges, d):
|
|
117
|
+
return d
|
|
118
|
+
d += datetime.timedelta(days=1)
|
|
119
|
+
# Degenerate calendar — no working day within a year. Fall back to the literal
|
|
120
|
+
# start_date rather than raise; the floor guard is advisory, not load-bearing,
|
|
121
|
+
# and a hard error here would block all task edits on a misconfigured calendar.
|
|
122
|
+
return start
|
|
123
|
+
|
|
124
|
+
|
|
125
|
+
# ---------------------------------------------------------------------------
|
|
126
|
+
# Peak concurrent allocation — the calendar-aware overallocation verdict for
|
|
127
|
+
# write-time callers that compare units against Resource.max_units (#3534)
|
|
128
|
+
# ---------------------------------------------------------------------------
|
|
129
|
+
|
|
130
|
+
|
|
131
|
+
@dataclasses.dataclass(frozen=True)
|
|
132
|
+
class Allocation:
|
|
133
|
+
"""One commitment of a resource: ``units`` held across an inclusive day span.
|
|
134
|
+
|
|
135
|
+
``start`` / ``end`` are ``None`` for a task that carries no CPM span yet —
|
|
136
|
+
see :func:`peak_concurrent_units` for how an undated commitment is folded in.
|
|
137
|
+
"""
|
|
138
|
+
|
|
139
|
+
units: Decimal
|
|
140
|
+
start: datetime.date | None
|
|
141
|
+
end: datetime.date | None
|
|
142
|
+
|
|
143
|
+
|
|
144
|
+
def _first_working_day_in(
|
|
145
|
+
working_days_mask: int,
|
|
146
|
+
exception_ranges: list[tuple[datetime.date, datetime.date]],
|
|
147
|
+
start: datetime.date,
|
|
148
|
+
end: datetime.date,
|
|
149
|
+
) -> datetime.date | None:
|
|
150
|
+
"""First working day inside the inclusive ``[start, end]`` span, or ``None``.
|
|
151
|
+
|
|
152
|
+
Bounded by ``_MAX_FLOOR_SCAN_DAYS`` so a degenerate calendar (empty weekday
|
|
153
|
+
bitmask, or exceptions blanketing the span) cannot spin across a multi-year
|
|
154
|
+
span — the same guard ``first_working_day`` applies.
|
|
155
|
+
"""
|
|
156
|
+
d = start
|
|
157
|
+
for _ in range(_MAX_FLOOR_SCAN_DAYS):
|
|
158
|
+
if d > end:
|
|
159
|
+
return None
|
|
160
|
+
if _is_working_day(working_days_mask, exception_ranges, d):
|
|
161
|
+
return d
|
|
162
|
+
d += datetime.timedelta(days=1)
|
|
163
|
+
return None
|
|
164
|
+
|
|
165
|
+
|
|
166
|
+
def peak_concurrent_units(
|
|
167
|
+
allocations: Sequence[Allocation],
|
|
168
|
+
working_days_mask: int,
|
|
169
|
+
exception_ranges: list[tuple[datetime.date, datetime.date]],
|
|
170
|
+
) -> tuple[Decimal, datetime.date | None]:
|
|
171
|
+
"""Return ``(peak units held on any single working day, that day)``.
|
|
172
|
+
|
|
173
|
+
This is the overallocation question a project-lifetime ``Sum(units)`` cannot
|
|
174
|
+
answer: three 0.8-unit tasks that never share a calendar day are a peak of
|
|
175
|
+
0.8, not 2.4 (#3534). It is the same verdict the daily engine above reaches
|
|
176
|
+
in hours, kept in units here because write-time callers compare it directly
|
|
177
|
+
against a units capacity and never need a calendar's ``hours_per_day``. Since
|
|
178
|
+
#3574 that capacity is the caller's project-effective figure (the roster's
|
|
179
|
+
``units_override`` when set, else ``Resource.max_units``), not the raw default.
|
|
180
|
+
|
|
181
|
+
Undated commitments — a task with no ``scheduled_start``/``early_start``
|
|
182
|
+
span, which the daily engine simply drops — are folded in as a **baseline
|
|
183
|
+
present on every day** rather than dropped. An unscheduled task has no window
|
|
184
|
+
that could prove it does not overlap, so counting it as concurrent keeps the
|
|
185
|
+
warning conservative on a project whose CPM has never run, which is exactly
|
|
186
|
+
when the first assignments are made.
|
|
187
|
+
|
|
188
|
+
Only working days are considered, under the *resource's* calendar: two tasks
|
|
189
|
+
that touch only across a weekend are not a real conflict, and the heat map
|
|
190
|
+
already refuses to color one. ``(baseline, None)`` comes back when nothing is
|
|
191
|
+
dated — there is no busiest day to name, only a floor.
|
|
192
|
+
|
|
193
|
+
Args:
|
|
194
|
+
allocations: Every commitment the resource holds in the scope being
|
|
195
|
+
checked. Units are summed as-is; the caller decides what counts.
|
|
196
|
+
working_days_mask: ``Calendar.working_days`` bitmask for the resource.
|
|
197
|
+
exception_ranges: Pre-fetched ``(start, end)`` non-working ranges.
|
|
198
|
+
|
|
199
|
+
Returns:
|
|
200
|
+
``(peak, day)`` where ``day`` is ``None`` if the peak is the undated
|
|
201
|
+
baseline rather than a dated overlap.
|
|
202
|
+
"""
|
|
203
|
+
baseline = Decimal("0")
|
|
204
|
+
# (units, span_start, span_end) — narrowed to non-null dates so the sweep below
|
|
205
|
+
# needs no per-element None handling.
|
|
206
|
+
dated: list[tuple[Decimal, datetime.date, datetime.date]] = []
|
|
207
|
+
for alloc in allocations:
|
|
208
|
+
if alloc.start is None or alloc.end is None or alloc.end < alloc.start:
|
|
209
|
+
baseline += alloc.units
|
|
210
|
+
else:
|
|
211
|
+
dated.append((alloc.units, alloc.start, alloc.end))
|
|
212
|
+
|
|
213
|
+
if not dated:
|
|
214
|
+
return baseline, None
|
|
215
|
+
|
|
216
|
+
# The peak of a sum of boxcars is always attained on the first working day of
|
|
217
|
+
# some allocation's span: if day D is a working-day maximum, let S be the
|
|
218
|
+
# allocations covering D and s the latest start among them. Every member of S
|
|
219
|
+
# spans [s, D], so the first working day at or after s is <= D, lies inside
|
|
220
|
+
# every member of S, and therefore carries at least as much load as D. That
|
|
221
|
+
# makes one candidate per allocation sufficient — no day-by-day walk of the
|
|
222
|
+
# union span, which could be years wide with no window to clamp it to.
|
|
223
|
+
candidates: list[datetime.date] = []
|
|
224
|
+
for _units, span_start, span_end in dated:
|
|
225
|
+
day = _first_working_day_in(working_days_mask, exception_ranges, span_start, span_end)
|
|
226
|
+
if day is not None:
|
|
227
|
+
candidates.append(day)
|
|
228
|
+
if not candidates:
|
|
229
|
+
# Degenerate calendar: no span contains a working day at all. Falling back
|
|
230
|
+
# to raw span starts keeps a genuine overlap detectable rather than
|
|
231
|
+
# silently reporting the undated baseline as the peak.
|
|
232
|
+
candidates = [span_start for _units, span_start, _span_end in dated]
|
|
233
|
+
|
|
234
|
+
# Sweep the candidate days in order, opening and closing spans as they are
|
|
235
|
+
# reached. O(n log n) rather than re-scanning every span per candidate: one
|
|
236
|
+
# resource can legitimately carry thousands of assignments in a project, and
|
|
237
|
+
# this runs inside a write request.
|
|
238
|
+
by_start = sorted(dated, key=lambda row: row[1])
|
|
239
|
+
by_end = sorted(dated, key=lambda row: row[2])
|
|
240
|
+
opened = closed = 0
|
|
241
|
+
running = Decimal("0")
|
|
242
|
+
|
|
243
|
+
peak = baseline
|
|
244
|
+
peak_day: datetime.date | None = None
|
|
245
|
+
for day in sorted(set(candidates)):
|
|
246
|
+
while opened < len(by_start) and by_start[opened][1] <= day:
|
|
247
|
+
running += by_start[opened][0]
|
|
248
|
+
opened += 1
|
|
249
|
+
while closed < len(by_end) and by_end[closed][2] < day:
|
|
250
|
+
running -= by_end[closed][0]
|
|
251
|
+
closed += 1
|
|
252
|
+
total = baseline + running
|
|
253
|
+
if total > peak:
|
|
254
|
+
peak, peak_day = total, day
|
|
255
|
+
return peak, peak_day
|
|
256
|
+
|
|
257
|
+
|
|
258
|
+
def compute_utilization(
|
|
259
|
+
project: Any, # trueppm_api.apps.projects.models.Project
|
|
260
|
+
window_start: datetime.date,
|
|
261
|
+
window_end: datetime.date,
|
|
262
|
+
) -> dict[str, Any]:
|
|
263
|
+
"""Compute per-resource daily utilization for *project* within the date window.
|
|
264
|
+
|
|
265
|
+
Returns a plain dict matching the UtilizationResponse JSON contract:
|
|
266
|
+
|
|
267
|
+
{
|
|
268
|
+
"project_id": str,
|
|
269
|
+
"window": {"start": str, "end": str},
|
|
270
|
+
"resources": [
|
|
271
|
+
{
|
|
272
|
+
"resource_id": str,
|
|
273
|
+
"resource_name": str,
|
|
274
|
+
# Capacity ON THIS PROJECT: the roster's units_override when one is set,
|
|
275
|
+
# else Resource.max_units. Decimal as string for stable serialization.
|
|
276
|
+
"max_units": str,
|
|
277
|
+
"calendar_id": str | null,
|
|
278
|
+
"calendar_differs_from_project": bool,
|
|
279
|
+
"overallocated": bool, # true if any day exceeds 100% load
|
|
280
|
+
"days": {
|
|
281
|
+
"2026-03-03": {
|
|
282
|
+
"hours": 6.4,
|
|
283
|
+
"tasks": ["uuid", ...],
|
|
284
|
+
"load_pct": 80.0, # hours / (hours_per_day × max_units) × 100
|
|
285
|
+
"load_band": "on-track", # on-track | at-risk | critical (web rule 91)
|
|
286
|
+
"overallocated": false # load_pct > 100
|
|
287
|
+
},
|
|
288
|
+
...
|
|
289
|
+
}
|
|
290
|
+
}
|
|
291
|
+
],
|
|
292
|
+
"unassigned_task_count": int # tasks with CPM dates in window but no assignments
|
|
293
|
+
}
|
|
294
|
+
|
|
295
|
+
Callers must ensure the queryset passed via project.tasks already has
|
|
296
|
+
prefetch_related("assignments__resource__calendar__exceptions") applied.
|
|
297
|
+
The caller (ProjectViewSet.utilization) handles the prefetch.
|
|
298
|
+
"""
|
|
299
|
+
# Imported here rather than at module scope: resources.models imports Task
|
|
300
|
+
# from this app, so a top-level import would close the cycle.
|
|
301
|
+
from trueppm_api.apps.resources.models import TaskResource
|
|
302
|
+
|
|
303
|
+
# Delegate to the internal engine, then count unassigned tasks separately.
|
|
304
|
+
rows = _compute_utilization_internal(project, window_start, window_end)
|
|
305
|
+
|
|
306
|
+
# Count tasks in window that have no assignments (unassigned_task_count).
|
|
307
|
+
#
|
|
308
|
+
# Asked as a correlated NOT EXISTS, not as a literal `NOT IN (<uuid>, …)`
|
|
309
|
+
# built from the day expansion above (#3576). The old form shipped one UUID
|
|
310
|
+
# of SQL text per in-window task — ~40 bytes each, and O(N) to evaluate per
|
|
311
|
+
# candidate row — and it answered a subtly different question: its set came
|
|
312
|
+
# from `_days`, which only holds a task if one of its assignments produced a
|
|
313
|
+
# *working day of load* inside the window. A task whose span falls entirely
|
|
314
|
+
# on non-working days therefore counted as unassigned despite plainly having
|
|
315
|
+
# an assignment. `~Exists` answers the question the field name asks, and it
|
|
316
|
+
# is served by the FK index on resources_task_resource.task_id.
|
|
317
|
+
unassigned_count = (
|
|
318
|
+
project.tasks.filter(is_deleted=False, early_start__isnull=False)
|
|
319
|
+
.annotate(_span_start=Coalesce("scheduled_start", "early_start", output_field=DateField()))
|
|
320
|
+
.filter(_span_start__lte=window_end, early_finish__gte=window_start)
|
|
321
|
+
.filter(~Exists(TaskResource.objects.filter(task=OuterRef("pk"))))
|
|
322
|
+
.count()
|
|
323
|
+
)
|
|
324
|
+
|
|
325
|
+
# Build the public response — strip internal _mask/_exc_ranges/_days fields.
|
|
326
|
+
# Per-day capacity = hours_per_day × max_units (web rule 92), where max_units is
|
|
327
|
+
# already the project-effective figure the engine resolved (#3574). The server now
|
|
328
|
+
# emits load_pct / load_band / overallocated per day so the client renders the
|
|
329
|
+
# verdict rather than re-deriving it from raw hours (#989) — and a resource-
|
|
330
|
+
# level ``overallocated`` flag (any day over 100%) for the overallocation
|
|
331
|
+
# drawer, so it needn't re-scan every day client-side.
|
|
332
|
+
resources_out = []
|
|
333
|
+
for row in rows:
|
|
334
|
+
max_units_f = float(row["max_units"])
|
|
335
|
+
capacity = row["hours_per_day"] * max_units_f
|
|
336
|
+
days_out: dict[str, Any] = {}
|
|
337
|
+
resource_overallocated = False
|
|
338
|
+
for key, day in row["_days"].items():
|
|
339
|
+
load_pct = round(100.0 * day["hours"] / capacity, 1) if capacity > 0 else 0.0
|
|
340
|
+
day_over = load_pct > 100
|
|
341
|
+
resource_overallocated = resource_overallocated or day_over
|
|
342
|
+
days_out[key] = {
|
|
343
|
+
"hours": day["hours"],
|
|
344
|
+
"tasks": day["tasks"],
|
|
345
|
+
"load_pct": load_pct,
|
|
346
|
+
"load_band": _load_band(load_pct),
|
|
347
|
+
"overallocated": day_over,
|
|
348
|
+
}
|
|
349
|
+
resources_out.append(
|
|
350
|
+
{
|
|
351
|
+
"resource_id": row["resource_id"],
|
|
352
|
+
"resource_name": row["resource_name"],
|
|
353
|
+
"max_units": row["max_units"],
|
|
354
|
+
# hours_per_day is the effective working hours for this resource
|
|
355
|
+
# after calendar resolution. The frontend divides actual load hours
|
|
356
|
+
# by (hours_per_day × max_units) to compute the % bar fill — and
|
|
357
|
+
# max_units is override-resolved, so that bar and the server's own
|
|
358
|
+
# load_pct cannot disagree (#3574).
|
|
359
|
+
"hours_per_day": row["hours_per_day"],
|
|
360
|
+
"calendar_id": row["calendar_id"],
|
|
361
|
+
"calendar_differs_from_project": row["calendar_differs_from_project"],
|
|
362
|
+
"overallocated": resource_overallocated,
|
|
363
|
+
"days": days_out,
|
|
364
|
+
}
|
|
365
|
+
)
|
|
366
|
+
|
|
367
|
+
return {
|
|
368
|
+
"project_id": str(project.pk),
|
|
369
|
+
"window": {
|
|
370
|
+
"start": window_start.isoformat(),
|
|
371
|
+
"end": window_end.isoformat(),
|
|
372
|
+
},
|
|
373
|
+
"resources": resources_out,
|
|
374
|
+
"unassigned_task_count": unassigned_count,
|
|
375
|
+
}
|
|
376
|
+
|
|
377
|
+
|
|
378
|
+
# ---------------------------------------------------------------------------
|
|
379
|
+
# Helpers for weekly aggregation
|
|
380
|
+
# ---------------------------------------------------------------------------
|
|
381
|
+
|
|
382
|
+
# 12-colour palette for deterministic avatar colours, hashed from resource UUID.
|
|
383
|
+
_AVATAR_COLORS = [
|
|
384
|
+
"#1C6B3A", # brand-primary green
|
|
385
|
+
"#4F46E5", # indigo
|
|
386
|
+
"#7C3AED", # violet
|
|
387
|
+
"#DB2777", # pink
|
|
388
|
+
"#D97706", # amber
|
|
389
|
+
"#0891B2", # cyan
|
|
390
|
+
"#059669", # emerald
|
|
391
|
+
"#DC2626", # red
|
|
392
|
+
"#7C2D12", # brown
|
|
393
|
+
"#1D4ED8", # blue
|
|
394
|
+
"#B45309", # yellow-brown
|
|
395
|
+
"#0F766E", # teal
|
|
396
|
+
]
|
|
397
|
+
|
|
398
|
+
|
|
399
|
+
def _resource_color(resource_id: str) -> str:
|
|
400
|
+
h = int(resource_id.replace("-", "")[:8], 16)
|
|
401
|
+
return _AVATAR_COLORS[h % len(_AVATAR_COLORS)]
|
|
402
|
+
|
|
403
|
+
|
|
404
|
+
def _initials(name: str) -> str:
|
|
405
|
+
parts = name.split()
|
|
406
|
+
if len(parts) >= 2:
|
|
407
|
+
return f"{parts[0][0]}{parts[-1][0]}".upper()
|
|
408
|
+
return name[:2].upper() if len(name) >= 2 else name.upper()
|
|
409
|
+
|
|
410
|
+
|
|
411
|
+
def _count_working_days_in_range(
|
|
412
|
+
working_days_mask: int,
|
|
413
|
+
exception_ranges: list[tuple[datetime.date, datetime.date]],
|
|
414
|
+
start: datetime.date,
|
|
415
|
+
end: datetime.date,
|
|
416
|
+
) -> int:
|
|
417
|
+
"""Count working days between start and end inclusive under the given calendar."""
|
|
418
|
+
count = 0
|
|
419
|
+
d = start
|
|
420
|
+
while d <= end:
|
|
421
|
+
if _is_working_day(working_days_mask, exception_ranges, d):
|
|
422
|
+
count += 1
|
|
423
|
+
d += datetime.timedelta(days=1)
|
|
424
|
+
return count
|
|
425
|
+
|
|
426
|
+
|
|
427
|
+
def aggregate_utilization_weekly(
|
|
428
|
+
project: Any,
|
|
429
|
+
weeks_start: datetime.date,
|
|
430
|
+
num_weeks: int,
|
|
431
|
+
group_by: str = "none",
|
|
432
|
+
) -> dict[str, Any]:
|
|
433
|
+
"""Aggregate per-resource daily utilization into ISO-week percent buckets.
|
|
434
|
+
|
|
435
|
+
``weeks_start`` must be a Monday. Returns:
|
|
436
|
+
|
|
437
|
+
{
|
|
438
|
+
"weeks": ["2026-W18", "2026-W19", ...],
|
|
439
|
+
"resources": [
|
|
440
|
+
{
|
|
441
|
+
"id": str,
|
|
442
|
+
"name": str,
|
|
443
|
+
"initials": str,
|
|
444
|
+
"job_role": str,
|
|
445
|
+
"color": str,
|
|
446
|
+
"calendar_differs_from_project": bool,
|
|
447
|
+
"util": [80, 90, 100, 110, 120, ...] # integer percent per week
|
|
448
|
+
}
|
|
449
|
+
]
|
|
450
|
+
}
|
|
451
|
+
|
|
452
|
+
Util percent = (weekly_hours / weekly_capacity) × 100, where weekly_capacity
|
|
453
|
+
is hours_per_day × max_units × working_days_in_that_week (calendar-aware), and
|
|
454
|
+
``max_units`` is the project-effective capacity — the roster's
|
|
455
|
+
``units_override`` when one is set, else ``Resource.max_units`` (#3574).
|
|
456
|
+
"""
|
|
457
|
+
# Build ISO-week boundaries and labels
|
|
458
|
+
week_dates: list[tuple[datetime.date, datetime.date]] = []
|
|
459
|
+
week_labels: list[str] = []
|
|
460
|
+
for i in range(num_weeks):
|
|
461
|
+
wstart = weeks_start + datetime.timedelta(weeks=i)
|
|
462
|
+
wend = wstart + datetime.timedelta(days=6)
|
|
463
|
+
week_dates.append((wstart, wend))
|
|
464
|
+
# strftime %G/%V is ISO year/week — handles year-boundary weeks correctly.
|
|
465
|
+
week_labels.append(f"{wstart.strftime('%G')}-W{wstart.strftime('%V')}")
|
|
466
|
+
|
|
467
|
+
window_end = week_dates[-1][1]
|
|
468
|
+
|
|
469
|
+
# Reuse the daily engine — it handles calendar logic and prefetch contracts.
|
|
470
|
+
daily = _compute_utilization_internal(project, weeks_start, window_end)
|
|
471
|
+
|
|
472
|
+
resources_out = [
|
|
473
|
+
{
|
|
474
|
+
"id": row["resource_id"],
|
|
475
|
+
"name": row["resource_name"],
|
|
476
|
+
"initials": _initials(row["resource_name"]),
|
|
477
|
+
"job_role": row["job_role"],
|
|
478
|
+
"color": _resource_color(row["resource_id"]),
|
|
479
|
+
"calendar_differs_from_project": row["calendar_differs_from_project"],
|
|
480
|
+
"util": _weekly_util_for_resource(row, week_dates),
|
|
481
|
+
}
|
|
482
|
+
for row in daily
|
|
483
|
+
]
|
|
484
|
+
|
|
485
|
+
# Client-side re-sort: server provides canonical order but supports group_by
|
|
486
|
+
# as a sort hint so the client can resort without a round-trip.
|
|
487
|
+
if group_by == "role":
|
|
488
|
+
applied = "role"
|
|
489
|
+
resources_out.sort(key=lambda r: (r["job_role"].lower(), r["name"].lower()))
|
|
490
|
+
else:
|
|
491
|
+
# "project" grouping needs cross-project data this endpoint does not have — it is
|
|
492
|
+
# scoped to one project, so grouping its rows by project is a single group by
|
|
493
|
+
# construction. The cross-portfolio heat map is Enterprise. So "project" falls
|
|
494
|
+
# back to alphabetical, identically to "none".
|
|
495
|
+
#
|
|
496
|
+
# ``group_by`` in the response names the grouping that was ACTUALLY applied,
|
|
497
|
+
# which is the whole point (#2907): the parameter is validated and accepted, so
|
|
498
|
+
# without this a caller asking for "project" gets a 200 and reads an
|
|
499
|
+
# alphabetical payload as project-grouped, with nothing anywhere to contradict
|
|
500
|
+
# them. The 400 that would have told them is the one thing we cannot send —
|
|
501
|
+
# "project" is a documented enum value in the published schema, and removing an
|
|
502
|
+
# enum value is a Breaking change under the API stability contract. Echoing what
|
|
503
|
+
# was applied is additive, so it closes the silence without breaking the
|
|
504
|
+
# contract; the value is deprecated in the schema for removal after its window.
|
|
505
|
+
applied = "none"
|
|
506
|
+
resources_out.sort(key=lambda r: r["name"].lower())
|
|
507
|
+
|
|
508
|
+
return {"weeks": week_labels, "resources": resources_out, "group_by": applied}
|
|
509
|
+
|
|
510
|
+
|
|
511
|
+
def _sum_week_hours(days: dict[str, Any], wstart: datetime.date, wend: datetime.date) -> float:
|
|
512
|
+
"""Sum a resource's daily load hours across an inclusive ``[wstart, wend]`` week."""
|
|
513
|
+
total = 0.0
|
|
514
|
+
d = wstart
|
|
515
|
+
while d <= wend:
|
|
516
|
+
iso = d.isoformat()
|
|
517
|
+
if iso in days:
|
|
518
|
+
total += days[iso]["hours"]
|
|
519
|
+
d += datetime.timedelta(days=1)
|
|
520
|
+
return total
|
|
521
|
+
|
|
522
|
+
|
|
523
|
+
def _weekly_util_for_resource(
|
|
524
|
+
row: dict[str, Any], week_dates: list[tuple[datetime.date, datetime.date]]
|
|
525
|
+
) -> list[int]:
|
|
526
|
+
"""Integer percent utilization per ISO week for one daily-engine resource row.
|
|
527
|
+
|
|
528
|
+
Util percent = (weekly_hours / weekly_capacity) × 100, where weekly_capacity is
|
|
529
|
+
hours_per_day × max_units × working_days_in_that_week (calendar-aware).
|
|
530
|
+
``row["max_units"]`` is the project-effective capacity resolved by the engine.
|
|
531
|
+
"""
|
|
532
|
+
hrs = row["hours_per_day"]
|
|
533
|
+
max_units = float(row["max_units"])
|
|
534
|
+
mask = row["_mask"]
|
|
535
|
+
exc_ranges = row["_exc_ranges"]
|
|
536
|
+
|
|
537
|
+
util_by_week: list[int] = []
|
|
538
|
+
for wstart, wend in week_dates:
|
|
539
|
+
weekly_hours = _sum_week_hours(row["_days"], wstart, wend)
|
|
540
|
+
working_days = _count_working_days_in_range(mask, exc_ranges, wstart, wend)
|
|
541
|
+
weekly_capacity = hrs * max_units * working_days
|
|
542
|
+
util_pct = round(100 * weekly_hours / weekly_capacity) if weekly_capacity > 0 else 0
|
|
543
|
+
util_by_week.append(util_pct)
|
|
544
|
+
return util_by_week
|
|
545
|
+
|
|
546
|
+
|
|
547
|
+
def _compute_utilization_internal(
|
|
548
|
+
project: Any,
|
|
549
|
+
window_start: datetime.date,
|
|
550
|
+
window_end: datetime.date,
|
|
551
|
+
) -> list[dict[str, Any]]:
|
|
552
|
+
"""Internal variant of compute_utilization that returns raw resource rows.
|
|
553
|
+
|
|
554
|
+
Rows include the private ``_mask``, ``_exc_ranges``, and ``_days`` fields
|
|
555
|
+
needed by ``aggregate_utilization_weekly``. Not part of the public API.
|
|
556
|
+
|
|
557
|
+
Deactivated resources are excluded (#3572) — see the ``Prefetch`` below. This is
|
|
558
|
+
the ONE point at which the daily engine assembles its resource set, so every
|
|
559
|
+
caller inherits it: :func:`compute_utilization` (heat map),
|
|
560
|
+
:func:`aggregate_utilization_weekly` (weekly buckets, and through it
|
|
561
|
+
``resources/summary``), :func:`compute_team_utilization` (Overview KPI numerator),
|
|
562
|
+
and the over-allocation digest.
|
|
563
|
+
"""
|
|
564
|
+
from trueppm_api.apps.resources.capacity import project_effective_units
|
|
565
|
+
from trueppm_api.apps.resources.models import TaskResource
|
|
566
|
+
|
|
567
|
+
project_cal = project.calendar
|
|
568
|
+
proj_mask, proj_exceptions, proj_cal_id = _resolve_project_calendar(project_cal)
|
|
569
|
+
|
|
570
|
+
# One query for the whole roster. ``ProjectResource.units_override`` is a
|
|
571
|
+
# PER-PROJECT capacity statement, and this engine is the choke point every
|
|
572
|
+
# per-project capacity read funnels through — the daily load bands, the weekly
|
|
573
|
+
# heat map, ``resources/summary``, the Overview KPI and the weekly digest all
|
|
574
|
+
# read the rows it returns. Resolving the override anywhere else would let two
|
|
575
|
+
# adjacent surfaces report different numbers for the same person (#3574).
|
|
576
|
+
roster_units = project_effective_units(project.pk)
|
|
577
|
+
|
|
578
|
+
# Window by the task's SPAN (scheduled_start..early_finish), not its
|
|
579
|
+
# remaining-work window (early_start..early_finish) — see the module
|
|
580
|
+
# docstring and ADR-0752 / #2623. scheduled_finish has no column of its
|
|
581
|
+
# own; it is always early_finish, so only the start side is swapped.
|
|
582
|
+
# scheduled_start falls back to early_start for rows a CPM run has not
|
|
583
|
+
# (re)populated it on yet, which is also correct: the two windows are
|
|
584
|
+
# identical for not-started and complete tasks.
|
|
585
|
+
tasks = (
|
|
586
|
+
project.tasks.filter(is_deleted=False, early_start__isnull=False)
|
|
587
|
+
.annotate(_span_start=Coalesce("scheduled_start", "early_start", output_field=DateField()))
|
|
588
|
+
.filter(_span_start__lte=window_end, early_finish__gte=window_start)
|
|
589
|
+
.prefetch_related(
|
|
590
|
+
# The deactivation filter lives HERE and only here: narrowing the first
|
|
591
|
+
# prefetch level is what keeps a deactivated person's retained assignment
|
|
592
|
+
# rows (kept on purpose, for audit) from drawing load on the heat map and
|
|
593
|
+
# from carrying capacity into the Overview denominator. The chained
|
|
594
|
+
# lookup below extends this same prefetch — it must stay second, or
|
|
595
|
+
# Django rejects the pair as one lookup with two querysets.
|
|
596
|
+
# ``select_related("resource")`` so the chained lookup below reuses the
|
|
597
|
+
# already-cached resource and prefetches only the calendar level.
|
|
598
|
+
Prefetch(
|
|
599
|
+
"assignments", queryset=TaskResource.objects.active().select_related("resource")
|
|
600
|
+
),
|
|
601
|
+
"assignments__resource__calendar__exceptions",
|
|
602
|
+
)
|
|
603
|
+
)
|
|
604
|
+
|
|
605
|
+
resource_rows: dict[str, dict[str, Any]] = {}
|
|
606
|
+
|
|
607
|
+
for task in tasks:
|
|
608
|
+
assignments = list(task.assignments.all())
|
|
609
|
+
if not assignments:
|
|
610
|
+
continue
|
|
611
|
+
|
|
612
|
+
task_start = max(task._span_start, window_start)
|
|
613
|
+
task_end = min(task.early_finish, window_end)
|
|
614
|
+
|
|
615
|
+
for assignment in assignments:
|
|
616
|
+
_accumulate_assignment(
|
|
617
|
+
resource_rows,
|
|
618
|
+
assignment,
|
|
619
|
+
task,
|
|
620
|
+
task_start,
|
|
621
|
+
task_end,
|
|
622
|
+
project_cal,
|
|
623
|
+
proj_mask,
|
|
624
|
+
proj_exceptions,
|
|
625
|
+
proj_cal_id,
|
|
626
|
+
roster_units,
|
|
627
|
+
)
|
|
628
|
+
|
|
629
|
+
return sorted(resource_rows.values(), key=lambda r: r["resource_name"])
|
|
630
|
+
|
|
631
|
+
|
|
632
|
+
def _resolve_project_calendar(
|
|
633
|
+
project_cal: Any,
|
|
634
|
+
) -> tuple[int, list[tuple[datetime.date, datetime.date]], Any]:
|
|
635
|
+
"""Resolve ``(mask, exception_ranges, calendar_id)`` for the project calendar.
|
|
636
|
+
|
|
637
|
+
Falls back to the Mon–Fri default (no calendar configured).
|
|
638
|
+
"""
|
|
639
|
+
if project_cal is not None:
|
|
640
|
+
return project_cal.working_days, _exception_ranges(project_cal.exceptions), project_cal.pk
|
|
641
|
+
return _DEFAULT_WORKING_DAYS, [], None
|
|
642
|
+
|
|
643
|
+
|
|
644
|
+
def _resolve_resource_calendar(
|
|
645
|
+
resource: Any,
|
|
646
|
+
project_cal: Any,
|
|
647
|
+
proj_mask: int,
|
|
648
|
+
proj_exceptions: list[tuple[datetime.date, datetime.date]],
|
|
649
|
+
proj_cal_id: Any,
|
|
650
|
+
) -> tuple[int, float, list[tuple[datetime.date, datetime.date]], bool]:
|
|
651
|
+
"""Resolve ``(mask, hours_per_day, exception_ranges, calendar_differs)`` for a resource.
|
|
652
|
+
|
|
653
|
+
"Resource calendar wins": a resource with its own calendar governs its working
|
|
654
|
+
days and hours; otherwise it inherits the project calendar (and never differs).
|
|
655
|
+
"""
|
|
656
|
+
res_cal = resource.calendar
|
|
657
|
+
if res_cal is not None:
|
|
658
|
+
return (
|
|
659
|
+
res_cal.working_days,
|
|
660
|
+
float(res_cal.hours_per_day),
|
|
661
|
+
_exception_ranges(res_cal.exceptions),
|
|
662
|
+
res_cal.pk != proj_cal_id,
|
|
663
|
+
)
|
|
664
|
+
hrs = float(project_cal.hours_per_day) if project_cal else _DEFAULT_HOURS_PER_DAY
|
|
665
|
+
return proj_mask, hrs, proj_exceptions, False
|
|
666
|
+
|
|
667
|
+
|
|
668
|
+
def resolve_working_calendar(
|
|
669
|
+
resource: Any, project: Any
|
|
670
|
+
) -> tuple[int, list[tuple[datetime.date, datetime.date]]]:
|
|
671
|
+
"""Return ``(working-days bitmask, non-working ranges)`` for *resource* on *project*.
|
|
672
|
+
|
|
673
|
+
The same "resource calendar wins" resolution the daily engine applies,
|
|
674
|
+
published for callers that need only the working-day question and not a load
|
|
675
|
+
figure — :func:`peak_concurrent_units` takes exactly this pair. ``project`` may
|
|
676
|
+
be ``None``, in which case the Mon-Fri default stands in, matching the engine.
|
|
677
|
+
"""
|
|
678
|
+
project_cal = getattr(project, "calendar", None)
|
|
679
|
+
proj_mask, proj_exceptions, proj_cal_id = _resolve_project_calendar(project_cal)
|
|
680
|
+
mask, _hours, exception_ranges, _differs = _resolve_resource_calendar(
|
|
681
|
+
resource, project_cal, proj_mask, proj_exceptions, proj_cal_id
|
|
682
|
+
)
|
|
683
|
+
return mask, exception_ranges
|
|
684
|
+
|
|
685
|
+
|
|
686
|
+
def _init_resource_row(
|
|
687
|
+
rid: str,
|
|
688
|
+
resource: Any,
|
|
689
|
+
hrs: float,
|
|
690
|
+
cal_differs: bool,
|
|
691
|
+
mask: int,
|
|
692
|
+
exc_ranges: list[tuple[datetime.date, datetime.date]],
|
|
693
|
+
effective_units: Decimal | None = None,
|
|
694
|
+
) -> dict[str, Any]:
|
|
695
|
+
"""Build a fresh accumulator row for a resource (including internal `_` fields).
|
|
696
|
+
|
|
697
|
+
``effective_units`` is the resource's capacity **on this project** — the roster's
|
|
698
|
+
``units_override`` when one is set, else ``Resource.max_units``. It is ``None``
|
|
699
|
+
for a resource carrying assignments without a roster row, whose capacity is the
|
|
700
|
+
resource default by definition.
|
|
701
|
+
"""
|
|
702
|
+
return {
|
|
703
|
+
"resource_id": rid,
|
|
704
|
+
"resource_name": resource.name,
|
|
705
|
+
"job_role": resource.job_role or "",
|
|
706
|
+
# The row's single capacity figure, already override-resolved. Every
|
|
707
|
+
# consumer (load_pct, load_band, overallocated, the weekly heat map, the
|
|
708
|
+
# Overview KPI, the client's % bar) divides by this one value, which is what
|
|
709
|
+
# keeps them from disagreeing (#3574).
|
|
710
|
+
"max_units": str(effective_units if effective_units is not None else resource.max_units),
|
|
711
|
+
"hours_per_day": hrs,
|
|
712
|
+
"calendar_id": str(resource.calendar_id) if resource.calendar_id else None,
|
|
713
|
+
"calendar_differs_from_project": cal_differs,
|
|
714
|
+
# Internal fields used by aggregate_utilization_weekly
|
|
715
|
+
"_mask": mask,
|
|
716
|
+
"_exc_ranges": exc_ranges,
|
|
717
|
+
"_days": defaultdict(lambda: {"hours": 0.0, "tasks": []}),
|
|
718
|
+
}
|
|
719
|
+
|
|
720
|
+
|
|
721
|
+
def _accumulate_days(
|
|
722
|
+
days: dict[str, Any],
|
|
723
|
+
task_start: datetime.date,
|
|
724
|
+
task_end: datetime.date,
|
|
725
|
+
mask: int,
|
|
726
|
+
exc_ranges: list[tuple[datetime.date, datetime.date]],
|
|
727
|
+
daily_hours: float,
|
|
728
|
+
task_pk: str,
|
|
729
|
+
) -> None:
|
|
730
|
+
"""Add ``daily_hours`` (and the task id) to every working day in the task window."""
|
|
731
|
+
d = task_start
|
|
732
|
+
while d <= task_end:
|
|
733
|
+
if _is_working_day(mask, exc_ranges, d):
|
|
734
|
+
key = d.isoformat()
|
|
735
|
+
days[key]["hours"] = round(days[key]["hours"] + daily_hours, 4)
|
|
736
|
+
days[key]["tasks"].append(task_pk)
|
|
737
|
+
d += datetime.timedelta(days=1)
|
|
738
|
+
|
|
739
|
+
|
|
740
|
+
def _accumulate_assignment(
|
|
741
|
+
resource_rows: dict[str, dict[str, Any]],
|
|
742
|
+
assignment: Any,
|
|
743
|
+
task: Any,
|
|
744
|
+
task_start: datetime.date,
|
|
745
|
+
task_end: datetime.date,
|
|
746
|
+
project_cal: Any,
|
|
747
|
+
proj_mask: int,
|
|
748
|
+
proj_exceptions: list[tuple[datetime.date, datetime.date]],
|
|
749
|
+
proj_cal_id: Any,
|
|
750
|
+
roster_units: dict[str, Decimal] | None = None,
|
|
751
|
+
) -> None:
|
|
752
|
+
"""Fold one TaskResource assignment's daily load into ``resource_rows``."""
|
|
753
|
+
resource = assignment.resource
|
|
754
|
+
rid = str(resource.pk)
|
|
755
|
+
mask, hrs, exc_ranges, cal_differs = _resolve_resource_calendar(
|
|
756
|
+
resource, project_cal, proj_mask, proj_exceptions, proj_cal_id
|
|
757
|
+
)
|
|
758
|
+
if rid not in resource_rows:
|
|
759
|
+
resource_rows[rid] = _init_resource_row(
|
|
760
|
+
rid,
|
|
761
|
+
resource,
|
|
762
|
+
hrs,
|
|
763
|
+
cal_differs,
|
|
764
|
+
mask,
|
|
765
|
+
exc_ranges,
|
|
766
|
+
(roster_units or {}).get(rid),
|
|
767
|
+
)
|
|
768
|
+
|
|
769
|
+
daily_hours = hrs * float(assignment.units)
|
|
770
|
+
_accumulate_days(
|
|
771
|
+
resource_rows[rid]["_days"],
|
|
772
|
+
task_start,
|
|
773
|
+
task_end,
|
|
774
|
+
mask,
|
|
775
|
+
exc_ranges,
|
|
776
|
+
daily_hours,
|
|
777
|
+
str(task.pk),
|
|
778
|
+
)
|
|
779
|
+
|
|
780
|
+
|
|
781
|
+
# ---------------------------------------------------------------------------
|
|
782
|
+
# Project-level team utilization (single scalar for the Overview KPI, #2428)
|
|
783
|
+
# ---------------------------------------------------------------------------
|
|
784
|
+
|
|
785
|
+
# Machine-readable codes for "the team-utilization ratio is undefined". The web
|
|
786
|
+
# package maps each to a plain-language sentence (rule 119); the vocabulary is
|
|
787
|
+
# owned here, so a client never guesses at the cause of a blank card.
|
|
788
|
+
#
|
|
789
|
+
# Deliberately NOT a reason: a computable 0%. Nobody being allocated this week is
|
|
790
|
+
# a real, meaningful answer — and telling those two states apart is the whole
|
|
791
|
+
# point of the card (#2428). Only a genuinely undefined ratio gets a reason.
|
|
792
|
+
TEAM_UTILIZATION_NO_ROSTER = "no_roster"
|
|
793
|
+
TEAM_UTILIZATION_NO_CAPACITY = "no_capacity"
|
|
794
|
+
|
|
795
|
+
|
|
796
|
+
def _window_load_hours(row: dict[str, Any]) -> float:
|
|
797
|
+
"""Total assigned hours in one engine row. ``_days`` is already window-clamped."""
|
|
798
|
+
return sum(float(day["hours"]) for day in row["_days"].values())
|
|
799
|
+
|
|
800
|
+
|
|
801
|
+
def compute_team_utilization(
|
|
802
|
+
project: Any, # trueppm_api.apps.projects.models.Project
|
|
803
|
+
window_start: datetime.date,
|
|
804
|
+
window_end: datetime.date,
|
|
805
|
+
) -> dict[str, Any]:
|
|
806
|
+
"""Collapse the per-resource daily engine into one project-level utilization percent.
|
|
807
|
+
|
|
808
|
+
Returns ``{"pct": float | None, "reason": str | None}``. Exactly one of the two
|
|
809
|
+
is populated: a computable ratio carries ``reason=None``, and an undefined one
|
|
810
|
+
carries ``pct=None`` plus a code from the ``TEAM_UTILIZATION_*`` vocabulary
|
|
811
|
+
above.
|
|
812
|
+
|
|
813
|
+
``pct = 100 × Σ assigned hours ÷ Σ capacity hours`` over the window, where
|
|
814
|
+
capacity is the same calendar-aware ``hours_per_day × units × working_days``
|
|
815
|
+
product the daily engine and the weekly heatmap use — so the Overview KPI, the
|
|
816
|
+
heatmap, and a headless/MCP client cannot disagree about how loaded a team is.
|
|
817
|
+
|
|
818
|
+
The measured population is the project roster **union** the resources carrying
|
|
819
|
+
assignments in the window. The union matters: ``TaskResource`` does not require
|
|
820
|
+
a matching ``ProjectResource`` row, so counting only the roster would put an
|
|
821
|
+
off-roster assignee's hours in the numerator with no capacity in the
|
|
822
|
+
denominator and report a phantom overallocation. Counting only assignees would
|
|
823
|
+
instead hide idle capacity and peg a barely-booked team at 100%.
|
|
824
|
+
|
|
825
|
+
Per-project ``units_override`` wins over ``Resource.max_units`` for anyone on
|
|
826
|
+
the roster — that override exists precisely to say "this person is only half
|
|
827
|
+
on this project", and ignoring it would understate their utilization. Since
|
|
828
|
+
#3574 that resolution happens once, inside the daily engine, so this card and
|
|
829
|
+
every other per-project capacity read share one answer.
|
|
830
|
+
"""
|
|
831
|
+
rows_by_id = {
|
|
832
|
+
row["resource_id"]: row
|
|
833
|
+
for row in _compute_utilization_internal(project, window_start, window_end)
|
|
834
|
+
}
|
|
835
|
+
|
|
836
|
+
project_cal = project.calendar
|
|
837
|
+
proj_mask, proj_exceptions, proj_cal_id = _resolve_project_calendar(project_cal)
|
|
838
|
+
|
|
839
|
+
roster = {
|
|
840
|
+
str(pr.resource_id): pr
|
|
841
|
+
# ``.active()`` (#3572): a deactivated person contributes no load (the engine
|
|
842
|
+
# above dropped their assignments) but WOULD still contribute capacity here,
|
|
843
|
+
# so leaving them in the denominator understates team load at exactly the
|
|
844
|
+
# moment an off-boarding makes the remaining team busier.
|
|
845
|
+
for pr in project.resource_pool.active().prefetch_related("resource__calendar__exceptions")
|
|
846
|
+
}
|
|
847
|
+
|
|
848
|
+
measured = set(roster) | set(rows_by_id)
|
|
849
|
+
if not measured:
|
|
850
|
+
return {"pct": None, "reason": TEAM_UTILIZATION_NO_ROSTER}
|
|
851
|
+
|
|
852
|
+
load_total = 0.0
|
|
853
|
+
capacity_total = 0.0
|
|
854
|
+
for rid in measured:
|
|
855
|
+
row = rows_by_id.get(rid)
|
|
856
|
+
roster_entry = roster.get(rid)
|
|
857
|
+
|
|
858
|
+
if row is not None:
|
|
859
|
+
# The engine row already resolved this resource's calendar AND its
|
|
860
|
+
# effective per-project capacity; reuse both rather than re-deriving
|
|
861
|
+
# them, so numerator and denominator cannot drift and this card cannot
|
|
862
|
+
# disagree with the heat map it links to (#3574).
|
|
863
|
+
mask, hrs, exc_ranges = row["_mask"], row["hours_per_day"], row["_exc_ranges"]
|
|
864
|
+
units = float(row["max_units"])
|
|
865
|
+
load_total += _window_load_hours(row)
|
|
866
|
+
else:
|
|
867
|
+
# On the roster but carrying no assignments in the window — pure idle
|
|
868
|
+
# capacity, which still belongs in the denominator. No engine row exists
|
|
869
|
+
# to carry the resolved capacity, so resolve it from the roster entry.
|
|
870
|
+
resource = roster_entry.resource # type: ignore[union-attr]
|
|
871
|
+
mask, hrs, exc_ranges, _ = _resolve_resource_calendar(
|
|
872
|
+
resource, project_cal, proj_mask, proj_exceptions, proj_cal_id
|
|
873
|
+
)
|
|
874
|
+
units = float(roster_entry.effective_max_units) # type: ignore[union-attr]
|
|
875
|
+
|
|
876
|
+
working_days = _count_working_days_in_range(mask, exc_ranges, window_start, window_end)
|
|
877
|
+
capacity_total += hrs * units * working_days
|
|
878
|
+
|
|
879
|
+
# No working capacity in the window at all (every calendar closed, or every
|
|
880
|
+
# roster member at 0 units). The ratio is undefined rather than zero, so this
|
|
881
|
+
# is a reason and not a 0% reading.
|
|
882
|
+
if capacity_total <= 0:
|
|
883
|
+
return {"pct": None, "reason": TEAM_UTILIZATION_NO_CAPACITY}
|
|
884
|
+
|
|
885
|
+
return {"pct": round(100.0 * load_total / capacity_total, 1), "reason": None}
|