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.
Files changed (759) hide show
  1. trueppm_api/__init__.py +14 -0
  2. trueppm_api/apps/access/__init__.py +0 -0
  3. trueppm_api/apps/access/apps.py +19 -0
  4. trueppm_api/apps/access/groups.py +518 -0
  5. trueppm_api/apps/access/management/__init__.py +0 -0
  6. trueppm_api/apps/access/management/commands/__init__.py +0 -0
  7. trueppm_api/apps/access/management/commands/create_admin.py +164 -0
  8. trueppm_api/apps/access/management/commands/migrate_locked.py +96 -0
  9. trueppm_api/apps/access/management/commands/revoke_api_tokens.py +209 -0
  10. trueppm_api/apps/access/migrations/0001_initial.py +61 -0
  11. trueppm_api/apps/access/migrations/0001_squashed_0012_programmembership_role_title.py +167 -0
  12. trueppm_api/apps/access/migrations/0002_alter_projectmembership_id.py +29 -0
  13. trueppm_api/apps/access/migrations/0003_projectmembership_soft_delete.py +24 -0
  14. trueppm_api/apps/access/migrations/0004_alter_projectmembership_role.py +34 -0
  15. trueppm_api/apps/access/migrations/0005_program_entity_and_membership.py +76 -0
  16. trueppm_api/apps/access/migrations/0006_role_ordinal_spacing.py +113 -0
  17. trueppm_api/apps/access/migrations/0007_projectmembership_joined_at_and_more.py +35 -0
  18. trueppm_api/apps/access/migrations/0008_projectmembership_source_group.py +25 -0
  19. trueppm_api/apps/access/migrations/0009_projectmembership_pm_proj_serverver_idx.py +20 -0
  20. trueppm_api/apps/access/migrations/0010_programmembership_joined_at_and_more.py +38 -0
  21. trueppm_api/apps/access/migrations/0011_alter_programmembership_unique_together_and_more.py +36 -0
  22. trueppm_api/apps/access/migrations/0012_programmembership_role_title.py +17 -0
  23. trueppm_api/apps/access/migrations/0013_userdefinedmentiongroup.py +82 -0
  24. trueppm_api/apps/access/migrations/0014_programmembership_progm_serverver_idx.py +19 -0
  25. trueppm_api/apps/access/migrations/0015_programuserdefinedmentiongroup.py +86 -0
  26. trueppm_api/apps/access/migrations/0016_externalstakeholder.py +67 -0
  27. trueppm_api/apps/access/migrations/0017_viewer_ordinal_one.py +132 -0
  28. trueppm_api/apps/access/migrations/0018_programmembership_sync_seq_and_more.py +52 -0
  29. trueppm_api/apps/access/migrations/0019_programmembership_reinstated_at_and_more.py +22 -0
  30. trueppm_api/apps/access/migrations/__init__.py +0 -0
  31. trueppm_api/apps/access/models.py +588 -0
  32. trueppm_api/apps/access/permissions.py +2837 -0
  33. trueppm_api/apps/access/serializers.py +946 -0
  34. trueppm_api/apps/access/services.py +667 -0
  35. trueppm_api/apps/access/signals.py +103 -0
  36. trueppm_api/apps/access/tasks.py +50 -0
  37. trueppm_api/apps/access/throttles.py +95 -0
  38. trueppm_api/apps/access/urls.py +191 -0
  39. trueppm_api/apps/access/views.py +1931 -0
  40. trueppm_api/apps/agents/__init__.py +6 -0
  41. trueppm_api/apps/agents/apps.py +11 -0
  42. trueppm_api/apps/agents/canonical.py +73 -0
  43. trueppm_api/apps/agents/deferred.py +108 -0
  44. trueppm_api/apps/agents/management/__init__.py +0 -0
  45. trueppm_api/apps/agents/management/commands/__init__.py +0 -0
  46. trueppm_api/apps/agents/management/commands/audit_prune.py +137 -0
  47. trueppm_api/apps/agents/management/commands/audit_verify.py +101 -0
  48. trueppm_api/apps/agents/middleware.py +44 -0
  49. trueppm_api/apps/agents/migrations/0001_initial.py +231 -0
  50. trueppm_api/apps/agents/migrations/0002_agentactioncheckpoint.py +71 -0
  51. trueppm_api/apps/agents/migrations/0003_agentactionrefusaldetail.py +58 -0
  52. trueppm_api/apps/agents/migrations/__init__.py +0 -0
  53. trueppm_api/apps/agents/models.py +371 -0
  54. trueppm_api/apps/agents/refusal.py +103 -0
  55. trueppm_api/apps/agents/serializers.py +85 -0
  56. trueppm_api/apps/agents/services.py +397 -0
  57. trueppm_api/apps/agents/signals.py +30 -0
  58. trueppm_api/apps/agents/urls.py +15 -0
  59. trueppm_api/apps/agents/views.py +108 -0
  60. trueppm_api/apps/csvimport/__init__.py +12 -0
  61. trueppm_api/apps/csvimport/apps.py +11 -0
  62. trueppm_api/apps/csvimport/mapping.py +363 -0
  63. trueppm_api/apps/csvimport/migrations/0001_initial.py +74 -0
  64. trueppm_api/apps/csvimport/migrations/0002_schedule_outline_batch_operations.py +37 -0
  65. trueppm_api/apps/csvimport/migrations/0003_csvimportrequest_date_order_and_more.py +26 -0
  66. trueppm_api/apps/csvimport/migrations/__init__.py +0 -0
  67. trueppm_api/apps/csvimport/models.py +111 -0
  68. trueppm_api/apps/csvimport/parser.py +1825 -0
  69. trueppm_api/apps/csvimport/services.py +48 -0
  70. trueppm_api/apps/csvimport/tasks.py +418 -0
  71. trueppm_api/apps/csvimport/template.py +37 -0
  72. trueppm_api/apps/csvimport/urls.py +50 -0
  73. trueppm_api/apps/csvimport/views.py +793 -0
  74. trueppm_api/apps/history/__init__.py +0 -0
  75. trueppm_api/apps/history/apps.py +12 -0
  76. trueppm_api/apps/history/changelog.py +359 -0
  77. trueppm_api/apps/history/diff_policy.py +177 -0
  78. trueppm_api/apps/history/serializers.py +104 -0
  79. trueppm_api/apps/history/signals.py +82 -0
  80. trueppm_api/apps/history/tasks.py +105 -0
  81. trueppm_api/apps/history/urls.py +38 -0
  82. trueppm_api/apps/history/views.py +443 -0
  83. trueppm_api/apps/idempotency/__init__.py +0 -0
  84. trueppm_api/apps/idempotency/apps.py +11 -0
  85. trueppm_api/apps/idempotency/migrations/0001_initial.py +71 -0
  86. trueppm_api/apps/idempotency/migrations/__init__.py +0 -0
  87. trueppm_api/apps/idempotency/mixins.py +226 -0
  88. trueppm_api/apps/idempotency/models.py +75 -0
  89. trueppm_api/apps/idempotency/tasks.py +61 -0
  90. trueppm_api/apps/integrations/__init__.py +13 -0
  91. trueppm_api/apps/integrations/apps.py +59 -0
  92. trueppm_api/apps/integrations/connections.py +806 -0
  93. trueppm_api/apps/integrations/encryption.py +92 -0
  94. trueppm_api/apps/integrations/external_sources.py +837 -0
  95. trueppm_api/apps/integrations/git_automation_services.py +231 -0
  96. trueppm_api/apps/integrations/git_webhook_auth.py +243 -0
  97. trueppm_api/apps/integrations/http.py +403 -0
  98. trueppm_api/apps/integrations/me_work.py +218 -0
  99. trueppm_api/apps/integrations/migrations/0001_initial.py +64 -0
  100. trueppm_api/apps/integrations/migrations/0001_squashed_0006_tasklink_description_tasklink_preview_type_and_more.py +187 -0
  101. trueppm_api/apps/integrations/migrations/0002_tasklink.py +67 -0
  102. trueppm_api/apps/integrations/migrations/0003_tasklink_tasklink_serverver_idx.py +17 -0
  103. trueppm_api/apps/integrations/migrations/0004_tasklink_custom_title_tasklink_labels.py +25 -0
  104. trueppm_api/apps/integrations/migrations/0005_boardautomation.py +56 -0
  105. trueppm_api/apps/integrations/migrations/0006_tasklink_description_tasklink_preview_type_and_more.py +40 -0
  106. trueppm_api/apps/integrations/migrations/0007_tasklink_created_at.py +23 -0
  107. trueppm_api/apps/integrations/migrations/0008_integrationcredential_config_externalworkitem.py +66 -0
  108. trueppm_api/apps/integrations/migrations/0009_externalsyncrequest_and_more.py +96 -0
  109. trueppm_api/apps/integrations/migrations/0010_externalworkitem_due_date.py +17 -0
  110. trueppm_api/apps/integrations/migrations/0011_tasklink_sync_seq_tasklink_tasklink_syncseq_idx.py +22 -0
  111. trueppm_api/apps/integrations/migrations/0012_boardautomation_last_delivery_at_and_more.py +42 -0
  112. trueppm_api/apps/integrations/migrations/0013_externalsyncrequest_attempt_count_and_more.py +26 -0
  113. trueppm_api/apps/integrations/migrations/__init__.py +0 -0
  114. trueppm_api/apps/integrations/models.py +622 -0
  115. trueppm_api/apps/integrations/notification_channels.py +57 -0
  116. trueppm_api/apps/integrations/opengraph.py +229 -0
  117. trueppm_api/apps/integrations/outgoing.py +201 -0
  118. trueppm_api/apps/integrations/providers.py +519 -0
  119. trueppm_api/apps/integrations/registry.py +345 -0
  120. trueppm_api/apps/integrations/serializers.py +453 -0
  121. trueppm_api/apps/integrations/services.py +171 -0
  122. trueppm_api/apps/integrations/tasks.py +731 -0
  123. trueppm_api/apps/integrations/throttles.py +165 -0
  124. trueppm_api/apps/integrations/urls.py +77 -0
  125. trueppm_api/apps/integrations/views.py +1106 -0
  126. trueppm_api/apps/jiraimport/__init__.py +8 -0
  127. trueppm_api/apps/jiraimport/apps.py +11 -0
  128. trueppm_api/apps/jiraimport/migrations/0001_initial.py +72 -0
  129. trueppm_api/apps/jiraimport/migrations/__init__.py +0 -0
  130. trueppm_api/apps/jiraimport/models.py +70 -0
  131. trueppm_api/apps/jiraimport/parser.py +350 -0
  132. trueppm_api/apps/jiraimport/services.py +46 -0
  133. trueppm_api/apps/jiraimport/tasks.py +277 -0
  134. trueppm_api/apps/jiraimport/urls.py +15 -0
  135. trueppm_api/apps/jiraimport/views.py +153 -0
  136. trueppm_api/apps/msproject/__init__.py +0 -0
  137. trueppm_api/apps/msproject/apps.py +11 -0
  138. trueppm_api/apps/msproject/dataclasses.py +153 -0
  139. trueppm_api/apps/msproject/exporter.py +500 -0
  140. trueppm_api/apps/msproject/extended_attributes.py +77 -0
  141. trueppm_api/apps/msproject/importer.py +1095 -0
  142. trueppm_api/apps/msproject/migrations/0001_import_request.py +77 -0
  143. trueppm_api/apps/msproject/migrations/0001_squashed_0002_importrequest_creates_project.py +80 -0
  144. trueppm_api/apps/msproject/migrations/0002_importrequest_creates_project.py +15 -0
  145. trueppm_api/apps/msproject/migrations/__init__.py +0 -0
  146. trueppm_api/apps/msproject/models.py +81 -0
  147. trueppm_api/apps/msproject/parser.py +1231 -0
  148. trueppm_api/apps/msproject/serializers.py +136 -0
  149. trueppm_api/apps/msproject/services.py +58 -0
  150. trueppm_api/apps/msproject/tasks.py +436 -0
  151. trueppm_api/apps/msproject/urls.py +39 -0
  152. trueppm_api/apps/msproject/views.py +531 -0
  153. trueppm_api/apps/notifications/__init__.py +7 -0
  154. trueppm_api/apps/notifications/apps.py +15 -0
  155. trueppm_api/apps/notifications/backfill.py +79 -0
  156. trueppm_api/apps/notifications/categories.py +112 -0
  157. trueppm_api/apps/notifications/delivery_limits.py +258 -0
  158. trueppm_api/apps/notifications/digests.py +447 -0
  159. trueppm_api/apps/notifications/email_backend.py +330 -0
  160. trueppm_api/apps/notifications/email_health.py +128 -0
  161. trueppm_api/apps/notifications/migrations/0001_initial.py +207 -0
  162. trueppm_api/apps/notifications/migrations/0001_squashed_0006_notification_task.py +294 -0
  163. trueppm_api/apps/notifications/migrations/0002_project_notification_preference.py +67 -0
  164. trueppm_api/apps/notifications/migrations/0003_projectnotificationpreference_paused.py +17 -0
  165. trueppm_api/apps/notifications/migrations/0004_clean_unknown_matrix_keys.py +30 -0
  166. trueppm_api/apps/notifications/migrations/0005_notification_body_notification_event_type_and_more.py +27 -0
  167. trueppm_api/apps/notifications/migrations/0006_notification_task.py +25 -0
  168. trueppm_api/apps/notifications/migrations/0007_workspaceemailsettings.py +80 -0
  169. trueppm_api/apps/notifications/migrations/0008_notification_snoozed_until.py +17 -0
  170. trueppm_api/apps/notifications/migrations/0009_usernotificationsettings.py +43 -0
  171. trueppm_api/apps/notifications/migrations/0010_projectnotificationpreference_schema_version.py +20 -0
  172. trueppm_api/apps/notifications/migrations/0011_usernotificationsettings_digest_hour_and_more.py +96 -0
  173. trueppm_api/apps/notifications/migrations/__init__.py +0 -0
  174. trueppm_api/apps/notifications/models.py +1197 -0
  175. trueppm_api/apps/notifications/receivers.py +155 -0
  176. trueppm_api/apps/notifications/schema_migrations.py +56 -0
  177. trueppm_api/apps/notifications/serializers.py +961 -0
  178. trueppm_api/apps/notifications/services.py +1451 -0
  179. trueppm_api/apps/notifications/tasks.py +711 -0
  180. trueppm_api/apps/notifications/throttles.py +98 -0
  181. trueppm_api/apps/notifications/urls.py +97 -0
  182. trueppm_api/apps/notifications/views.py +904 -0
  183. trueppm_api/apps/observability/__init__.py +0 -0
  184. trueppm_api/apps/observability/apps.py +31 -0
  185. trueppm_api/apps/observability/logging.py +213 -0
  186. trueppm_api/apps/observability/migrations/0001_initial.py +35 -0
  187. trueppm_api/apps/observability/migrations/0001_squashed_0003_alter_purgerun_trigger.py +154 -0
  188. trueppm_api/apps/observability/migrations/0002_purgerun_retentionpolicy_retentionschedule.py +131 -0
  189. trueppm_api/apps/observability/migrations/0003_alter_purgerun_trigger.py +21 -0
  190. trueppm_api/apps/observability/migrations/0004_alter_retentionpolicy_key.py +28 -0
  191. trueppm_api/apps/observability/migrations/__init__.py +0 -0
  192. trueppm_api/apps/observability/models.py +141 -0
  193. trueppm_api/apps/observability/otel/__init__.py +45 -0
  194. trueppm_api/apps/observability/otel/attributes.py +247 -0
  195. trueppm_api/apps/observability/otel/export_health.py +533 -0
  196. trueppm_api/apps/observability/otel/instrumentation.py +351 -0
  197. trueppm_api/apps/observability/otel/metrics.py +551 -0
  198. trueppm_api/apps/observability/otel/provider.py +511 -0
  199. trueppm_api/apps/observability/otel/request_attributes.py +204 -0
  200. trueppm_api/apps/observability/purge_registry.py +124 -0
  201. trueppm_api/apps/observability/retention.py +139 -0
  202. trueppm_api/apps/observability/selectors.py +969 -0
  203. trueppm_api/apps/observability/serializers.py +142 -0
  204. trueppm_api/apps/observability/services.py +407 -0
  205. trueppm_api/apps/observability/tasks.py +266 -0
  206. trueppm_api/apps/observability/urls.py +27 -0
  207. trueppm_api/apps/observability/views.py +523 -0
  208. trueppm_api/apps/profiles/__init__.py +0 -0
  209. trueppm_api/apps/profiles/apps.py +15 -0
  210. trueppm_api/apps/profiles/constants.py +54 -0
  211. trueppm_api/apps/profiles/migrations/0001_initial.py +55 -0
  212. trueppm_api/apps/profiles/migrations/0001_squashed_0004_userprofile_role_context.py +125 -0
  213. trueppm_api/apps/profiles/migrations/0002_userprofile_hidden_views.py +17 -0
  214. trueppm_api/apps/profiles/migrations/0003_projectvisit.py +63 -0
  215. trueppm_api/apps/profiles/migrations/0004_userprofile_role_context.py +26 -0
  216. trueppm_api/apps/profiles/migrations/0005_userprofile_schedule_in_deliver.py +20 -0
  217. trueppm_api/apps/profiles/migrations/0006_userprofile_date_format_userprofile_timezone.py +36 -0
  218. trueppm_api/apps/profiles/migrations/0007_userpin.py +91 -0
  219. trueppm_api/apps/profiles/migrations/0008_remove_userprofile_schedule_in_deliver.py +71 -0
  220. trueppm_api/apps/profiles/migrations/0009_auth_user_email_upper_idx.py +81 -0
  221. trueppm_api/apps/profiles/migrations/__init__.py +0 -0
  222. trueppm_api/apps/profiles/models.py +276 -0
  223. trueppm_api/apps/profiles/serializers.py +199 -0
  224. trueppm_api/apps/profiles/services.py +466 -0
  225. trueppm_api/apps/profiles/views.py +124 -0
  226. trueppm_api/apps/projects/__init__.py +0 -0
  227. trueppm_api/apps/projects/actual_date_rules.py +163 -0
  228. trueppm_api/apps/projects/amend.py +133 -0
  229. trueppm_api/apps/projects/apps.py +38 -0
  230. trueppm_api/apps/projects/asset_feed.py +459 -0
  231. trueppm_api/apps/projects/asset_views.py +317 -0
  232. trueppm_api/apps/projects/attachment_policy.py +278 -0
  233. trueppm_api/apps/projects/authentication.py +449 -0
  234. trueppm_api/apps/projects/backfill.py +287 -0
  235. trueppm_api/apps/projects/backlog_services.py +324 -0
  236. trueppm_api/apps/projects/backlog_views.py +302 -0
  237. trueppm_api/apps/projects/batch_operation_views.py +264 -0
  238. trueppm_api/apps/projects/blocker_services.py +510 -0
  239. trueppm_api/apps/projects/board_activity.py +462 -0
  240. trueppm_api/apps/projects/board_activity_views.py +186 -0
  241. trueppm_api/apps/projects/board_lanes.py +134 -0
  242. trueppm_api/apps/projects/bulk_settings.py +194 -0
  243. trueppm_api/apps/projects/bundled_templates.py +215 -0
  244. trueppm_api/apps/projects/calendar_settings.py +180 -0
  245. trueppm_api/apps/projects/ceremony_views.py +244 -0
  246. trueppm_api/apps/projects/commit_moment.py +204 -0
  247. trueppm_api/apps/projects/config_notice.py +1325 -0
  248. trueppm_api/apps/projects/custom_field_values.py +266 -0
  249. trueppm_api/apps/projects/decisions_services.py +93 -0
  250. trueppm_api/apps/projects/decisions_views.py +94 -0
  251. trueppm_api/apps/projects/estimation_scale.py +126 -0
  252. trueppm_api/apps/projects/export_bundle.py +353 -0
  253. trueppm_api/apps/projects/fixtures/seeds/atlas-platform-launch.json +4256 -0
  254. trueppm_api/apps/projects/fixtures/seeds/aurora-mobile-app.json +2000 -0
  255. trueppm_api/apps/projects/fixtures/seeds/bayside-civic-center.json +1825 -0
  256. trueppm_api/apps/projects/fixtures/seeds/ga-launch.json +1905 -0
  257. trueppm_api/apps/projects/fixtures/seeds/helios-crm-replacement.json +1409 -0
  258. trueppm_api/apps/projects/guardrail_policy_source.py +269 -0
  259. trueppm_api/apps/projects/inbound_sync.py +555 -0
  260. trueppm_api/apps/projects/iteration_label.py +85 -0
  261. trueppm_api/apps/projects/lifecycle.py +191 -0
  262. trueppm_api/apps/projects/management/__init__.py +0 -0
  263. trueppm_api/apps/projects/management/commands/__init__.py +0 -0
  264. trueppm_api/apps/projects/management/commands/backfill_in_progress_status.py +92 -0
  265. trueppm_api/apps/projects/management/commands/create_demo_share_link.py +368 -0
  266. trueppm_api/apps/projects/management/commands/export_program.py +50 -0
  267. trueppm_api/apps/projects/management/commands/import_seed.py +165 -0
  268. trueppm_api/apps/projects/management/commands/load_sample_project.py +247 -0
  269. trueppm_api/apps/projects/management/commands/seed_capacity.py +405 -0
  270. trueppm_api/apps/projects/management/commands/seed_integration_fixtures.py +178 -0
  271. trueppm_api/apps/projects/management/commands/shift_sample_dates.py +120 -0
  272. trueppm_api/apps/projects/mcp_settings.py +305 -0
  273. trueppm_api/apps/projects/methodology.py +178 -0
  274. trueppm_api/apps/projects/migrations/0001_initial.py +208 -0
  275. trueppm_api/apps/projects/migrations/0001_squashed_0094_project_decisions_policy.py +5595 -0
  276. trueppm_api/apps/projects/migrations/0002_alter_uuid_pk_serialize_false.py +57 -0
  277. trueppm_api/apps/projects/migrations/0003_rename_task_project_index.py +25 -0
  278. trueppm_api/apps/projects/migrations/0004_soft_delete_and_dependency_versioned.py +70 -0
  279. trueppm_api/apps/projects/migrations/0005_task_assignee.py +33 -0
  280. trueppm_api/apps/projects/migrations/0006_task_utilization_index.py +31 -0
  281. trueppm_api/apps/projects/migrations/0007_task_is_milestone.py +28 -0
  282. trueppm_api/apps/projects/migrations/0008_baseline.py +119 -0
  283. trueppm_api/apps/projects/migrations/0009_historicaldependency_historicalproject_and_more.py +210 -0
  284. trueppm_api/apps/projects/migrations/0010_risk.py +229 -0
  285. trueppm_api/apps/projects/migrations/0011_task_status.py +27 -0
  286. trueppm_api/apps/projects/migrations/0012_task_status.py +27 -0
  287. trueppm_api/apps/projects/migrations/0013_task_planned_start.py +24 -0
  288. trueppm_api/apps/projects/migrations/0014_short_hex_ids.py +74 -0
  289. trueppm_api/apps/projects/migrations/0015_backfill_short_ids.py +48 -0
  290. trueppm_api/apps/projects/migrations/0016_task_actual_dates.py +42 -0
  291. trueppm_api/apps/projects/migrations/0017_boardcolumnconfig.py +43 -0
  292. trueppm_api/apps/projects/migrations/0018_estimation_governance.py +62 -0
  293. trueppm_api/apps/projects/migrations/0019_backfill_wbs_paths.py +28 -0
  294. trueppm_api/apps/projects/migrations/0020_task_status_5col.py +65 -0
  295. trueppm_api/apps/projects/migrations/0021_boardsavedview.py +64 -0
  296. trueppm_api/apps/projects/migrations/0022_task_status_changed_at_priority_rank.py +35 -0
  297. trueppm_api/apps/projects/migrations/0023_risk_framework_fields.py +96 -0
  298. trueppm_api/apps/projects/migrations/0024_riskcomment.py +52 -0
  299. trueppm_api/apps/projects/migrations/0025_sprint.py +352 -0
  300. trueppm_api/apps/projects/migrations/0026_project_methodology.py +30 -0
  301. trueppm_api/apps/projects/migrations/0027_sprint_retro.py +89 -0
  302. trueppm_api/apps/projects/migrations/0028_normalize_notes_field.py +42 -0
  303. trueppm_api/apps/projects/migrations/0029_complete_implies_full_progress.py +38 -0
  304. trueppm_api/apps/projects/migrations/0030_review_implies_full_progress.py +37 -0
  305. trueppm_api/apps/projects/migrations/0031_task_remaining_points.py +22 -0
  306. trueppm_api/apps/projects/migrations/0032_task_is_subtask_and_sprint_scope_change.py +90 -0
  307. trueppm_api/apps/projects/migrations/0033_task_my_work_index.py +38 -0
  308. trueppm_api/apps/projects/migrations/0034_inbound_task_sync.py +313 -0
  309. trueppm_api/apps/projects/migrations/0035_retro_versioned_and_suggested_assignee.py +173 -0
  310. trueppm_api/apps/projects/migrations/0036_program_entity_and_membership.py +157 -0
  311. trueppm_api/apps/projects/migrations/0037_sprint_capacity_points.py +20 -0
  312. trueppm_api/apps/projects/migrations/0038_taskcomment_commentreaction_commentacknowledgement_and_more.py +233 -0
  313. trueppm_api/apps/projects/migrations/0039_apitoken_and_more.py +88 -0
  314. trueppm_api/apps/projects/migrations/0040_program_general_fields.py +119 -0
  315. trueppm_api/apps/projects/migrations/0041_ceremony_template_and_phase_gate_config.py +210 -0
  316. trueppm_api/apps/projects/migrations/0041_project_general_fields.py +106 -0
  317. trueppm_api/apps/projects/migrations/0042_merge_20260522_0410.py +12 -0
  318. trueppm_api/apps/projects/migrations/0042_program_rollup_config.py +95 -0
  319. trueppm_api/apps/projects/migrations/0042_workflow_color_and_custom_fields.py +94 -0
  320. trueppm_api/apps/projects/migrations/0043_merge_20260522_1118.py +10 -0
  321. trueppm_api/apps/projects/migrations/0044_merge_20260522_rollup.py +10 -0
  322. trueppm_api/apps/projects/migrations/0044_project_archive_program_close.py +119 -0
  323. trueppm_api/apps/projects/migrations/0045_program_risk_policy.py +78 -0
  324. trueppm_api/apps/projects/migrations/0046_merge_20260523_2248.py +12 -0
  325. trueppm_api/apps/projects/migrations/0047_apitokenauditentry_program_and_more.py +55 -0
  326. trueppm_api/apps/projects/migrations/0048_historicalprogram_color_program_color.py +32 -0
  327. trueppm_api/apps/projects/migrations/0049_backlog_item.py +112 -0
  328. trueppm_api/apps/projects/migrations/0050_backlog_item_trgm_search.py +26 -0
  329. trueppm_api/apps/projects/migrations/0051_alter_calendar_working_days_alter_dependency_lag_and_more.py +144 -0
  330. trueppm_api/apps/projects/migrations/0052_recurring_tasks.py +278 -0
  331. trueppm_api/apps/projects/migrations/0053_dependency_dep_pred_serverver_idx_and_more.py +56 -0
  332. trueppm_api/apps/projects/migrations/0054_sprintscopechange_goal_impact_and_more.py +117 -0
  333. trueppm_api/apps/projects/migrations/0055_historicaltask_sprint_pending_and_more.py +51 -0
  334. trueppm_api/apps/projects/migrations/0056_historicalproject_prioritization_model_and_more.py +276 -0
  335. trueppm_api/apps/projects/migrations/0057_historicalsprint_binding_committed_snapshot_and_more.py +58 -0
  336. trueppm_api/apps/projects/migrations/0058_historicaltask_delivery_mode_and_more.py +72 -0
  337. trueppm_api/apps/projects/migrations/0059_forecastsnapshot.py +80 -0
  338. trueppm_api/apps/projects/migrations/0060_historicalprojectsignalprivacypolicy_and_more.py +90 -0
  339. trueppm_api/apps/projects/migrations/0061_baselinetask_story_points.py +17 -0
  340. trueppm_api/apps/projects/migrations/0062_project_is_sample.py +22 -0
  341. trueppm_api/apps/projects/migrations/0063_historicalsprint_wip_limit_sprint_wip_limit.py +22 -0
  342. trueppm_api/apps/projects/migrations/0064_sprinttaskoutcome.py +97 -0
  343. trueppm_api/apps/projects/migrations/0065_historicalsprint_goal_outcome_sprint_goal_outcome.py +32 -0
  344. trueppm_api/apps/projects/migrations/0066_historicalproject_lead_project_lead.py +38 -0
  345. trueppm_api/apps/projects/migrations/0067_sprint_exclude_from_velocity.py +22 -0
  346. trueppm_api/apps/projects/migrations/0068_project_recalculated_at.py +23 -0
  347. trueppm_api/apps/projects/migrations/0069_iteration_label.py +22 -0
  348. trueppm_api/apps/projects/migrations/0070_historicalprogram_iteration_label_and_more.py +32 -0
  349. trueppm_api/apps/projects/migrations/0071_backfill_iteration_label_inherit.py +35 -0
  350. trueppm_api/apps/projects/migrations/0072_pulseresponse_retroboarditem.py +129 -0
  351. trueppm_api/apps/projects/migrations/0073_sprinttaskoutcome_demo_ready.py +17 -0
  352. trueppm_api/apps/projects/migrations/0074_historicaltask_blocked_reason_task_blocked_reason.py +30 -0
  353. trueppm_api/apps/projects/migrations/0075_risk_decimal_short_id.py +42 -0
  354. trueppm_api/apps/projects/migrations/0076_sprinttaskoutcome_review_polish.py +45 -0
  355. trueppm_api/apps/projects/migrations/0077_task_blocker_fields.py +111 -0
  356. trueppm_api/apps/projects/migrations/0078_alter_risktask_unique_together_and_more.py +22 -0
  357. trueppm_api/apps/projects/migrations/0079_historicalproject_status_date_project_status_date.py +22 -0
  358. trueppm_api/apps/projects/migrations/0080_alter_historicaltask_type_alter_task_type.py +46 -0
  359. trueppm_api/apps/projects/migrations/0081_historicalprogram_allow_guests_and_more.py +52 -0
  360. trueppm_api/apps/projects/migrations/0082_project_last_sync_version.py +90 -0
  361. trueppm_api/apps/projects/migrations/0083_historicalprogram_mc_history_attribution_audience_and_more.py +108 -0
  362. trueppm_api/apps/projects/migrations/0084_tasknote.py +71 -0
  363. trueppm_api/apps/projects/migrations/0085_sprint_ix_sprint_velocity.py +33 -0
  364. trueppm_api/apps/projects/migrations/0086_board_card_search_trgm.py +33 -0
  365. trueppm_api/apps/projects/migrations/0087_historicalprogram_task_duration_change_percent_policy_and_more.py +155 -0
  366. trueppm_api/apps/projects/migrations/0088_historicalprogram_allowed_attachment_types_and_more.py +61 -0
  367. trueppm_api/apps/projects/migrations/0089_signalceilingraiseproposal_signalceilingraisevote_and_more.py +157 -0
  368. trueppm_api/apps/projects/migrations/0090_historicaltask_proj_histdate_index.py +44 -0
  369. trueppm_api/apps/projects/migrations/0091_project_board_cadence.py +39 -0
  370. trueppm_api/apps/projects/migrations/0092_program_target_date.py +22 -0
  371. trueppm_api/apps/projects/migrations/0093_cross_project_dependency_consent.py +58 -0
  372. trueppm_api/apps/projects/migrations/0094_project_decisions_policy.py +90 -0
  373. trueppm_api/apps/projects/migrations/0095_poker_session_vote.py +127 -0
  374. trueppm_api/apps/projects/migrations/0095_squashed_0097_release_0_3.py +225 -0
  375. trueppm_api/apps/projects/migrations/0096_crossprojectslipconflict.py +91 -0
  376. trueppm_api/apps/projects/migrations/0097_backlogitem_backlogitem_tags_gin_and_more.py +32 -0
  377. trueppm_api/apps/projects/migrations/0098_historicalproject_show_baselines_and_more.py +52 -0
  378. trueppm_api/apps/projects/migrations/0099_apitoken_scopes.py +48 -0
  379. trueppm_api/apps/projects/migrations/0100_task_dep_serverver_idx_concurrent.py +61 -0
  380. trueppm_api/apps/projects/migrations/0101_dependency_deleted_at_task_deleted_at.py +22 -0
  381. trueppm_api/apps/projects/migrations/0102_project_deleted_at_project_proj_isdel_deletedat_idx.py +25 -0
  382. trueppm_api/apps/projects/migrations/0103_taskdurationchangeevent_task_dur_evt_sprint_idx.py +18 -0
  383. trueppm_api/apps/projects/migrations/0104_historicalproject_stale_task_threshold_days_and_more.py +32 -0
  384. trueppm_api/apps/projects/migrations/0104_trash_restore_1113.py +38 -0
  385. trueppm_api/apps/projects/migrations/0105_historical_changelog_indexes.py +62 -0
  386. trueppm_api/apps/projects/migrations/0106_boardsavedview_schema_version.py +20 -0
  387. trueppm_api/apps/projects/migrations/0107_task_activity_event.py +70 -0
  388. trueppm_api/apps/projects/migrations/0108_remove_apitoken_api_token_scope_xor_and_more.py +117 -0
  389. trueppm_api/apps/projects/migrations/0109_projectexportjob.py +82 -0
  390. trueppm_api/apps/projects/migrations/0110_sharelink.py +123 -0
  391. trueppm_api/apps/projects/migrations/0111_projectcalendarlayer.py +67 -0
  392. trueppm_api/apps/projects/migrations/0112_sharelink_expires_at_alter_sharelink_content_kind.py +31 -0
  393. trueppm_api/apps/projects/migrations/0113_alter_historicaltask_percent_complete_and_more.py +35 -0
  394. trueppm_api/apps/projects/migrations/0114_historicalproject_default_member_role_and_more.py +28 -0
  395. trueppm_api/apps/projects/migrations/0115_historicalproject_end_date_shift_threshold_days_and_more.py +22 -0
  396. trueppm_api/apps/projects/migrations/0116_alter_taskactivityevent_event_type.py +28 -0
  397. trueppm_api/apps/projects/migrations/0117_label_tasklabel_label_tasks_and_more.py +126 -0
  398. trueppm_api/apps/projects/migrations/0118_programexportjob.py +82 -0
  399. trueppm_api/apps/projects/migrations/0119_historicalprogram_calendar_program_calendar.py +36 -0
  400. trueppm_api/apps/projects/migrations/0120_alter_backlogitem_item_type.py +29 -0
  401. trueppm_api/apps/projects/migrations/0121_task_three_point_estimate_ordered.py +64 -0
  402. trueppm_api/apps/projects/migrations/0122_task_relation.py +173 -0
  403. trueppm_api/apps/projects/migrations/0123_remove_historicalproject_agile_features_and_more.py +20 -0
  404. trueppm_api/apps/projects/migrations/0124_dependency_is_driving.py +17 -0
  405. trueppm_api/apps/projects/migrations/0125_historicalprogram_estimation_scale_and_more.py +68 -0
  406. trueppm_api/apps/projects/migrations/0126_projectcustomfield_show_on_card_taskcustomfieldvalue.py +80 -0
  407. trueppm_api/apps/projects/migrations/0127_historicalprogram_mcp_enabled_and_more.py +32 -0
  408. trueppm_api/apps/projects/migrations/0128_acceptancecriterion_sync_seq_apitoken_sync_seq_and_more.py +192 -0
  409. trueppm_api/apps/projects/migrations/0129_sharelink_show_milestone_dates.py +20 -0
  410. trueppm_api/apps/projects/migrations/0130_programimportjob.py +85 -0
  411. trueppm_api/apps/projects/migrations/0131_historicalprogram_sprint_picker_ready_only_default_and_more.py +32 -0
  412. trueppm_api/apps/projects/migrations/0132_task_scheduled_start.py +17 -0
  413. trueppm_api/apps/projects/migrations/0133_project_status_date_floor_armed_at.py +17 -0
  414. trueppm_api/apps/projects/migrations/0134_task_edited_at_task_seeded_at_task_source_id_and_more.py +65 -0
  415. trueppm_api/apps/projects/migrations/0135_projecttemplate_templateapplication_and_more.py +175 -0
  416. trueppm_api/apps/projects/migrations/0136_schedule_outline_batch_operations.py +118 -0
  417. trueppm_api/apps/projects/migrations/0137_collapse_dual_scope_api_tokens.py +54 -0
  418. trueppm_api/apps/projects/migrations/0138_apitokenauditentry_api_token_audit_owner_idx.py +18 -0
  419. trueppm_api/apps/projects/migrations/0139_historicaltask_duration_unit_task_duration_unit.py +32 -0
  420. trueppm_api/apps/projects/migrations/0140_historicaltask_auto_container_and_more.py +113 -0
  421. trueppm_api/apps/projects/migrations/0141_historicalproject_draft_started_at_and_more.py +44 -0
  422. trueppm_api/apps/projects/migrations/0142_baseline_calendar_hours_per_day_and_more.py +31 -0
  423. trueppm_api/apps/projects/migrations/0143_sprintcloserequest_failure_reason_and_more.py +42 -0
  424. trueppm_api/apps/projects/migrations/0144_projecttemplate_source_project_and_more.py +35 -0
  425. trueppm_api/apps/projects/migrations/0145_seed_bundled_templates.py +65 -0
  426. trueppm_api/apps/projects/migrations/0146_historicaltask_board_lane_task_board_lane.py +32 -0
  427. trueppm_api/apps/projects/migrations/0147_structuraloperation.py +128 -0
  428. trueppm_api/apps/projects/migrations/0148_task_unique_task_wbs_path_per_project_live.py +76 -0
  429. trueppm_api/apps/projects/migrations/0149_drop_workshops_tables.py +42 -0
  430. trueppm_api/apps/projects/migrations/0150_clear_uncommitted_cpm_output.py +130 -0
  431. trueppm_api/apps/projects/migrations/0151_config_notice_request.py +70 -0
  432. trueppm_api/apps/projects/migrations/0152_aggregate_task_wbs_name_idx.py +20 -0
  433. trueppm_api/apps/projects/migrations/0153_program_sample_anchor_date.py +22 -0
  434. trueppm_api/apps/projects/migrations/__init__.py +0 -0
  435. trueppm_api/apps/projects/models.py +8946 -0
  436. trueppm_api/apps/projects/poker_services.py +154 -0
  437. trueppm_api/apps/projects/poker_views.py +398 -0
  438. trueppm_api/apps/projects/product_backlog_services.py +450 -0
  439. trueppm_api/apps/projects/program_label_services.py +94 -0
  440. trueppm_api/apps/projects/program_label_views.py +189 -0
  441. trueppm_api/apps/projects/program_rollup.py +575 -0
  442. trueppm_api/apps/projects/program_schedule.py +745 -0
  443. trueppm_api/apps/projects/program_views.py +3220 -0
  444. trueppm_api/apps/projects/project_templates.py +422 -0
  445. trueppm_api/apps/projects/receivers.py +234 -0
  446. trueppm_api/apps/projects/refusal_codes.py +140 -0
  447. trueppm_api/apps/projects/reorder_services.py +145 -0
  448. trueppm_api/apps/projects/restructure_hooks.py +54 -0
  449. trueppm_api/apps/projects/retro_board_services.py +368 -0
  450. trueppm_api/apps/projects/retro_services.py +285 -0
  451. trueppm_api/apps/projects/risk_import.py +396 -0
  452. trueppm_api/apps/projects/row_identity.py +113 -0
  453. trueppm_api/apps/projects/schema_migrations.py +228 -0
  454. trueppm_api/apps/projects/schemas/seed_v1.json +493 -0
  455. trueppm_api/apps/projects/schemas/seed_v2.json +892 -0
  456. trueppm_api/apps/projects/seed/__init__.py +61 -0
  457. trueppm_api/apps/projects/seed/exporter.py +1644 -0
  458. trueppm_api/apps/projects/seed/forecast_backfill.py +247 -0
  459. trueppm_api/apps/projects/seed/importer.py +2390 -0
  460. trueppm_api/apps/projects/seed/reanchor.py +551 -0
  461. trueppm_api/apps/projects/seed/reldates.py +126 -0
  462. trueppm_api/apps/projects/seed/replace.py +126 -0
  463. trueppm_api/apps/projects/seed/replay.py +1691 -0
  464. trueppm_api/apps/projects/seed/replay_ctx.py +41 -0
  465. trueppm_api/apps/projects/seed/samples.py +427 -0
  466. trueppm_api/apps/projects/seed/validation.py +1149 -0
  467. trueppm_api/apps/projects/serializers.py +12310 -0
  468. trueppm_api/apps/projects/services.py +6966 -0
  469. trueppm_api/apps/projects/share_serializers.py +132 -0
  470. trueppm_api/apps/projects/share_services.py +325 -0
  471. trueppm_api/apps/projects/share_views.py +374 -0
  472. trueppm_api/apps/projects/sharing_settings.py +187 -0
  473. trueppm_api/apps/projects/signal_privacy_services.py +909 -0
  474. trueppm_api/apps/projects/signal_privacy_views.py +476 -0
  475. trueppm_api/apps/projects/signals.py +132 -0
  476. trueppm_api/apps/projects/slip_conflict.py +266 -0
  477. trueppm_api/apps/projects/sprint_cadence.py +453 -0
  478. trueppm_api/apps/projects/sprint_picker_settings.py +132 -0
  479. trueppm_api/apps/projects/standup.py +304 -0
  480. trueppm_api/apps/projects/standup_views.py +99 -0
  481. trueppm_api/apps/projects/structural_operation_services.py +727 -0
  482. trueppm_api/apps/projects/structural_operation_views.py +311 -0
  483. trueppm_api/apps/projects/surface_visibility.py +126 -0
  484. trueppm_api/apps/projects/task_batch_services.py +379 -0
  485. trueppm_api/apps/projects/task_bulk.py +1152 -0
  486. trueppm_api/apps/projects/task_classification.py +561 -0
  487. trueppm_api/apps/projects/task_classification_defaults.py +95 -0
  488. trueppm_api/apps/projects/task_duration_settings.py +142 -0
  489. trueppm_api/apps/projects/task_grouping.py +754 -0
  490. trueppm_api/apps/projects/tasks.py +1917 -0
  491. trueppm_api/apps/projects/template_divergence.py +168 -0
  492. trueppm_api/apps/projects/template_services.py +160 -0
  493. trueppm_api/apps/projects/template_tasks.py +258 -0
  494. trueppm_api/apps/projects/template_views.py +799 -0
  495. trueppm_api/apps/projects/throttles.py +311 -0
  496. trueppm_api/apps/projects/urls.py +1011 -0
  497. trueppm_api/apps/projects/utilization.py +885 -0
  498. trueppm_api/apps/projects/views.py +20572 -0
  499. trueppm_api/apps/projects/wbs_paths.py +119 -0
  500. trueppm_api/apps/resources/__init__.py +0 -0
  501. trueppm_api/apps/resources/apps.py +8 -0
  502. trueppm_api/apps/resources/capacity.py +121 -0
  503. trueppm_api/apps/resources/migrations/0001_initial.py +68 -0
  504. trueppm_api/apps/resources/migrations/0001_squashed_0013_alter_projectresource_unique_together_and_more.py +281 -0
  505. trueppm_api/apps/resources/migrations/0002_alter_uuid_pk_serialize_false.py +36 -0
  506. trueppm_api/apps/resources/migrations/0003_resource_soft_delete.py +30 -0
  507. trueppm_api/apps/resources/migrations/0004_add_taskresource_resource_index.py +25 -0
  508. trueppm_api/apps/resources/migrations/0005_resource_job_role.py +20 -0
  509. trueppm_api/apps/resources/migrations/0006_skill.py +34 -0
  510. trueppm_api/apps/resources/migrations/0007_resource_skill.py +63 -0
  511. trueppm_api/apps/resources/migrations/0008_project_resource.py +63 -0
  512. trueppm_api/apps/resources/migrations/0009_task_skill_requirement.py +60 -0
  513. trueppm_api/apps/resources/migrations/0010_alter_resourceskill_options_and_more.py +20 -0
  514. trueppm_api/apps/resources/migrations/0011_alter_projectresource_notes.py +17 -0
  515. trueppm_api/apps/resources/migrations/0012_add_resource_user_fk.py +26 -0
  516. trueppm_api/apps/resources/migrations/0013_alter_projectresource_unique_together_and_more.py +53 -0
  517. trueppm_api/apps/resources/migrations/0014_projectresource_sync_seq_resource_sync_seq_and_more.py +37 -0
  518. trueppm_api/apps/resources/migrations/0015_projectresource_deactivated_with_resource.py +17 -0
  519. trueppm_api/apps/resources/migrations/__init__.py +0 -0
  520. trueppm_api/apps/resources/models.py +298 -0
  521. trueppm_api/apps/resources/serializers.py +426 -0
  522. trueppm_api/apps/resources/services.py +465 -0
  523. trueppm_api/apps/resources/urls.py +28 -0
  524. trueppm_api/apps/resources/views.py +1749 -0
  525. trueppm_api/apps/scheduling/__init__.py +0 -0
  526. trueppm_api/apps/scheduling/apps.py +153 -0
  527. trueppm_api/apps/scheduling/calendars.py +119 -0
  528. trueppm_api/apps/scheduling/deadletter.py +91 -0
  529. trueppm_api/apps/scheduling/forecast_history_settings.py +215 -0
  530. trueppm_api/apps/scheduling/forecast_staleness.py +313 -0
  531. trueppm_api/apps/scheduling/graph_guard.py +263 -0
  532. trueppm_api/apps/scheduling/management/__init__.py +0 -0
  533. trueppm_api/apps/scheduling/management/commands/__init__.py +0 -0
  534. trueppm_api/apps/scheduling/management/commands/prune_forecast_snapshots.py +53 -0
  535. trueppm_api/apps/scheduling/migrations/0001_failed_task.py +62 -0
  536. trueppm_api/apps/scheduling/migrations/0001_squashed_0007_projectforecastsnapshot.py +309 -0
  537. trueppm_api/apps/scheduling/migrations/0002_schedulerequest.py +78 -0
  538. trueppm_api/apps/scheduling/migrations/0003_add_schedule_request_reason.py +27 -0
  539. trueppm_api/apps/scheduling/migrations/0004_velocity_suggestion.py +94 -0
  540. trueppm_api/apps/scheduling/migrations/0005_montecarlorun.py +61 -0
  541. trueppm_api/apps/scheduling/migrations/0006_montecarlorun_distribution.py +17 -0
  542. trueppm_api/apps/scheduling/migrations/0007_projectforecastsnapshot.py +65 -0
  543. trueppm_api/apps/scheduling/migrations/0008_alter_schedulerequest_reason.py +28 -0
  544. trueppm_api/apps/scheduling/migrations/0008_folded_schedulerequest_reason.py +34 -0
  545. trueppm_api/apps/scheduling/migrations/0009_alter_schedulerequest_reason.py +29 -0
  546. trueppm_api/apps/scheduling/migrations/0010_failedtask_resolution_note_failedtask_resolved_at_and_more.py +43 -0
  547. trueppm_api/apps/scheduling/migrations/0011_failedtask_project.py +26 -0
  548. trueppm_api/apps/scheduling/migrations/0012_montecarlorun_diagnostic.py +17 -0
  549. trueppm_api/apps/scheduling/migrations/0013_montecarlorun_status_date.py +17 -0
  550. trueppm_api/apps/scheduling/migrations/0014_montecarlorun_plan_version.py +17 -0
  551. trueppm_api/apps/scheduling/migrations/__init__.py +0 -0
  552. trueppm_api/apps/scheduling/models.py +516 -0
  553. trueppm_api/apps/scheduling/receivers.py +160 -0
  554. trueppm_api/apps/scheduling/risk_premium.py +283 -0
  555. trueppm_api/apps/scheduling/serializers.py +564 -0
  556. trueppm_api/apps/scheduling/services.py +1182 -0
  557. trueppm_api/apps/scheduling/signals.py +56 -0
  558. trueppm_api/apps/scheduling/tasks.py +1984 -0
  559. trueppm_api/apps/scheduling/telemetry.py +80 -0
  560. trueppm_api/apps/scheduling/units.py +35 -0
  561. trueppm_api/apps/scheduling/urls.py +57 -0
  562. trueppm_api/apps/scheduling/views.py +2564 -0
  563. trueppm_api/apps/sso/__init__.py +0 -0
  564. trueppm_api/apps/sso/apps.py +19 -0
  565. trueppm_api/apps/sso/extensions.py +130 -0
  566. trueppm_api/apps/sso/management/__init__.py +0 -0
  567. trueppm_api/apps/sso/management/commands/__init__.py +0 -0
  568. trueppm_api/apps/sso/management/commands/seed_sso_keycloak.py +172 -0
  569. trueppm_api/apps/sso/migrations/0001_initial.py +119 -0
  570. trueppm_api/apps/sso/migrations/0002_remove_oidcprovider_workspace_ssoproviderpolicy_and_more.py +169 -0
  571. trueppm_api/apps/sso/migrations/__init__.py +0 -0
  572. trueppm_api/apps/sso/models.py +148 -0
  573. trueppm_api/apps/sso/serializers.py +437 -0
  574. trueppm_api/apps/sso/services.py +1385 -0
  575. trueppm_api/apps/sso/urls.py +47 -0
  576. trueppm_api/apps/sso/views.py +935 -0
  577. trueppm_api/apps/sync/__init__.py +0 -0
  578. trueppm_api/apps/sync/apps.py +15 -0
  579. trueppm_api/apps/sync/backfill.py +208 -0
  580. trueppm_api/apps/sync/broadcast.py +320 -0
  581. trueppm_api/apps/sync/conflict.py +262 -0
  582. trueppm_api/apps/sync/consumers.py +471 -0
  583. trueppm_api/apps/sync/migrations/0001_initial.py +59 -0
  584. trueppm_api/apps/sync/migrations/0001_squashed_0002_remove_syncbatch_syncbatch_project_client_batch_uniq_and_more.py +77 -0
  585. trueppm_api/apps/sync/migrations/0002_remove_syncbatch_syncbatch_project_client_batch_uniq_and_more.py +41 -0
  586. trueppm_api/apps/sync/migrations/0003_boardevent.py +46 -0
  587. trueppm_api/apps/sync/migrations/0004_seed_sync_seq.py +24 -0
  588. trueppm_api/apps/sync/migrations/0005_program_sync_sequence.py +35 -0
  589. trueppm_api/apps/sync/migrations/__init__.py +0 -0
  590. trueppm_api/apps/sync/models.py +225 -0
  591. trueppm_api/apps/sync/pagination.py +231 -0
  592. trueppm_api/apps/sync/sequence.py +371 -0
  593. trueppm_api/apps/sync/serializers.py +687 -0
  594. trueppm_api/apps/sync/tasks.py +260 -0
  595. trueppm_api/apps/sync/throttles.py +175 -0
  596. trueppm_api/apps/sync/upload.py +501 -0
  597. trueppm_api/apps/sync/urls.py +17 -0
  598. trueppm_api/apps/sync/views.py +930 -0
  599. trueppm_api/apps/sync/ws_auth.py +193 -0
  600. trueppm_api/apps/taskruns/__init__.py +0 -0
  601. trueppm_api/apps/taskruns/apps.py +11 -0
  602. trueppm_api/apps/taskruns/migrations/0001_initial.py +92 -0
  603. trueppm_api/apps/taskruns/migrations/__init__.py +0 -0
  604. trueppm_api/apps/taskruns/models.py +68 -0
  605. trueppm_api/apps/taskruns/serializers.py +92 -0
  606. trueppm_api/apps/taskruns/tasks.py +60 -0
  607. trueppm_api/apps/taskruns/tracker.py +286 -0
  608. trueppm_api/apps/taskruns/urls.py +46 -0
  609. trueppm_api/apps/taskruns/views.py +195 -0
  610. trueppm_api/apps/teams/__init__.py +8 -0
  611. trueppm_api/apps/teams/apps.py +16 -0
  612. trueppm_api/apps/teams/migrations/0001_initial.py +139 -0
  613. trueppm_api/apps/teams/migrations/0001_squashed_0002_default_teams.py +142 -0
  614. trueppm_api/apps/teams/migrations/0002_default_teams.py +62 -0
  615. trueppm_api/apps/teams/migrations/0003_team_sync_seq_teammembership_sync_seq.py +22 -0
  616. trueppm_api/apps/teams/migrations/__init__.py +0 -0
  617. trueppm_api/apps/teams/models.py +145 -0
  618. trueppm_api/apps/teams/permissions.py +149 -0
  619. trueppm_api/apps/teams/serializers.py +95 -0
  620. trueppm_api/apps/teams/services.py +434 -0
  621. trueppm_api/apps/teams/signals.py +61 -0
  622. trueppm_api/apps/teams/urls.py +34 -0
  623. trueppm_api/apps/teams/views.py +201 -0
  624. trueppm_api/apps/timetracking/__init__.py +0 -0
  625. trueppm_api/apps/timetracking/apps.py +9 -0
  626. trueppm_api/apps/timetracking/migrations/0001_initial.py +117 -0
  627. trueppm_api/apps/timetracking/migrations/0002_timesheetsubmission.py +46 -0
  628. trueppm_api/apps/timetracking/migrations/0003_timeentry_deleted_at_timeentry_deleted_by.py +31 -0
  629. trueppm_api/apps/timetracking/migrations/0004_timeentry_sync_seq_and_more.py +24 -0
  630. trueppm_api/apps/timetracking/migrations/__init__.py +0 -0
  631. trueppm_api/apps/timetracking/models.py +178 -0
  632. trueppm_api/apps/timetracking/serializers.py +175 -0
  633. trueppm_api/apps/timetracking/services.py +117 -0
  634. trueppm_api/apps/timetracking/urls.py +47 -0
  635. trueppm_api/apps/timetracking/views.py +526 -0
  636. trueppm_api/apps/webhooks/__init__.py +0 -0
  637. trueppm_api/apps/webhooks/apps.py +8 -0
  638. trueppm_api/apps/webhooks/backfill.py +90 -0
  639. trueppm_api/apps/webhooks/dispatch.py +144 -0
  640. trueppm_api/apps/webhooks/migrations/0001_initial.py +146 -0
  641. trueppm_api/apps/webhooks/migrations/0001_squashed_0007_sprint_lifecycle_events.py +243 -0
  642. trueppm_api/apps/webhooks/migrations/0002_alter_webhook_events.py +32 -0
  643. trueppm_api/apps/webhooks/migrations/0003_delivery_status_created_idx.py +17 -0
  644. trueppm_api/apps/webhooks/migrations/0004_webhook_program_alter_webhook_project_and_more.py +64 -0
  645. trueppm_api/apps/webhooks/migrations/0005_webhook_delivery_sequence_numbers.py +30 -0
  646. trueppm_api/apps/webhooks/migrations/0006_webhook_format_alter_webhook_events_and_more.py +61 -0
  647. trueppm_api/apps/webhooks/migrations/0007_sprint_lifecycle_events.py +63 -0
  648. trueppm_api/apps/webhooks/migrations/0008_risk_baseline_comment_events.py +73 -0
  649. trueppm_api/apps/webhooks/migrations/0009_encrypt_webhook_secret_and_failure_counters.py +90 -0
  650. trueppm_api/apps/webhooks/migrations/__init__.py +0 -0
  651. trueppm_api/apps/webhooks/models.py +372 -0
  652. trueppm_api/apps/webhooks/serializers.py +318 -0
  653. trueppm_api/apps/webhooks/tasks.py +663 -0
  654. trueppm_api/apps/webhooks/urls.py +22 -0
  655. trueppm_api/apps/webhooks/views.py +383 -0
  656. trueppm_api/apps/workflow_engine/__init__.py +0 -0
  657. trueppm_api/apps/workflow_engine/apps.py +23 -0
  658. trueppm_api/apps/workflow_engine/migrations/0001_initial.py +230 -0
  659. trueppm_api/apps/workflow_engine/migrations/0001_squashed_0002_remove_workflowhistoryevent_workflow_history_lookup_idx.py +234 -0
  660. trueppm_api/apps/workflow_engine/migrations/0002_remove_workflowhistoryevent_workflow_history_lookup_idx.py +16 -0
  661. trueppm_api/apps/workflow_engine/migrations/0003_workflowoutboxrow_workflow_outbox_recovery_idx.py +21 -0
  662. trueppm_api/apps/workflow_engine/migrations/__init__.py +0 -0
  663. trueppm_api/apps/workflow_engine/models.py +265 -0
  664. trueppm_api/apps/workflow_engine/tasks.py +368 -0
  665. trueppm_api/apps/workspace/__init__.py +0 -0
  666. trueppm_api/apps/workspace/apps.py +10 -0
  667. trueppm_api/apps/workspace/backfill.py +111 -0
  668. trueppm_api/apps/workspace/export.py +242 -0
  669. trueppm_api/apps/workspace/migrations/0001_initial.py +326 -0
  670. trueppm_api/apps/workspace/migrations/0001_squashed_0014_workspacemembership_availability_effective_from_and_more.py +829 -0
  671. trueppm_api/apps/workspace/migrations/0002_remove_workspace_fiscal_year_start_and_more.py +85 -0
  672. trueppm_api/apps/workspace/migrations/0003_workspaceexportjob.py +73 -0
  673. trueppm_api/apps/workspace/migrations/0004_alter_workspaceinvite_status.py +27 -0
  674. trueppm_api/apps/workspace/migrations/0005_workspace_iteration_label_and_more.py +26 -0
  675. trueppm_api/apps/workspace/migrations/0006_alter_groupmembership_unique_together_and_more.py +45 -0
  676. trueppm_api/apps/workspace/migrations/0007_workspace_public_sharing_override_policy.py +21 -0
  677. trueppm_api/apps/workspace/migrations/0008_workspace_mc_history_attribution_audience_and_more.py +44 -0
  678. trueppm_api/apps/workspace/migrations/0009_workspace_methodology_and_more.py +186 -0
  679. trueppm_api/apps/workspace/migrations/0010_workspace_logo.py +38 -0
  680. trueppm_api/apps/workspace/migrations/0011_historicalworkspace_task_duration_change_percent_override_policy_and_more.py +56 -0
  681. trueppm_api/apps/workspace/migrations/0012_historicalworkspace_allowed_attachment_types_and_more.py +64 -0
  682. trueppm_api/apps/workspace/migrations/0013_auditevent.py +70 -0
  683. trueppm_api/apps/workspace/migrations/0014_workspacemembership_availability_effective_from_and_more.py +39 -0
  684. trueppm_api/apps/workspace/migrations/0015_trash_restore_1113.py +34 -0
  685. trueppm_api/apps/workspace/migrations/0016_historicalworkspace_calendar_and_more.py +55 -0
  686. trueppm_api/apps/workspace/migrations/0017_historicalworkspace_estimation_scale_and_more.py +38 -0
  687. trueppm_api/apps/workspace/migrations/0018_historicalworkspace_feedback_enabled_and_more.py +32 -0
  688. trueppm_api/apps/workspace/migrations/0019_historicalworkspace_mcp_enabled_and_more.py +22 -0
  689. trueppm_api/apps/workspace/migrations/0020_viewer_ordinal_one.py +34 -0
  690. trueppm_api/apps/workspace/migrations/0021_group_sync_seq_groupmembership_sync_seq_and_more.py +27 -0
  691. trueppm_api/apps/workspace/migrations/0022_historicalworkspace_sprint_picker_ready_only_default_and_more.py +22 -0
  692. trueppm_api/apps/workspace/migrations/0023_alter_auditevent_event_type.py +32 -0
  693. trueppm_api/apps/workspace/migrations/0024_alter_auditevent_event_type.py +33 -0
  694. trueppm_api/apps/workspace/migrations/0025_alter_auditevent_event_type.py +36 -0
  695. trueppm_api/apps/workspace/migrations/0026_alter_auditevent_event_type.py +37 -0
  696. trueppm_api/apps/workspace/migrations/0027_alter_auditevent_event_type.py +42 -0
  697. trueppm_api/apps/workspace/migrations/__init__.py +0 -0
  698. trueppm_api/apps/workspace/models.py +857 -0
  699. trueppm_api/apps/workspace/permissions.py +187 -0
  700. trueppm_api/apps/workspace/serializers.py +590 -0
  701. trueppm_api/apps/workspace/services.py +919 -0
  702. trueppm_api/apps/workspace/signals.py +37 -0
  703. trueppm_api/apps/workspace/tasks.py +555 -0
  704. trueppm_api/apps/workspace/urls.py +113 -0
  705. trueppm_api/apps/workspace/views.py +1502 -0
  706. trueppm_api/asgi.py +42 -0
  707. trueppm_api/celery.py +31 -0
  708. trueppm_api/core/__init__.py +0 -0
  709. trueppm_api/core/admin_site.py +206 -0
  710. trueppm_api/core/auth_views.py +916 -0
  711. trueppm_api/core/constant_time.py +51 -0
  712. trueppm_api/core/csp.py +54 -0
  713. trueppm_api/core/db.py +87 -0
  714. trueppm_api/core/db_session.py +37 -0
  715. trueppm_api/core/exception_handlers.py +157 -0
  716. trueppm_api/core/export_downloads.py +56 -0
  717. trueppm_api/core/extension_providers.py +56 -0
  718. trueppm_api/core/extension_signals.py +147 -0
  719. trueppm_api/core/idempotent.py +260 -0
  720. trueppm_api/core/metadata.py +42 -0
  721. trueppm_api/core/middleware.py +51 -0
  722. trueppm_api/core/openapi.py +949 -0
  723. trueppm_api/core/password_reset.py +500 -0
  724. trueppm_api/core/protect_conflict.py +100 -0
  725. trueppm_api/core/ratelimit.py +148 -0
  726. trueppm_api/core/redis_throttle.py +82 -0
  727. trueppm_api/core/refresh_cookie_policy.py +156 -0
  728. trueppm_api/core/request_body.py +86 -0
  729. trueppm_api/core/security_checks.py +884 -0
  730. trueppm_api/core/storage_config.py +105 -0
  731. trueppm_api/core/text_decode.py +168 -0
  732. trueppm_api/core/throttling.py +344 -0
  733. trueppm_api/core/valkey.py +214 -0
  734. trueppm_api/core/valkey_cache.py +66 -0
  735. trueppm_api/core/valkey_checks.py +104 -0
  736. trueppm_api/core/valkey_config.py +39 -0
  737. trueppm_api/core/worker_broker_wait.py +149 -0
  738. trueppm_api/core/worker_heartbeat.py +134 -0
  739. trueppm_api/fields.py +36 -0
  740. trueppm_api/permissions.py +30 -0
  741. trueppm_api/py.typed +0 -0
  742. trueppm_api/routing.py +11 -0
  743. trueppm_api/settings/__init__.py +0 -0
  744. trueppm_api/settings/base.py +2455 -0
  745. trueppm_api/settings/dev.py +273 -0
  746. trueppm_api/settings/prod.py +228 -0
  747. trueppm_api/urls.py +153 -0
  748. trueppm_api/workflows/__init__.py +38 -0
  749. trueppm_api/workflows/backends/__init__.py +6 -0
  750. trueppm_api/workflows/backends/default.py +297 -0
  751. trueppm_api/workflows/consumers/__init__.py +11 -0
  752. trueppm_api/workflows/consumers/requeue_failed_task.py +65 -0
  753. trueppm_api/workflows/interface.py +148 -0
  754. trueppm_api/workflows/registry.py +106 -0
  755. trueppm_api/workflows/services.py +90 -0
  756. trueppm_api/wsgi.py +11 -0
  757. trueppm_api-0.4.0b2.dist-info/METADATA +70 -0
  758. trueppm_api-0.4.0b2.dist-info/RECORD +759 -0
  759. 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}