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,919 @@
1
+ """Service-layer helpers for the workspace app (ADR-0087).
2
+
3
+ Three multi-row transactions live here:
4
+
5
+ - :func:`reconcile_group_access` — the Group→project access **cascade**. It
6
+ materializes, updates, and removes ``ProjectMembership`` rows so that every
7
+ (group member × linked project) pair has the project ``Role`` the group
8
+ confers. Reconciliation is idempotent and recomputed from scratch per affected
9
+ pair, so it is safe to call after any group/member/link/role change.
10
+
11
+ - :func:`accept_invite` — atomically provisions (or links) a user account and
12
+ creates the ``WorkspaceMembership`` from a token-bearing invite.
13
+
14
+ - :func:`create_invite` — issues a pending invite with a one-time token.
15
+
16
+ The owner-counting helpers back the last-owner guard: a workspace must never be
17
+ left without at least one active owner (explicit OWNER membership or an active
18
+ Django superuser).
19
+ """
20
+
21
+ from __future__ import annotations
22
+
23
+ import hashlib
24
+ import logging
25
+ import secrets
26
+ import uuid
27
+ from typing import Any
28
+
29
+ from django.contrib.auth import get_user_model
30
+ from django.contrib.auth.password_validation import validate_password
31
+
32
+ # ``ValidationError`` here is Django's (used for the ownership-transfer guards and
33
+ # the password-policy check) — distinct from DRF's ValidationError raised in views.
34
+ from django.core.exceptions import ValidationError
35
+ from django.db import IntegrityError, transaction
36
+ from django.utils import timezone
37
+
38
+ from trueppm_api.apps.access.models import ProjectMembership
39
+ from trueppm_api.apps.workspace.models import (
40
+ AuditEvent,
41
+ AuditEventType,
42
+ ExportJobStatus,
43
+ GroupMembership,
44
+ GroupProject,
45
+ InviteStatus,
46
+ MemberStatus,
47
+ Workspace,
48
+ WorkspaceExportJob,
49
+ WorkspaceInvite,
50
+ WorkspaceMembership,
51
+ WorkspaceRole,
52
+ )
53
+ from trueppm_api.apps.workspace.signals import audit_event_created
54
+ from trueppm_api.core.extension_signals import dispatch_extension_signal
55
+
56
+ logger = logging.getLogger(__name__)
57
+
58
+ _PK = uuid.UUID | str
59
+
60
+
61
+ class InviteError(Exception):
62
+ """Raised when an invite cannot be accepted (invalid/expired token, etc.).
63
+
64
+ The message is deliberately generic for token failures to avoid leaking
65
+ whether a given token exists (enumeration).
66
+ """
67
+
68
+
69
+ # Deliberately generic so an invalid/expired/consumed token never reveals whether
70
+ # a given token exists (enumeration). Shared by every failure path in the accept
71
+ # flow so the three sites cannot drift apart (S1192).
72
+ _INVALID_INVITE_MESSAGE = "This invitation link is invalid or has expired."
73
+
74
+
75
+ # ---------------------------------------------------------------------------
76
+ # Owner counting / last-owner guard
77
+ # ---------------------------------------------------------------------------
78
+
79
+
80
+ def workspace_owner_user_ids(exclude_user_id: _PK | None = None) -> set[Any]:
81
+ """Return the set of user ids that currently hold workspace-owner authority.
82
+
83
+ An owner is an active explicit OWNER ``WorkspaceMembership`` **or** an active
84
+ Django superuser with no explicit (overriding) membership row. ``exclude_user_id``
85
+ drops a candidate so callers can ask "who would remain if I changed this user?".
86
+ """
87
+ User = get_user_model()
88
+ owners: set[Any] = set(
89
+ WorkspaceMembership.objects.filter(
90
+ role=WorkspaceRole.OWNER,
91
+ status=MemberStatus.ACTIVE,
92
+ is_deleted=False,
93
+ ).values_list("user_id", flat=True)
94
+ )
95
+ # Active superusers are implicit owners unless an explicit row overrides them
96
+ # (that row's role is already reflected above if it is OWNER).
97
+ explicit_ids = set(
98
+ WorkspaceMembership.objects.filter(is_deleted=False).values_list("user_id", flat=True)
99
+ )
100
+ for uid in User.objects.filter(is_superuser=True, is_active=True).values_list("id", flat=True):
101
+ if uid not in explicit_ids:
102
+ owners.add(uid)
103
+ if exclude_user_id is not None:
104
+ owners.discard(exclude_user_id)
105
+ return owners
106
+
107
+
108
+ def would_strand_workspace(user_id: _PK) -> bool:
109
+ """True if removing/demoting ``user_id`` would leave the workspace ownerless."""
110
+ return len(workspace_owner_user_ids(exclude_user_id=user_id)) == 0
111
+
112
+
113
+ # ---------------------------------------------------------------------------
114
+ # Operational audit log (ADR-0157, #859)
115
+ # ---------------------------------------------------------------------------
116
+
117
+
118
+ def _actor_label(actor: Any) -> str:
119
+ """Human-readable display for an audit actor, captured at event time.
120
+
121
+ Denormalized onto the row so the log stays readable after the user is deleted
122
+ (the ``actor`` FK then resolves to NULL). Prefers a full name, then email,
123
+ then username; an absent actor (system action) yields an empty string.
124
+ """
125
+ if actor is None or not getattr(actor, "pk", None):
126
+ return ""
127
+ full_name = ""
128
+ get_full_name = getattr(actor, "get_full_name", None)
129
+ if callable(get_full_name):
130
+ full_name = (get_full_name() or "").strip()
131
+ label = full_name or getattr(actor, "email", "") or actor.get_username()
132
+ return label[:255]
133
+
134
+
135
+ def record_audit_event(
136
+ *,
137
+ event_type: str,
138
+ actor: Any,
139
+ target_type: str = "",
140
+ target_id: Any = None,
141
+ target_label: str = "",
142
+ metadata: dict[str, Any] | None = None,
143
+ ) -> AuditEvent:
144
+ """Write one operational ``AuditEvent`` and fan it out to enterprise receivers.
145
+
146
+ The single choke point for the OSS audit log (ADR-0157): every emission site
147
+ calls this rather than ``AuditEvent.objects.create`` directly. The row is
148
+ written synchronously inside the caller's transaction (so it rolls back with a
149
+ failed action — the log never claims an action that did not happen), and the
150
+ ``audit_event_created`` signal is fired from ``transaction.on_commit`` via
151
+ ``dispatch_extension_signal`` so a raising enterprise receiver is contained
152
+ and logged, and can never break the OSS write path. OSS itself connects no
153
+ receiver.
154
+ """
155
+ event = AuditEvent.objects.create(
156
+ actor=actor if (actor is not None and getattr(actor, "pk", None)) else None,
157
+ actor_label=_actor_label(actor),
158
+ event_type=event_type,
159
+ target_type=target_type,
160
+ target_id=target_id,
161
+ target_label=(target_label or "")[:512],
162
+ metadata=metadata or {},
163
+ )
164
+ transaction.on_commit(
165
+ lambda: dispatch_extension_signal(audit_event_created, sender=AuditEvent, audit_event=event)
166
+ )
167
+ return event
168
+
169
+
170
+ # ---------------------------------------------------------------------------
171
+ # Lifecycle: transfer ownership / export / delete (ADR-0174, #641)
172
+ # ---------------------------------------------------------------------------
173
+
174
+
175
+ def transfer_workspace_ownership(*, new_owner: Any, actor: Any) -> WorkspaceMembership:
176
+ """Atomically promote a workspace member to OWNER, demote the actor to ADMIN.
177
+
178
+ Mirrors :func:`access.services.transfer_project_ownership`. The target must
179
+ already be an **active** workspace member — requiring an explicit membership
180
+ forces an invite step and keeps a clean "joined → promoted" audit sequence.
181
+
182
+ The actor's explicit OWNER row (if any) is demoted to ADMIN. If the actor is
183
+ an *implicit* owner (an active superuser with no explicit row), nothing is
184
+ demoted — there is no row to change and the superuser bootstrap is intentional.
185
+ Promoting the target always leaves at least one owner, so this never strands
186
+ the workspace.
187
+
188
+ Args:
189
+ new_owner: The user who will become OWNER.
190
+ actor: The current owner initiating the transfer.
191
+
192
+ Returns:
193
+ The new owner's ``WorkspaceMembership`` row.
194
+
195
+ Raises:
196
+ ValidationError: if ``new_owner`` is the actor, or has no active membership.
197
+ """
198
+ if new_owner.pk == actor.pk:
199
+ raise ValidationError("You already own this workspace.")
200
+
201
+ # Defense in depth — the view gates with ``IsWorkspaceOwner``, but the service
202
+ # is reusable (management commands, signals, future endpoints). Without this an
203
+ # actor who is not actually an owner would promote the target while no one is
204
+ # demoted, minting an extra owner. Assert authority before any state change.
205
+ if actor.pk not in workspace_owner_user_ids():
206
+ raise ValidationError("Only an existing workspace Owner can transfer ownership.")
207
+
208
+ with transaction.atomic():
209
+ try:
210
+ target = WorkspaceMembership.objects.select_for_update().get(
211
+ user=new_owner,
212
+ is_deleted=False,
213
+ )
214
+ except WorkspaceMembership.DoesNotExist as exc:
215
+ raise ValidationError(
216
+ "The new owner must already be an active workspace member."
217
+ ) from exc
218
+ if target.status == MemberStatus.DEACTIVATED:
219
+ raise ValidationError("The new owner must be an active workspace member.")
220
+
221
+ # Promote the target first so the workspace is never momentarily ownerless.
222
+ if target.role != WorkspaceRole.OWNER:
223
+ target.role = WorkspaceRole.OWNER
224
+ target.role_changed_at = timezone.now()
225
+ target.save(update_fields=["role", "role_changed_at"])
226
+
227
+ # Demote the actor's explicit OWNER row, if they have one.
228
+ actor_row = (
229
+ WorkspaceMembership.objects.select_for_update()
230
+ .filter(user=actor, is_deleted=False)
231
+ .first()
232
+ )
233
+ if actor_row is not None and actor_row.role == WorkspaceRole.OWNER:
234
+ actor_row.role = WorkspaceRole.ADMIN
235
+ actor_row.role_changed_at = timezone.now()
236
+ actor_row.save(update_fields=["role", "role_changed_at"])
237
+
238
+ # Audit inside the same transaction so the row rolls back with a failed
239
+ # transfer. target_id is left null — a User PK is an int, not a UUID — and
240
+ # the new owner's id is carried in metadata instead (ADR-0157).
241
+ record_audit_event(
242
+ event_type=AuditEventType.OWNERSHIP_TRANSFERRED,
243
+ actor=actor,
244
+ target_type="member",
245
+ target_label=_actor_label(new_owner),
246
+ metadata={"new_owner_user_id": new_owner.pk},
247
+ )
248
+
249
+ return target
250
+
251
+
252
+ def enqueue_workspace_export(*, requested_by: Any) -> WorkspaceExportJob:
253
+ """Create an export job row and best-effort dispatch the Celery task (ADR-0174).
254
+
255
+ Follows the transactional-outbox convention (ADR-0080): the row commits with
256
+ the request; ``.delay()`` is attempted in ``transaction.on_commit`` and broker
257
+ errors are swallowed because ``drain_workspace_exports`` re-dispatches stuck
258
+ ``pending`` rows. ``.delay()`` is only ever called from here and the drain.
259
+
260
+ De-dupes in-flight work: a full-workspace archive is expensive, so if an export
261
+ is already ``pending``/``running`` the existing job is returned rather than
262
+ queuing a second build (also bounds an owner triggering repeated exports).
263
+ """
264
+ existing = WorkspaceExportJob.objects.filter(
265
+ status__in=[ExportJobStatus.PENDING, ExportJobStatus.RUNNING]
266
+ ).first()
267
+ if existing is not None:
268
+ return existing
269
+
270
+ job = WorkspaceExportJob.objects.create(requested_by=requested_by)
271
+
272
+ # Audit only the path that actually queues a new export — the dedupe branch
273
+ # above returns an in-flight job without minting work, so it is not an event.
274
+ record_audit_event(
275
+ event_type=AuditEventType.EXPORT_TRIGGERED,
276
+ actor=requested_by,
277
+ target_type="workspace_export",
278
+ target_id=job.id,
279
+ target_label="Workspace export",
280
+ )
281
+
282
+ def _dispatch() -> None:
283
+ from trueppm_api.apps.workspace.tasks import run_workspace_export
284
+
285
+ try:
286
+ run_workspace_export.delay(str(job.id))
287
+ except Exception: # pragma: no cover - broker-down path, drain recovers
288
+ logger.warning(
289
+ "broker unavailable; drain_workspace_exports will pick up export %s", job.id
290
+ )
291
+
292
+ transaction.on_commit(_dispatch)
293
+ return job
294
+
295
+
296
+ def purge_workspace() -> None:
297
+ """Hard-delete every workspace-scoped row and the singleton itself (ADR-0174).
298
+
299
+ Because ``Workspace.load()`` re-materializes the singleton on next access,
300
+ deleting the row is a factory reset: the next request gets a fresh default
301
+ workspace. Deletes run in FK-safe order in one transaction — ``PROTECT``
302
+ membership rows (project/program) and ``Project``-referenced ``Calendar`` rows
303
+ must be removed before their referents, so a naive ``Workspace.delete()``
304
+ cascade is not enough.
305
+ """
306
+ # Imported lazily: this is the only place the workspace service reaches across
307
+ # into the projects/access/resources models, and doing it at module load would
308
+ # widen the import graph for every workspace request.
309
+ from trueppm_api.apps.access.models import ProgramMembership
310
+ from trueppm_api.apps.projects.models import Calendar, Program, Project
311
+ from trueppm_api.apps.resources.models import Resource, Skill
312
+
313
+ with transaction.atomic():
314
+ # Group access cascade first (GroupProject/GroupMembership → Group).
315
+ GroupProject.objects.all().delete()
316
+ GroupMembership.objects.all().delete()
317
+ from trueppm_api.apps.workspace.models import Group
318
+
319
+ Group.objects.all().delete()
320
+ WorkspaceInvite.objects.all().delete()
321
+ WorkspaceMembership.objects.all().delete()
322
+ # PROTECT memberships must precede their parents.
323
+ ProjectMembership.objects.all().delete()
324
+ ProgramMembership.objects.all().delete()
325
+ # Projects cascade tasks/deps/baselines/sprints/risks/attachments/etc.
326
+ Project.objects.all().delete()
327
+ Program.objects.all().delete()
328
+ # Workspace-global flat tables (no project/workspace FK).
329
+ Resource.objects.all().delete()
330
+ Skill.objects.all().delete()
331
+ # Calendars are PROTECT-referenced by Project; safe now projects are gone.
332
+ Calendar.objects.all().delete()
333
+ WorkspaceExportJob.objects.all().delete()
334
+ Workspace.objects.all().delete()
335
+
336
+
337
+ # ---------------------------------------------------------------------------
338
+ # Group → project access cascade (ADR-0087 §5)
339
+ # ---------------------------------------------------------------------------
340
+
341
+
342
+ def _build_confer_map(
343
+ user_ids: set[Any], project_ids: set[Any]
344
+ ) -> dict[tuple[Any, Any], tuple[int, Any]]:
345
+ """Bulk-compute the conferred project ``Role`` per (user, project) pair.
346
+
347
+ Returns ``{(user_id, project_id): (role, source_group_id)}`` for the highest
348
+ role any active group the user belongs to confers on that project. Replaces a
349
+ per-pair query with two bulk reads (GroupProject + GroupMembership), so a
350
+ cascade over M members × P projects costs O(1) queries, not O(M·P).
351
+ """
352
+ gp_rows = list(
353
+ GroupProject.objects.filter(
354
+ project_id__in=project_ids, group__is_deleted=False
355
+ ).values_list("project_id", "group_id", "role")
356
+ )
357
+ involved_group_ids = {gid for _, gid, _ in gp_rows}
358
+ members_by_group: dict[Any, set[Any]] = {}
359
+ for gid, uid in GroupMembership.objects.filter(
360
+ group_id__in=involved_group_ids, is_deleted=False, user_id__in=user_ids
361
+ ).values_list("group_id", "user_id"):
362
+ members_by_group.setdefault(gid, set()).add(uid)
363
+
364
+ confer: dict[tuple[Any, Any], tuple[int, Any]] = {}
365
+ for project_id, gid, role in gp_rows:
366
+ for uid in members_by_group.get(gid, ()):
367
+ key = (uid, project_id)
368
+ current = confer.get(key)
369
+ if current is None or role > current[0]:
370
+ confer[key] = (int(role), gid)
371
+ return confer
372
+
373
+
374
+ def _sync_existing_membership(
375
+ existing: ProjectMembership,
376
+ confer_role: int,
377
+ src_group_id: Any,
378
+ now: Any,
379
+ user_id: Any,
380
+ project_id: Any,
381
+ events: list[tuple[Any, str, dict[str, Any]]],
382
+ ) -> None:
383
+ """Role-sync an existing *active* group-derived row to the conferred role.
384
+
385
+ Only broadcasts ``member_role_changed`` when the role actually moved — a pure
386
+ source_group reattribution (e.g. one of two overlapping groups removed, role
387
+ unchanged) is invisible to board consumers.
388
+ """
389
+ changed: list[str] = []
390
+ role_changed = existing.role != confer_role
391
+ if role_changed:
392
+ existing.role = confer_role
393
+ existing.role_changed_at = now
394
+ changed += ["role", "role_changed_at"]
395
+ if existing.source_group_id != src_group_id:
396
+ existing.source_group_id = src_group_id
397
+ changed.append("source_group")
398
+ if not changed:
399
+ return
400
+ existing.save(update_fields=changed)
401
+ if role_changed:
402
+ events.append(
403
+ (
404
+ project_id,
405
+ "member_role_changed",
406
+ {
407
+ "membership_id": str(existing.pk),
408
+ "user_id": str(user_id),
409
+ "role": existing.role,
410
+ },
411
+ )
412
+ )
413
+
414
+
415
+ def _reconcile_pair(
416
+ user_id: Any,
417
+ project_id: Any,
418
+ confer_entry: tuple[int, Any] | None,
419
+ existing: ProjectMembership | None,
420
+ now: Any,
421
+ events: list[tuple[Any, str, dict[str, Any]]],
422
+ ) -> None:
423
+ """Reconcile one (user, project) pair from pre-fetched confer + existing data.
424
+
425
+ A direct membership (``source_group IS NULL``) always wins and is never
426
+ touched. Otherwise the group-derived row is created, role-synced, resurrected,
427
+ or removed to match the conferred role. Board events are appended to ``events``.
428
+ """
429
+ confer_role, src_group_id = confer_entry if confer_entry is not None else (None, None)
430
+
431
+ # Direct grant wins — group reconciliation must not alter or revoke it.
432
+ if existing is not None and not existing.is_deleted and existing.source_group_id is None:
433
+ return
434
+
435
+ if confer_role is None:
436
+ if (
437
+ existing is not None
438
+ and not existing.is_deleted
439
+ and existing.source_group_id is not None
440
+ ):
441
+ existing.soft_delete()
442
+ events.append(
443
+ (
444
+ project_id,
445
+ "member_removed",
446
+ {"membership_id": str(existing.pk), "user_id": str(user_id)},
447
+ )
448
+ )
449
+ return
450
+
451
+ if existing is None:
452
+ pm = ProjectMembership.objects.create(
453
+ project_id=project_id,
454
+ user_id=user_id,
455
+ role=confer_role,
456
+ source_group_id=src_group_id,
457
+ )
458
+ events.append(
459
+ (
460
+ project_id,
461
+ "member_added",
462
+ {"membership_id": str(pm.pk), "user_id": str(user_id), "role": confer_role},
463
+ )
464
+ )
465
+ elif existing.is_deleted:
466
+ # Resurrect a previously-removed row as group-derived (unique_together on
467
+ # (project, user) means we cannot insert a second row).
468
+ existing.is_deleted = False
469
+ existing.deleted_version = None
470
+ existing.role = confer_role
471
+ existing.source_group_id = src_group_id
472
+ existing.role_changed_at = now
473
+ existing.save()
474
+ events.append(
475
+ (
476
+ project_id,
477
+ "member_added",
478
+ {"membership_id": str(existing.pk), "user_id": str(user_id), "role": confer_role},
479
+ )
480
+ )
481
+ else:
482
+ _sync_existing_membership(
483
+ existing, confer_role, src_group_id, now, user_id, project_id, events
484
+ )
485
+
486
+
487
+ @transaction.atomic
488
+ def reconcile_group_access(group_id: Any) -> None:
489
+ """Reconcile all affected (member × project) pairs for a group.
490
+
491
+ Considers the union of the group's current desired pairs (active members ×
492
+ linked projects) and any pair still attributed to this group in
493
+ ``ProjectMembership.source_group`` (so removals are caught when a member or
494
+ project link is dropped, or the group is soft-deleted). Reconciliation is
495
+ global across groups (overlaps resolve to the highest conferred role) and is
496
+ driven by bulk reads — three queries regardless of group size.
497
+ """
498
+ member_ids = list(
499
+ GroupMembership.objects.filter(group_id=group_id, is_deleted=False).values_list(
500
+ "user_id", flat=True
501
+ )
502
+ )
503
+ project_ids = list(
504
+ GroupProject.objects.filter(group_id=group_id).values_list("project_id", flat=True)
505
+ )
506
+ desired = {(u, p) for u in member_ids for p in project_ids}
507
+ attributed = set(
508
+ ProjectMembership.objects.filter(source_group_id=group_id, is_deleted=False).values_list(
509
+ "user_id", "project_id"
510
+ )
511
+ )
512
+ pairs = desired | attributed
513
+ if not pairs:
514
+ return
515
+
516
+ user_ids = {u for u, _ in pairs}
517
+ proj_ids = {p for _, p in pairs}
518
+ confer = _build_confer_map(user_ids, proj_ids)
519
+ # Lock the candidate membership rows once (one query), then reconcile in memory.
520
+ # order_by("pk"): access.views' `create` / `partial_update` lock ProjectMembership
521
+ # rows in ascending-pk order to avoid deadlocking against each other on a
522
+ # reversed actor/target pair (#3438) — this bulk lock joins the same
523
+ # convention rather than leaving Postgres to pick its own row order.
524
+ existing = {
525
+ (m.user_id, m.project_id): m
526
+ for m in ProjectMembership.objects.select_for_update()
527
+ .filter(user_id__in=user_ids, project_id__in=proj_ids)
528
+ .order_by("pk")
529
+ }
530
+
531
+ now = timezone.now()
532
+ events: list[tuple[Any, str, dict[str, Any]]] = []
533
+ for user_id, project_id in pairs:
534
+ _reconcile_pair(
535
+ user_id,
536
+ project_id,
537
+ confer.get((user_id, project_id)),
538
+ existing.get((user_id, project_id)),
539
+ now,
540
+ events,
541
+ )
542
+ _broadcast_membership_events(events)
543
+
544
+
545
+ def _broadcast_membership_events(events: list[tuple[Any, str, dict[str, Any]]]) -> None:
546
+ """Defer best-effort board broadcasts for each cascade-affected project."""
547
+ if not events:
548
+ return
549
+
550
+ def _send() -> None:
551
+ from trueppm_api.apps.sync.broadcast import broadcast_board_event
552
+
553
+ for project_id, event_type, payload in events:
554
+ broadcast_board_event(str(project_id), event_type, payload)
555
+
556
+ transaction.on_commit(_send)
557
+
558
+
559
+ # ---------------------------------------------------------------------------
560
+ # Invites
561
+ # ---------------------------------------------------------------------------
562
+
563
+
564
+ def create_invite(
565
+ *,
566
+ workspace: Workspace,
567
+ email: str,
568
+ role: int,
569
+ invited_by: Any,
570
+ ) -> WorkspaceInvite:
571
+ """Create a pending invite with a one-time token and queue its email.
572
+
573
+ The raw token is generated here, hashed for the durable credential, and kept
574
+ in ``email_token`` only until the drain sends the link (ADR-0087 §4).
575
+ """
576
+ raw_token = secrets.token_urlsafe(32)
577
+ token_hash = hashlib.sha256(raw_token.encode()).hexdigest()
578
+ return WorkspaceInvite.objects.create(
579
+ workspace=workspace,
580
+ email=email,
581
+ role=role,
582
+ token_hash=token_hash,
583
+ email_token=raw_token,
584
+ invited_by=invited_by,
585
+ expires_at=WorkspaceInvite.default_expiry(),
586
+ email_pending=True,
587
+ )
588
+
589
+
590
+ # Statuses an admin may resend (ADR-0149). PENDING covers a lost/bounced live
591
+ # invite; FAILED is a send-exhausted invite — resend is its recovery path. An
592
+ # ACCEPTED/REVOKED/EXPIRED invite is intentionally *not* revivable.
593
+ RESENDABLE_INVITE_STATUSES = (InviteStatus.PENDING, InviteStatus.FAILED)
594
+
595
+ _RESEND_UPDATE_FIELDS = [
596
+ "token_hash",
597
+ "email_token",
598
+ "status",
599
+ "expires_at",
600
+ "email_pending",
601
+ "email_sent_at",
602
+ "email_failed_at",
603
+ "email_attempts",
604
+ ]
605
+
606
+
607
+ def _reissue_invite_token(invite: WorkspaceInvite) -> None:
608
+ """Reset an (unsaved, locked) invite back into the drain-eligible queued shape.
609
+
610
+ Regenerates the one-time token — so any link in a previously-sent email stops
611
+ working, which is the correct posture for a re-issue (ADR-0149) — and clears the
612
+ outbox columns (``email_pending`` on, ``email_sent_at``/``email_failed_at`` off,
613
+ attempts zeroed) so the existing ``drain_invite_emails`` picks the row up on its
614
+ next 30 s tick. ``created_at`` is unchanged, so the resend clears the drain's
615
+ 5-min orphan window immediately (unlike a fresh create).
616
+ """
617
+ raw_token = secrets.token_urlsafe(32)
618
+ invite.token_hash = hashlib.sha256(raw_token.encode()).hexdigest()
619
+ invite.email_token = raw_token
620
+ invite.status = InviteStatus.PENDING
621
+ invite.expires_at = WorkspaceInvite.default_expiry()
622
+ invite.email_pending = True
623
+ invite.email_sent_at = None
624
+ invite.email_failed_at = None
625
+ invite.email_attempts = 0
626
+
627
+
628
+ def _is_in_flight(invite: WorkspaceInvite) -> bool:
629
+ """True if a send is already queued and not yet sent (idempotent-resend guard).
630
+
631
+ A double-click on Resend (or a created-but-not-yet-drained invite) must not
632
+ re-issue a token the drain is about to send with the *current* token, so resend
633
+ is a no-op for these rows.
634
+ """
635
+ return invite.email_pending and invite.email_sent_at is None
636
+
637
+
638
+ def drain_invite_emails_soon() -> None:
639
+ """Best-effort nudge the invite-email drain to run now instead of next tick.
640
+
641
+ A resend re-queues a row whose ``created_at`` is already past the 5-min orphan
642
+ window, so it's drain-eligible immediately — this just shortens the wait from the
643
+ 30 s Beat cadence to "right after commit". Broker errors are swallowed: the
644
+ periodic ``drain_invite_emails`` is the durability guarantee, this is only an
645
+ optimization (ADR-0149). Call inside ``transaction.on_commit``.
646
+ """
647
+ from trueppm_api.apps.workspace.tasks import drain_invite_emails
648
+
649
+ try:
650
+ drain_invite_emails.delay()
651
+ except Exception: # pragma: no cover - broker-down path, periodic drain recovers
652
+ logger.warning("broker unavailable; periodic drain_invite_emails will send resends")
653
+
654
+
655
+ def resend_invite(invite_id: _PK) -> WorkspaceInvite | None:
656
+ """Re-queue one resendable invite's email with a fresh token (ADR-0149).
657
+
658
+ Returns the invite on success, the unchanged invite when it is already in
659
+ flight (idempotent no-op), or ``None`` when it does not exist or is not
660
+ resendable (accepted/revoked/expired) — the view maps ``None`` to 409/404.
661
+ Locks the row so a concurrent double-submit re-issues at most once.
662
+ """
663
+ with transaction.atomic():
664
+ invite = WorkspaceInvite.objects.select_for_update().filter(pk=invite_id).first()
665
+ if invite is None or invite.status not in RESENDABLE_INVITE_STATUSES:
666
+ return None
667
+ if _is_in_flight(invite):
668
+ return invite
669
+ _reissue_invite_token(invite)
670
+ invite.save(update_fields=_RESEND_UPDATE_FIELDS)
671
+ return invite
672
+
673
+
674
+ def resend_all_pending(workspace: Workspace) -> int:
675
+ """Re-queue every resendable invite in one transaction; return the count.
676
+
677
+ Bundled into a single transaction so "Resend all" is one throttle bucket hit
678
+ (ADR-0149) and can never email-bomb regardless of how many invites are pending.
679
+ In-flight rows are skipped, so the returned count reflects only rows actually
680
+ re-issued.
681
+ """
682
+ count = 0
683
+ with transaction.atomic():
684
+ invites = list(
685
+ WorkspaceInvite.objects.select_for_update().filter(
686
+ workspace=workspace,
687
+ status__in=RESENDABLE_INVITE_STATUSES,
688
+ )
689
+ )
690
+ for invite in invites:
691
+ if _is_in_flight(invite):
692
+ continue
693
+ _reissue_invite_token(invite)
694
+ invite.save(update_fields=_RESEND_UPDATE_FIELDS)
695
+ count += 1
696
+ return count
697
+
698
+
699
+ # ---------------------------------------------------------------------------
700
+ # Workspace logo (ADR-0149, #969)
701
+ # ---------------------------------------------------------------------------
702
+
703
+
704
+ def _delete_storage_file_on_commit(name: str) -> None:
705
+ """Best-effort delete of a storage blob after the current transaction commits.
706
+
707
+ Deferred to ``on_commit`` so a rolled-back logo write never orphans the *new*
708
+ file by deleting the *old* one prematurely; storage drift (already gone) is
709
+ logged, not raised.
710
+ """
711
+ if not name:
712
+ return
713
+
714
+ def _delete() -> None:
715
+ from django.core.files.storage import default_storage
716
+
717
+ try:
718
+ default_storage.delete(name)
719
+ except OSError: # pragma: no cover - storage drift, nothing to clean up
720
+ logger.warning("could not delete old workspace logo file %s", name)
721
+
722
+ transaction.on_commit(_delete)
723
+
724
+
725
+ def set_workspace_logo(*, file: Any, mime: str) -> Workspace:
726
+ """Store a new workspace logo, deleting the previously-stored file on commit.
727
+
728
+ The validated content type is pinned in ``logo_mime`` so the public serve
729
+ endpoint sets Content-Type from a trusted column rather than re-sniffing. The
730
+ UUID-prefixed ``upload_to`` guarantees the new key differs from the old, so the
731
+ old blob is always safe to delete once the row commits (ADR-0149).
732
+ """
733
+ ws = Workspace.load()
734
+ old_name = ws.logo.name
735
+ ws.logo = file
736
+ ws.logo_mime = mime
737
+ ws.save(update_fields=["logo", "logo_mime", "updated_at"])
738
+ if old_name and old_name != ws.logo.name:
739
+ _delete_storage_file_on_commit(old_name)
740
+ return ws
741
+
742
+
743
+ def clear_workspace_logo() -> Workspace:
744
+ """Remove the workspace logo and delete its stored file on commit (ADR-0149)."""
745
+ ws = Workspace.load()
746
+ old_name = ws.logo.name
747
+ if old_name:
748
+ ws.logo = ""
749
+ ws.logo_mime = ""
750
+ ws.save(update_fields=["logo", "logo_mime", "updated_at"])
751
+ _delete_storage_file_on_commit(old_name)
752
+ return ws
753
+
754
+
755
+ def _load_pending_invite(token: str) -> WorkspaceInvite:
756
+ """Resolve a token to a pending, unexpired invite; raise ``InviteError`` otherwise.
757
+
758
+ A lapsed (still-PENDING but expired) invite is marked ``EXPIRED`` via a
759
+ standalone autocommit ``update`` — not inside a provisioning ``atomic`` block —
760
+ so the state change survives the ``InviteError`` raise instead of being rolled
761
+ back and leaving the invite pending.
762
+ """
763
+ token_hash = hashlib.sha256(token.encode()).hexdigest()
764
+ try:
765
+ invite = WorkspaceInvite.objects.get(token_hash=token_hash)
766
+ except WorkspaceInvite.DoesNotExist as exc:
767
+ raise InviteError(_INVALID_INVITE_MESSAGE) from exc
768
+
769
+ if invite.status != InviteStatus.PENDING or invite.is_expired:
770
+ if invite.status == InviteStatus.PENDING and invite.is_expired:
771
+ WorkspaceInvite.objects.filter(pk=invite.pk).update(
772
+ status=InviteStatus.EXPIRED, email_pending=False, email_token=""
773
+ )
774
+ raise InviteError(_INVALID_INVITE_MESSAGE)
775
+ return invite
776
+
777
+
778
+ def _create_invited_user(*, username: str, email: str, password: str) -> Any:
779
+ """Mint a new account for an invitee, enforcing the configured password policy.
780
+
781
+ ``create_user`` hashes but does NOT run ``AUTH_PASSWORD_VALIDATORS``, and the
782
+ serializer accepts any non-empty string — so the policy is enforced here before
783
+ minting the account. Without this an unauthenticated invitee could set a
784
+ trivially-guessable password.
785
+ """
786
+ User = get_user_model()
787
+ try:
788
+ validate_password(password)
789
+ except ValidationError as exc:
790
+ raise InviteError(" ".join(exc.messages)) from exc
791
+ try:
792
+ return User.objects.create_user(username=username, email=email, password=password)
793
+ except IntegrityError as exc:
794
+ raise InviteError("That username is already taken.") from exc
795
+
796
+
797
+ def _link_existing_membership(
798
+ membership: WorkspaceMembership, invite: WorkspaceInvite, user: Any, now: Any
799
+ ) -> None:
800
+ """Elevate (never reactivate) an existing membership when replaying an invite.
801
+
802
+ A deactivated member must NOT be silently reactivated (or re-elevated) by
803
+ replaying a pending invite — that would let an admin's deactivation be undone
804
+ without admin consent. Reactivation is an explicit admin action; refuse the
805
+ invite instead. Otherwise the role is raised (never lowered) to the invite's.
806
+ """
807
+ if membership.status == MemberStatus.DEACTIVATED:
808
+ raise InviteError(
809
+ "Membership is deactivated; an admin must reactivate it before this invite can be used."
810
+ )
811
+ if invite.role <= membership.role:
812
+ return
813
+ old_role = membership.role
814
+ membership.role = invite.role
815
+ membership.role_changed_at = now
816
+ membership.save()
817
+ record_audit_event(
818
+ event_type=AuditEventType.MEMBER_ROLE_CHANGED,
819
+ actor=user,
820
+ target_type="member",
821
+ target_label=_actor_label(user),
822
+ metadata={
823
+ "old_role": WorkspaceRole(old_role).label,
824
+ "new_role": WorkspaceRole(membership.role).label,
825
+ "source": "invite",
826
+ },
827
+ )
828
+
829
+
830
+ def accept_invite(*, token: str, username: str = "", password: str = "") -> Any:
831
+ """Provision (or link) a user and create their workspace membership.
832
+
833
+ Looks the invite up by token hash, validates it is pending and unexpired,
834
+ then atomically links an existing user matching the invite email or creates
835
+ a new account from ``username``/``password``. Idempotent under a double-submit:
836
+ the status flips ``pending → accepted`` under a row lock.
837
+
838
+ Raises:
839
+ InviteError: invalid/expired token, or account-creation conflict.
840
+ """
841
+ invite = _load_pending_invite(token)
842
+
843
+ User = get_user_model()
844
+ user = User.objects.filter(email__iexact=invite.email).first()
845
+ if user is None and (not username or not password):
846
+ raise InviteError("A username and password are required to accept this invitation.")
847
+
848
+ with transaction.atomic():
849
+ # Re-fetch under a row lock to make a double-submit create exactly one
850
+ # membership (the second caller sees status != PENDING and bails).
851
+ invite = WorkspaceInvite.objects.select_for_update().get(pk=invite.pk)
852
+ if invite.status != InviteStatus.PENDING:
853
+ raise InviteError(_INVALID_INVITE_MESSAGE)
854
+
855
+ if user is None:
856
+ user = _create_invited_user(
857
+ username=username, email=invite.email.lower(), password=password
858
+ )
859
+
860
+ now = timezone.now()
861
+ membership, created = WorkspaceMembership.objects.get_or_create(
862
+ workspace=invite.workspace,
863
+ user=user,
864
+ defaults={"role": invite.role, "status": MemberStatus.ACTIVE},
865
+ )
866
+ if created:
867
+ # Self-service join: the actor is the invitee provisioning their own
868
+ # membership via a token (the endpoint is unauthenticated). Audited
869
+ # inside the provisioning transaction so it rolls back with it.
870
+ record_audit_event(
871
+ event_type=AuditEventType.MEMBER_ADDED,
872
+ actor=user,
873
+ target_type="member",
874
+ target_label=_actor_label(user),
875
+ metadata={
876
+ "role": WorkspaceRole(membership.role).label,
877
+ "source": "invite",
878
+ },
879
+ )
880
+ else:
881
+ _link_existing_membership(membership, invite, user, now)
882
+
883
+ invite.status = InviteStatus.ACCEPTED
884
+ invite.accepted_at = now
885
+ invite.accepted_user = user
886
+ invite.email_pending = False
887
+ invite.email_token = "" # consume the raw token
888
+ invite.save(
889
+ update_fields=[
890
+ "status",
891
+ "accepted_at",
892
+ "accepted_user",
893
+ "email_pending",
894
+ "email_token",
895
+ ]
896
+ )
897
+
898
+ # The invite's own durable record (#2911). Distinct from the MEMBER_ADDED
899
+ # row above and not redundant with it: that row's actor is the *invitee*,
900
+ # because this endpoint is unauthenticated and the invitee provisions
901
+ # themselves. It therefore cannot answer "who let them in". The inviter is
902
+ # carried here explicitly, denormalized to a label as well as an id so the
903
+ # answer survives the inviter's own off-boarding (the AuditEvent.actor_label
904
+ # idiom). Written inside the same transaction, so it rolls back with a
905
+ # failed accept rather than claiming a join that did not happen.
906
+ record_audit_event(
907
+ event_type=AuditEventType.INVITE_ACCEPTED,
908
+ actor=user,
909
+ target_type="invite",
910
+ target_id=invite.pk,
911
+ target_label=invite.email,
912
+ metadata={
913
+ "role": WorkspaceRole(invite.role).label,
914
+ "invited_by": _actor_label(invite.invited_by),
915
+ "invited_by_id": str(invite.invited_by_id) if invite.invited_by_id else None,
916
+ "invited_at": invite.created_at.isoformat(),
917
+ },
918
+ )
919
+ return user