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,961 @@
1
+ """DRF serializers for the notifications app (ADR-0075)."""
2
+
3
+ from __future__ import annotations
4
+
5
+ import logging
6
+ import re
7
+ import zoneinfo
8
+ from functools import partial
9
+ from typing import Any, cast
10
+
11
+ from drf_spectacular.utils import extend_schema_field
12
+ from rest_framework import serializers
13
+
14
+ from trueppm_api.apps.projects.schema_migrations import migrate_payload
15
+
16
+ from .categories import category_for
17
+ from .delivery_limits import EMAIL_MAX_BATCH_SIZE
18
+ from .models import (
19
+ PROJECT_NOTIFICATION_DELIVERY_REPORTED_CHANNELS,
20
+ PROJECT_NOTIFICATION_DELIVERY_REPORTED_EVENTS,
21
+ EmailSecurity,
22
+ EmailTransportMode,
23
+ Mention,
24
+ Notification,
25
+ NotificationPreference,
26
+ ProjectNotificationChannel,
27
+ ProjectNotificationEventType,
28
+ ProjectNotificationPreference,
29
+ UserNotificationSettings,
30
+ WorkspaceEmailSettings,
31
+ project_notification_channel_delivery,
32
+ project_notification_event_delivery,
33
+ )
34
+ from .schema_migrations import SURFACE_PROJECT_NOTIFICATION_MATRIX
35
+ from .services import (
36
+ QUIET_HOURS_TZ_SOURCE_FALLBACK,
37
+ QUIET_HOURS_TZ_SOURCE_PROJECT,
38
+ QUIET_HOURS_TZ_SOURCE_SERVER,
39
+ QUIET_HOURS_TZ_SOURCE_WORKSPACE,
40
+ )
41
+
42
+ logger = logging.getLogger(__name__)
43
+
44
+ # DKIM selector: a single DNS label component set (letters, digits, dot, dash,
45
+ # underscore), capped to the model's 63-char column. Restricting this prevents
46
+ # DNS-name injection into the deliverability health lookup (security review M3).
47
+ _DKIM_SELECTOR_RE = re.compile(r"^[A-Za-z0-9._-]{1,63}$")
48
+
49
+ # Transports that require a stored/submitted credential.
50
+ _CREDENTIAL_MODES = {
51
+ EmailTransportMode.SMTP,
52
+ EmailTransportMode.SENDGRID,
53
+ EmailTransportMode.SES,
54
+ }
55
+ # Transports where the admin supplies the relay host (SendGrid's host is fixed).
56
+ _HOST_REQUIRED_MODES = {EmailTransportMode.SMTP, EmailTransportMode.SES}
57
+ # Transports where the admin supplies the SMTP AUTH username. SendGrid is excluded
58
+ # because its username is server-fixed to the literal "apikey" (the key travels as
59
+ # the password), and CLOUD stores no credentials at all.
60
+ _USERNAME_REQUIRED_MODES = {EmailTransportMode.SMTP, EmailTransportMode.SES}
61
+
62
+
63
+ def _effective(attrs: dict[str, Any], instance: Any, field: str, default: Any = "") -> Any:
64
+ """Value ``field`` will hold after this write.
65
+
66
+ A PATCH only carries the fields being changed, so validation has to reason
67
+ about the *merged* record: incoming value if the request set one, otherwise
68
+ whatever is already stored.
69
+ """
70
+ if field in attrs:
71
+ return attrs[field]
72
+ return getattr(instance, field, default)
73
+
74
+
75
+ def _assert_transport_fields(
76
+ *,
77
+ mode: Any,
78
+ host: str,
79
+ username: str,
80
+ effective_pw: str,
81
+ needs_fresh_password: bool,
82
+ ) -> None:
83
+ """Reject a transport config that is missing something the transport needs.
84
+
85
+ Runs before the live probe so a config that cannot possibly work is refused
86
+ without opening a connection.
87
+ """
88
+ # Reusing a stale secret across a transport switch is a footgun — a
89
+ # SendGrid API key is not an SES password (security review M2).
90
+ if needs_fresh_password and mode in _CREDENTIAL_MODES:
91
+ raise serializers.ValidationError(
92
+ {"password": "Re-enter the password when changing the transport."}
93
+ )
94
+
95
+ if mode in _HOST_REQUIRED_MODES and not host:
96
+ raise serializers.ValidationError({"host": "Host is required for this transport."})
97
+
98
+ # SMTP AUTH is a (username, password) pair, so a blank username is not a
99
+ # weaker credential — it is *no* credential. Django's SMTP backend calls
100
+ # login() only when both are truthy, so a blank username makes the probe
101
+ # open an unauthenticated connection that succeeds, persisting a config
102
+ # whose every real send then fails 530 Authentication Required. Requiring
103
+ # it here is what makes the validate-before-persist gate honest.
104
+ if mode in _USERNAME_REQUIRED_MODES and not username:
105
+ raise serializers.ValidationError(
106
+ {
107
+ "username": (
108
+ "A username is required for this transport — the mail server "
109
+ "authenticates as this account. It is usually the full email "
110
+ "address that owns the password or app password."
111
+ )
112
+ }
113
+ )
114
+
115
+ if not effective_pw:
116
+ raise serializers.ValidationError(
117
+ {"password": "A password is required for this transport."}
118
+ )
119
+
120
+
121
+ def _probe_or_raise(
122
+ *,
123
+ mode: Any,
124
+ host: str,
125
+ port: Any,
126
+ security: Any,
127
+ username: str,
128
+ password: str,
129
+ ) -> None:
130
+ """Validate-before-persist: open the candidate transport now.
131
+
132
+ Generic error only — never leak the underlying smtplib exception (M1).
133
+ """
134
+ from .email_backend import EmailTransportError, probe_transport
135
+
136
+ try:
137
+ probe_transport(
138
+ transport_mode=str(mode),
139
+ host=host,
140
+ port=int(port),
141
+ security=str(security),
142
+ username=username,
143
+ password=password,
144
+ )
145
+ except EmailTransportError as exc:
146
+ # Curated message only — never surface the exception object. The
147
+ # SSRF-guarded host path can carry the DNS-resolved internal address
148
+ # (scrubbed from the client at email_backend._assert_host_public);
149
+ # log the detail server-side (CodeQL py/stack-trace-exposure).
150
+ logger.info("email transport probe failed (host=%s port=%s): %s", host, port, exc)
151
+ raise serializers.ValidationError(
152
+ {
153
+ "non_field_errors": [
154
+ "Could not connect to the mail server with these settings. "
155
+ "Check the host, port, security, and credentials."
156
+ ]
157
+ }
158
+ ) from exc
159
+
160
+
161
+ class MentionAuthorSerializer(serializers.Serializer[Any]):
162
+ """Nested read-only user summary for Mention.mentioner / mentioned_user."""
163
+
164
+ id = serializers.UUIDField(read_only=True)
165
+ username = serializers.CharField(read_only=True)
166
+ display_name = serializers.SerializerMethodField()
167
+
168
+ def get_display_name(self, obj: Any) -> str:
169
+ name: str = obj.get_full_name() or obj.username
170
+ return name
171
+
172
+
173
+ class MentionSerializer(serializers.ModelSerializer[Mention]):
174
+ """Read-only serializer for Mention.
175
+
176
+ Mentions are append-only — no write path through this serializer. Created
177
+ indirectly via TaskCommentSerializer.create + services.create_mention_notifications.
178
+ """
179
+
180
+ mentioner = MentionAuthorSerializer(read_only=True)
181
+ mentioned_user = MentionAuthorSerializer(read_only=True)
182
+
183
+ class Meta:
184
+ model = Mention
185
+ fields = [
186
+ "id",
187
+ "mentioner",
188
+ "mentioned_user",
189
+ "mentioned_group_key",
190
+ "scope",
191
+ "task_comment",
192
+ "created_at",
193
+ ]
194
+ read_only_fields = fields
195
+
196
+
197
+ class NotificationSerializer(serializers.ModelSerializer[Notification]):
198
+ """Per-recipient inbox row.
199
+
200
+ Writes are limited to is_read / is_archived (PATCH-only on the viewset).
201
+ All other fields are read-only.
202
+ """
203
+
204
+ mention = MentionSerializer(read_only=True, allow_null=True)
205
+ snippet = serializers.SerializerMethodField()
206
+ task_id = serializers.SerializerMethodField()
207
+ # Derived read-only category (ADR-0216 §3) — mentions | tasks | signals |
208
+ # project. Sourced from categories.category_for so the field and the
209
+ # ?category= filter share one mapping and never drift.
210
+ category = serializers.SerializerMethodField()
211
+
212
+ def get_category(self, obj: Notification) -> str:
213
+ return category_for(obj)
214
+
215
+ def get_snippet(self, obj: Notification) -> str:
216
+ """Short preview of the source mention's body.
217
+
218
+ Truncated to 200 chars. Returns empty string if the source is
219
+ unavailable (e.g. comment soft-deleted).
220
+
221
+ Cross-project gate (#514): the snippet is a project member's-eyes view
222
+ of the source comment body, so it is returned ONLY to a recipient who
223
+ is a *current* member of the mention's source project. Program-scoped
224
+ auto-groups (`@program-*`) fan a mention out to members of sibling
225
+ projects who are NOT members of the source project — for them the row
226
+ still surfaces (they know they were pinged) but the body is redacted, so
227
+ a program ping never leaks one project's comment content to another
228
+ project's team. This also honors the standing rule that a departed
229
+ member no longer sees the body. Project membership is the read boundary
230
+ in OSS; the program is a coordination unit, not a shared-content unit.
231
+ """
232
+ mention = obj.mention
233
+ if mention is None:
234
+ return ""
235
+ comment = mention.task_comment
236
+ if comment is None or comment.is_deleted:
237
+ return ""
238
+ if not self._recipient_can_see_project(obj):
239
+ return ""
240
+ body = comment.body or ""
241
+ return body[:200]
242
+
243
+ def _recipient_can_see_project(self, obj: Notification) -> bool:
244
+ """True if the notification's recipient currently belongs to ``obj.project``.
245
+
246
+ Generalizes the mention-only #514 gate (formerly
247
+ ``_recipient_can_see_source``, keyed on ``mention.project_id``) to every
248
+ notification, mention- or event-sourced (#3510): ``Notification.project_id``
249
+ is set at dispatch for both — the event-sourced fan-outs in ``services.py``
250
+ write it directly, and the mention fan-out (``_build_mention_notification``)
251
+ writes the same ``project_id`` the mention's source project resolved to — so
252
+ one project-membership check now backs the mention ``snippet``
253
+ redaction, the ``subject``/``body``/``project`` redaction in
254
+ :meth:`to_representation`, and — since #3674 — the ``task_id`` /
255
+ ``mention.task_comment`` object-reference redaction alongside it. A
256
+ notification with no project at all (the
257
+ ADR-0663 account-scoped digest rows, which span the recipient's whole
258
+ membership set rather than one project) has no project boundary to check
259
+ against, so it is always visible.
260
+
261
+ The set of the recipient's member projects is resolved once per response
262
+ and memoized on the serializer context, so the inbox list stays O(1)
263
+ queries rather than one membership query per row. Falls open only when
264
+ there is no request/user context at all (e.g. a bare unit test
265
+ serializing without a request) — every real read path (the viewset)
266
+ supplies it.
267
+ """
268
+ project_id = obj.project_id
269
+ if project_id is None:
270
+ return True
271
+ member_project_ids = self.context.get("member_project_ids")
272
+ if member_project_ids is None:
273
+ request = self.context.get("request")
274
+ user = getattr(request, "user", None) if request is not None else None
275
+ if user is None or not getattr(user, "is_authenticated", False):
276
+ return True # no user context to gate against — preserve behavior
277
+ from trueppm_api.apps.access.models import ProjectMembership
278
+
279
+ member_project_ids = set(
280
+ ProjectMembership.objects.filter(user=user, is_deleted=False).values_list(
281
+ "project_id", flat=True
282
+ )
283
+ )
284
+ # DRF's serializer context is a plain dict at runtime (typed Mapping
285
+ # in the stubs); memoize so the list path resolves membership once.
286
+ cast(dict[str, Any], self.context)["member_project_ids"] = member_project_ids
287
+ return project_id in member_project_ids
288
+
289
+ def to_representation(self, instance: Notification) -> dict[str, Any]:
290
+ """Redact ``subject``/``body``/``project`` (#3510) + the source object refs (#3674).
291
+
292
+ ``subject`` and ``body`` are free text rendered from the project and task
293
+ names at dispatch time (see the ``Notification(...)`` fan-outs in
294
+ ``services.py``), and ``project`` is the FK to the row's source project.
295
+ All three are frozen at dispatch and, before this change, were served
296
+ unredacted forever after — including to a user removed from the project,
297
+ who kept an inbox that went on naming that project's tasks indefinitely.
298
+ ``snippet`` already redacted the same class of content one field over
299
+ (#514); this extends that same treatment to the rest of the row instead
300
+ of re-flooring the whole read against current membership.
301
+
302
+ Retention position (#3510): a delivered notification is a record of a
303
+ message that was sent, not a live view of the project — so the row is
304
+ kept and its content is redacted, matching ``snippet``'s existing
305
+ behavior. Redacted values reuse shapes the client already handles:
306
+ ``subject``/``body`` blank to ``""`` (their normal non-null default), and
307
+ ``project`` becomes ``None`` — already the shape of an ADR-0663
308
+ account-scoped digest row with no single owning project. No schema
309
+ change, no new client-side branch.
310
+
311
+ Object references (#3674). ``mention.task_comment`` — a raw comment UUID
312
+ — is redacted to ``None`` on the same gate, as is ``task_id`` (in
313
+ :meth:`get_task_id`). The rest of the nested ``mention`` object is
314
+ deliberately KEPT. The dividing line is not which population is reading
315
+ (see below) but what the field *is*:
316
+
317
+ * **Redacted — opaque handles into the source project's content graph.**
318
+ ``task_id`` and ``mention.task_comment`` are UUIDs. They say nothing to
319
+ a human and exist only to be handed back to another endpoint, which is
320
+ precisely the residual-IDOR surface #3674 was filed on. Nobody who
321
+ fails this gate can spend one: ``TaskViewSet`` and the comment routes
322
+ floor on current membership. So redacting them removes an object
323
+ reference and zero capability.
324
+ * **Kept — the "you were pinged" signal, which is not a project-content
325
+ reference.** ``mentioner`` is the author's username/display name;
326
+ ``mentioned_user`` is null (group mention) or the recipient themselves
327
+ (``_resolve_mention_recipients`` keys a direct mention by its own
328
+ target); ``mentioned_group_key`` is a group the recipient belongs to —
329
+ that is *how* they were reached; ``scope`` is a 3-value enum. None of
330
+ these name a task, a project, or a comment. ``mention.id`` is kept with
331
+ them: it is a handle, but to an object no endpoint serves, and the one
332
+ pre-positioned read path (``MentionManager.visible_to``, for #476)
333
+ independently floors on live ``ProjectMembership`` rather than trusting
334
+ an id it was handed.
335
+
336
+ Why this does NOT need to distinguish the two populations that reach this
337
+ branch. ``_recipient_can_see_project`` is one predicate over two groups:
338
+ a member whose access was revoked, and a sibling-project member pinged
339
+ through a ``@program-*`` auto-group who was never a member of the source
340
+ project and was never intentionally denied (the #514 population). They
341
+ differ in intent, but they are identical in capability — both are gated
342
+ out of every endpoint a task or comment UUID could be spent at — and the
343
+ fields where their intents *would* diverge are exactly the ones kept
344
+ above. So the honest #514 promise, "the row still surfaces, they know
345
+ they were pinged", survives intact: a redacted mention row still renders
346
+ "Authoria mentioned @program-pms". What it loses is a deep link that was
347
+ already dead for that reader (the client short-circuits on
348
+ ``project === null`` before it ever reads ``task_id``). Widening the
349
+ redaction to ``mentioner``/``mentioned_group_key`` WOULD reverse #514 —
350
+ it would leave a row that says only "something happened" — and would
351
+ need a discriminator this row does not carry; that is not done here and
352
+ is not needed for the leak #3674 names.
353
+ """
354
+ data = super().to_representation(instance)
355
+ if not self._recipient_can_see_project(instance):
356
+ data["subject"] = ""
357
+ data["body"] = ""
358
+ data["project"] = None
359
+ mention = data.get("mention")
360
+ if mention is not None:
361
+ # Reuses a shape the client already handles: a mention row whose
362
+ # source comment was soft-deleted serializes with a null FK and a
363
+ # blank snippet, which is exactly what a redacted row now looks
364
+ # like. No schema change, no new client-side branch.
365
+ mention["task_comment"] = None
366
+ return data
367
+
368
+ def get_task_id(self, obj: Notification) -> str | None:
369
+ # Deliberately comment-only, not a docstring: drf-spectacular publishes a
370
+ # SerializerMethodField's docstring as the field `description` in
371
+ # docs/api/openapi.json, which would put this internal reasoning (and
372
+ # issue numbers) in the public contract.
373
+ #
374
+ # Redacted on the same membership predicate as `snippet` (#514) and
375
+ # `subject`/`body`/`project` (#3510) — see `to_representation` for why a
376
+ # raw task UUID goes while the mention's identity fields stay. Checked
377
+ # before the FK is read so a redacted row costs no attribute walk.
378
+ if not self._recipient_can_see_project(obj):
379
+ return None
380
+ # Event-sourced rows (#497/#861) carry a direct deep-link FK; mention
381
+ # rows resolve their task through the source comment. Prefer the explicit
382
+ # FK so the inbox row links to the affected task/milestone either way.
383
+ if obj.task_id is not None:
384
+ return str(obj.task_id)
385
+ mention = obj.mention
386
+ if mention is None or mention.task_comment is None:
387
+ return None
388
+ return str(mention.task_comment.task_id)
389
+
390
+ class Meta:
391
+ model = Notification
392
+ # event_type/subject/body are the event-sourced inbox payload (#639,
393
+ # #497, #861). They were inbox-invisible before — a mention row leaves
394
+ # them blank and renders from `snippet`; an event row has no mention, so
395
+ # without these fields the client could not show its title/preview and
396
+ # fell back to "mentioned you / comment unavailable".
397
+ fields = [
398
+ "id",
399
+ "recipient",
400
+ "mention",
401
+ "event_type",
402
+ "subject",
403
+ "body",
404
+ "project",
405
+ "is_read",
406
+ "is_archived",
407
+ "snoozed_until",
408
+ "category",
409
+ "created_at",
410
+ "read_at",
411
+ "snippet",
412
+ "task_id",
413
+ ]
414
+ read_only_fields = [
415
+ "id",
416
+ "recipient",
417
+ "mention",
418
+ "event_type",
419
+ "subject",
420
+ "body",
421
+ "project",
422
+ # snoozed_until is written by the dedicated snooze action, never PATCH.
423
+ "snoozed_until",
424
+ "category",
425
+ "created_at",
426
+ "read_at",
427
+ "snippet",
428
+ "task_id",
429
+ ]
430
+
431
+
432
+ class NotificationPreferenceSerializer(serializers.ModelSerializer[NotificationPreference]):
433
+ """Per-user (event_type, channel) toggle.
434
+
435
+ PATCH on the viewset only modifies `enabled` — event_type / channel /
436
+ user are immutable.
437
+ """
438
+
439
+ class Meta:
440
+ model = NotificationPreference
441
+ fields = ["id", "event_type", "channel", "enabled", "updated_at"]
442
+ read_only_fields = ["id", "event_type", "channel", "updated_at"]
443
+
444
+
445
+ # ---------------------------------------------------------------------------
446
+ # Project-scoped preferences (#522)
447
+ # ---------------------------------------------------------------------------
448
+
449
+
450
+ _VALID_EVENT_TYPES = {choice.value for choice in ProjectNotificationEventType}
451
+ _VALID_CHANNELS = {choice.value for choice in ProjectNotificationChannel}
452
+
453
+
454
+ #: The published shape of the notification matrix (#3364).
455
+ #:
456
+ #: A bare ``JSONField`` carries no schema hint, so drf-spectacular publishes it as
457
+ #: ``{}`` — "any JSON at all". That is not a small imprecision on this field: it is
458
+ #: the only thing ``PATCH .../notification-preferences/`` exists to write, and the
459
+ #: field below rejects every key outside the two enumerations with a 400. Declaring
460
+ #: the body while leaving its one field untyped would tell an integrator "send some
461
+ #: JSON" and 400 on every guess — the same gap #3364 closes one level up.
462
+ #:
463
+ #: Derived from the enums rather than restated, so a new event type or channel
464
+ #: reaches the published contract without a second edit that can be forgotten.
465
+ #:
466
+ #: ``propertyNames`` is JSON Schema, not OpenAPI 3.0 Schema Object — this project
467
+ #: publishes ``openapi: 3.0.3`` (see ``docs/api/openapi.json``), whose meta-schema
468
+ #: has no such keyword and rejects the whole object under ``additionalProperties``'
469
+ #: ``oneOf`` the moment it appears anywhere in the tree. The two enumerations are
470
+ #: small and closed, so each key is spelled out explicitly under ``properties``
471
+ #: instead, with ``additionalProperties: False`` doing the same "no unknown key"
472
+ #: rejection ``propertyNames`` would have — this is what "9×4 grid" means literally.
473
+ _PROJECT_NOTIFICATION_MATRIX_SCHEMA: dict[str, Any] = {
474
+ "type": "object",
475
+ "description": (
476
+ "Per-event, per-channel routing grid. Keys are event types; each value is "
477
+ "an object of channel to boolean. A PATCH may send a partial grid — the "
478
+ "supplied cells are merged onto the stored ones, so a single toggle need "
479
+ "not repost the whole matrix. Any key outside these two enumerations, or "
480
+ "any non-boolean leaf, is rejected with a 400."
481
+ ),
482
+ "properties": {
483
+ event_type: {
484
+ "type": "object",
485
+ "properties": {channel: {"type": "boolean"} for channel in sorted(_VALID_CHANNELS)},
486
+ "additionalProperties": False,
487
+ }
488
+ for event_type in sorted(_VALID_EVENT_TYPES)
489
+ },
490
+ "additionalProperties": False,
491
+ }
492
+
493
+
494
+ @extend_schema_field(_PROJECT_NOTIFICATION_MATRIX_SCHEMA)
495
+ class _ProjectNotificationMatrixField(serializers.JSONField):
496
+ """JSON matrix `{event_type: {channel: bool}}` with strict key validation.
497
+
498
+ Rejects unknown event types and channels at the serializer layer so a
499
+ typo in the client doesn't silently corrupt the stored matrix. Non-bool
500
+ leaves are also rejected — there is no "tri-state" toggle.
501
+ """
502
+
503
+ def to_internal_value(self, data: Any) -> dict[str, dict[str, bool]]:
504
+ value = super().to_internal_value(data)
505
+ if not isinstance(value, dict):
506
+ raise serializers.ValidationError("matrix must be a JSON object")
507
+ validated: dict[str, dict[str, bool]] = {}
508
+ for event_type, channels in value.items():
509
+ if event_type not in _VALID_EVENT_TYPES:
510
+ raise serializers.ValidationError(f"Unknown event_type: {event_type!r}")
511
+ if not isinstance(channels, dict):
512
+ raise serializers.ValidationError(
513
+ f"matrix[{event_type!r}] must be an object of channel→bool"
514
+ )
515
+ row: dict[str, bool] = {}
516
+ for channel, enabled in channels.items():
517
+ if channel not in _VALID_CHANNELS:
518
+ raise serializers.ValidationError(f"Unknown channel: {channel!r}")
519
+ if not isinstance(enabled, bool):
520
+ raise serializers.ValidationError(
521
+ f"matrix[{event_type!r}][{channel!r}] must be a boolean"
522
+ )
523
+ row[channel] = enabled
524
+ validated[event_type] = row
525
+ return validated
526
+
527
+
528
+ class ProjectNotificationPreferenceSerializer(
529
+ serializers.ModelSerializer[ProjectNotificationPreference]
530
+ ):
531
+ """Per-(project, user) notification preferences.
532
+
533
+ The full matrix and quiet-hours window are returned in one document; the
534
+ PATCH path merges the supplied matrix onto the stored one so a partial
535
+ toggle does not have to repost the full 9×4 grid.
536
+
537
+ On read, matrix is run through the forward-migration registry
538
+ (``schema_migrations.migrate_payload``, ADR-0086 / ADR-0204, #1916): a
539
+ stale stored payload is upgraded to the current shape before any client
540
+ sees it, mirroring ``BoardSavedViewSerializer``. The view layer's
541
+ ``_merge_matrix`` overlay still runs afterward (it also drops unknown
542
+ garbage keys, #675 — a distinct concern from the version upgrade), so this
543
+ is defense-in-depth for any caller that reads this serializer directly
544
+ rather than through ``ProjectNotificationPreferenceView``.
545
+ """
546
+
547
+ matrix = _ProjectNotificationMatrixField()
548
+ # The window is stored as a bare wall-clock range, so without these two the
549
+ # governed user cannot tell what "22:00" means (#3377). Workspace.timezone is
550
+ # itself member-readable (IsWorkspaceAdmin admits any role on safe methods), so
551
+ # this is not a disclosure question — it is that resolving the window client-side
552
+ # means re-implementing a four-tier chain across three models and keeping it in
553
+ # sync, and the winning *tier* is not derivable from the values at all. If
554
+ # GET /workspace/ is ever narrowed to IsWorkspaceAdminStrict (#1724), revisit
555
+ # whether these two should follow it; today they expose nothing new.
556
+ quiet_hours_timezone = serializers.SerializerMethodField()
557
+ quiet_hours_timezone_source = serializers.SerializerMethodField()
558
+
559
+ class Meta:
560
+ model = ProjectNotificationPreference
561
+ fields = [
562
+ "matrix",
563
+ "schema_version",
564
+ "paused",
565
+ "quiet_hours_enabled",
566
+ "quiet_hours_from",
567
+ "quiet_hours_until",
568
+ "quiet_hours_timezone",
569
+ "quiet_hours_timezone_source",
570
+ "updated_at",
571
+ ]
572
+ # quiet_hours_timezone* are SerializerMethodFields — inherently read-only, and
573
+ # DRF forbids naming a declared field here.
574
+ read_only_fields = ["schema_version", "updated_at"]
575
+
576
+ def _resolved_quiet_hours_tz(self, instance: ProjectNotificationPreference) -> tuple[str, str]:
577
+ """``(IANA name, tier)`` for this row's window, memoized per project.
578
+
579
+ Memoized because both method fields call it for the same row; keyed on the
580
+ project so a serializer instance reused across projects cannot report one
581
+ project's zone for another.
582
+
583
+ ``instance.project`` costs no query because the view primes the FK cache —
584
+ ``get_or_create`` populates ``fields_cache`` on its create branch but not on
585
+ the get branch, which is the common one.
586
+
587
+ The workspace tier is left to the resolver rather than pre-loaded into
588
+ ``context``. Pre-loading it would be wrong twice over on this endpoint: it
589
+ queries even when the project sets its own timezone and the chain never
590
+ reaches the workspace, and — because the natural pre-load is
591
+ ``Workspace.load()``, a get_or_create — a *read* of this endpoint on an
592
+ install with no singleton would create the row and then report
593
+ ``source="workspace"``, where the dispatcher (which never writes) would have
594
+ reported ``"server"``. The whole point of these fields is to say what dispatch
595
+ does. ``context["workspace"]`` is still honored for a caller that has one in
596
+ hand, matching ``projects.bulk_settings``.
597
+ """
598
+ from trueppm_api.apps.notifications.services import resolve_quiet_hours_timezone
599
+
600
+ cache: dict[Any, tuple[str, str]] = getattr(self, "_quiet_hours_tz_cache", {})
601
+ key = instance.project_id
602
+ if key not in cache:
603
+ zone, source = resolve_quiet_hours_timezone(
604
+ instance.project, workspace=self.context.get("workspace")
605
+ )
606
+ cache[key] = (zone.key, source)
607
+ self._quiet_hours_tz_cache = cache
608
+ return cache[key]
609
+
610
+ @extend_schema_field(serializers.CharField())
611
+ def get_quiet_hours_timezone(self, instance: ProjectNotificationPreference) -> str:
612
+ """IANA zone the stored ``quiet_hours_from``/``_until`` are interpreted in."""
613
+ return self._resolved_quiet_hours_tz(instance)[0]
614
+
615
+ @extend_schema_field(
616
+ serializers.ChoiceField(
617
+ choices=[
618
+ QUIET_HOURS_TZ_SOURCE_PROJECT,
619
+ QUIET_HOURS_TZ_SOURCE_WORKSPACE,
620
+ QUIET_HOURS_TZ_SOURCE_SERVER,
621
+ QUIET_HOURS_TZ_SOURCE_FALLBACK,
622
+ ]
623
+ )
624
+ )
625
+ def get_quiet_hours_timezone_source(self, instance: ProjectNotificationPreference) -> str:
626
+ """Which tier supplied it: ``project``, ``workspace``, ``server`` or ``fallback``.
627
+
628
+ Provenance, not decoration — ``project`` vs ``workspace`` is the difference
629
+ between "my project lead set this" and "the workspace admin did", and
630
+ ``fallback`` says the chain found nothing usable and landed on UTC.
631
+ """
632
+ return self._resolved_quiet_hours_tz(instance)[1]
633
+
634
+ def to_representation(self, instance: ProjectNotificationPreference) -> dict[str, Any]:
635
+ """Upgrade the stored matrix to the current shape on read.
636
+
637
+ The stored payload's version is the model's ``schema_version`` column
638
+ (rows predating the convention carry the migration default of 1 and
639
+ are already at the current 9-event shape, so the chain is a no-op for
640
+ them). Passing it explicitly keeps the column as the single source of
641
+ truth for "which shape is this" rather than sniffing the payload.
642
+ """
643
+ data = super().to_representation(instance)
644
+ matrix = data.get("matrix")
645
+ if isinstance(matrix, dict):
646
+ upgraded, version = migrate_payload(
647
+ SURFACE_PROJECT_NOTIFICATION_MATRIX,
648
+ matrix,
649
+ from_version=instance.schema_version,
650
+ )
651
+ # schema_version is exposed as a sibling metadata field, not mixed
652
+ # into the matrix event/channel grid — keep matrix the clean grid.
653
+ upgraded.pop("schema_version", None)
654
+ data["matrix"] = upgraded
655
+ data["schema_version"] = version
656
+ return data
657
+
658
+
659
+ #: The published shape of ``event_delivery`` (#3396, #3399).
660
+ #:
661
+ #: Enumerated key-by-key rather than left as ``additionalProperties: {type: boolean}``
662
+ #: because the key set is closed and derivable: it is exactly
663
+ #: :data:`PROJECT_NOTIFICATION_DELIVERY_REPORTED_EVENTS`, the same tuple
664
+ #: :func:`project_notification_event_delivery` iterates. Deriving it is the pin
665
+ #: #3399 asked for — the declaration cannot report a different set of events than
666
+ #: the classification does, because there is only one list. An open
667
+ #: ``additionalProperties`` map would have typed the *values* and said nothing about
668
+ #: which rows a client can expect, which is the half a client actually indexes into.
669
+ #:
670
+ #: The booleans themselves are deliberately NOT pinned to today's classification.
671
+ #: Which rows are wired is runtime state that moves as dispatchers land
672
+ #: (TODO(#3016)); baking ``comment_mention: true`` into the schema would turn the
673
+ #: contract into a lie on the day the second dispatcher ships.
674
+ #:
675
+ #: ``propertyNames`` is JSON Schema and not OpenAPI 3.0 — see
676
+ #: :data:`_PROJECT_NOTIFICATION_MATRIX_SCHEMA` for why this project cannot use it.
677
+ _PROJECT_NOTIFICATION_EVENT_DELIVERY_SCHEMA: dict[str, Any] = {
678
+ "type": "object",
679
+ "description": (
680
+ "Which matrix rows are wired to a delivery path. `true` means toggling that "
681
+ "event's channels changes what gets delivered; `false` means the row is "
682
+ "rendered and stored but nothing dispatches it yet, so a client should label "
683
+ "it rather than imply a delivery that never happens. Reported as a server "
684
+ "fact so every client does not hard-code the same list and drift from it."
685
+ ),
686
+ "properties": {
687
+ event_type: {"type": "boolean"}
688
+ for event_type in PROJECT_NOTIFICATION_DELIVERY_REPORTED_EVENTS
689
+ },
690
+ "required": list(PROJECT_NOTIFICATION_DELIVERY_REPORTED_EVENTS),
691
+ "additionalProperties": False,
692
+ }
693
+
694
+
695
+ #: The published shape of ``channel_delivery`` (#3378).
696
+ #:
697
+ #: Same construction and the same reasoning as
698
+ #: :data:`_PROJECT_NOTIFICATION_EVENT_DELIVERY_SCHEMA` one axis over: the key set is
699
+ #: closed and derivable — it is exactly
700
+ #: :data:`PROJECT_NOTIFICATION_DELIVERY_REPORTED_CHANNELS`, the tuple
701
+ #: :func:`project_notification_channel_delivery` iterates — so the declaration
702
+ #: cannot report a different set of channels than the matrix renders.
703
+ #:
704
+ #: The booleans are again NOT pinned to today's answer. Which channels deliver is
705
+ #: runtime state that moves when an ADR-0049 ``NOTIFICATION_CHANNELS`` registration
706
+ #: lands (TODO(#3252)); baking ``slack: false`` into the schema would turn the
707
+ #: contract into a lie on the day one does.
708
+ _PROJECT_NOTIFICATION_CHANNEL_DELIVERY_SCHEMA: dict[str, Any] = {
709
+ "type": "object",
710
+ "description": (
711
+ "Which matrix columns TruePPM has a delivery path for. `true` means an "
712
+ "enabled cell in that column can reach you once its event is also "
713
+ "dispatched; `false` means the "
714
+ "column is rendered and the preference stored, but nothing delivers on it "
715
+ "yet and no setting anywhere turns it on, so a client should label it "
716
+ "rather than imply a delivery that never happens. Orthogonal to "
717
+ "`event_delivery`: a cell is live only when its event is dispatched AND "
718
+ "its channel delivers. Server-global — it does not vary by user or project, "
719
+ "and rides on this per-user document only so a client can label the whole "
720
+ "grid in one render. Reported as a server fact so every client does not "
721
+ "hard-code the same list and drift from it."
722
+ ),
723
+ "properties": {
724
+ channel: {"type": "boolean"} for channel in PROJECT_NOTIFICATION_DELIVERY_REPORTED_CHANNELS
725
+ },
726
+ "required": list(PROJECT_NOTIFICATION_DELIVERY_REPORTED_CHANNELS),
727
+ "additionalProperties": False,
728
+ }
729
+
730
+
731
+ class ProjectNotificationPreferenceDocumentSerializer(ProjectNotificationPreferenceSerializer):
732
+ """What ``GET``/``PATCH .../notification-preferences/`` actually returns (#3396, #3399).
733
+
734
+ The stored row's fields **plus** ``event_delivery`` and ``channel_delivery``,
735
+ which the view adds on both methods and which are not model fields. Declaring
736
+ the plain serializer as the ``200`` would have been the obvious fix and a worse
737
+ one: the schema would be self-consistent, ``api:schema-drift`` would pass, and a
738
+ generated SDK would silently drop the two keys a client needs to label the rows
739
+ nothing dispatches and the columns nothing delivers on. A declared lie is more
740
+ dangerous than a declared absence.
741
+
742
+ Subclasses rather than restating the field list, so a field added to the parent
743
+ reaches the published response without a second edit. Only the two delivery maps
744
+ are named here, because only they are the difference.
745
+ """
746
+
747
+ event_delivery = serializers.SerializerMethodField()
748
+ channel_delivery = serializers.SerializerMethodField()
749
+
750
+ class Meta(ProjectNotificationPreferenceSerializer.Meta):
751
+ fields = [
752
+ *ProjectNotificationPreferenceSerializer.Meta.fields,
753
+ "event_delivery",
754
+ "channel_delivery",
755
+ ]
756
+
757
+ @extend_schema_field(_PROJECT_NOTIFICATION_EVENT_DELIVERY_SCHEMA)
758
+ def get_event_delivery(self, instance: ProjectNotificationPreference) -> dict[str, bool]:
759
+ """Row-independent: it reports server wiring, not this user's preferences."""
760
+ return project_notification_event_delivery()
761
+
762
+ @extend_schema_field(_PROJECT_NOTIFICATION_CHANNEL_DELIVERY_SCHEMA)
763
+ def get_channel_delivery(self, instance: ProjectNotificationPreference) -> dict[str, bool]:
764
+ """Column-independent, and row-independent: it reports which channels the
765
+ server delivers on at all, not anything about this user or project."""
766
+ return project_notification_channel_delivery()
767
+
768
+
769
+ class UserNotificationSettingsSerializer(serializers.ModelSerializer[UserNotificationSettings]):
770
+ """Account-wide notification settings (#1707, ADR-0292; digest slot ADR-0663).
771
+
772
+ ``dnd_enabled`` plus the weekly digest slot (``digest_weekday`` /
773
+ ``digest_hour`` / ``digest_timezone``) are writable; ``updated_at`` is
774
+ read-only. The endpoint is self-scoped (the row is always the caller's own), so
775
+ there is no ``user`` field to expose or spoof.
776
+
777
+ The slot fields are range- and tz-validated rather than clamped: a bad value
778
+ must surface as a 400 the user can act on. Silently coercing hour 25 to 23
779
+ would leave someone waiting for a digest that arrives at the wrong time with no
780
+ indication anything was wrong.
781
+ """
782
+
783
+ class Meta:
784
+ model = UserNotificationSettings
785
+ fields = [
786
+ "dnd_enabled",
787
+ "digest_weekday",
788
+ "digest_hour",
789
+ "digest_timezone",
790
+ "updated_at",
791
+ ]
792
+ read_only_fields = ["updated_at"]
793
+
794
+ def validate_digest_weekday(self, value: int) -> int:
795
+ """0=Monday .. 6=Sunday, matching Python's ``date.weekday()``."""
796
+ if not 0 <= value <= 6:
797
+ raise serializers.ValidationError("Must be between 0 (Monday) and 6 (Sunday).")
798
+ return value
799
+
800
+ def validate_digest_hour(self, value: int) -> int:
801
+ """Local hour of day, 0-23."""
802
+ if not 0 <= value <= 23:
803
+ raise serializers.ValidationError("Must be between 0 and 23.")
804
+ return value
805
+
806
+ def validate_digest_timezone(self, value: str) -> str:
807
+ """An IANA key, or blank to use the server timezone.
808
+
809
+ Validated against the running interpreter's tz database so a typo is a 400
810
+ at save time rather than a digest that silently never fires.
811
+ """
812
+ if value and value not in zoneinfo.available_timezones():
813
+ raise serializers.ValidationError(f"Unknown timezone: {value!r}")
814
+ return value
815
+
816
+
817
+ class WorkspaceEmailSettingsSerializer(serializers.ModelSerializer[WorkspaceEmailSettings]):
818
+ """Read/write serializer for the workspace SMTP singleton (#712, ADR-0213).
819
+
820
+ The password is **write-only** and never echoed — the response carries only
821
+ ``password_is_set``. On update, an omitted/blank ``password`` keeps the
822
+ stored secret (rotate-vs-keep); a non-empty value replaces it. The
823
+ validate-before-persist probe opens the candidate transport before ``save``
824
+ so a bad configuration cannot lock the workspace out of mail. All admin-
825
+ supplied network/header inputs are validated against SSRF and header
826
+ injection (security review H1/M2/M3).
827
+ """
828
+
829
+ # Write-only credential. required=False so other fields can be edited
830
+ # without re-submitting it; allow_blank so "" explicitly means "keep".
831
+ password = serializers.CharField(
832
+ write_only=True,
833
+ required=False,
834
+ allow_blank=True,
835
+ max_length=4096,
836
+ trim_whitespace=False,
837
+ style={"input_type": "password"},
838
+ )
839
+ password_is_set = serializers.BooleanField(read_only=True)
840
+
841
+ # Rows one drain tick may claim (#2860 rebound this from "addresses per message",
842
+ # which nothing implemented). The drain caps every tick at EMAIL_MAX_BATCH_SIZE
843
+ # regardless, because a tick runs under a 25 s soft time limit — so a larger value
844
+ # was accepted, persisted, echoed back and then silently discarded (#2887 item 2).
845
+ # Rejecting it out loud is the whole point: a control that reports a value it does
846
+ # not apply is the dead-control failure mode wearing a different hat. ``0`` means
847
+ # "no explicit cap" and falls back to EMAIL_MAX_BATCH_SIZE, which is why min_value
848
+ # is 0 rather than 1.
849
+ max_recipients = serializers.IntegerField(
850
+ required=False,
851
+ min_value=0,
852
+ max_value=EMAIL_MAX_BATCH_SIZE,
853
+ help_text=(
854
+ f"Queued emails one drain tick sends, 1-{EMAIL_MAX_BATCH_SIZE}. "
855
+ f"0 means no explicit cap ({EMAIL_MAX_BATCH_SIZE} per tick)."
856
+ ),
857
+ )
858
+
859
+ class Meta:
860
+ model = WorkspaceEmailSettings
861
+ fields = [
862
+ "transport_mode",
863
+ "host",
864
+ "port",
865
+ "security",
866
+ "username",
867
+ "password",
868
+ "password_is_set",
869
+ "from_name",
870
+ "from_email",
871
+ "reply_to",
872
+ "dkim_selector",
873
+ "max_recipients",
874
+ "throttle_per_min",
875
+ "updated_at",
876
+ ]
877
+ read_only_fields = ["updated_at"]
878
+
879
+ # -- field-level validation ------------------------------------------------
880
+
881
+ def validate_port(self, value: int) -> int:
882
+ if not (1 <= value <= 65535):
883
+ raise serializers.ValidationError("Port must be between 1 and 65535.")
884
+ return value
885
+
886
+ def validate_from_name(self, value: str) -> str:
887
+ # Header-injection guard: a CRLF in the From display name could inject
888
+ # extra headers. Django's sanitizer catches raw CRLF, but reject here
889
+ # for a clear message (security review M3).
890
+ if "\r" in value or "\n" in value:
891
+ raise serializers.ValidationError("From name must not contain line breaks.")
892
+ return value
893
+
894
+ def validate_dkim_selector(self, value: str) -> str:
895
+ if value and not _DKIM_SELECTOR_RE.match(value):
896
+ raise serializers.ValidationError(
897
+ "DKIM selector may contain only letters, digits, '.', '_', and '-'."
898
+ )
899
+ return value
900
+
901
+ # -- object-level validation + persist ------------------------------------
902
+
903
+ def validate(self, attrs: dict[str, Any]) -> dict[str, Any]:
904
+ instance = self.instance
905
+ # Bound rather than nested: a closure's own branching is charged to its
906
+ # enclosing function, and a module-level resolver is testable alone.
907
+ eff = partial(_effective, attrs, instance)
908
+
909
+ mode = eff("transport_mode", EmailTransportMode.CLOUD)
910
+ if mode == EmailTransportMode.CLOUD:
911
+ # Nothing to probe — fall back to the global backend at send time.
912
+ return attrs
913
+
914
+ host = (eff("host") or "").strip()
915
+ port = eff("port", 587)
916
+ security = eff("security", EmailSecurity.TLS)
917
+ username = (eff("username") or "").strip()
918
+
919
+ incoming_pw = attrs.get("password", "")
920
+ stored_pw = instance.get_password() if instance is not None else ""
921
+ mode_changed = instance is not None and instance.transport_mode != mode
922
+
923
+ effective_pw = incoming_pw or stored_pw
924
+ _assert_transport_fields(
925
+ mode=mode,
926
+ host=host,
927
+ username=username,
928
+ effective_pw=effective_pw,
929
+ needs_fresh_password=mode_changed and not incoming_pw,
930
+ )
931
+ _probe_or_raise(
932
+ mode=mode,
933
+ host=host,
934
+ port=port,
935
+ security=security,
936
+ username=username,
937
+ password=effective_pw,
938
+ )
939
+
940
+ return attrs
941
+
942
+ def update(
943
+ self, instance: WorkspaceEmailSettings, validated_data: dict[str, Any]
944
+ ) -> WorkspaceEmailSettings:
945
+ password = validated_data.pop("password", None)
946
+ for field, value in validated_data.items():
947
+ setattr(instance, field, value)
948
+ # Rotate only when a non-empty password was submitted; blank keeps the
949
+ # stored ciphertext untouched (never overwrite with b"").
950
+ if password:
951
+ # This is a third-party SMTP relay credential (Fernet-encrypted at
952
+ # rest), not a Django auth password — validate_password() enforces
953
+ # user-account policy (min length, common-password blocklist) that is
954
+ # meaningless for a provider-issued secret the operator cannot change.
955
+ # nosemgrep: unvalidated-password
956
+ instance.set_password(password)
957
+ request = self.context.get("request")
958
+ if request is not None and getattr(request, "user", None) is not None:
959
+ instance.updated_by = request.user
960
+ instance.save()
961
+ return instance