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,105 @@
1
+ """Pure builder for the S3 / MinIO attachment-storage options (#2559).
2
+
3
+ Deliberately free of any Django import, for the same reason as
4
+ ``core.valkey_config``: ``settings/base.py`` needs :func:`build_s3_storage_options`
5
+ at module import time, and it must not drag the check registry in while settings
6
+ are still being read.
7
+
8
+ Why this exists at all: django-storages' ``S3Storage`` reads its bucket from
9
+ *Django settings*, not the environment, so setting
10
+ ``TRUEPPM_DEFAULT_FILE_STORAGE=storages.backends.s3.S3Storage`` — the value all
11
+ four operator-facing surfaces recommend — was necessary but never sufficient. The
12
+ backend instantiated fine and then failed on the first upload with a bare
13
+ ``ValueError: Required parameter name not set``. This module maps
14
+ ``TRUEPPM_S3_*`` env vars onto the ``STORAGES['default']['OPTIONS']`` dict that
15
+ django-storages 1.14+ accepts.
16
+ """
17
+
18
+ from __future__ import annotations
19
+
20
+ from collections.abc import Mapping
21
+ from typing import Any
22
+
23
+ #: Backends that take the S3 option set below. The legacy ``S3Boto3Storage`` alias
24
+ #: is included because django-storages still ships it and older operator runbooks
25
+ #: name it. Mirrored by ``core.security_checks._S3_FAMILY_BACKENDS``.
26
+ S3_STORAGE_BACKENDS = frozenset(
27
+ {
28
+ "storages.backends.s3.S3Storage",
29
+ "storages.backends.s3boto3.S3Boto3Storage",
30
+ }
31
+ )
32
+
33
+ #: SigV4 is not botocore's default once an ``endpoint_url`` is supplied — it falls
34
+ #: back to the deprecated SigV2 (``?AWSAccessKeyId=…&Signature=…``), which AWS
35
+ #: rejects in every region created after 2014. Defaulting it forward is what makes
36
+ #: the ``signed-url`` action hand out a real ``X-Amz-Expires`` URL rather than a
37
+ #: SigV2 one, so the promise in ``storage_backend_supports_signed_urls`` holds.
38
+ DEFAULT_SIGNATURE_VERSION = "s3v4"
39
+
40
+ #: Region must be concrete for SigV4: the signature embeds it in the credential
41
+ #: scope, so an empty region yields an unusable signature even against MinIO.
42
+ DEFAULT_REGION_NAME = "us-east-1"
43
+
44
+ #: Presigned-URL lifetime, in seconds, for TaskAttachmentViewSet.signed_url.
45
+ DEFAULT_QUERYSTRING_EXPIRE = 900
46
+
47
+
48
+ def _int_or_default(raw: str, default: int) -> int:
49
+ """Coerce an env value to int, falling back rather than crashing the boot.
50
+
51
+ A malformed expiry is not worth refusing to start over — the default is safe,
52
+ and the alternative is an operator locked out of their own deploy by a typo in
53
+ a tuning knob.
54
+ """
55
+ try:
56
+ return int(raw)
57
+ except ValueError:
58
+ return default
59
+
60
+
61
+ def build_s3_storage_options(environ: Mapping[str, str]) -> dict[str, Any]:
62
+ """Build ``STORAGES['default']['OPTIONS']`` for an S3-family backend.
63
+
64
+ Only the keys the operator actually set are emitted for the optional knobs:
65
+ passing ``endpoint_url=""`` would stop boto3 resolving the real AWS endpoint,
66
+ and passing empty credentials would defeat its resolution chain (IRSA, IAM
67
+ instance profile, ``~/.aws``) — which is how a well-run EKS deploy should
68
+ authenticate. ``bucket_name`` is always emitted, even empty, so the deploy
69
+ check in ``core.security_checks`` can report it as missing with a message that
70
+ names the env var.
71
+ """
72
+ options: dict[str, Any] = {
73
+ "bucket_name": environ.get("TRUEPPM_S3_BUCKET_NAME", ""),
74
+ "region_name": environ.get("TRUEPPM_S3_REGION_NAME") or DEFAULT_REGION_NAME,
75
+ "signature_version": (
76
+ environ.get("TRUEPPM_S3_SIGNATURE_VERSION") or DEFAULT_SIGNATURE_VERSION
77
+ ),
78
+ "querystring_expire": _int_or_default(
79
+ environ.get("TRUEPPM_S3_QUERYSTRING_EXPIRE", ""),
80
+ DEFAULT_QUERYSTRING_EXPIRE,
81
+ ),
82
+ # django-storages defaults file_overwrite=True, which silently REPLACES the
83
+ # object already at that key. TaskAttachment keys derive from user-supplied
84
+ # filenames, so two people uploading `report.pdf` to one task would destroy
85
+ # the first attachment. FileSystemStorage suffixes instead of overwriting;
86
+ # match it, so choosing a storage backend is not also choosing data loss.
87
+ "file_overwrite": False,
88
+ # Never attach a canned public ACL. Attachments are project-scoped and
89
+ # reached only through a presigned URL.
90
+ "default_acl": None,
91
+ }
92
+
93
+ # Non-AWS S3-compatible endpoint (MinIO, Ceph RGW, Cloudflare R2, Wasabi).
94
+ if endpoint := environ.get("TRUEPPM_S3_ENDPOINT_URL", ""):
95
+ options["endpoint_url"] = endpoint
96
+ # MinIO and Ceph need path-style addressing; AWS prefers virtual-hosted, and
97
+ # boto3's own "auto" default already gets AWS right — so only override on ask.
98
+ if addressing := environ.get("TRUEPPM_S3_ADDRESSING_STYLE", ""):
99
+ options["addressing_style"] = addressing
100
+ if access_key := environ.get("TRUEPPM_S3_ACCESS_KEY_ID", ""):
101
+ options["access_key"] = access_key
102
+ if secret_key := environ.get("TRUEPPM_S3_SECRET_ACCESS_KEY", ""):
103
+ options["secret_key"] = secret_key
104
+
105
+ return options
@@ -0,0 +1,168 @@
1
+ """The one decoder for uploaded delimited-text files (#2892, #2937).
2
+
3
+ Decoding an upload is not "call ``.decode()``". The hazard is that the useful
4
+ fallback codecs — cp1252 and latin-1 — map almost every byte, so a *wrong* guess
5
+ **succeeds** and yields mojibake instead of an error. UTF-16 read as cp1252
6
+ becomes NUL-interleaved text; because header matching strips non-alphanumerics
7
+ before comparing, that mojibake still matched its aliases at
8
+ ``confidence="exact"`` and the import wizard rendered a fully-green mapping over
9
+ a file it had comprehensively misread (#2892).
10
+
11
+ Strict UTF-8 is not the fix either, and looks like one. ``raw.decode("utf-8-sig")``
12
+ reads as fail-closed and is, for a *BOM'd* UTF-16 file — ``\\xff\\xfe`` is invalid
13
+ UTF-8, so it raises. But **NUL is a valid UTF-8 code point**, so a BOM-*less*
14
+ UTF-16 stream decodes without raising, straight into mojibake. That was
15
+ ``risk_import._decode`` for its whole life (#2937): the same class as #2892, at a
16
+ fourth site, in a second app, three months after the first fix.
17
+
18
+ Which is the reason this module exists rather than a second copy of the guard.
19
+ #2892 fixed one importer and left the logic private to it; #2937 is what that
20
+ costs. ``tests/test_uploaded_text_decode_sites.py`` now enforces the boundary:
21
+ no module in ``apps/`` that imports ``csv`` may call ``.decode(`` itself.
22
+
23
+ The strategy, in order:
24
+
25
+ 1. **A byte-order mark wins outright.** It is the one piece of encoding evidence
26
+ that is not a guess.
27
+ 2. **Otherwise walk the ladder**, strict codecs first.
28
+ 3. **Then check the output**, because steps 1–2 can succeed and still be wrong.
29
+ A refusal names the fix; mojibake names nothing.
30
+
31
+ Callers translate :class:`TextDecodeError` into their own domain exception so
32
+ their existing messages and 400 responses are unchanged.
33
+ """
34
+
35
+ from __future__ import annotations
36
+
37
+ import codecs
38
+
39
+
40
+ class TextDecodeError(Exception):
41
+ """An upload could not be read as delimited text, or decoded wrong."""
42
+
43
+
44
+ #: Advice appended to every decode refusal. Named once so both importers, the
45
+ #: wizard, the tests, and the docs quote the same sentence.
46
+ ENCODING_ADVICE = "Re-save the file as UTF-8 CSV (in Excel: File → Save As → CSV UTF-8)."
47
+
48
+ #: Text encodings tried in order when the upload carries no byte-order mark.
49
+ #: utf-8-sig first so a BOM written by Excel is consumed rather than becoming part
50
+ #: of the first header ("Name"). cp1252 and latin-1 are lossy fallbacks: they
51
+ #: map almost every byte and therefore never raise, so a wrong guess reaching them
52
+ #: produces mojibake rather than an error. ``_reject_undecodable`` is what stops
53
+ #: that (#2892).
54
+ _ENCODINGS = ("utf-8-sig", "utf-8", "cp1252", "latin-1")
55
+
56
+ #: Byte-order marks mapped to the codec that consumes them, longest mark first.
57
+ #:
58
+ #: Order is load-bearing, not cosmetic: ``BOM_UTF32_LE`` is ``BOM_UTF16_LE``
59
+ #: followed by two NUL bytes, so testing the 2-byte UTF-16 mark first would
60
+ #: classify every UTF-32 file as UTF-16. The named codecs ("utf-16", "utf-32")
61
+ #: rather than the endian-specific ones are deliberate — they consume the mark,
62
+ #: which the ``-le``/``-be`` variants leave in the text as U+FEFF.
63
+ _BOM_ENCODINGS: tuple[tuple[bytes, str], ...] = (
64
+ (codecs.BOM_UTF32_LE, "utf-32"),
65
+ (codecs.BOM_UTF32_BE, "utf-32"),
66
+ (codecs.BOM_UTF8, "utf-8-sig"),
67
+ (codecs.BOM_UTF16_LE, "utf-16"),
68
+ (codecs.BOM_UTF16_BE, "utf-16"),
69
+ )
70
+
71
+ #: How much of a decoded upload the undecodable-text guard inspects. The check is
72
+ #: a ratio over a prefix rather than the whole string so its cost is constant for
73
+ #: a 100 MB workbook; a decode wrong enough to matter is wrong from byte one.
74
+ _DECODE_SAMPLE_CHARS = 65_536
75
+
76
+ #: Share of control characters (excluding tab / CR / LF) above which a decode is
77
+ #: treated as failed rather than merely odd. A real spreadsheet export carries
78
+ #: essentially none; anything at this level means the bytes were run through the
79
+ #: wrong codec.
80
+ _MAX_NON_PRINTABLE_RATIO = 0.2
81
+
82
+
83
+ def _encoding_from_bom(content: bytes) -> str | None:
84
+ """Name the codec a leading byte-order mark declares, or ``None``.
85
+
86
+ A BOM is the one piece of encoding evidence that is not a guess, so it wins
87
+ outright over the ``_ENCODINGS`` ladder — which cannot be trusted to reach the
88
+ right answer, because its lossy tail decodes anything.
89
+ """
90
+ for bom, encoding in _BOM_ENCODINGS:
91
+ if content.startswith(bom):
92
+ return encoding
93
+ return None
94
+
95
+
96
+ def _reject_undecodable(text: str) -> None:
97
+ """Refuse text that decoded without raising but plainly decoded wrong.
98
+
99
+ The hazard the ``_ENCODINGS`` ladder creates is not a missing codec — it is
100
+ that cp1252 and latin-1 map nearly every byte, so a wrong guess *succeeds*.
101
+
102
+ So the guard is on the *output*: a spreadsheet export contains no NUL and
103
+ essentially no other control characters, and either signal means the bytes
104
+ went through the wrong codec. Raising here is strictly better than importing
105
+ the mojibake, because a refusal names the fix and mojibake names nothing.
106
+
107
+ Raises:
108
+ TextDecodeError: The decoded text cannot be spreadsheet text.
109
+ """
110
+ sample = text[:_DECODE_SAMPLE_CHARS]
111
+ if "\x00" in sample:
112
+ raise TextDecodeError(
113
+ "The file could not be read as text — the decoded content contains NUL "
114
+ "bytes, which means it is not in the encoding it appears to be (a "
115
+ f"UTF-16 file saved without a byte-order mark does this). {ENCODING_ADVICE}"
116
+ )
117
+ if not sample:
118
+ return
119
+ # Tab, CR and LF are structural in delimited text; every other control
120
+ # character is evidence of a bad decode.
121
+ non_printable = sum(1 for ch in sample if ch < " " and ch not in "\t\r\n")
122
+ if non_printable / len(sample) > _MAX_NON_PRINTABLE_RATIO:
123
+ raise TextDecodeError(
124
+ "The file could not be read as text — most of it is not readable "
125
+ "characters, so it is either binary or in an unexpected encoding. "
126
+ f"{ENCODING_ADVICE}"
127
+ )
128
+
129
+
130
+ def decode_uploaded_text(content: bytes) -> str:
131
+ """Decode an uploaded delimited-text file, refusing a decode that went wrong.
132
+
133
+ Args:
134
+ content: The raw uploaded bytes, exactly as received.
135
+
136
+ Returns:
137
+ The decoded text.
138
+
139
+ Raises:
140
+ TextDecodeError: No codec produced usable spreadsheet text. Callers
141
+ translate this into their own domain exception; the message is
142
+ written to be shown to the uploader as-is and always names the fix.
143
+ """
144
+ bom_encoding = _encoding_from_bom(content)
145
+ if bom_encoding is not None:
146
+ try:
147
+ text = content.decode(bom_encoding)
148
+ except UnicodeDecodeError as exc:
149
+ raise TextDecodeError(
150
+ f"The file declares a {bom_encoding} byte-order mark but does not "
151
+ f"decode as {bom_encoding}. {ENCODING_ADVICE}"
152
+ ) from exc
153
+ _reject_undecodable(text)
154
+ return text
155
+
156
+ for encoding in _ENCODINGS:
157
+ try:
158
+ text = content.decode(encoding)
159
+ except UnicodeDecodeError:
160
+ continue
161
+ # Deliberately not "try the next codec": the remaining codecs are the
162
+ # lossy ones, and they produce the same mojibake from the same bytes.
163
+ # A failed decode has to become an error, not a quieter guess.
164
+ _reject_undecodable(text)
165
+ return text
166
+ # latin-1 maps every byte, so this is unreachable in practice; keep the
167
+ # explicit raise so a future edit to _ENCODINGS cannot silently return None.
168
+ raise TextDecodeError(f"Could not decode the file as text. {ENCODING_ADVICE}")
@@ -0,0 +1,344 @@
1
+ """Probe-exempt default throttles for the general API rate limit (#1080).
2
+
3
+ TruePPM installs a global ``DEFAULT_THROTTLE_CLASSES`` so every endpoint that
4
+ does not declare its own scoped throttle still gets a baseline anon/user rate
5
+ limit (bounded DoS / resource-starvation protection for self-hosters). The one
6
+ hazard a *global* throttle introduces is that it would also count the
7
+ unauthenticated Kubernetes probe endpoints — ``/api/v1/health/`` (liveness) and
8
+ ``/api/v1/edition/`` (the shell's startup edition read) — which orchestrators
9
+ hit on a tight loop. If those requests consumed the shared anon bucket, a busy
10
+ readiness loop could 429 the liveness probe and cause Kubernetes to restart a
11
+ perfectly healthy pod.
12
+
13
+ This is exactly why ``settings/base.py`` historically shipped *scoped throttles
14
+ only* and deliberately avoided a bare ``AnonRateThrottle``. The classes below
15
+ resolve that tension: they are the standard DRF anon/user throttles with a
16
+ single override — ``get_cache_key`` returns ``None`` (which DRF treats as "do
17
+ not throttle this request") for the probe paths — so the global default can be
18
+ turned on without ever rate-limiting a k8s probe.
19
+
20
+ ``/api/v1/readyz`` is deliberately **not** in that exempt set (#2820, #3346).
21
+ Unlike ``/health/`` and ``/edition/`` it is not free — every call does a real
22
+ database and cache round-trip — so a full exemption meant an unauthenticated
23
+ caller who reached the pod IP directly (the probe path bypasses the Ingress)
24
+ could drive unbounded database load with no rate limit at all. It gets its own
25
+ scoped throttle instead (``ReadyzRateThrottle`` below), generous enough that no
26
+ documented probe configuration comes close to tripping it.
27
+ """
28
+
29
+ from __future__ import annotations
30
+
31
+ import hashlib
32
+ from typing import TYPE_CHECKING, cast
33
+
34
+ from django.http import HttpRequest
35
+ from rest_framework.request import Request
36
+ from rest_framework.throttling import (
37
+ AnonRateThrottle,
38
+ SimpleRateThrottle,
39
+ UserRateThrottle,
40
+ )
41
+
42
+ if TYPE_CHECKING:
43
+ # Imported for type hints only. A runtime ``from rest_framework.views import
44
+ # APIView`` would be circular: DRF's ``APIView`` class body eagerly resolves
45
+ # ``DEFAULT_THROTTLE_CLASSES`` (→ this module) while ``rest_framework.views``
46
+ # is still initializing, before ``APIView`` itself is bound. ``from __future__
47
+ # import annotations`` keeps the annotations below as strings, so this import
48
+ # is never needed at runtime.
49
+ from rest_framework.views import APIView
50
+
51
+ # Kubernetes liveness and edition-discovery probes. Free to answer (no DB/cache
52
+ # round-trip) and hit on a tight orchestrator loop, so the general default
53
+ # throttle must never count them (returning None from get_cache_key skips
54
+ # throttling for the request). Stored trailing-slash-normalized so the check is
55
+ # robust whether or not the request path carries the trailing slash.
56
+ #
57
+ # ``/api/v1/readyz`` is NOT here — see ``ReadyzRateThrottle`` below (#2820,
58
+ # #3346): unlike these two it does real dependency round-trips, so it gets its
59
+ # own bounded scope instead of a blanket exemption.
60
+ _PROBE_EXEMPT_PATHS = frozenset(
61
+ path.rstrip("/") for path in ("/api/v1/health/", "/api/v1/edition/")
62
+ )
63
+
64
+
65
+ def _is_probe_path(request: Request) -> bool:
66
+ """Return True when the request targets an exempt k8s probe endpoint.
67
+
68
+ Matches on ``path_info`` (the path *without* any ``SCRIPT_NAME`` mount prefix)
69
+ so the exemption still fires when TruePPM is served under a sub-path — otherwise
70
+ a probe at ``/trueppm/api/v1/health/`` would carry the prefix in ``request.path``,
71
+ miss the exempt set, and get throttled: the exact failure this guards against.
72
+ """
73
+ return request.path_info.rstrip("/") in _PROBE_EXEMPT_PATHS
74
+
75
+
76
+ class ProbeExemptAnonRateThrottle(AnonRateThrottle):
77
+ """Anonymous default throttle that never counts the k8s probe endpoints.
78
+
79
+ Inherits the ``"anon"`` scope, so its rate comes from
80
+ ``DEFAULT_THROTTLE_RATES["anon"]``. Only the probe exemption is added; all
81
+ other requests are throttled exactly like the stock ``AnonRateThrottle``.
82
+ """
83
+
84
+ def get_cache_key(self, request: Request, view: APIView) -> str | None:
85
+ """Skip throttling for probe paths; otherwise defer to DRF's default.
86
+
87
+ Returning ``None`` tells DRF not to record or limit this request, which
88
+ keeps the tight-loop liveness/readiness probes off the shared anon
89
+ bucket (see module docstring).
90
+ """
91
+ if _is_probe_path(request):
92
+ return None
93
+ return super().get_cache_key(request, view)
94
+
95
+
96
+ class ConsumableRateThrottle(SimpleRateThrottle):
97
+ """A ``SimpleRateThrottle`` that can also be charged outside DRF's pipeline.
98
+
99
+ DRF throttles only run from ``APIView.check_throttles``, so a door that is not
100
+ a DRF view — the Django admin login (#3557) — cannot use one at all, and a
101
+ door that must charge a bucket it could not know about until *inside* the view
102
+ body — the email-identifier login retry (#3468) — cannot use one either.
103
+
104
+ :meth:`consume_key` is the shared primitive both need: record one attempt
105
+ against an explicit cache key and report the verdict, using the same window
106
+ arithmetic ``SimpleRateThrottle.allow_request`` uses, so a bucket charged this
107
+ way and a bucket charged by DRF are the same bucket with the same semantics.
108
+ """
109
+
110
+ @classmethod
111
+ def consume_key(cls, key: str) -> float | None:
112
+ """Record one attempt against ``key``'s bucket and report the verdict.
113
+
114
+ Returns ``None`` when the attempt was within the rate, or the number of
115
+ seconds to wait when the bucket was already at its limit.
116
+
117
+ Charging after the fact (rather than pre-emptively) matches how DRF
118
+ throttles work anyway — the Nth attempt is served and the N+1th refused.
119
+ """
120
+ throttle = cls()
121
+ if not throttle.rate:
122
+ # No rate configured for this scope — nothing to charge, nothing to refuse.
123
+ return None
124
+ throttle.key = key
125
+ throttle.now = throttle.timer()
126
+
127
+ # Evict entries that have aged out of the window before recording, exactly as
128
+ # ``SimpleRateThrottle.allow_request`` does. ``throttle_success`` refreshes the
129
+ # cache TTL on every write, so without this an entry could outlive the window
130
+ # it belongs to and over-throttle the account. ``duration`` is set in
131
+ # ``SimpleRateThrottle.__init__`` from ``parse_rate`` but is not declared on the
132
+ # class, so it carries no type for mypy --strict.
133
+ duration = cast("int", getattr(throttle, "duration", 0))
134
+ history: list[float] = list(throttle.cache.get(throttle.key, []))
135
+ while history and history[-1] <= throttle.now - duration:
136
+ history.pop()
137
+ throttle.history = history
138
+ # ``num_requests`` and ``duration`` are set in ``SimpleRateThrottle.__init__``
139
+ # from ``parse_rate`` but are not declared on the class, so they carry no type.
140
+ if len(history) >= cast("int", getattr(throttle, "num_requests", 0)):
141
+ # Already at the limit before this attempt. Report the wait and record
142
+ # nothing — DRF's own throttle_failure does not extend the window either,
143
+ # so a refused attempt must not push the bucket's expiry out.
144
+ return throttle.wait()
145
+ throttle.throttle_success()
146
+ return None
147
+
148
+
149
+ class LoginIpRateThrottle(ConsumableRateThrottle):
150
+ """The IP-keyed ``login`` bucket, chargeable from a non-DRF login door (#3557).
151
+
152
+ Deliberately the **same scope and the same cache key** as the
153
+ ``ScopedRateThrottle`` the API login runs under, not a parallel bucket of its
154
+ own. ``/api/v1/auth/token/`` and ``/admin/login/`` are two doors onto one
155
+ credential set, so an attacker who exhausts one must not find the other's
156
+ allowance untouched — a per-door bucket would hand them ``2 x`` the guesses
157
+ the ``login`` rate is written to permit. Sharing it also means an operator who
158
+ tunes the rate tunes both doors, with nothing to keep in sync.
159
+
160
+ The key derivation mirrors ``ScopedRateThrottle.get_cache_key`` exactly
161
+ (account pk when the request is already authenticated, client IP otherwise);
162
+ if the two ever drift the buckets silently stop being the same bucket, which
163
+ is why :meth:`cache_key_for_request` is the single place either spells it out.
164
+ """
165
+
166
+ scope = "login"
167
+
168
+ def get_cache_key(self, request: Request, view: APIView) -> str | None:
169
+ """Key on the account pk when authenticated, the client IP otherwise."""
170
+ return self.cache_key_for_request(request)
171
+
172
+ @classmethod
173
+ def cache_key_for_request(cls, request: HttpRequest | Request) -> str:
174
+ """Return the ``login``-scope bucket key for ``request``'s source.
175
+
176
+ Accepts a plain Django ``HttpRequest`` as well as a DRF ``Request``: it
177
+ reads only ``request.user`` and ``request.META``, both of which the
178
+ ``AuthenticationMiddleware`` has already populated on the admin login path.
179
+ """
180
+ throttle = cls()
181
+ user = getattr(request, "user", None)
182
+ # ``get_ident`` is annotated for a DRF ``Request`` but reads only ``META``
183
+ # (``HTTP_X_FORWARDED_FOR`` / ``REMOTE_ADDR``) plus the ``NUM_PROXIES``
184
+ # setting, so a plain ``HttpRequest`` satisfies it at runtime. Narrowing
185
+ # here rather than duplicating DRF's proxy-depth logic is what keeps the
186
+ # admin door's key byte-identical to the API login's.
187
+ ident = (
188
+ user.pk
189
+ if user is not None and user.is_authenticated
190
+ else throttle.get_ident(cast("Request", request))
191
+ )
192
+ return cls.cache_format % {"scope": cls.scope, "ident": ident}
193
+
194
+ @classmethod
195
+ def consume(cls, request: HttpRequest | Request) -> float | None:
196
+ """Charge one login attempt from ``request``'s source against the IP bucket."""
197
+ return cls.consume_key(cls.cache_key_for_request(request))
198
+
199
+
200
+ class LoginAccountRateThrottle(ConsumableRateThrottle):
201
+ """Per-*account* login throttle, keyed on the submitted username (#1717).
202
+
203
+ Why this exists alongside the IP-keyed ``login`` throttle:
204
+ The stock login throttle keys only on the client IP, so it caps guesses
205
+ *per source address*. A distributed credential-stuffing attack against a
206
+ single account rotates through a botnet / proxy pool, giving the attacker
207
+ the full per-IP allowance from every fresh IP — the aggregate guess rate
208
+ against that one account is unbounded even though no single IP trips the
209
+ limit. This throttle closes that gap by counting failed *and* successful
210
+ attempts against the same normalized username regardless of source IP, so
211
+ an account under distributed attack is locked out after the per-account
212
+ rate no matter how many IPs participate. It is *stacked* with (not a
213
+ replacement for) the IP throttle: both must pass, so IP-local flooding and
214
+ cross-IP account targeting are each bounded.
215
+
216
+ Privacy: the username is lowercased/trimmed and SHA-256 hashed before it goes
217
+ into the cache key, so the raw email/username is never persisted in the cache
218
+ backend (or leaked through a cache-key dump). Hashing is sufficient here — the
219
+ key only needs to be stable and collision-resistant, not reversible.
220
+
221
+ This is basic brute-force hardening (table-stakes self-hosting security), not
222
+ an org-wide enforced lockout *policy* with admin-configurable escalation /
223
+ unlock workflows — that governance layer is Enterprise.
224
+ """
225
+
226
+ scope = "login_account"
227
+
228
+ def get_cache_key(self, request: Request, view: APIView) -> str | None:
229
+ """Key the throttle on the hashed, normalized submitted username.
230
+
231
+ Returns ``None`` (skip this throttle) when no username is present so a
232
+ malformed request is not charged against an empty-string bucket — the IP
233
+ throttle still applies to those. Reading ``request.data`` here parses the
234
+ request body once (DRF caches it), which is safe inside ``check_throttles``.
235
+ """
236
+ # ``hasattr(request, "data")`` alone is insufficient: a non-object JSON body
237
+ # (list/str/scalar) makes ``request.data`` a non-dict with no ``.get``, which
238
+ # would raise AttributeError inside check_throttles → 500 before the login
239
+ # serializer ever runs (#2126). A non-object body carries no username, so
240
+ # treat it as "no username" → skip this throttle (the IP throttle still bites).
241
+ username = request.data.get("username") if isinstance(request.data, dict) else None
242
+ if not username:
243
+ return None
244
+ return self.cache_key_for(str(username))
245
+
246
+ @classmethod
247
+ def cache_key_for(cls, identifier: str) -> str:
248
+ """Return the bucket key for ``identifier``.
249
+
250
+ The single owner of this throttle's key derivation. ``get_cache_key`` and
251
+ ``charge`` must not each spell the hash out, or the two drift and the
252
+ canonical charge silently stops landing in the bucket ``get_cache_key``
253
+ reads.
254
+ """
255
+ ident = hashlib.sha256(identifier.strip().lower().encode("utf-8")).hexdigest()
256
+ return cls.cache_format % {"scope": cls.scope, "ident": ident}
257
+
258
+ @classmethod
259
+ def consume(cls, identifier: str) -> float | None:
260
+ """Record one attempt against ``identifier``'s bucket and report the verdict.
261
+
262
+ Returns ``None`` when the attempt was within the rate, or the number of
263
+ seconds to wait when the bucket was already at its limit.
264
+
265
+ Why this exists (#3468): the throttle runs in ``check_throttles``, *before*
266
+ the view body, so it can only ever key on the identifier as submitted. Once
267
+ one account answers to two identifiers (its username and its email), an
268
+ attacker gets two independent per-account buckets and the effective guess
269
+ allowance against that account doubles — which defeats exactly the cross-IP
270
+ protection #1717 added. Resolving the email inside ``get_cache_key`` would
271
+ put an unauthenticated, unindexed ``email__iexact`` query in front of *every*
272
+ login, so instead the login view calls this once it has resolved an email to
273
+ its canonical username.
274
+
275
+ **Recording is not enough, and the half-measure is the trap.** The username
276
+ bucket already accumulates every username-form attempt (DRF charges it in
277
+ ``allow_request``) and now every email-form attempt too, so it holds the true
278
+ total — but nothing *checks* it on the email path, and an attacker who spends
279
+ the username budget first then finds the email's own bucket empty and gets a
280
+ second full allowance. Only the email-first order would be capped, which is
281
+ worse than not fixing it at all: the protection looks complete and is
282
+ order-dependent. So this both records **and** reports, and the view refuses
283
+ on a ``None``-less return.
284
+
285
+ The residual is a narrow oracle and it is the right trade: an attacker who
286
+ already knows a username, and who spends that account's entire per-window
287
+ budget on it, can then learn whether a given address belongs to that same
288
+ account by whether they get a 429 rather than a 401. That leaks a mapping
289
+ between two identifiers of one already-known account, at one bit per window,
290
+ at the cost of the guesses they came for — against doubling the brute-force
291
+ budget on every targeted account, permanently.
292
+
293
+ Charging after the fact (rather than pre-emptively) matches how DRF throttles
294
+ work anyway — the Nth attempt is served and the N+1th is refused.
295
+ """
296
+ return cls.consume_key(cls.cache_key_for(identifier))
297
+
298
+
299
+ class ProbeExemptUserRateThrottle(UserRateThrottle):
300
+ """Authenticated default throttle that never counts the k8s probe endpoints.
301
+
302
+ Inherits the ``"user"`` scope, so its rate comes from
303
+ ``DEFAULT_THROTTLE_RATES["user"]``. Only the probe exemption is added; all
304
+ other requests are throttled exactly like the stock ``UserRateThrottle``.
305
+ """
306
+
307
+ def get_cache_key(self, request: Request, view: APIView) -> str | None:
308
+ """Skip throttling for probe paths; otherwise defer to DRF's default.
309
+
310
+ Returning ``None`` tells DRF not to record or limit this request, which
311
+ keeps the tight-loop liveness/readiness probes off the shared user
312
+ bucket (see module docstring).
313
+ """
314
+ if _is_probe_path(request):
315
+ return None
316
+ return super().get_cache_key(request, view)
317
+
318
+
319
+ class ReadyzRateThrottle(AnonRateThrottle):
320
+ """Dedicated, generous rate limit for the unauthenticated ``/readyz`` probe.
321
+
322
+ (#2820, #3346) ``/readyz`` must stay unauthenticated — kubelet carries no
323
+ credential — but it is not free the way ``/health/`` and ``/edition/`` are:
324
+ every call does a bounded database round-trip, a cache round-trip, and a
325
+ migration-state check. Before this it was fully exempt from the shared
326
+ throttle (see ``_PROBE_EXEMPT_PATHS``), which meant an unauthenticated
327
+ caller who reached the pod IP directly — the probe path bypasses the
328
+ Ingress entirely — could drive unbounded database load with no rate limit
329
+ of any kind.
330
+
331
+ A dedicated ``"readyz"`` scope rather than the shared ``"anon"`` bucket, on
332
+ purpose: kubelet's readiness/startup probes hit the pod IP directly from
333
+ the node, not through the Ingress, so their source IP is the node's, not an
334
+ end user's. Sharing "anon" would let a legitimate probe loop compete with
335
+ real anonymous traffic in both directions — draining the budget a genuine
336
+ anonymous client needs, or (with a generous enough rate to avoid that)
337
+ giving an attacker room under the anon scope they would not otherwise have.
338
+ The rate itself (``DEFAULT_THROTTLE_RATES["readyz"]``) is picked to clear
339
+ every documented probe configuration with room to spare — see
340
+ administration/probes.md for the numbers it assumes — while still bounding
341
+ an outright flood.
342
+ """
343
+
344
+ scope = "readyz"