trueppm-api 0.4.0b2__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- trueppm_api/__init__.py +14 -0
- trueppm_api/apps/access/__init__.py +0 -0
- trueppm_api/apps/access/apps.py +19 -0
- trueppm_api/apps/access/groups.py +518 -0
- trueppm_api/apps/access/management/__init__.py +0 -0
- trueppm_api/apps/access/management/commands/__init__.py +0 -0
- trueppm_api/apps/access/management/commands/create_admin.py +164 -0
- trueppm_api/apps/access/management/commands/migrate_locked.py +96 -0
- trueppm_api/apps/access/management/commands/revoke_api_tokens.py +209 -0
- trueppm_api/apps/access/migrations/0001_initial.py +61 -0
- trueppm_api/apps/access/migrations/0001_squashed_0012_programmembership_role_title.py +167 -0
- trueppm_api/apps/access/migrations/0002_alter_projectmembership_id.py +29 -0
- trueppm_api/apps/access/migrations/0003_projectmembership_soft_delete.py +24 -0
- trueppm_api/apps/access/migrations/0004_alter_projectmembership_role.py +34 -0
- trueppm_api/apps/access/migrations/0005_program_entity_and_membership.py +76 -0
- trueppm_api/apps/access/migrations/0006_role_ordinal_spacing.py +113 -0
- trueppm_api/apps/access/migrations/0007_projectmembership_joined_at_and_more.py +35 -0
- trueppm_api/apps/access/migrations/0008_projectmembership_source_group.py +25 -0
- trueppm_api/apps/access/migrations/0009_projectmembership_pm_proj_serverver_idx.py +20 -0
- trueppm_api/apps/access/migrations/0010_programmembership_joined_at_and_more.py +38 -0
- trueppm_api/apps/access/migrations/0011_alter_programmembership_unique_together_and_more.py +36 -0
- trueppm_api/apps/access/migrations/0012_programmembership_role_title.py +17 -0
- trueppm_api/apps/access/migrations/0013_userdefinedmentiongroup.py +82 -0
- trueppm_api/apps/access/migrations/0014_programmembership_progm_serverver_idx.py +19 -0
- trueppm_api/apps/access/migrations/0015_programuserdefinedmentiongroup.py +86 -0
- trueppm_api/apps/access/migrations/0016_externalstakeholder.py +67 -0
- trueppm_api/apps/access/migrations/0017_viewer_ordinal_one.py +132 -0
- trueppm_api/apps/access/migrations/0018_programmembership_sync_seq_and_more.py +52 -0
- trueppm_api/apps/access/migrations/0019_programmembership_reinstated_at_and_more.py +22 -0
- trueppm_api/apps/access/migrations/__init__.py +0 -0
- trueppm_api/apps/access/models.py +588 -0
- trueppm_api/apps/access/permissions.py +2837 -0
- trueppm_api/apps/access/serializers.py +946 -0
- trueppm_api/apps/access/services.py +667 -0
- trueppm_api/apps/access/signals.py +103 -0
- trueppm_api/apps/access/tasks.py +50 -0
- trueppm_api/apps/access/throttles.py +95 -0
- trueppm_api/apps/access/urls.py +191 -0
- trueppm_api/apps/access/views.py +1931 -0
- trueppm_api/apps/agents/__init__.py +6 -0
- trueppm_api/apps/agents/apps.py +11 -0
- trueppm_api/apps/agents/canonical.py +73 -0
- trueppm_api/apps/agents/deferred.py +108 -0
- trueppm_api/apps/agents/management/__init__.py +0 -0
- trueppm_api/apps/agents/management/commands/__init__.py +0 -0
- trueppm_api/apps/agents/management/commands/audit_prune.py +137 -0
- trueppm_api/apps/agents/management/commands/audit_verify.py +101 -0
- trueppm_api/apps/agents/middleware.py +44 -0
- trueppm_api/apps/agents/migrations/0001_initial.py +231 -0
- trueppm_api/apps/agents/migrations/0002_agentactioncheckpoint.py +71 -0
- trueppm_api/apps/agents/migrations/0003_agentactionrefusaldetail.py +58 -0
- trueppm_api/apps/agents/migrations/__init__.py +0 -0
- trueppm_api/apps/agents/models.py +371 -0
- trueppm_api/apps/agents/refusal.py +103 -0
- trueppm_api/apps/agents/serializers.py +85 -0
- trueppm_api/apps/agents/services.py +397 -0
- trueppm_api/apps/agents/signals.py +30 -0
- trueppm_api/apps/agents/urls.py +15 -0
- trueppm_api/apps/agents/views.py +108 -0
- trueppm_api/apps/csvimport/__init__.py +12 -0
- trueppm_api/apps/csvimport/apps.py +11 -0
- trueppm_api/apps/csvimport/mapping.py +363 -0
- trueppm_api/apps/csvimport/migrations/0001_initial.py +74 -0
- trueppm_api/apps/csvimport/migrations/0002_schedule_outline_batch_operations.py +37 -0
- trueppm_api/apps/csvimport/migrations/0003_csvimportrequest_date_order_and_more.py +26 -0
- trueppm_api/apps/csvimport/migrations/__init__.py +0 -0
- trueppm_api/apps/csvimport/models.py +111 -0
- trueppm_api/apps/csvimport/parser.py +1825 -0
- trueppm_api/apps/csvimport/services.py +48 -0
- trueppm_api/apps/csvimport/tasks.py +418 -0
- trueppm_api/apps/csvimport/template.py +37 -0
- trueppm_api/apps/csvimport/urls.py +50 -0
- trueppm_api/apps/csvimport/views.py +793 -0
- trueppm_api/apps/history/__init__.py +0 -0
- trueppm_api/apps/history/apps.py +12 -0
- trueppm_api/apps/history/changelog.py +359 -0
- trueppm_api/apps/history/diff_policy.py +177 -0
- trueppm_api/apps/history/serializers.py +104 -0
- trueppm_api/apps/history/signals.py +82 -0
- trueppm_api/apps/history/tasks.py +105 -0
- trueppm_api/apps/history/urls.py +38 -0
- trueppm_api/apps/history/views.py +443 -0
- trueppm_api/apps/idempotency/__init__.py +0 -0
- trueppm_api/apps/idempotency/apps.py +11 -0
- trueppm_api/apps/idempotency/migrations/0001_initial.py +71 -0
- trueppm_api/apps/idempotency/migrations/__init__.py +0 -0
- trueppm_api/apps/idempotency/mixins.py +226 -0
- trueppm_api/apps/idempotency/models.py +75 -0
- trueppm_api/apps/idempotency/tasks.py +61 -0
- trueppm_api/apps/integrations/__init__.py +13 -0
- trueppm_api/apps/integrations/apps.py +59 -0
- trueppm_api/apps/integrations/connections.py +806 -0
- trueppm_api/apps/integrations/encryption.py +92 -0
- trueppm_api/apps/integrations/external_sources.py +837 -0
- trueppm_api/apps/integrations/git_automation_services.py +231 -0
- trueppm_api/apps/integrations/git_webhook_auth.py +243 -0
- trueppm_api/apps/integrations/http.py +403 -0
- trueppm_api/apps/integrations/me_work.py +218 -0
- trueppm_api/apps/integrations/migrations/0001_initial.py +64 -0
- trueppm_api/apps/integrations/migrations/0001_squashed_0006_tasklink_description_tasklink_preview_type_and_more.py +187 -0
- trueppm_api/apps/integrations/migrations/0002_tasklink.py +67 -0
- trueppm_api/apps/integrations/migrations/0003_tasklink_tasklink_serverver_idx.py +17 -0
- trueppm_api/apps/integrations/migrations/0004_tasklink_custom_title_tasklink_labels.py +25 -0
- trueppm_api/apps/integrations/migrations/0005_boardautomation.py +56 -0
- trueppm_api/apps/integrations/migrations/0006_tasklink_description_tasklink_preview_type_and_more.py +40 -0
- trueppm_api/apps/integrations/migrations/0007_tasklink_created_at.py +23 -0
- trueppm_api/apps/integrations/migrations/0008_integrationcredential_config_externalworkitem.py +66 -0
- trueppm_api/apps/integrations/migrations/0009_externalsyncrequest_and_more.py +96 -0
- trueppm_api/apps/integrations/migrations/0010_externalworkitem_due_date.py +17 -0
- trueppm_api/apps/integrations/migrations/0011_tasklink_sync_seq_tasklink_tasklink_syncseq_idx.py +22 -0
- trueppm_api/apps/integrations/migrations/0012_boardautomation_last_delivery_at_and_more.py +42 -0
- trueppm_api/apps/integrations/migrations/0013_externalsyncrequest_attempt_count_and_more.py +26 -0
- trueppm_api/apps/integrations/migrations/__init__.py +0 -0
- trueppm_api/apps/integrations/models.py +622 -0
- trueppm_api/apps/integrations/notification_channels.py +57 -0
- trueppm_api/apps/integrations/opengraph.py +229 -0
- trueppm_api/apps/integrations/outgoing.py +201 -0
- trueppm_api/apps/integrations/providers.py +519 -0
- trueppm_api/apps/integrations/registry.py +345 -0
- trueppm_api/apps/integrations/serializers.py +453 -0
- trueppm_api/apps/integrations/services.py +171 -0
- trueppm_api/apps/integrations/tasks.py +731 -0
- trueppm_api/apps/integrations/throttles.py +165 -0
- trueppm_api/apps/integrations/urls.py +77 -0
- trueppm_api/apps/integrations/views.py +1106 -0
- trueppm_api/apps/jiraimport/__init__.py +8 -0
- trueppm_api/apps/jiraimport/apps.py +11 -0
- trueppm_api/apps/jiraimport/migrations/0001_initial.py +72 -0
- trueppm_api/apps/jiraimport/migrations/__init__.py +0 -0
- trueppm_api/apps/jiraimport/models.py +70 -0
- trueppm_api/apps/jiraimport/parser.py +350 -0
- trueppm_api/apps/jiraimport/services.py +46 -0
- trueppm_api/apps/jiraimport/tasks.py +277 -0
- trueppm_api/apps/jiraimport/urls.py +15 -0
- trueppm_api/apps/jiraimport/views.py +153 -0
- trueppm_api/apps/msproject/__init__.py +0 -0
- trueppm_api/apps/msproject/apps.py +11 -0
- trueppm_api/apps/msproject/dataclasses.py +153 -0
- trueppm_api/apps/msproject/exporter.py +500 -0
- trueppm_api/apps/msproject/extended_attributes.py +77 -0
- trueppm_api/apps/msproject/importer.py +1095 -0
- trueppm_api/apps/msproject/migrations/0001_import_request.py +77 -0
- trueppm_api/apps/msproject/migrations/0001_squashed_0002_importrequest_creates_project.py +80 -0
- trueppm_api/apps/msproject/migrations/0002_importrequest_creates_project.py +15 -0
- trueppm_api/apps/msproject/migrations/__init__.py +0 -0
- trueppm_api/apps/msproject/models.py +81 -0
- trueppm_api/apps/msproject/parser.py +1231 -0
- trueppm_api/apps/msproject/serializers.py +136 -0
- trueppm_api/apps/msproject/services.py +58 -0
- trueppm_api/apps/msproject/tasks.py +436 -0
- trueppm_api/apps/msproject/urls.py +39 -0
- trueppm_api/apps/msproject/views.py +531 -0
- trueppm_api/apps/notifications/__init__.py +7 -0
- trueppm_api/apps/notifications/apps.py +15 -0
- trueppm_api/apps/notifications/backfill.py +79 -0
- trueppm_api/apps/notifications/categories.py +112 -0
- trueppm_api/apps/notifications/delivery_limits.py +258 -0
- trueppm_api/apps/notifications/digests.py +447 -0
- trueppm_api/apps/notifications/email_backend.py +330 -0
- trueppm_api/apps/notifications/email_health.py +128 -0
- trueppm_api/apps/notifications/migrations/0001_initial.py +207 -0
- trueppm_api/apps/notifications/migrations/0001_squashed_0006_notification_task.py +294 -0
- trueppm_api/apps/notifications/migrations/0002_project_notification_preference.py +67 -0
- trueppm_api/apps/notifications/migrations/0003_projectnotificationpreference_paused.py +17 -0
- trueppm_api/apps/notifications/migrations/0004_clean_unknown_matrix_keys.py +30 -0
- trueppm_api/apps/notifications/migrations/0005_notification_body_notification_event_type_and_more.py +27 -0
- trueppm_api/apps/notifications/migrations/0006_notification_task.py +25 -0
- trueppm_api/apps/notifications/migrations/0007_workspaceemailsettings.py +80 -0
- trueppm_api/apps/notifications/migrations/0008_notification_snoozed_until.py +17 -0
- trueppm_api/apps/notifications/migrations/0009_usernotificationsettings.py +43 -0
- trueppm_api/apps/notifications/migrations/0010_projectnotificationpreference_schema_version.py +20 -0
- trueppm_api/apps/notifications/migrations/0011_usernotificationsettings_digest_hour_and_more.py +96 -0
- trueppm_api/apps/notifications/migrations/__init__.py +0 -0
- trueppm_api/apps/notifications/models.py +1197 -0
- trueppm_api/apps/notifications/receivers.py +155 -0
- trueppm_api/apps/notifications/schema_migrations.py +56 -0
- trueppm_api/apps/notifications/serializers.py +961 -0
- trueppm_api/apps/notifications/services.py +1451 -0
- trueppm_api/apps/notifications/tasks.py +711 -0
- trueppm_api/apps/notifications/throttles.py +98 -0
- trueppm_api/apps/notifications/urls.py +97 -0
- trueppm_api/apps/notifications/views.py +904 -0
- trueppm_api/apps/observability/__init__.py +0 -0
- trueppm_api/apps/observability/apps.py +31 -0
- trueppm_api/apps/observability/logging.py +213 -0
- trueppm_api/apps/observability/migrations/0001_initial.py +35 -0
- trueppm_api/apps/observability/migrations/0001_squashed_0003_alter_purgerun_trigger.py +154 -0
- trueppm_api/apps/observability/migrations/0002_purgerun_retentionpolicy_retentionschedule.py +131 -0
- trueppm_api/apps/observability/migrations/0003_alter_purgerun_trigger.py +21 -0
- trueppm_api/apps/observability/migrations/0004_alter_retentionpolicy_key.py +28 -0
- trueppm_api/apps/observability/migrations/__init__.py +0 -0
- trueppm_api/apps/observability/models.py +141 -0
- trueppm_api/apps/observability/otel/__init__.py +45 -0
- trueppm_api/apps/observability/otel/attributes.py +247 -0
- trueppm_api/apps/observability/otel/export_health.py +533 -0
- trueppm_api/apps/observability/otel/instrumentation.py +351 -0
- trueppm_api/apps/observability/otel/metrics.py +551 -0
- trueppm_api/apps/observability/otel/provider.py +511 -0
- trueppm_api/apps/observability/otel/request_attributes.py +204 -0
- trueppm_api/apps/observability/purge_registry.py +124 -0
- trueppm_api/apps/observability/retention.py +139 -0
- trueppm_api/apps/observability/selectors.py +969 -0
- trueppm_api/apps/observability/serializers.py +142 -0
- trueppm_api/apps/observability/services.py +407 -0
- trueppm_api/apps/observability/tasks.py +266 -0
- trueppm_api/apps/observability/urls.py +27 -0
- trueppm_api/apps/observability/views.py +523 -0
- trueppm_api/apps/profiles/__init__.py +0 -0
- trueppm_api/apps/profiles/apps.py +15 -0
- trueppm_api/apps/profiles/constants.py +54 -0
- trueppm_api/apps/profiles/migrations/0001_initial.py +55 -0
- trueppm_api/apps/profiles/migrations/0001_squashed_0004_userprofile_role_context.py +125 -0
- trueppm_api/apps/profiles/migrations/0002_userprofile_hidden_views.py +17 -0
- trueppm_api/apps/profiles/migrations/0003_projectvisit.py +63 -0
- trueppm_api/apps/profiles/migrations/0004_userprofile_role_context.py +26 -0
- trueppm_api/apps/profiles/migrations/0005_userprofile_schedule_in_deliver.py +20 -0
- trueppm_api/apps/profiles/migrations/0006_userprofile_date_format_userprofile_timezone.py +36 -0
- trueppm_api/apps/profiles/migrations/0007_userpin.py +91 -0
- trueppm_api/apps/profiles/migrations/0008_remove_userprofile_schedule_in_deliver.py +71 -0
- trueppm_api/apps/profiles/migrations/0009_auth_user_email_upper_idx.py +81 -0
- trueppm_api/apps/profiles/migrations/__init__.py +0 -0
- trueppm_api/apps/profiles/models.py +276 -0
- trueppm_api/apps/profiles/serializers.py +199 -0
- trueppm_api/apps/profiles/services.py +466 -0
- trueppm_api/apps/profiles/views.py +124 -0
- trueppm_api/apps/projects/__init__.py +0 -0
- trueppm_api/apps/projects/actual_date_rules.py +163 -0
- trueppm_api/apps/projects/amend.py +133 -0
- trueppm_api/apps/projects/apps.py +38 -0
- trueppm_api/apps/projects/asset_feed.py +459 -0
- trueppm_api/apps/projects/asset_views.py +317 -0
- trueppm_api/apps/projects/attachment_policy.py +278 -0
- trueppm_api/apps/projects/authentication.py +449 -0
- trueppm_api/apps/projects/backfill.py +287 -0
- trueppm_api/apps/projects/backlog_services.py +324 -0
- trueppm_api/apps/projects/backlog_views.py +302 -0
- trueppm_api/apps/projects/batch_operation_views.py +264 -0
- trueppm_api/apps/projects/blocker_services.py +510 -0
- trueppm_api/apps/projects/board_activity.py +462 -0
- trueppm_api/apps/projects/board_activity_views.py +186 -0
- trueppm_api/apps/projects/board_lanes.py +134 -0
- trueppm_api/apps/projects/bulk_settings.py +194 -0
- trueppm_api/apps/projects/bundled_templates.py +215 -0
- trueppm_api/apps/projects/calendar_settings.py +180 -0
- trueppm_api/apps/projects/ceremony_views.py +244 -0
- trueppm_api/apps/projects/commit_moment.py +204 -0
- trueppm_api/apps/projects/config_notice.py +1325 -0
- trueppm_api/apps/projects/custom_field_values.py +266 -0
- trueppm_api/apps/projects/decisions_services.py +93 -0
- trueppm_api/apps/projects/decisions_views.py +94 -0
- trueppm_api/apps/projects/estimation_scale.py +126 -0
- trueppm_api/apps/projects/export_bundle.py +353 -0
- trueppm_api/apps/projects/fixtures/seeds/atlas-platform-launch.json +4256 -0
- trueppm_api/apps/projects/fixtures/seeds/aurora-mobile-app.json +2000 -0
- trueppm_api/apps/projects/fixtures/seeds/bayside-civic-center.json +1825 -0
- trueppm_api/apps/projects/fixtures/seeds/ga-launch.json +1905 -0
- trueppm_api/apps/projects/fixtures/seeds/helios-crm-replacement.json +1409 -0
- trueppm_api/apps/projects/guardrail_policy_source.py +269 -0
- trueppm_api/apps/projects/inbound_sync.py +555 -0
- trueppm_api/apps/projects/iteration_label.py +85 -0
- trueppm_api/apps/projects/lifecycle.py +191 -0
- trueppm_api/apps/projects/management/__init__.py +0 -0
- trueppm_api/apps/projects/management/commands/__init__.py +0 -0
- trueppm_api/apps/projects/management/commands/backfill_in_progress_status.py +92 -0
- trueppm_api/apps/projects/management/commands/create_demo_share_link.py +368 -0
- trueppm_api/apps/projects/management/commands/export_program.py +50 -0
- trueppm_api/apps/projects/management/commands/import_seed.py +165 -0
- trueppm_api/apps/projects/management/commands/load_sample_project.py +247 -0
- trueppm_api/apps/projects/management/commands/seed_capacity.py +405 -0
- trueppm_api/apps/projects/management/commands/seed_integration_fixtures.py +178 -0
- trueppm_api/apps/projects/management/commands/shift_sample_dates.py +120 -0
- trueppm_api/apps/projects/mcp_settings.py +305 -0
- trueppm_api/apps/projects/methodology.py +178 -0
- trueppm_api/apps/projects/migrations/0001_initial.py +208 -0
- trueppm_api/apps/projects/migrations/0001_squashed_0094_project_decisions_policy.py +5595 -0
- trueppm_api/apps/projects/migrations/0002_alter_uuid_pk_serialize_false.py +57 -0
- trueppm_api/apps/projects/migrations/0003_rename_task_project_index.py +25 -0
- trueppm_api/apps/projects/migrations/0004_soft_delete_and_dependency_versioned.py +70 -0
- trueppm_api/apps/projects/migrations/0005_task_assignee.py +33 -0
- trueppm_api/apps/projects/migrations/0006_task_utilization_index.py +31 -0
- trueppm_api/apps/projects/migrations/0007_task_is_milestone.py +28 -0
- trueppm_api/apps/projects/migrations/0008_baseline.py +119 -0
- trueppm_api/apps/projects/migrations/0009_historicaldependency_historicalproject_and_more.py +210 -0
- trueppm_api/apps/projects/migrations/0010_risk.py +229 -0
- trueppm_api/apps/projects/migrations/0011_task_status.py +27 -0
- trueppm_api/apps/projects/migrations/0012_task_status.py +27 -0
- trueppm_api/apps/projects/migrations/0013_task_planned_start.py +24 -0
- trueppm_api/apps/projects/migrations/0014_short_hex_ids.py +74 -0
- trueppm_api/apps/projects/migrations/0015_backfill_short_ids.py +48 -0
- trueppm_api/apps/projects/migrations/0016_task_actual_dates.py +42 -0
- trueppm_api/apps/projects/migrations/0017_boardcolumnconfig.py +43 -0
- trueppm_api/apps/projects/migrations/0018_estimation_governance.py +62 -0
- trueppm_api/apps/projects/migrations/0019_backfill_wbs_paths.py +28 -0
- trueppm_api/apps/projects/migrations/0020_task_status_5col.py +65 -0
- trueppm_api/apps/projects/migrations/0021_boardsavedview.py +64 -0
- trueppm_api/apps/projects/migrations/0022_task_status_changed_at_priority_rank.py +35 -0
- trueppm_api/apps/projects/migrations/0023_risk_framework_fields.py +96 -0
- trueppm_api/apps/projects/migrations/0024_riskcomment.py +52 -0
- trueppm_api/apps/projects/migrations/0025_sprint.py +352 -0
- trueppm_api/apps/projects/migrations/0026_project_methodology.py +30 -0
- trueppm_api/apps/projects/migrations/0027_sprint_retro.py +89 -0
- trueppm_api/apps/projects/migrations/0028_normalize_notes_field.py +42 -0
- trueppm_api/apps/projects/migrations/0029_complete_implies_full_progress.py +38 -0
- trueppm_api/apps/projects/migrations/0030_review_implies_full_progress.py +37 -0
- trueppm_api/apps/projects/migrations/0031_task_remaining_points.py +22 -0
- trueppm_api/apps/projects/migrations/0032_task_is_subtask_and_sprint_scope_change.py +90 -0
- trueppm_api/apps/projects/migrations/0033_task_my_work_index.py +38 -0
- trueppm_api/apps/projects/migrations/0034_inbound_task_sync.py +313 -0
- trueppm_api/apps/projects/migrations/0035_retro_versioned_and_suggested_assignee.py +173 -0
- trueppm_api/apps/projects/migrations/0036_program_entity_and_membership.py +157 -0
- trueppm_api/apps/projects/migrations/0037_sprint_capacity_points.py +20 -0
- trueppm_api/apps/projects/migrations/0038_taskcomment_commentreaction_commentacknowledgement_and_more.py +233 -0
- trueppm_api/apps/projects/migrations/0039_apitoken_and_more.py +88 -0
- trueppm_api/apps/projects/migrations/0040_program_general_fields.py +119 -0
- trueppm_api/apps/projects/migrations/0041_ceremony_template_and_phase_gate_config.py +210 -0
- trueppm_api/apps/projects/migrations/0041_project_general_fields.py +106 -0
- trueppm_api/apps/projects/migrations/0042_merge_20260522_0410.py +12 -0
- trueppm_api/apps/projects/migrations/0042_program_rollup_config.py +95 -0
- trueppm_api/apps/projects/migrations/0042_workflow_color_and_custom_fields.py +94 -0
- trueppm_api/apps/projects/migrations/0043_merge_20260522_1118.py +10 -0
- trueppm_api/apps/projects/migrations/0044_merge_20260522_rollup.py +10 -0
- trueppm_api/apps/projects/migrations/0044_project_archive_program_close.py +119 -0
- trueppm_api/apps/projects/migrations/0045_program_risk_policy.py +78 -0
- trueppm_api/apps/projects/migrations/0046_merge_20260523_2248.py +12 -0
- trueppm_api/apps/projects/migrations/0047_apitokenauditentry_program_and_more.py +55 -0
- trueppm_api/apps/projects/migrations/0048_historicalprogram_color_program_color.py +32 -0
- trueppm_api/apps/projects/migrations/0049_backlog_item.py +112 -0
- trueppm_api/apps/projects/migrations/0050_backlog_item_trgm_search.py +26 -0
- trueppm_api/apps/projects/migrations/0051_alter_calendar_working_days_alter_dependency_lag_and_more.py +144 -0
- trueppm_api/apps/projects/migrations/0052_recurring_tasks.py +278 -0
- trueppm_api/apps/projects/migrations/0053_dependency_dep_pred_serverver_idx_and_more.py +56 -0
- trueppm_api/apps/projects/migrations/0054_sprintscopechange_goal_impact_and_more.py +117 -0
- trueppm_api/apps/projects/migrations/0055_historicaltask_sprint_pending_and_more.py +51 -0
- trueppm_api/apps/projects/migrations/0056_historicalproject_prioritization_model_and_more.py +276 -0
- trueppm_api/apps/projects/migrations/0057_historicalsprint_binding_committed_snapshot_and_more.py +58 -0
- trueppm_api/apps/projects/migrations/0058_historicaltask_delivery_mode_and_more.py +72 -0
- trueppm_api/apps/projects/migrations/0059_forecastsnapshot.py +80 -0
- trueppm_api/apps/projects/migrations/0060_historicalprojectsignalprivacypolicy_and_more.py +90 -0
- trueppm_api/apps/projects/migrations/0061_baselinetask_story_points.py +17 -0
- trueppm_api/apps/projects/migrations/0062_project_is_sample.py +22 -0
- trueppm_api/apps/projects/migrations/0063_historicalsprint_wip_limit_sprint_wip_limit.py +22 -0
- trueppm_api/apps/projects/migrations/0064_sprinttaskoutcome.py +97 -0
- trueppm_api/apps/projects/migrations/0065_historicalsprint_goal_outcome_sprint_goal_outcome.py +32 -0
- trueppm_api/apps/projects/migrations/0066_historicalproject_lead_project_lead.py +38 -0
- trueppm_api/apps/projects/migrations/0067_sprint_exclude_from_velocity.py +22 -0
- trueppm_api/apps/projects/migrations/0068_project_recalculated_at.py +23 -0
- trueppm_api/apps/projects/migrations/0069_iteration_label.py +22 -0
- trueppm_api/apps/projects/migrations/0070_historicalprogram_iteration_label_and_more.py +32 -0
- trueppm_api/apps/projects/migrations/0071_backfill_iteration_label_inherit.py +35 -0
- trueppm_api/apps/projects/migrations/0072_pulseresponse_retroboarditem.py +129 -0
- trueppm_api/apps/projects/migrations/0073_sprinttaskoutcome_demo_ready.py +17 -0
- trueppm_api/apps/projects/migrations/0074_historicaltask_blocked_reason_task_blocked_reason.py +30 -0
- trueppm_api/apps/projects/migrations/0075_risk_decimal_short_id.py +42 -0
- trueppm_api/apps/projects/migrations/0076_sprinttaskoutcome_review_polish.py +45 -0
- trueppm_api/apps/projects/migrations/0077_task_blocker_fields.py +111 -0
- trueppm_api/apps/projects/migrations/0078_alter_risktask_unique_together_and_more.py +22 -0
- trueppm_api/apps/projects/migrations/0079_historicalproject_status_date_project_status_date.py +22 -0
- trueppm_api/apps/projects/migrations/0080_alter_historicaltask_type_alter_task_type.py +46 -0
- trueppm_api/apps/projects/migrations/0081_historicalprogram_allow_guests_and_more.py +52 -0
- trueppm_api/apps/projects/migrations/0082_project_last_sync_version.py +90 -0
- trueppm_api/apps/projects/migrations/0083_historicalprogram_mc_history_attribution_audience_and_more.py +108 -0
- trueppm_api/apps/projects/migrations/0084_tasknote.py +71 -0
- trueppm_api/apps/projects/migrations/0085_sprint_ix_sprint_velocity.py +33 -0
- trueppm_api/apps/projects/migrations/0086_board_card_search_trgm.py +33 -0
- trueppm_api/apps/projects/migrations/0087_historicalprogram_task_duration_change_percent_policy_and_more.py +155 -0
- trueppm_api/apps/projects/migrations/0088_historicalprogram_allowed_attachment_types_and_more.py +61 -0
- trueppm_api/apps/projects/migrations/0089_signalceilingraiseproposal_signalceilingraisevote_and_more.py +157 -0
- trueppm_api/apps/projects/migrations/0090_historicaltask_proj_histdate_index.py +44 -0
- trueppm_api/apps/projects/migrations/0091_project_board_cadence.py +39 -0
- trueppm_api/apps/projects/migrations/0092_program_target_date.py +22 -0
- trueppm_api/apps/projects/migrations/0093_cross_project_dependency_consent.py +58 -0
- trueppm_api/apps/projects/migrations/0094_project_decisions_policy.py +90 -0
- trueppm_api/apps/projects/migrations/0095_poker_session_vote.py +127 -0
- trueppm_api/apps/projects/migrations/0095_squashed_0097_release_0_3.py +225 -0
- trueppm_api/apps/projects/migrations/0096_crossprojectslipconflict.py +91 -0
- trueppm_api/apps/projects/migrations/0097_backlogitem_backlogitem_tags_gin_and_more.py +32 -0
- trueppm_api/apps/projects/migrations/0098_historicalproject_show_baselines_and_more.py +52 -0
- trueppm_api/apps/projects/migrations/0099_apitoken_scopes.py +48 -0
- trueppm_api/apps/projects/migrations/0100_task_dep_serverver_idx_concurrent.py +61 -0
- trueppm_api/apps/projects/migrations/0101_dependency_deleted_at_task_deleted_at.py +22 -0
- trueppm_api/apps/projects/migrations/0102_project_deleted_at_project_proj_isdel_deletedat_idx.py +25 -0
- trueppm_api/apps/projects/migrations/0103_taskdurationchangeevent_task_dur_evt_sprint_idx.py +18 -0
- trueppm_api/apps/projects/migrations/0104_historicalproject_stale_task_threshold_days_and_more.py +32 -0
- trueppm_api/apps/projects/migrations/0104_trash_restore_1113.py +38 -0
- trueppm_api/apps/projects/migrations/0105_historical_changelog_indexes.py +62 -0
- trueppm_api/apps/projects/migrations/0106_boardsavedview_schema_version.py +20 -0
- trueppm_api/apps/projects/migrations/0107_task_activity_event.py +70 -0
- trueppm_api/apps/projects/migrations/0108_remove_apitoken_api_token_scope_xor_and_more.py +117 -0
- trueppm_api/apps/projects/migrations/0109_projectexportjob.py +82 -0
- trueppm_api/apps/projects/migrations/0110_sharelink.py +123 -0
- trueppm_api/apps/projects/migrations/0111_projectcalendarlayer.py +67 -0
- trueppm_api/apps/projects/migrations/0112_sharelink_expires_at_alter_sharelink_content_kind.py +31 -0
- trueppm_api/apps/projects/migrations/0113_alter_historicaltask_percent_complete_and_more.py +35 -0
- trueppm_api/apps/projects/migrations/0114_historicalproject_default_member_role_and_more.py +28 -0
- trueppm_api/apps/projects/migrations/0115_historicalproject_end_date_shift_threshold_days_and_more.py +22 -0
- trueppm_api/apps/projects/migrations/0116_alter_taskactivityevent_event_type.py +28 -0
- trueppm_api/apps/projects/migrations/0117_label_tasklabel_label_tasks_and_more.py +126 -0
- trueppm_api/apps/projects/migrations/0118_programexportjob.py +82 -0
- trueppm_api/apps/projects/migrations/0119_historicalprogram_calendar_program_calendar.py +36 -0
- trueppm_api/apps/projects/migrations/0120_alter_backlogitem_item_type.py +29 -0
- trueppm_api/apps/projects/migrations/0121_task_three_point_estimate_ordered.py +64 -0
- trueppm_api/apps/projects/migrations/0122_task_relation.py +173 -0
- trueppm_api/apps/projects/migrations/0123_remove_historicalproject_agile_features_and_more.py +20 -0
- trueppm_api/apps/projects/migrations/0124_dependency_is_driving.py +17 -0
- trueppm_api/apps/projects/migrations/0125_historicalprogram_estimation_scale_and_more.py +68 -0
- trueppm_api/apps/projects/migrations/0126_projectcustomfield_show_on_card_taskcustomfieldvalue.py +80 -0
- trueppm_api/apps/projects/migrations/0127_historicalprogram_mcp_enabled_and_more.py +32 -0
- trueppm_api/apps/projects/migrations/0128_acceptancecriterion_sync_seq_apitoken_sync_seq_and_more.py +192 -0
- trueppm_api/apps/projects/migrations/0129_sharelink_show_milestone_dates.py +20 -0
- trueppm_api/apps/projects/migrations/0130_programimportjob.py +85 -0
- trueppm_api/apps/projects/migrations/0131_historicalprogram_sprint_picker_ready_only_default_and_more.py +32 -0
- trueppm_api/apps/projects/migrations/0132_task_scheduled_start.py +17 -0
- trueppm_api/apps/projects/migrations/0133_project_status_date_floor_armed_at.py +17 -0
- trueppm_api/apps/projects/migrations/0134_task_edited_at_task_seeded_at_task_source_id_and_more.py +65 -0
- trueppm_api/apps/projects/migrations/0135_projecttemplate_templateapplication_and_more.py +175 -0
- trueppm_api/apps/projects/migrations/0136_schedule_outline_batch_operations.py +118 -0
- trueppm_api/apps/projects/migrations/0137_collapse_dual_scope_api_tokens.py +54 -0
- trueppm_api/apps/projects/migrations/0138_apitokenauditentry_api_token_audit_owner_idx.py +18 -0
- trueppm_api/apps/projects/migrations/0139_historicaltask_duration_unit_task_duration_unit.py +32 -0
- trueppm_api/apps/projects/migrations/0140_historicaltask_auto_container_and_more.py +113 -0
- trueppm_api/apps/projects/migrations/0141_historicalproject_draft_started_at_and_more.py +44 -0
- trueppm_api/apps/projects/migrations/0142_baseline_calendar_hours_per_day_and_more.py +31 -0
- trueppm_api/apps/projects/migrations/0143_sprintcloserequest_failure_reason_and_more.py +42 -0
- trueppm_api/apps/projects/migrations/0144_projecttemplate_source_project_and_more.py +35 -0
- trueppm_api/apps/projects/migrations/0145_seed_bundled_templates.py +65 -0
- trueppm_api/apps/projects/migrations/0146_historicaltask_board_lane_task_board_lane.py +32 -0
- trueppm_api/apps/projects/migrations/0147_structuraloperation.py +128 -0
- trueppm_api/apps/projects/migrations/0148_task_unique_task_wbs_path_per_project_live.py +76 -0
- trueppm_api/apps/projects/migrations/0149_drop_workshops_tables.py +42 -0
- trueppm_api/apps/projects/migrations/0150_clear_uncommitted_cpm_output.py +130 -0
- trueppm_api/apps/projects/migrations/0151_config_notice_request.py +70 -0
- trueppm_api/apps/projects/migrations/0152_aggregate_task_wbs_name_idx.py +20 -0
- trueppm_api/apps/projects/migrations/0153_program_sample_anchor_date.py +22 -0
- trueppm_api/apps/projects/migrations/__init__.py +0 -0
- trueppm_api/apps/projects/models.py +8946 -0
- trueppm_api/apps/projects/poker_services.py +154 -0
- trueppm_api/apps/projects/poker_views.py +398 -0
- trueppm_api/apps/projects/product_backlog_services.py +450 -0
- trueppm_api/apps/projects/program_label_services.py +94 -0
- trueppm_api/apps/projects/program_label_views.py +189 -0
- trueppm_api/apps/projects/program_rollup.py +575 -0
- trueppm_api/apps/projects/program_schedule.py +745 -0
- trueppm_api/apps/projects/program_views.py +3220 -0
- trueppm_api/apps/projects/project_templates.py +422 -0
- trueppm_api/apps/projects/receivers.py +234 -0
- trueppm_api/apps/projects/refusal_codes.py +140 -0
- trueppm_api/apps/projects/reorder_services.py +145 -0
- trueppm_api/apps/projects/restructure_hooks.py +54 -0
- trueppm_api/apps/projects/retro_board_services.py +368 -0
- trueppm_api/apps/projects/retro_services.py +285 -0
- trueppm_api/apps/projects/risk_import.py +396 -0
- trueppm_api/apps/projects/row_identity.py +113 -0
- trueppm_api/apps/projects/schema_migrations.py +228 -0
- trueppm_api/apps/projects/schemas/seed_v1.json +493 -0
- trueppm_api/apps/projects/schemas/seed_v2.json +892 -0
- trueppm_api/apps/projects/seed/__init__.py +61 -0
- trueppm_api/apps/projects/seed/exporter.py +1644 -0
- trueppm_api/apps/projects/seed/forecast_backfill.py +247 -0
- trueppm_api/apps/projects/seed/importer.py +2390 -0
- trueppm_api/apps/projects/seed/reanchor.py +551 -0
- trueppm_api/apps/projects/seed/reldates.py +126 -0
- trueppm_api/apps/projects/seed/replace.py +126 -0
- trueppm_api/apps/projects/seed/replay.py +1691 -0
- trueppm_api/apps/projects/seed/replay_ctx.py +41 -0
- trueppm_api/apps/projects/seed/samples.py +427 -0
- trueppm_api/apps/projects/seed/validation.py +1149 -0
- trueppm_api/apps/projects/serializers.py +12310 -0
- trueppm_api/apps/projects/services.py +6966 -0
- trueppm_api/apps/projects/share_serializers.py +132 -0
- trueppm_api/apps/projects/share_services.py +325 -0
- trueppm_api/apps/projects/share_views.py +374 -0
- trueppm_api/apps/projects/sharing_settings.py +187 -0
- trueppm_api/apps/projects/signal_privacy_services.py +909 -0
- trueppm_api/apps/projects/signal_privacy_views.py +476 -0
- trueppm_api/apps/projects/signals.py +132 -0
- trueppm_api/apps/projects/slip_conflict.py +266 -0
- trueppm_api/apps/projects/sprint_cadence.py +453 -0
- trueppm_api/apps/projects/sprint_picker_settings.py +132 -0
- trueppm_api/apps/projects/standup.py +304 -0
- trueppm_api/apps/projects/standup_views.py +99 -0
- trueppm_api/apps/projects/structural_operation_services.py +727 -0
- trueppm_api/apps/projects/structural_operation_views.py +311 -0
- trueppm_api/apps/projects/surface_visibility.py +126 -0
- trueppm_api/apps/projects/task_batch_services.py +379 -0
- trueppm_api/apps/projects/task_bulk.py +1152 -0
- trueppm_api/apps/projects/task_classification.py +561 -0
- trueppm_api/apps/projects/task_classification_defaults.py +95 -0
- trueppm_api/apps/projects/task_duration_settings.py +142 -0
- trueppm_api/apps/projects/task_grouping.py +754 -0
- trueppm_api/apps/projects/tasks.py +1917 -0
- trueppm_api/apps/projects/template_divergence.py +168 -0
- trueppm_api/apps/projects/template_services.py +160 -0
- trueppm_api/apps/projects/template_tasks.py +258 -0
- trueppm_api/apps/projects/template_views.py +799 -0
- trueppm_api/apps/projects/throttles.py +311 -0
- trueppm_api/apps/projects/urls.py +1011 -0
- trueppm_api/apps/projects/utilization.py +885 -0
- trueppm_api/apps/projects/views.py +20572 -0
- trueppm_api/apps/projects/wbs_paths.py +119 -0
- trueppm_api/apps/resources/__init__.py +0 -0
- trueppm_api/apps/resources/apps.py +8 -0
- trueppm_api/apps/resources/capacity.py +121 -0
- trueppm_api/apps/resources/migrations/0001_initial.py +68 -0
- trueppm_api/apps/resources/migrations/0001_squashed_0013_alter_projectresource_unique_together_and_more.py +281 -0
- trueppm_api/apps/resources/migrations/0002_alter_uuid_pk_serialize_false.py +36 -0
- trueppm_api/apps/resources/migrations/0003_resource_soft_delete.py +30 -0
- trueppm_api/apps/resources/migrations/0004_add_taskresource_resource_index.py +25 -0
- trueppm_api/apps/resources/migrations/0005_resource_job_role.py +20 -0
- trueppm_api/apps/resources/migrations/0006_skill.py +34 -0
- trueppm_api/apps/resources/migrations/0007_resource_skill.py +63 -0
- trueppm_api/apps/resources/migrations/0008_project_resource.py +63 -0
- trueppm_api/apps/resources/migrations/0009_task_skill_requirement.py +60 -0
- trueppm_api/apps/resources/migrations/0010_alter_resourceskill_options_and_more.py +20 -0
- trueppm_api/apps/resources/migrations/0011_alter_projectresource_notes.py +17 -0
- trueppm_api/apps/resources/migrations/0012_add_resource_user_fk.py +26 -0
- trueppm_api/apps/resources/migrations/0013_alter_projectresource_unique_together_and_more.py +53 -0
- trueppm_api/apps/resources/migrations/0014_projectresource_sync_seq_resource_sync_seq_and_more.py +37 -0
- trueppm_api/apps/resources/migrations/0015_projectresource_deactivated_with_resource.py +17 -0
- trueppm_api/apps/resources/migrations/__init__.py +0 -0
- trueppm_api/apps/resources/models.py +298 -0
- trueppm_api/apps/resources/serializers.py +426 -0
- trueppm_api/apps/resources/services.py +465 -0
- trueppm_api/apps/resources/urls.py +28 -0
- trueppm_api/apps/resources/views.py +1749 -0
- trueppm_api/apps/scheduling/__init__.py +0 -0
- trueppm_api/apps/scheduling/apps.py +153 -0
- trueppm_api/apps/scheduling/calendars.py +119 -0
- trueppm_api/apps/scheduling/deadletter.py +91 -0
- trueppm_api/apps/scheduling/forecast_history_settings.py +215 -0
- trueppm_api/apps/scheduling/forecast_staleness.py +313 -0
- trueppm_api/apps/scheduling/graph_guard.py +263 -0
- trueppm_api/apps/scheduling/management/__init__.py +0 -0
- trueppm_api/apps/scheduling/management/commands/__init__.py +0 -0
- trueppm_api/apps/scheduling/management/commands/prune_forecast_snapshots.py +53 -0
- trueppm_api/apps/scheduling/migrations/0001_failed_task.py +62 -0
- trueppm_api/apps/scheduling/migrations/0001_squashed_0007_projectforecastsnapshot.py +309 -0
- trueppm_api/apps/scheduling/migrations/0002_schedulerequest.py +78 -0
- trueppm_api/apps/scheduling/migrations/0003_add_schedule_request_reason.py +27 -0
- trueppm_api/apps/scheduling/migrations/0004_velocity_suggestion.py +94 -0
- trueppm_api/apps/scheduling/migrations/0005_montecarlorun.py +61 -0
- trueppm_api/apps/scheduling/migrations/0006_montecarlorun_distribution.py +17 -0
- trueppm_api/apps/scheduling/migrations/0007_projectforecastsnapshot.py +65 -0
- trueppm_api/apps/scheduling/migrations/0008_alter_schedulerequest_reason.py +28 -0
- trueppm_api/apps/scheduling/migrations/0008_folded_schedulerequest_reason.py +34 -0
- trueppm_api/apps/scheduling/migrations/0009_alter_schedulerequest_reason.py +29 -0
- trueppm_api/apps/scheduling/migrations/0010_failedtask_resolution_note_failedtask_resolved_at_and_more.py +43 -0
- trueppm_api/apps/scheduling/migrations/0011_failedtask_project.py +26 -0
- trueppm_api/apps/scheduling/migrations/0012_montecarlorun_diagnostic.py +17 -0
- trueppm_api/apps/scheduling/migrations/0013_montecarlorun_status_date.py +17 -0
- trueppm_api/apps/scheduling/migrations/0014_montecarlorun_plan_version.py +17 -0
- trueppm_api/apps/scheduling/migrations/__init__.py +0 -0
- trueppm_api/apps/scheduling/models.py +516 -0
- trueppm_api/apps/scheduling/receivers.py +160 -0
- trueppm_api/apps/scheduling/risk_premium.py +283 -0
- trueppm_api/apps/scheduling/serializers.py +564 -0
- trueppm_api/apps/scheduling/services.py +1182 -0
- trueppm_api/apps/scheduling/signals.py +56 -0
- trueppm_api/apps/scheduling/tasks.py +1984 -0
- trueppm_api/apps/scheduling/telemetry.py +80 -0
- trueppm_api/apps/scheduling/units.py +35 -0
- trueppm_api/apps/scheduling/urls.py +57 -0
- trueppm_api/apps/scheduling/views.py +2564 -0
- trueppm_api/apps/sso/__init__.py +0 -0
- trueppm_api/apps/sso/apps.py +19 -0
- trueppm_api/apps/sso/extensions.py +130 -0
- trueppm_api/apps/sso/management/__init__.py +0 -0
- trueppm_api/apps/sso/management/commands/__init__.py +0 -0
- trueppm_api/apps/sso/management/commands/seed_sso_keycloak.py +172 -0
- trueppm_api/apps/sso/migrations/0001_initial.py +119 -0
- trueppm_api/apps/sso/migrations/0002_remove_oidcprovider_workspace_ssoproviderpolicy_and_more.py +169 -0
- trueppm_api/apps/sso/migrations/__init__.py +0 -0
- trueppm_api/apps/sso/models.py +148 -0
- trueppm_api/apps/sso/serializers.py +437 -0
- trueppm_api/apps/sso/services.py +1385 -0
- trueppm_api/apps/sso/urls.py +47 -0
- trueppm_api/apps/sso/views.py +935 -0
- trueppm_api/apps/sync/__init__.py +0 -0
- trueppm_api/apps/sync/apps.py +15 -0
- trueppm_api/apps/sync/backfill.py +208 -0
- trueppm_api/apps/sync/broadcast.py +320 -0
- trueppm_api/apps/sync/conflict.py +262 -0
- trueppm_api/apps/sync/consumers.py +471 -0
- trueppm_api/apps/sync/migrations/0001_initial.py +59 -0
- trueppm_api/apps/sync/migrations/0001_squashed_0002_remove_syncbatch_syncbatch_project_client_batch_uniq_and_more.py +77 -0
- trueppm_api/apps/sync/migrations/0002_remove_syncbatch_syncbatch_project_client_batch_uniq_and_more.py +41 -0
- trueppm_api/apps/sync/migrations/0003_boardevent.py +46 -0
- trueppm_api/apps/sync/migrations/0004_seed_sync_seq.py +24 -0
- trueppm_api/apps/sync/migrations/0005_program_sync_sequence.py +35 -0
- trueppm_api/apps/sync/migrations/__init__.py +0 -0
- trueppm_api/apps/sync/models.py +225 -0
- trueppm_api/apps/sync/pagination.py +231 -0
- trueppm_api/apps/sync/sequence.py +371 -0
- trueppm_api/apps/sync/serializers.py +687 -0
- trueppm_api/apps/sync/tasks.py +260 -0
- trueppm_api/apps/sync/throttles.py +175 -0
- trueppm_api/apps/sync/upload.py +501 -0
- trueppm_api/apps/sync/urls.py +17 -0
- trueppm_api/apps/sync/views.py +930 -0
- trueppm_api/apps/sync/ws_auth.py +193 -0
- trueppm_api/apps/taskruns/__init__.py +0 -0
- trueppm_api/apps/taskruns/apps.py +11 -0
- trueppm_api/apps/taskruns/migrations/0001_initial.py +92 -0
- trueppm_api/apps/taskruns/migrations/__init__.py +0 -0
- trueppm_api/apps/taskruns/models.py +68 -0
- trueppm_api/apps/taskruns/serializers.py +92 -0
- trueppm_api/apps/taskruns/tasks.py +60 -0
- trueppm_api/apps/taskruns/tracker.py +286 -0
- trueppm_api/apps/taskruns/urls.py +46 -0
- trueppm_api/apps/taskruns/views.py +195 -0
- trueppm_api/apps/teams/__init__.py +8 -0
- trueppm_api/apps/teams/apps.py +16 -0
- trueppm_api/apps/teams/migrations/0001_initial.py +139 -0
- trueppm_api/apps/teams/migrations/0001_squashed_0002_default_teams.py +142 -0
- trueppm_api/apps/teams/migrations/0002_default_teams.py +62 -0
- trueppm_api/apps/teams/migrations/0003_team_sync_seq_teammembership_sync_seq.py +22 -0
- trueppm_api/apps/teams/migrations/__init__.py +0 -0
- trueppm_api/apps/teams/models.py +145 -0
- trueppm_api/apps/teams/permissions.py +149 -0
- trueppm_api/apps/teams/serializers.py +95 -0
- trueppm_api/apps/teams/services.py +434 -0
- trueppm_api/apps/teams/signals.py +61 -0
- trueppm_api/apps/teams/urls.py +34 -0
- trueppm_api/apps/teams/views.py +201 -0
- trueppm_api/apps/timetracking/__init__.py +0 -0
- trueppm_api/apps/timetracking/apps.py +9 -0
- trueppm_api/apps/timetracking/migrations/0001_initial.py +117 -0
- trueppm_api/apps/timetracking/migrations/0002_timesheetsubmission.py +46 -0
- trueppm_api/apps/timetracking/migrations/0003_timeentry_deleted_at_timeentry_deleted_by.py +31 -0
- trueppm_api/apps/timetracking/migrations/0004_timeentry_sync_seq_and_more.py +24 -0
- trueppm_api/apps/timetracking/migrations/__init__.py +0 -0
- trueppm_api/apps/timetracking/models.py +178 -0
- trueppm_api/apps/timetracking/serializers.py +175 -0
- trueppm_api/apps/timetracking/services.py +117 -0
- trueppm_api/apps/timetracking/urls.py +47 -0
- trueppm_api/apps/timetracking/views.py +526 -0
- trueppm_api/apps/webhooks/__init__.py +0 -0
- trueppm_api/apps/webhooks/apps.py +8 -0
- trueppm_api/apps/webhooks/backfill.py +90 -0
- trueppm_api/apps/webhooks/dispatch.py +144 -0
- trueppm_api/apps/webhooks/migrations/0001_initial.py +146 -0
- trueppm_api/apps/webhooks/migrations/0001_squashed_0007_sprint_lifecycle_events.py +243 -0
- trueppm_api/apps/webhooks/migrations/0002_alter_webhook_events.py +32 -0
- trueppm_api/apps/webhooks/migrations/0003_delivery_status_created_idx.py +17 -0
- trueppm_api/apps/webhooks/migrations/0004_webhook_program_alter_webhook_project_and_more.py +64 -0
- trueppm_api/apps/webhooks/migrations/0005_webhook_delivery_sequence_numbers.py +30 -0
- trueppm_api/apps/webhooks/migrations/0006_webhook_format_alter_webhook_events_and_more.py +61 -0
- trueppm_api/apps/webhooks/migrations/0007_sprint_lifecycle_events.py +63 -0
- trueppm_api/apps/webhooks/migrations/0008_risk_baseline_comment_events.py +73 -0
- trueppm_api/apps/webhooks/migrations/0009_encrypt_webhook_secret_and_failure_counters.py +90 -0
- trueppm_api/apps/webhooks/migrations/__init__.py +0 -0
- trueppm_api/apps/webhooks/models.py +372 -0
- trueppm_api/apps/webhooks/serializers.py +318 -0
- trueppm_api/apps/webhooks/tasks.py +663 -0
- trueppm_api/apps/webhooks/urls.py +22 -0
- trueppm_api/apps/webhooks/views.py +383 -0
- trueppm_api/apps/workflow_engine/__init__.py +0 -0
- trueppm_api/apps/workflow_engine/apps.py +23 -0
- trueppm_api/apps/workflow_engine/migrations/0001_initial.py +230 -0
- trueppm_api/apps/workflow_engine/migrations/0001_squashed_0002_remove_workflowhistoryevent_workflow_history_lookup_idx.py +234 -0
- trueppm_api/apps/workflow_engine/migrations/0002_remove_workflowhistoryevent_workflow_history_lookup_idx.py +16 -0
- trueppm_api/apps/workflow_engine/migrations/0003_workflowoutboxrow_workflow_outbox_recovery_idx.py +21 -0
- trueppm_api/apps/workflow_engine/migrations/__init__.py +0 -0
- trueppm_api/apps/workflow_engine/models.py +265 -0
- trueppm_api/apps/workflow_engine/tasks.py +368 -0
- trueppm_api/apps/workspace/__init__.py +0 -0
- trueppm_api/apps/workspace/apps.py +10 -0
- trueppm_api/apps/workspace/backfill.py +111 -0
- trueppm_api/apps/workspace/export.py +242 -0
- trueppm_api/apps/workspace/migrations/0001_initial.py +326 -0
- trueppm_api/apps/workspace/migrations/0001_squashed_0014_workspacemembership_availability_effective_from_and_more.py +829 -0
- trueppm_api/apps/workspace/migrations/0002_remove_workspace_fiscal_year_start_and_more.py +85 -0
- trueppm_api/apps/workspace/migrations/0003_workspaceexportjob.py +73 -0
- trueppm_api/apps/workspace/migrations/0004_alter_workspaceinvite_status.py +27 -0
- trueppm_api/apps/workspace/migrations/0005_workspace_iteration_label_and_more.py +26 -0
- trueppm_api/apps/workspace/migrations/0006_alter_groupmembership_unique_together_and_more.py +45 -0
- trueppm_api/apps/workspace/migrations/0007_workspace_public_sharing_override_policy.py +21 -0
- trueppm_api/apps/workspace/migrations/0008_workspace_mc_history_attribution_audience_and_more.py +44 -0
- trueppm_api/apps/workspace/migrations/0009_workspace_methodology_and_more.py +186 -0
- trueppm_api/apps/workspace/migrations/0010_workspace_logo.py +38 -0
- trueppm_api/apps/workspace/migrations/0011_historicalworkspace_task_duration_change_percent_override_policy_and_more.py +56 -0
- trueppm_api/apps/workspace/migrations/0012_historicalworkspace_allowed_attachment_types_and_more.py +64 -0
- trueppm_api/apps/workspace/migrations/0013_auditevent.py +70 -0
- trueppm_api/apps/workspace/migrations/0014_workspacemembership_availability_effective_from_and_more.py +39 -0
- trueppm_api/apps/workspace/migrations/0015_trash_restore_1113.py +34 -0
- trueppm_api/apps/workspace/migrations/0016_historicalworkspace_calendar_and_more.py +55 -0
- trueppm_api/apps/workspace/migrations/0017_historicalworkspace_estimation_scale_and_more.py +38 -0
- trueppm_api/apps/workspace/migrations/0018_historicalworkspace_feedback_enabled_and_more.py +32 -0
- trueppm_api/apps/workspace/migrations/0019_historicalworkspace_mcp_enabled_and_more.py +22 -0
- trueppm_api/apps/workspace/migrations/0020_viewer_ordinal_one.py +34 -0
- trueppm_api/apps/workspace/migrations/0021_group_sync_seq_groupmembership_sync_seq_and_more.py +27 -0
- trueppm_api/apps/workspace/migrations/0022_historicalworkspace_sprint_picker_ready_only_default_and_more.py +22 -0
- trueppm_api/apps/workspace/migrations/0023_alter_auditevent_event_type.py +32 -0
- trueppm_api/apps/workspace/migrations/0024_alter_auditevent_event_type.py +33 -0
- trueppm_api/apps/workspace/migrations/0025_alter_auditevent_event_type.py +36 -0
- trueppm_api/apps/workspace/migrations/0026_alter_auditevent_event_type.py +37 -0
- trueppm_api/apps/workspace/migrations/0027_alter_auditevent_event_type.py +42 -0
- trueppm_api/apps/workspace/migrations/__init__.py +0 -0
- trueppm_api/apps/workspace/models.py +857 -0
- trueppm_api/apps/workspace/permissions.py +187 -0
- trueppm_api/apps/workspace/serializers.py +590 -0
- trueppm_api/apps/workspace/services.py +919 -0
- trueppm_api/apps/workspace/signals.py +37 -0
- trueppm_api/apps/workspace/tasks.py +555 -0
- trueppm_api/apps/workspace/urls.py +113 -0
- trueppm_api/apps/workspace/views.py +1502 -0
- trueppm_api/asgi.py +42 -0
- trueppm_api/celery.py +31 -0
- trueppm_api/core/__init__.py +0 -0
- trueppm_api/core/admin_site.py +206 -0
- trueppm_api/core/auth_views.py +916 -0
- trueppm_api/core/constant_time.py +51 -0
- trueppm_api/core/csp.py +54 -0
- trueppm_api/core/db.py +87 -0
- trueppm_api/core/db_session.py +37 -0
- trueppm_api/core/exception_handlers.py +157 -0
- trueppm_api/core/export_downloads.py +56 -0
- trueppm_api/core/extension_providers.py +56 -0
- trueppm_api/core/extension_signals.py +147 -0
- trueppm_api/core/idempotent.py +260 -0
- trueppm_api/core/metadata.py +42 -0
- trueppm_api/core/middleware.py +51 -0
- trueppm_api/core/openapi.py +949 -0
- trueppm_api/core/password_reset.py +500 -0
- trueppm_api/core/protect_conflict.py +100 -0
- trueppm_api/core/ratelimit.py +148 -0
- trueppm_api/core/redis_throttle.py +82 -0
- trueppm_api/core/refresh_cookie_policy.py +156 -0
- trueppm_api/core/request_body.py +86 -0
- trueppm_api/core/security_checks.py +884 -0
- trueppm_api/core/storage_config.py +105 -0
- trueppm_api/core/text_decode.py +168 -0
- trueppm_api/core/throttling.py +344 -0
- trueppm_api/core/valkey.py +214 -0
- trueppm_api/core/valkey_cache.py +66 -0
- trueppm_api/core/valkey_checks.py +104 -0
- trueppm_api/core/valkey_config.py +39 -0
- trueppm_api/core/worker_broker_wait.py +149 -0
- trueppm_api/core/worker_heartbeat.py +134 -0
- trueppm_api/fields.py +36 -0
- trueppm_api/permissions.py +30 -0
- trueppm_api/py.typed +0 -0
- trueppm_api/routing.py +11 -0
- trueppm_api/settings/__init__.py +0 -0
- trueppm_api/settings/base.py +2455 -0
- trueppm_api/settings/dev.py +273 -0
- trueppm_api/settings/prod.py +228 -0
- trueppm_api/urls.py +153 -0
- trueppm_api/workflows/__init__.py +38 -0
- trueppm_api/workflows/backends/__init__.py +6 -0
- trueppm_api/workflows/backends/default.py +297 -0
- trueppm_api/workflows/consumers/__init__.py +11 -0
- trueppm_api/workflows/consumers/requeue_failed_task.py +65 -0
- trueppm_api/workflows/interface.py +148 -0
- trueppm_api/workflows/registry.py +106 -0
- trueppm_api/workflows/services.py +90 -0
- trueppm_api/wsgi.py +11 -0
- trueppm_api-0.4.0b2.dist-info/METADATA +70 -0
- trueppm_api-0.4.0b2.dist-info/RECORD +759 -0
- trueppm_api-0.4.0b2.dist-info/WHEEL +4 -0
|
@@ -0,0 +1,403 @@
|
|
|
1
|
+
"""SSRF-guarded outbound HTTP helper for the integrations app (ADR-0049 §3).
|
|
2
|
+
|
|
3
|
+
Two integration surfaces make request-cycle HTTP calls to user/operator-supplied
|
|
4
|
+
hosts: PAT verification (#677, ``TaskLinkProvider.verify_token``) and git-link
|
|
5
|
+
status refresh (#637, ``fetch_status``). Both must defend against SSRF — a PAT's
|
|
6
|
+
``base_url`` or a pasted git URL could point at ``169.254.169.254`` (cloud
|
|
7
|
+
metadata), ``127.0.0.1`` (loopback), or an RFC1918 host on the cluster network.
|
|
8
|
+
|
|
9
|
+
This module is the single egress chokepoint. ``assert_url_allowed`` resolves the
|
|
10
|
+
target host and rejects any URL that resolves to a private / loopback /
|
|
11
|
+
link-local / reserved address; ``get`` validates first, then performs a
|
|
12
|
+
time-bounded, redirect-disabled GET with a capped response body. Both #677 and
|
|
13
|
+
#637 route through it so the guard is implemented and tested once.
|
|
14
|
+
|
|
15
|
+
The guard resolves the hostname and checks **every** returned address — a host
|
|
16
|
+
with one public and one private A record is rejected. A residual DNS-rebinding
|
|
17
|
+
TOCTOU window (re-resolution between check and connect) is accepted for the OSS
|
|
18
|
+
tier; pinning the connection to the validated IP would break TLS SNI / cert
|
|
19
|
+
validation and is an Enterprise hardening item (ADR-0049 §6).
|
|
20
|
+
|
|
21
|
+
**Operator allow-list (ADR-0590).** A self-hoster who runs an identity provider
|
|
22
|
+
*inside the same cluster* has an OIDC issuer that resolves to a private ClusterIP
|
|
23
|
+
(e.g. ``keycloak.sso.svc``); the deny-list above would block discovery / token /
|
|
24
|
+
JWKS and make in-cluster SSO impossible. ``EGRESS_ALLOWLISTED_HOSTS`` (default
|
|
25
|
+
empty) names the exact hostnames the operator trusts, which then bypass the
|
|
26
|
+
private-address check. It is **operator configuration only** — never derived from
|
|
27
|
+
request or user input — and matches on an **exact, case-insensitive hostname**
|
|
28
|
+
(no wildcard / suffix), so allow-listing ``keycloak`` cannot admit
|
|
29
|
+
``keycloak.attacker.example``. Empty by default keeps every existing install on
|
|
30
|
+
the original "every resolved address must be globally routable" posture. Note the
|
|
31
|
+
allow-list is honored by **every** caller of this chokepoint (PAT verification,
|
|
32
|
+
git-link refresh, webhooks, SMTP relay, SSO), so an allow-listed host is reachable
|
|
33
|
+
through the user-influenceable URL surfaces too — an accepted, operator-declared
|
|
34
|
+
trust, documented for operators alongside the setting.
|
|
35
|
+
"""
|
|
36
|
+
|
|
37
|
+
from __future__ import annotations
|
|
38
|
+
|
|
39
|
+
import ipaddress
|
|
40
|
+
import json
|
|
41
|
+
import socket
|
|
42
|
+
import urllib.error
|
|
43
|
+
import urllib.parse
|
|
44
|
+
import urllib.request
|
|
45
|
+
from dataclasses import dataclass
|
|
46
|
+
from typing import Any
|
|
47
|
+
from urllib.parse import urlparse
|
|
48
|
+
|
|
49
|
+
# Synchronous, request-cycle calls — the user is staring at a spinner. Short
|
|
50
|
+
# by design; 5s is the ADR-0049 §3 budget for the refresh endpoint.
|
|
51
|
+
DEFAULT_TIMEOUT = 5.0
|
|
52
|
+
|
|
53
|
+
# Cap the response body we buffer. Provider ``/user`` and PR/issue payloads are
|
|
54
|
+
# a few KB; anything larger is either hostile or not what we asked for. Reading
|
|
55
|
+
# a bounded amount prevents a malicious endpoint from exhausting memory.
|
|
56
|
+
_MAX_BODY_BYTES = 256 * 1024
|
|
57
|
+
|
|
58
|
+
_USER_AGENT = "TruePPM-Integrations/1.0"
|
|
59
|
+
|
|
60
|
+
|
|
61
|
+
class EgressBlocked(Exception):
|
|
62
|
+
"""The URL failed the SSRF guard (bad scheme, missing host, or the host
|
|
63
|
+
resolved to a private / loopback / link-local / reserved address)."""
|
|
64
|
+
|
|
65
|
+
|
|
66
|
+
class EgressTimeout(Exception):
|
|
67
|
+
"""The request exceeded :data:`DEFAULT_TIMEOUT` (or the caller's timeout)."""
|
|
68
|
+
|
|
69
|
+
|
|
70
|
+
class EgressError(Exception):
|
|
71
|
+
"""A transport-level failure — DNS resolution failed, the connection was
|
|
72
|
+
refused, or the socket errored. Distinct from an HTTP error *response*,
|
|
73
|
+
which is returned as an :class:`EgressResponse` so callers can branch on
|
|
74
|
+
the status code (a 401 from ``/user`` means "bad token", not "unreachable").
|
|
75
|
+
"""
|
|
76
|
+
|
|
77
|
+
|
|
78
|
+
@dataclass(frozen=True)
|
|
79
|
+
class EgressResponse:
|
|
80
|
+
"""A buffered HTTP response from a guarded GET.
|
|
81
|
+
|
|
82
|
+
Non-2xx responses are returned, not raised — ``verify_token`` needs to read
|
|
83
|
+
a 401/403 to distinguish an invalid token from an unreachable host.
|
|
84
|
+
"""
|
|
85
|
+
|
|
86
|
+
status: int
|
|
87
|
+
body: bytes
|
|
88
|
+
headers: dict[str, str]
|
|
89
|
+
|
|
90
|
+
def json(self) -> Any:
|
|
91
|
+
"""Parse the body as JSON, or return ``None`` if it is not valid JSON.
|
|
92
|
+
|
|
93
|
+
Providers occasionally answer a 200 with an HTML error page (e.g. a
|
|
94
|
+
login redirect landing). Returning ``None`` lets the caller treat an
|
|
95
|
+
unparseable 200 as "verified but no metadata" rather than 500ing.
|
|
96
|
+
"""
|
|
97
|
+
try:
|
|
98
|
+
return json.loads(self.body.decode("utf-8"))
|
|
99
|
+
except (ValueError, UnicodeDecodeError):
|
|
100
|
+
return None
|
|
101
|
+
|
|
102
|
+
|
|
103
|
+
# RFC6052 well-known NAT64 prefix. ``64:ff9b::/96`` embeds an IPv4 address in
|
|
104
|
+
# its low 32 bits; a NAT64 gateway (common on dual-stack k8s) translates it back
|
|
105
|
+
# to that IPv4 on the wire. Python reports the wrapper as ``is_global`` True, so
|
|
106
|
+
# without unwrapping it a user-supplied ``[64:ff9b::a9fe:a9fe]`` URL would reach
|
|
107
|
+
# cloud metadata (169.254.169.254) straight through the guard (#900).
|
|
108
|
+
_NAT64_WELLKNOWN = ipaddress.ip_network("64:ff9b::/96")
|
|
109
|
+
|
|
110
|
+
|
|
111
|
+
def _embedded_ipv4(ip: ipaddress.IPv6Address) -> ipaddress.IPv4Address | None:
|
|
112
|
+
"""Extract the IPv4 address tunneled inside a transition-format IPv6 address.
|
|
113
|
+
|
|
114
|
+
Covers the forms whose ``is_global`` reflects the *wrapper* rather than the
|
|
115
|
+
embedded target, so a private/metadata IPv4 can be smuggled past the guard:
|
|
116
|
+
IPv4-mapped (``::ffff:0:0/96``), 6to4 (``2002::/16``), Teredo, the RFC6052
|
|
117
|
+
NAT64 well-known prefix, and the deprecated IPv4-compatible form
|
|
118
|
+
(``::a.b.c.d``, ``::/96``). Returns ``None`` for a native IPv6 address.
|
|
119
|
+
"""
|
|
120
|
+
if ip.ipv4_mapped is not None:
|
|
121
|
+
return ip.ipv4_mapped
|
|
122
|
+
if ip.sixtofour is not None:
|
|
123
|
+
return ip.sixtofour
|
|
124
|
+
if ip.teredo is not None:
|
|
125
|
+
return ip.teredo[1]
|
|
126
|
+
if ip in _NAT64_WELLKNOWN:
|
|
127
|
+
return ipaddress.IPv4Address(int(ip) & 0xFFFFFFFF)
|
|
128
|
+
# IPv4-compatible (deprecated, RFC4291 ``::/96``). No stdlib accessor: the
|
|
129
|
+
# high 96 bits are zero and the low 32 are the embedded IPv4. ``is_global``
|
|
130
|
+
# is True on the wrapper, so ``[::169.254.169.254]`` would otherwise reach
|
|
131
|
+
# metadata. Exclude ``::`` (unspecified) and ``::1`` (loopback) — those are
|
|
132
|
+
# native IPv6 that ``is_global`` already blocks, not tunneled IPv4.
|
|
133
|
+
as_int = int(ip)
|
|
134
|
+
if as_int >> 32 == 0 and as_int > 1:
|
|
135
|
+
return ipaddress.IPv4Address(as_int & 0xFFFFFFFF)
|
|
136
|
+
return None
|
|
137
|
+
|
|
138
|
+
|
|
139
|
+
def _is_blocked_ip(ip: ipaddress.IPv4Address | ipaddress.IPv6Address) -> bool:
|
|
140
|
+
"""Return ``True`` for any address an outbound integration call must not reach.
|
|
141
|
+
|
|
142
|
+
``is_global`` is ``False`` for the entire special-use space — private
|
|
143
|
+
(RFC1918), loopback, link-local (incl. ``169.254.169.254`` cloud metadata),
|
|
144
|
+
reserved, multicast, and unspecified — so the single negated check covers
|
|
145
|
+
every SSRF target the ADR-0049 deny-list enumerates without maintaining a
|
|
146
|
+
hand-rolled CIDR table that drifts from the IANA registry.
|
|
147
|
+
|
|
148
|
+
IPv6 transition formats are unwrapped first: ``is_global`` is computed on the
|
|
149
|
+
wrapper, so a metadata/RFC1918 IPv4 tunneled via NAT64, 6to4, Teredo, or an
|
|
150
|
+
IPv4-mapped address would otherwise pass. The embedded IPv4 is re-checked
|
|
151
|
+
through this same guard (#900).
|
|
152
|
+
"""
|
|
153
|
+
if isinstance(ip, ipaddress.IPv6Address):
|
|
154
|
+
embedded = _embedded_ipv4(ip)
|
|
155
|
+
if embedded is not None:
|
|
156
|
+
return _is_blocked_ip(embedded)
|
|
157
|
+
return not ip.is_global
|
|
158
|
+
|
|
159
|
+
|
|
160
|
+
def _allowlisted_hosts() -> frozenset[str]:
|
|
161
|
+
"""Operator-trusted hostnames exempt from the private-address deny-list (ADR-0590).
|
|
162
|
+
|
|
163
|
+
Read from the ``EGRESS_ALLOWLISTED_HOSTS`` setting (default empty). This is an
|
|
164
|
+
operator escape hatch for a trusted internal host the operator runs
|
|
165
|
+
themselves — chiefly an in-cluster identity provider whose OIDC issuer resolves
|
|
166
|
+
to a private ClusterIP, which the deny-list would otherwise block.
|
|
167
|
+
|
|
168
|
+
Safety: the value is **configuration only** — never request/user-derived — so
|
|
169
|
+
it cannot be widened by an attacker. Membership is an **exact, case-insensitive
|
|
170
|
+
hostname** compare, so an allow-listed ``keycloak`` never admits a lookalike
|
|
171
|
+
like ``keycloak.attacker.example``. ``django.conf`` is imported lazily to keep
|
|
172
|
+
this module importable without Django configured (it is otherwise pure stdlib).
|
|
173
|
+
"""
|
|
174
|
+
from django.conf import settings
|
|
175
|
+
|
|
176
|
+
hosts = getattr(settings, "EGRESS_ALLOWLISTED_HOSTS", ()) or ()
|
|
177
|
+
return frozenset(h.strip().lower() for h in hosts if h and h.strip())
|
|
178
|
+
|
|
179
|
+
|
|
180
|
+
def _blocked_if_literal(host: str) -> bool | None:
|
|
181
|
+
"""Return the deny-decision for ``host`` if it is an IP literal, else ``None``.
|
|
182
|
+
|
|
183
|
+
A literal IP needs no DNS. Classifying it directly avoids a pointless
|
|
184
|
+
``getaddrinfo`` round-trip on every IP-literal target and — critically —
|
|
185
|
+
removes the only resolver dependency from the guard's rejection of a literal
|
|
186
|
+
SSRF target (``169.254.169.254`` cloud metadata, an RFC1918 host). That deny
|
|
187
|
+
becomes a pure, syscall-free computation, so a constrained network namespace
|
|
188
|
+
(e.g. a CI runner) can never turn it into a transient ``EgressError`` /
|
|
189
|
+
resolver failure and let the caller retry into a real connection (#1628).
|
|
190
|
+
"""
|
|
191
|
+
try:
|
|
192
|
+
ip = ipaddress.ip_address(host)
|
|
193
|
+
except ValueError:
|
|
194
|
+
return None
|
|
195
|
+
return _is_blocked_ip(ip)
|
|
196
|
+
|
|
197
|
+
|
|
198
|
+
class NoRedirectHandler(urllib.request.HTTPRedirectHandler):
|
|
199
|
+
"""Disable redirect following so a 3xx can't bounce the request to an
|
|
200
|
+
internal host that the original (validated) URL did not resolve to.
|
|
201
|
+
|
|
202
|
+
Returning ``None`` from ``redirect_request`` tells urllib not to follow the
|
|
203
|
+
redirect; the 3xx response is surfaced to the caller as-is.
|
|
204
|
+
|
|
205
|
+
Public so sibling SSRF-guarded callers (webhook delivery, anywhere we POST
|
|
206
|
+
to a user-supplied URL) can compose their own opener without re-deriving
|
|
207
|
+
the handler. The original underscore name is kept as an alias for
|
|
208
|
+
backwards-compatibility inside this module.
|
|
209
|
+
"""
|
|
210
|
+
|
|
211
|
+
def redirect_request(self, *args: Any, **kwargs: Any) -> None:
|
|
212
|
+
return None
|
|
213
|
+
|
|
214
|
+
|
|
215
|
+
_opener = urllib.request.build_opener(NoRedirectHandler)
|
|
216
|
+
|
|
217
|
+
|
|
218
|
+
def assert_url_allowed(url: str) -> None:
|
|
219
|
+
"""Raise :class:`EgressBlocked` / :class:`EgressError` if ``url`` is unsafe to fetch.
|
|
220
|
+
|
|
221
|
+
Validates the scheme is ``http``/``https``, the host is present, and that
|
|
222
|
+
**every** address the host resolves to is globally routable. Shared by
|
|
223
|
+
#677 PAT verification and #637 git-link refresh so the SSRF policy has one
|
|
224
|
+
implementation and one test surface.
|
|
225
|
+
|
|
226
|
+
Raises:
|
|
227
|
+
EgressBlocked: Bad scheme, missing host, or a resolved address is
|
|
228
|
+
private / loopback / link-local / reserved.
|
|
229
|
+
EgressError: The host could not be resolved (DNS failure).
|
|
230
|
+
"""
|
|
231
|
+
parsed = urlparse(url)
|
|
232
|
+
if parsed.scheme not in ("http", "https"):
|
|
233
|
+
raise EgressBlocked(f"scheme {parsed.scheme!r} is not allowed")
|
|
234
|
+
host = parsed.hostname
|
|
235
|
+
if not host:
|
|
236
|
+
raise EgressBlocked("URL has no host")
|
|
237
|
+
# Operator escape hatch (ADR-0590): a hostname the operator explicitly trusts
|
|
238
|
+
# (e.g. an in-cluster IdP on a private ClusterIP) bypasses the private-address
|
|
239
|
+
# deny-list. Config-only, exact-match — the scheme gate above still applies.
|
|
240
|
+
if host.lower() in _allowlisted_hosts():
|
|
241
|
+
return
|
|
242
|
+
# A bracketed/parseable literal IP still has to clear the deny-list — a
|
|
243
|
+
# user can paste http://169.254.169.254 directly — but needs no resolution.
|
|
244
|
+
literal = _blocked_if_literal(host)
|
|
245
|
+
if literal is not None:
|
|
246
|
+
if literal:
|
|
247
|
+
raise EgressBlocked(f"host {host!r} is a non-public address")
|
|
248
|
+
return
|
|
249
|
+
port = parsed.port or (443 if parsed.scheme == "https" else 80)
|
|
250
|
+
try:
|
|
251
|
+
infos = socket.getaddrinfo(host, port, proto=socket.IPPROTO_TCP)
|
|
252
|
+
except socket.gaierror as exc:
|
|
253
|
+
raise EgressError(f"could not resolve host {host!r}") from exc
|
|
254
|
+
for info in infos:
|
|
255
|
+
addr = info[4][0]
|
|
256
|
+
try:
|
|
257
|
+
ip = ipaddress.ip_address(addr)
|
|
258
|
+
except ValueError: # pragma: no cover — getaddrinfo returns valid IPs
|
|
259
|
+
raise EgressBlocked(f"unparseable address {addr!r}") from None
|
|
260
|
+
if _is_blocked_ip(ip):
|
|
261
|
+
raise EgressBlocked(f"host {host!r} resolves to non-public address {addr}")
|
|
262
|
+
|
|
263
|
+
|
|
264
|
+
def assert_host_allowed(host: str, port: int) -> None:
|
|
265
|
+
"""Raise :class:`EgressBlocked` / :class:`EgressError` if ``host`` is unsafe.
|
|
266
|
+
|
|
267
|
+
Scheme-free sibling of :func:`assert_url_allowed` for non-HTTP egress —
|
|
268
|
+
e.g. an SMTP relay host (#712). It runs the same deny-list check (every
|
|
269
|
+
resolved address must be globally routable) but without the ``http``/
|
|
270
|
+
``https`` scheme gate, which would reject an SMTP target outright. Reused by
|
|
271
|
+
the workspace-SMTP serializer (validate-at-save) *and* the connection
|
|
272
|
+
resolver (re-validate at send, closing the DNS-rebinding gap — ADR-0213 §4).
|
|
273
|
+
|
|
274
|
+
Raises:
|
|
275
|
+
EgressBlocked: Missing host or a resolved address is private /
|
|
276
|
+
loopback / link-local / reserved (SSRF to metadata / internal svc).
|
|
277
|
+
EgressError: The host could not be resolved (DNS failure).
|
|
278
|
+
"""
|
|
279
|
+
if not host:
|
|
280
|
+
raise EgressBlocked("SMTP host is empty")
|
|
281
|
+
# Operator escape hatch (ADR-0590), shared with assert_url_allowed: an
|
|
282
|
+
# explicitly trusted host (e.g. an in-cluster relay) bypasses the deny-list.
|
|
283
|
+
if host.lower() in _allowlisted_hosts():
|
|
284
|
+
return
|
|
285
|
+
# A literal IP SMTP relay needs no resolution — classify it directly (#1628).
|
|
286
|
+
literal = _blocked_if_literal(host)
|
|
287
|
+
if literal is not None:
|
|
288
|
+
if literal:
|
|
289
|
+
raise EgressBlocked(f"host {host!r} is a non-public address")
|
|
290
|
+
return
|
|
291
|
+
try:
|
|
292
|
+
infos = socket.getaddrinfo(host, port, proto=socket.IPPROTO_TCP)
|
|
293
|
+
except socket.gaierror as exc:
|
|
294
|
+
raise EgressError(f"could not resolve host {host!r}") from exc
|
|
295
|
+
for info in infos:
|
|
296
|
+
addr = info[4][0]
|
|
297
|
+
try:
|
|
298
|
+
ip = ipaddress.ip_address(addr)
|
|
299
|
+
except ValueError: # pragma: no cover — getaddrinfo returns valid IPs
|
|
300
|
+
raise EgressBlocked(f"unparseable address {addr!r}") from None
|
|
301
|
+
if _is_blocked_ip(ip):
|
|
302
|
+
raise EgressBlocked(f"host {host!r} resolves to non-public address {addr}")
|
|
303
|
+
|
|
304
|
+
|
|
305
|
+
def get(
|
|
306
|
+
url: str,
|
|
307
|
+
*,
|
|
308
|
+
headers: dict[str, str] | None = None,
|
|
309
|
+
timeout: float = DEFAULT_TIMEOUT,
|
|
310
|
+
) -> EgressResponse:
|
|
311
|
+
"""Perform an SSRF-guarded, redirect-disabled, time-bounded GET.
|
|
312
|
+
|
|
313
|
+
The URL is validated by :func:`assert_url_allowed` before any socket is
|
|
314
|
+
opened. Non-2xx responses are returned (not raised) so callers can read the
|
|
315
|
+
status code; only transport failures raise.
|
|
316
|
+
|
|
317
|
+
Raises:
|
|
318
|
+
EgressBlocked: The URL failed the SSRF guard.
|
|
319
|
+
EgressTimeout: The request exceeded ``timeout``.
|
|
320
|
+
EgressError: DNS / connection / socket failure.
|
|
321
|
+
"""
|
|
322
|
+
assert_url_allowed(url)
|
|
323
|
+
request_headers = {"User-Agent": _USER_AGENT, **(headers or {})}
|
|
324
|
+
req = urllib.request.Request(url, headers=request_headers, method="GET")
|
|
325
|
+
try:
|
|
326
|
+
# URL is SSRF-validated by assert_url_allowed above; redirects are
|
|
327
|
+
# disabled via the _opener (NoRedirectHandler) so a 3xx can't escape the guard.
|
|
328
|
+
with _opener.open(req, timeout=timeout) as resp: # nosec B310
|
|
329
|
+
body = resp.read(_MAX_BODY_BYTES)
|
|
330
|
+
resp_headers = {k.lower(): v for k, v in resp.headers.items()}
|
|
331
|
+
return EgressResponse(status=resp.status, body=body, headers=resp_headers)
|
|
332
|
+
except urllib.error.HTTPError as exc:
|
|
333
|
+
# An HTTP error response is still a response — return it so the caller
|
|
334
|
+
# can map 401/403 → invalid token and 5xx → unreachable.
|
|
335
|
+
try:
|
|
336
|
+
body = exc.read(_MAX_BODY_BYTES)
|
|
337
|
+
except (AttributeError, OSError, ValueError): # no body / closed fp
|
|
338
|
+
body = b""
|
|
339
|
+
resp_headers = {k.lower(): v for k, v in (exc.headers or {}).items()}
|
|
340
|
+
return EgressResponse(status=exc.code, body=body, headers=resp_headers)
|
|
341
|
+
except TimeoutError as exc:
|
|
342
|
+
raise EgressTimeout(f"request to {url!r} timed out after {timeout}s") from exc
|
|
343
|
+
except urllib.error.URLError as exc:
|
|
344
|
+
# URLError wraps socket.timeout on some platforms.
|
|
345
|
+
if isinstance(exc.reason, (TimeoutError, socket.timeout)):
|
|
346
|
+
raise EgressTimeout(f"request to {url!r} timed out after {timeout}s") from exc
|
|
347
|
+
raise EgressError(f"request to {url!r} failed: {exc.reason}") from exc
|
|
348
|
+
except OSError as exc:
|
|
349
|
+
raise EgressError(f"request to {url!r} failed: {exc}") from exc
|
|
350
|
+
|
|
351
|
+
|
|
352
|
+
def post_form(
|
|
353
|
+
url: str,
|
|
354
|
+
*,
|
|
355
|
+
data: dict[str, str],
|
|
356
|
+
headers: dict[str, str] | None = None,
|
|
357
|
+
timeout: float = DEFAULT_TIMEOUT,
|
|
358
|
+
) -> EgressResponse:
|
|
359
|
+
"""Perform an SSRF-guarded, redirect-disabled, time-bounded form POST.
|
|
360
|
+
|
|
361
|
+
Same egress policy as :func:`get` — the URL is validated by
|
|
362
|
+
:func:`assert_url_allowed` before any socket is opened, redirects are
|
|
363
|
+
disabled (a 3xx can't bounce the request to an internal host), the response
|
|
364
|
+
body is capped, and non-2xx responses are returned (not raised) so callers
|
|
365
|
+
can read an OAuth error body. ``data`` is ``application/x-www-form-urlencoded``
|
|
366
|
+
encoded — the OAuth 2.0 token endpoint shape (ADR-0187 SSO token exchange).
|
|
367
|
+
|
|
368
|
+
Raises:
|
|
369
|
+
EgressBlocked: The URL failed the SSRF guard.
|
|
370
|
+
EgressTimeout: The request exceeded ``timeout``.
|
|
371
|
+
EgressError: DNS / connection / socket failure.
|
|
372
|
+
"""
|
|
373
|
+
assert_url_allowed(url)
|
|
374
|
+
body = urllib.parse.urlencode(data).encode("ascii")
|
|
375
|
+
request_headers = {
|
|
376
|
+
"User-Agent": _USER_AGENT,
|
|
377
|
+
"Content-Type": "application/x-www-form-urlencoded",
|
|
378
|
+
"Accept": "application/json",
|
|
379
|
+
**(headers or {}),
|
|
380
|
+
}
|
|
381
|
+
req = urllib.request.Request(url, data=body, headers=request_headers, method="POST")
|
|
382
|
+
try:
|
|
383
|
+
# URL is SSRF-validated by assert_url_allowed above; redirects are
|
|
384
|
+
# disabled via the _opener (NoRedirectHandler) so a 3xx can't escape the guard.
|
|
385
|
+
with _opener.open(req, timeout=timeout) as resp: # nosec B310
|
|
386
|
+
resp_body = resp.read(_MAX_BODY_BYTES)
|
|
387
|
+
resp_headers = {k.lower(): v for k, v in resp.headers.items()}
|
|
388
|
+
return EgressResponse(status=resp.status, body=resp_body, headers=resp_headers)
|
|
389
|
+
except urllib.error.HTTPError as exc:
|
|
390
|
+
try:
|
|
391
|
+
resp_body = exc.read(_MAX_BODY_BYTES)
|
|
392
|
+
except (AttributeError, OSError, ValueError):
|
|
393
|
+
resp_body = b""
|
|
394
|
+
resp_headers = {k.lower(): v for k, v in (exc.headers or {}).items()}
|
|
395
|
+
return EgressResponse(status=exc.code, body=resp_body, headers=resp_headers)
|
|
396
|
+
except TimeoutError as exc:
|
|
397
|
+
raise EgressTimeout(f"request to {url!r} timed out after {timeout}s") from exc
|
|
398
|
+
except urllib.error.URLError as exc:
|
|
399
|
+
if isinstance(exc.reason, (TimeoutError, socket.timeout)):
|
|
400
|
+
raise EgressTimeout(f"request to {url!r} timed out after {timeout}s") from exc
|
|
401
|
+
raise EgressError(f"request to {url!r} failed: {exc.reason}") from exc
|
|
402
|
+
except OSError as exc:
|
|
403
|
+
raise EgressError(f"request to {url!r} failed: {exc}") from exc
|
|
@@ -0,0 +1,218 @@
|
|
|
1
|
+
"""My Work integration side-blocks (ADR-0097 §4, #1422).
|
|
2
|
+
|
|
3
|
+
Builds the ``external_items`` and ``external_sources`` first-page blocks that
|
|
4
|
+
``GET /api/v1/me/work/`` returns, so a contributor sees their read-only Jira
|
|
5
|
+
(and future-source) items alongside native TruePPM tasks in one feed.
|
|
6
|
+
|
|
7
|
+
Kept in the integrations app on purpose: the Apache-2.0 / read-only isolation
|
|
8
|
+
invariant (``ExternalWorkItem`` is a personal cache, never a ``Task``, ADR-0097
|
|
9
|
+
§2) lives here, and the projects app only calls :func:`me_work_external_blocks`
|
|
10
|
+
without ever touching ``ExternalWorkItem`` directly. Distinct from the standalone
|
|
11
|
+
``/me/external-items/`` endpoint (``connections.ExternalWorkItemSerializer``),
|
|
12
|
+
which predates #1422 and keeps its own field names; the web reads *this* block.
|
|
13
|
+
"""
|
|
14
|
+
|
|
15
|
+
from __future__ import annotations
|
|
16
|
+
|
|
17
|
+
import logging
|
|
18
|
+
import urllib.parse
|
|
19
|
+
from datetime import timedelta
|
|
20
|
+
from typing import Any
|
|
21
|
+
|
|
22
|
+
from django.conf import settings
|
|
23
|
+
from django.db.models import Case, F, IntegerField, QuerySet, Value, When
|
|
24
|
+
from django.utils import timezone
|
|
25
|
+
from rest_framework import serializers
|
|
26
|
+
|
|
27
|
+
from .connections import STATUS_AUTH_FAILED, STATUS_CONNECTED, last_sync_summary
|
|
28
|
+
from .external_sources import BUCKET_IN_PROGRESS, BUCKET_TODO, EXTERNAL_TASK_SOURCES
|
|
29
|
+
from .models import ExternalSyncRequestReason, ExternalWorkItem, IntegrationCredential
|
|
30
|
+
|
|
31
|
+
logger = logging.getLogger(__name__)
|
|
32
|
+
|
|
33
|
+
# Bucket display-rank: in_progress first, then todo, then done — the order a
|
|
34
|
+
# contributor scans (what am I on now → what's next → what's finished). Applied
|
|
35
|
+
# as the secondary sort after the due-date cascade.
|
|
36
|
+
_BUCKET_RANK = Case(
|
|
37
|
+
When(display_bucket=BUCKET_IN_PROGRESS, then=Value(0)),
|
|
38
|
+
When(display_bucket=BUCKET_TODO, then=Value(1)),
|
|
39
|
+
default=Value(2),
|
|
40
|
+
output_field=IntegerField(),
|
|
41
|
+
)
|
|
42
|
+
|
|
43
|
+
|
|
44
|
+
class MeWorkExternalItemSerializer(serializers.Serializer[Any]):
|
|
45
|
+
"""One external work item in the My Work ``external_items`` block (#1422).
|
|
46
|
+
|
|
47
|
+
Field names are the My Work contract (``source_type`` / ``key`` /
|
|
48
|
+
``status_category`` / ``synced_at`` / ``url``), distinct from the standalone
|
|
49
|
+
``/me/external-items/`` serializer that predates it — the web binds this
|
|
50
|
+
block. Read-only throughout: an external item is a personal cache row, never
|
|
51
|
+
a ``Task`` (ADR-0097 §2), so it carries no schedule/board/action fields.
|
|
52
|
+
"""
|
|
53
|
+
|
|
54
|
+
id = serializers.UUIDField(read_only=True)
|
|
55
|
+
# ``source_type`` is the cross-source discriminator ("jira", "github", …);
|
|
56
|
+
# ``source="source"`` maps it onto the model's ``source`` column (a field
|
|
57
|
+
# literally named ``source`` collides with DRF's internal ``Field.source``).
|
|
58
|
+
source_type = serializers.CharField(source="source", read_only=True)
|
|
59
|
+
key = serializers.CharField(source="external_id", read_only=True)
|
|
60
|
+
title = serializers.CharField(read_only=True, allow_blank=True)
|
|
61
|
+
external_status = serializers.CharField(read_only=True, allow_blank=True)
|
|
62
|
+
status_category = serializers.CharField(source="display_bucket", read_only=True)
|
|
63
|
+
due_date = serializers.DateField(read_only=True, allow_null=True)
|
|
64
|
+
url = serializers.CharField(source="external_url", read_only=True, allow_blank=True)
|
|
65
|
+
synced_at = serializers.DateTimeField(source="last_synced_at", read_only=True, allow_null=True)
|
|
66
|
+
|
|
67
|
+
|
|
68
|
+
def external_items_queryset(user: Any) -> QuerySet[ExternalWorkItem]:
|
|
69
|
+
"""Return the user's live external items, ordered for My Work (#1422).
|
|
70
|
+
|
|
71
|
+
Ordering: ``due_date`` ascending with nulls last (dated work first, then
|
|
72
|
+
undated), then bucket rank (in_progress → todo → done), then most-recently
|
|
73
|
+
synced. The live set is bounded (≤500 per connected source, ADR-0097 §4 — a
|
|
74
|
+
single OSS source today), so the trailing sort over the
|
|
75
|
+
``(user, is_stale, display_bucket)`` index range is cheap and needs no extra
|
|
76
|
+
index. Strictly personal — filters ``user`` and hides soft-removed
|
|
77
|
+
(``is_stale``) rows so no other user can ever see another user's items.
|
|
78
|
+
"""
|
|
79
|
+
return (
|
|
80
|
+
ExternalWorkItem.objects.filter(user=user, is_stale=False)
|
|
81
|
+
.annotate(_bucket_rank=_BUCKET_RANK)
|
|
82
|
+
.order_by(F("due_date").asc(nulls_last=True), "_bucket_rank", "-last_synced_at")
|
|
83
|
+
)
|
|
84
|
+
|
|
85
|
+
|
|
86
|
+
def _site_url(base_url: str) -> str:
|
|
87
|
+
"""Extract the bare host ("truescope.atlassian.net") from a stored base URL."""
|
|
88
|
+
if not base_url:
|
|
89
|
+
return ""
|
|
90
|
+
parsed = urllib.parse.urlparse(base_url if "//" in base_url else f"https://{base_url}")
|
|
91
|
+
return (parsed.hostname or "").lower()
|
|
92
|
+
|
|
93
|
+
|
|
94
|
+
def external_source_summaries(user: Any) -> list[dict[str, Any]]:
|
|
95
|
+
"""Per-source freshness/status for the My Work ``external_sources`` block.
|
|
96
|
+
|
|
97
|
+
One row per ``EXTERNAL_TASK_SOURCES`` provider the user has actually
|
|
98
|
+
connected, so the UI can render a "Jira · synced 2 min ago" freshness line
|
|
99
|
+
and swap to a "Reconnect" prompt when the #1419 pull worker flipped the
|
|
100
|
+
connection to ``auth_failed`` (ADR-0097 §5). A single query over the user's
|
|
101
|
+
credentials — no per-source round-trip.
|
|
102
|
+
|
|
103
|
+
Each row also carries the last pull's outcome (``last_sync``, #2925), because
|
|
104
|
+
this block is what My Work itself renders: a feed truncated at the source's
|
|
105
|
+
page size is otherwise indistinguishable from a complete one, and the place
|
|
106
|
+
that truth matters most is the list the user is actually looking at.
|
|
107
|
+
"""
|
|
108
|
+
source_keys = EXTERNAL_TASK_SOURCES.keys()
|
|
109
|
+
creds = {
|
|
110
|
+
c.provider: c
|
|
111
|
+
for c in IntegrationCredential.objects.filter(user=user, provider__in=source_keys)
|
|
112
|
+
}
|
|
113
|
+
summaries: list[dict[str, Any]] = []
|
|
114
|
+
for key in source_keys:
|
|
115
|
+
row = creds.get(key)
|
|
116
|
+
if row is None:
|
|
117
|
+
continue # only surface sources the user has connected
|
|
118
|
+
source_cls = EXTERNAL_TASK_SOURCES.get(key)
|
|
119
|
+
cfg = row.config or {}
|
|
120
|
+
summaries.append(
|
|
121
|
+
{
|
|
122
|
+
"source_type": key,
|
|
123
|
+
"label": getattr(source_cls, "label", key.title()),
|
|
124
|
+
"site_url": _site_url(row.base_url),
|
|
125
|
+
"status": cfg.get("status") or STATUS_CONNECTED,
|
|
126
|
+
"last_synced_at": row.last_used_at,
|
|
127
|
+
"last_sync": last_sync_summary(cfg),
|
|
128
|
+
}
|
|
129
|
+
)
|
|
130
|
+
return summaries
|
|
131
|
+
|
|
132
|
+
|
|
133
|
+
def _maybe_enqueue_on_open_refresh(user: Any) -> None:
|
|
134
|
+
"""Refresh-if-stale: enqueue a non-blocking ON_OPEN pull for stale connections.
|
|
135
|
+
|
|
136
|
+
ADR-0097 §4 names "an on-open refresh-if-stale when My Work loads" as the
|
|
137
|
+
feature's second trigger (alongside the user-hit-Refresh ``MANUAL`` one) but
|
|
138
|
+
it was never wired (#1921) — ``ExternalSyncRequestReason.ON_OPEN`` sat
|
|
139
|
+
defined-but-unused. This is that wiring.
|
|
140
|
+
|
|
141
|
+
Deliberately fire-and-forget and never allowed to affect the response:
|
|
142
|
+
``enqueue_external_sync`` only writes a small outbox row and hands the
|
|
143
|
+
actual Jira fetch to Celery via a ``transaction.on_commit`` dispatch (see
|
|
144
|
+
``services.py``) — no external HTTP call happens on this request's thread,
|
|
145
|
+
so a slow or unreachable Jira instance cannot slow down or fail My Work.
|
|
146
|
+
Any enqueue failure (unregistered source, broker hiccup inside
|
|
147
|
+
``enqueue_external_sync``) is swallowed for the same reason: a background
|
|
148
|
+
refresh is a nice-to-have, not a condition of the page loading.
|
|
149
|
+
|
|
150
|
+
The staleness check below *is* the throttle, not a separate mechanism: a
|
|
151
|
+
connection whose ``last_used_at`` is inside
|
|
152
|
+
``TRUEPPM_EXTERNAL_SYNC_ON_OPEN_STALE_SECONDS`` is fresh and skipped
|
|
153
|
+
outright, so a user bouncing in and out of My Work does not enqueue a pull
|
|
154
|
+
(let alone hit Jira) on every load — matching the "already low-frequency by
|
|
155
|
+
construction" exemption ``enqueue_external_sync`` already documents for
|
|
156
|
+
this reason. Once a pull *is* enqueued, the outbox's per-``(user, source)``
|
|
157
|
+
partial-unique-PENDING constraint coalesces any further opens onto that
|
|
158
|
+
same in-flight row instead of stacking a second fetch.
|
|
159
|
+
"""
|
|
160
|
+
from .services import enqueue_external_sync
|
|
161
|
+
|
|
162
|
+
source_keys = EXTERNAL_TASK_SOURCES.keys()
|
|
163
|
+
if not source_keys:
|
|
164
|
+
return
|
|
165
|
+
|
|
166
|
+
stale_floor = timedelta(
|
|
167
|
+
seconds=getattr(settings, "TRUEPPM_EXTERNAL_SYNC_ON_OPEN_STALE_SECONDS", 300)
|
|
168
|
+
)
|
|
169
|
+
now = timezone.now()
|
|
170
|
+
|
|
171
|
+
creds = IntegrationCredential.objects.filter(user=user, provider__in=source_keys)
|
|
172
|
+
for cred in creds:
|
|
173
|
+
config = cred.config or {}
|
|
174
|
+
if config.get("status") == STATUS_AUTH_FAILED:
|
|
175
|
+
# A dead token needs "Reconnect", not a retry that will just fail
|
|
176
|
+
# again and needlessly burn the outbox/broker (mirrors the same
|
|
177
|
+
# skip in ``tasks._do_poll``).
|
|
178
|
+
continue
|
|
179
|
+
is_stale = cred.last_used_at is None or (now - cred.last_used_at) >= stale_floor
|
|
180
|
+
if not is_stale:
|
|
181
|
+
continue
|
|
182
|
+
try:
|
|
183
|
+
enqueue_external_sync(user.id, cred.provider, reason=ExternalSyncRequestReason.ON_OPEN)
|
|
184
|
+
except ValueError:
|
|
185
|
+
# Source de-registered since the credential was created — nothing
|
|
186
|
+
# to enqueue against.
|
|
187
|
+
continue
|
|
188
|
+
except Exception:
|
|
189
|
+
# Never let a refresh-if-stale hiccup break the My Work response.
|
|
190
|
+
logger.exception(
|
|
191
|
+
"me_work: on-open refresh enqueue failed for user=%s source=%s",
|
|
192
|
+
user.id,
|
|
193
|
+
cred.provider,
|
|
194
|
+
)
|
|
195
|
+
|
|
196
|
+
|
|
197
|
+
def me_work_external_blocks(user: Any) -> dict[str, Any]:
|
|
198
|
+
"""Build the ``external_items`` + ``external_sources`` My Work side-blocks.
|
|
199
|
+
|
|
200
|
+
Called once, on the first page of ``GET /me/work/`` (mirrors ``signals``).
|
|
201
|
+
Both keys are always present (possibly empty lists) so the web binds one
|
|
202
|
+
stable shape and can distinguish "no source connected" (empty
|
|
203
|
+
``external_sources``) from "connected, nothing assigned" (a source present
|
|
204
|
+
with an empty ``external_items``).
|
|
205
|
+
|
|
206
|
+
Also fires the ADR-0097 §4 on-open refresh-if-stale (#1921): a best-effort,
|
|
207
|
+
non-blocking enqueue of an ``ON_OPEN`` pull for any connected source whose
|
|
208
|
+
cache has gone stale, so the *next* load picks up fresher data without the
|
|
209
|
+
user having to find the manual refresh control. See
|
|
210
|
+
:func:`_maybe_enqueue_on_open_refresh` for the non-blocking/throttle
|
|
211
|
+
contract.
|
|
212
|
+
"""
|
|
213
|
+
items = list(external_items_queryset(user))
|
|
214
|
+
_maybe_enqueue_on_open_refresh(user)
|
|
215
|
+
return {
|
|
216
|
+
"external_items": MeWorkExternalItemSerializer(items, many=True).data,
|
|
217
|
+
"external_sources": external_source_summaries(user),
|
|
218
|
+
}
|
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
"""Initial migration for ``apps.integrations`` — ``IntegrationCredential`` only.
|
|
2
|
+
|
|
3
|
+
``TaskLink`` (#637), the outgoing webhook ``format`` field (#638), and
|
|
4
|
+
``UserNotificationPreference`` table extensions (#639) ship in successor
|
|
5
|
+
migrations that depend on this 0001 baseline.
|
|
6
|
+
"""
|
|
7
|
+
|
|
8
|
+
import uuid
|
|
9
|
+
|
|
10
|
+
import django.db.models.deletion
|
|
11
|
+
from django.conf import settings
|
|
12
|
+
from django.db import migrations, models
|
|
13
|
+
|
|
14
|
+
|
|
15
|
+
class Migration(migrations.Migration):
|
|
16
|
+
initial = True
|
|
17
|
+
|
|
18
|
+
dependencies = [
|
|
19
|
+
migrations.swappable_dependency(settings.AUTH_USER_MODEL),
|
|
20
|
+
]
|
|
21
|
+
|
|
22
|
+
operations = [
|
|
23
|
+
migrations.CreateModel(
|
|
24
|
+
name="IntegrationCredential",
|
|
25
|
+
fields=[
|
|
26
|
+
(
|
|
27
|
+
"id",
|
|
28
|
+
models.UUIDField(
|
|
29
|
+
default=uuid.uuid4,
|
|
30
|
+
editable=False,
|
|
31
|
+
primary_key=True,
|
|
32
|
+
serialize=False,
|
|
33
|
+
),
|
|
34
|
+
),
|
|
35
|
+
("provider", models.CharField(max_length=32)),
|
|
36
|
+
("secret_ciphertext", models.BinaryField()),
|
|
37
|
+
("base_url", models.CharField(blank=True, default="", max_length=512)),
|
|
38
|
+
("created_at", models.DateTimeField(auto_now_add=True)),
|
|
39
|
+
("updated_at", models.DateTimeField(auto_now=True)),
|
|
40
|
+
("last_used_at", models.DateTimeField(blank=True, null=True)),
|
|
41
|
+
("expires_at", models.DateTimeField(blank=True, null=True)),
|
|
42
|
+
(
|
|
43
|
+
"user",
|
|
44
|
+
models.ForeignKey(
|
|
45
|
+
on_delete=django.db.models.deletion.CASCADE,
|
|
46
|
+
related_name="integration_credentials",
|
|
47
|
+
to=settings.AUTH_USER_MODEL,
|
|
48
|
+
),
|
|
49
|
+
),
|
|
50
|
+
],
|
|
51
|
+
options={
|
|
52
|
+
"verbose_name": "Integration credential",
|
|
53
|
+
"verbose_name_plural": "Integration credentials",
|
|
54
|
+
"ordering": ("provider",),
|
|
55
|
+
},
|
|
56
|
+
),
|
|
57
|
+
migrations.AddConstraint(
|
|
58
|
+
model_name="integrationcredential",
|
|
59
|
+
constraint=models.UniqueConstraint(
|
|
60
|
+
fields=("user", "provider"),
|
|
61
|
+
name="integrations_credential_unique_per_user_provider",
|
|
62
|
+
),
|
|
63
|
+
),
|
|
64
|
+
]
|