trueppm-api 0.4.0b2__py3-none-any.whl

trueppm_api/apps/projects/migrations/0010_risk.py

@@ -0,0 +1,229 @@
+# Generated for feat/risk-register (issue #52)
+
+import uuid
+
+import django.db.models.deletion
+import simple_history.models
+from django.conf import settings
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("projects", "0009_historicaldependency_historicalproject_and_more"),
+        migrations.swappable_dependency(settings.AUTH_USER_MODEL),
+    ]
+
+    operations = [
+        # -----------------------------------------------------------------------
+        # Risk
+        # -----------------------------------------------------------------------
+        migrations.CreateModel(
+            name="Risk",
+            fields=[
+                (
+                    "id",
+                    models.UUIDField(
+                        default=uuid.uuid4, editable=False, primary_key=True, serialize=False
+                    ),
+                ),
+                ("server_version", models.BigIntegerField(default=0, editable=False)),
+                ("is_deleted", models.BooleanField(db_index=True, default=False)),
+                ("deleted_version", models.BigIntegerField(blank=True, editable=False, null=True)),
+                ("title", models.CharField(max_length=512)),
+                ("description", models.TextField(blank=True)),
+                (
+                    "status",
+                    models.CharField(
+                        choices=[
+                            ("OPEN", "Open"),
+                            ("MITIGATING", "Mitigating"),
+                            ("RESOLVED", "Resolved"),
+                            ("ACCEPTED", "Accepted"),
+                            ("CLOSED", "Closed"),
+                        ],
+                        db_index=True,
+                        default="OPEN",
+                        max_length=12,
+                    ),
+                ),
+                ("probability", models.PositiveSmallIntegerField()),
+                ("impact", models.PositiveSmallIntegerField()),
+                ("created_at", models.DateTimeField(auto_now_add=True)),
+                ("updated_at", models.DateTimeField(auto_now=True)),
+                (
+                    "project",
+                    models.ForeignKey(
+                        on_delete=django.db.models.deletion.CASCADE,
+                        related_name="risks",
+                        to="projects.project",
+                    ),
+                ),
+                (
+                    "owner",
+                    models.ForeignKey(
+                        blank=True,
+                        null=True,
+                        on_delete=django.db.models.deletion.SET_NULL,
+                        related_name="owned_risks",
+                        to=settings.AUTH_USER_MODEL,
+                    ),
+                ),
+                (
+                    "created_by",
+                    models.ForeignKey(
+                        blank=True,
+                        null=True,
+                        on_delete=django.db.models.deletion.SET_NULL,
+                        related_name="created_risks",
+                        to=settings.AUTH_USER_MODEL,
+                    ),
+                ),
+            ],
+            options={
+                "db_table": "projects_risk",
+                "ordering": ["-impact", "-probability", "title"],
+            },
+        ),
+        migrations.AddIndex(
+            model_name="risk",
+            index=models.Index(fields=["project", "status"], name="risk_project_status_idx"),
+        ),
+        # -----------------------------------------------------------------------
+        # RiskTask (through table)
+        # -----------------------------------------------------------------------
+        migrations.CreateModel(
+            name="RiskTask",
+            fields=[
+                (
+                    "id",
+                    models.UUIDField(
+                        default=uuid.uuid4, editable=False, primary_key=True, serialize=False
+                    ),
+                ),
+                (
+                    "risk",
+                    models.ForeignKey(
+                        on_delete=django.db.models.deletion.CASCADE,
+                        to="projects.risk",
+                    ),
+                ),
+                (
+                    "task",
+                    models.ForeignKey(
+                        on_delete=django.db.models.deletion.CASCADE,
+                        to="projects.task",
+                    ),
+                ),
+            ],
+            options={
+                "db_table": "projects_risk_task",
+            },
+        ),
+        migrations.AlterUniqueTogether(
+            name="risktask",
+            unique_together={("risk", "task")},
+        ),
+        # tasks M2M — must come after RiskTask is created
+        migrations.AddField(
+            model_name="risk",
+            name="tasks",
+            field=models.ManyToManyField(
+                blank=True,
+                related_name="risks",
+                through="projects.RiskTask",
+                to="projects.task",
+            ),
+        ),
+        # -----------------------------------------------------------------------
+        # HistoricalRisk (django-simple-history audit table)
+        # server_version and deleted_version are excluded via excluded_fields=_HISTORY_EXCLUDED_BASE
+        # -----------------------------------------------------------------------
+        migrations.CreateModel(
+            name="HistoricalRisk",
+            fields=[
+                ("id", models.UUIDField(db_index=True, default=uuid.uuid4, editable=False)),
+                ("is_deleted", models.BooleanField(db_index=True, default=False)),
+                ("title", models.CharField(max_length=512)),
+                ("description", models.TextField(blank=True)),
+                (
+                    "status",
+                    models.CharField(
+                        choices=[
+                            ("OPEN", "Open"),
+                            ("MITIGATING", "Mitigating"),
+                            ("RESOLVED", "Resolved"),
+                            ("ACCEPTED", "Accepted"),
+                            ("CLOSED", "Closed"),
+                        ],
+                        db_index=True,
+                        default="OPEN",
+                        max_length=12,
+                    ),
+                ),
+                ("probability", models.PositiveSmallIntegerField()),
+                ("impact", models.PositiveSmallIntegerField()),
+                ("created_at", models.DateTimeField(blank=True, editable=False)),
+                ("updated_at", models.DateTimeField(blank=True, editable=False)),
+                ("history_id", models.AutoField(primary_key=True, serialize=False)),
+                ("history_date", models.DateTimeField(db_index=True)),
+                ("history_change_reason", models.CharField(max_length=100, null=True)),
+                (
+                    "history_type",
+                    models.CharField(
+                        choices=[("+", "Created"), ("~", "Changed"), ("-", "Deleted")],
+                        max_length=1,
+                    ),
+                ),
+                (
+                    "project",
+                    models.ForeignKey(
+                        blank=True,
+                        db_constraint=False,
+                        null=True,
+                        on_delete=django.db.models.deletion.DO_NOTHING,
+                        related_name="+",
+                        to="projects.project",
+                    ),
+                ),
+                (
+                    "owner",
+                    models.ForeignKey(
+                        blank=True,
+                        db_constraint=False,
+                        null=True,
+                        on_delete=django.db.models.deletion.DO_NOTHING,
+                        related_name="+",
+                        to=settings.AUTH_USER_MODEL,
+                    ),
+                ),
+                (
+                    "created_by",
+                    models.ForeignKey(
+                        blank=True,
+                        db_constraint=False,
+                        null=True,
+                        on_delete=django.db.models.deletion.DO_NOTHING,
+                        related_name="+",
+                        to=settings.AUTH_USER_MODEL,
+                    ),
+                ),
+                (
+                    "history_user",
+                    models.ForeignKey(
+                        null=True,
+                        on_delete=django.db.models.deletion.SET_NULL,
+                        related_name="+",
+                        to=settings.AUTH_USER_MODEL,
+                    ),
+                ),
+            ],
+            options={
+                "verbose_name": "historical risk",
+                "verbose_name_plural": "historical risks",
+                "ordering": ("-history_date", "-history_id"),
+                "get_latest_by": ("history_date", "history_id"),
+            },
+            bases=(simple_history.models.HistoricalChanges, models.Model),
+        ),
+    ]

trueppm_api/apps/projects/migrations/0011_task_status.py

@@ -0,0 +1,27 @@
+"""Add Task.status field for the board/kanban view (issue #21, #58)."""
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("projects", "0010_risk"),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name="task",
+            name="status",
+            field=models.CharField(
+                choices=[
+                    ("NOT_STARTED", "Not started"),
+                    ("IN_PROGRESS", "In progress"),
+                    ("ON_HOLD", "On hold"),
+                    ("COMPLETE", "Complete"),
+                ],
+                db_index=True,
+                default="NOT_STARTED",
+                max_length=12,
+            ),
+        ),
+    ]

trueppm_api/apps/projects/migrations/0012_task_status.py

@@ -0,0 +1,27 @@
+# Generated by Django 5.1.15 on 2026-03-26 22:55
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("projects", "0011_task_status"),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name="historicaltask",
+            name="status",
+            field=models.CharField(
+                choices=[
+                    ("NOT_STARTED", "Not started"),
+                    ("IN_PROGRESS", "In progress"),
+                    ("ON_HOLD", "On hold"),
+                    ("COMPLETE", "Complete"),
+                ],
+                db_index=True,
+                default="NOT_STARTED",
+                max_length=12,
+            ),
+        ),
+    ]

trueppm_api/apps/projects/migrations/0013_task_planned_start.py

@@ -0,0 +1,24 @@
+# Generated by Django 5.2.12 on 2026-03-27 03:52
+
+from django.db import migrations, models
+
+_HELP = "Start no earlier than (SNET). CPM floor applied during forward pass."
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("projects", "0012_task_status"),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name="historicaltask",
+            name="planned_start",
+            field=models.DateField(blank=True, db_index=True, help_text=_HELP, null=True),
+        ),
+        migrations.AddField(
+            model_name="task",
+            name="planned_start",
+            field=models.DateField(blank=True, db_index=True, help_text=_HELP, null=True),
+        ),
+    ]

trueppm_api/apps/projects/migrations/0014_short_hex_ids.py

@@ -0,0 +1,74 @@
+"""Add short_id to Task and Risk, object_sequence to Project (ADR-0016)."""
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("projects", "0013_task_planned_start"),
+    ]
+
+    operations = [
+        # Project.object_sequence — per-project sequential counter shared by
+        # Tasks and Risks for short_id generation.
+        migrations.AddField(
+            model_name="project",
+            name="object_sequence",
+            field=models.BigIntegerField(default=0, editable=False),
+        ),
+        migrations.AddField(
+            model_name="historicalproject",
+            name="object_sequence",
+            field=models.BigIntegerField(default=0, editable=False),
+        ),
+        # Task.short_id
+        migrations.AddField(
+            model_name="task",
+            name="short_id",
+            field=models.CharField(blank=True, max_length=8, editable=False),
+        ),
+        migrations.AddField(
+            model_name="historicaltask",
+            name="short_id",
+            field=models.CharField(blank=True, max_length=8, editable=False),
+        ),
+        # Risk.short_id
+        migrations.AddField(
+            model_name="risk",
+            name="short_id",
+            field=models.CharField(blank=True, max_length=8, editable=False),
+        ),
+        migrations.AddField(
+            model_name="historicalrisk",
+            name="short_id",
+            field=models.CharField(blank=True, max_length=8, editable=False),
+        ),
+        # Unique constraints: (project, short_id) on both Task and Risk.
+        # safe-constraint: UNREACHABLE, not safe. `short_id` is added just above with no
+        # default, so Django backfills '' on every existing row, and this constraint is
+        # then added unconditionally with no RunPython in between — two tasks in one
+        # project both land on (project, ''). This is the #3068 defect class, already
+        # shipped.
+        #
+        # It is deliberately NOT repaired. A fresh install takes
+        # 0001_squashed_0094_..., where this constraint sits inside CreateModel and the
+        # table is empty; any database old enough to run 0014 is long past it. Editing
+        # an applied migration to fix a path nothing can travel is the more dangerous
+        # act. Recorded here so the next sweep does not re-derive it (#3080).
+        migrations.AddConstraint(
+            model_name="task",
+            constraint=models.UniqueConstraint(
+                fields=["project", "short_id"],
+                name="unique_task_short_id_per_project",
+            ),
+        ),
+        # safe-constraint: UNREACHABLE, not safe — same as the Task constraint above.
+        # See that comment for why it is recorded rather than repaired (#3080).
+        migrations.AddConstraint(
+            model_name="risk",
+            constraint=models.UniqueConstraint(
+                fields=["project", "short_id"],
+                name="unique_risk_short_id_per_project",
+            ),
+        ),
+    ]

trueppm_api/apps/projects/migrations/0015_backfill_short_ids.py

@@ -0,0 +1,48 @@
+"""Backfill short_id for existing Tasks and Risks (ADR-0016).
+
+Assigns sequential hex IDs ordered by PK (UUID, deterministic but arbitrary).
+Sets Project.object_sequence to the highest assigned value.
+"""
+
+from typing import Any
+
+from django.db import migrations
+
+
+def backfill_short_ids(apps: Any, schema_editor: Any) -> None:
+    Project = apps.get_model("projects", "Project")
+    Task = apps.get_model("projects", "Task")
+    Risk = apps.get_model("projects", "Risk")
+
+    for project in Project.objects.all():
+        seq = 0
+        # Backfill tasks ordered by PK for deterministic assignment.
+        for task in Task.objects.filter(project=project).order_by("id"):
+            seq += 1
+            Task.objects.filter(pk=task.pk).update(short_id=f"{seq:08X}")
+        # Continue the same counter for risks.
+        for risk in Risk.objects.filter(project=project).order_by("id"):
+            seq += 1
+            Risk.objects.filter(pk=risk.pk).update(short_id=f"{seq:08X}")
+        # Persist the counter so new objects continue the sequence.
+        if seq > 0:
+            Project.objects.filter(pk=project.pk).update(object_sequence=seq)
+
+
+def reverse_backfill(apps: Any, schema_editor: Any) -> None:
+    Task = apps.get_model("projects", "Task")
+    Risk = apps.get_model("projects", "Risk")
+    Project = apps.get_model("projects", "Project")
+    Task.objects.all().update(short_id="")
+    Risk.objects.all().update(short_id="")
+    Project.objects.all().update(object_sequence=0)
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("projects", "0014_short_hex_ids"),
+    ]
+
+    operations = [
+        migrations.RunPython(backfill_short_ids, reverse_backfill, elidable=True),
+    ]

trueppm_api/apps/projects/migrations/0016_task_actual_dates.py

@@ -0,0 +1,42 @@
+"""Add actual_start and actual_finish to Task and BaselineTask."""
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("projects", "0015_backfill_short_ids"),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name="task",
+            name="actual_start",
+            field=models.DateField(blank=True, db_index=True, null=True),
+        ),
+        migrations.AddField(
+            model_name="task",
+            name="actual_finish",
+            field=models.DateField(blank=True, db_index=True, null=True),
+        ),
+        migrations.AddField(
+            model_name="baselinetask",
+            name="actual_start",
+            field=models.DateField(blank=True, null=True),
+        ),
+        migrations.AddField(
+            model_name="baselinetask",
+            name="actual_finish",
+            field=models.DateField(blank=True, null=True),
+        ),
+        migrations.AddField(
+            model_name="historicaltask",
+            name="actual_start",
+            field=models.DateField(blank=True, db_index=True, null=True),
+        ),
+        migrations.AddField(
+            model_name="historicaltask",
+            name="actual_finish",
+            field=models.DateField(blank=True, db_index=True, null=True),
+        ),
+    ]

trueppm_api/apps/projects/migrations/0017_boardcolumnconfig.py

@@ -0,0 +1,43 @@
+from __future__ import annotations
+
+import django.db.models.deletion
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("projects", "0016_task_actual_dates"),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name="BoardColumnConfig",
+            fields=[
+                (
+                    "id",
+                    models.BigAutoField(
+                        auto_created=True, primary_key=True, serialize=False, verbose_name="ID"
+                    ),
+                ),
+                (
+                    "columns",
+                    models.JSONField(
+                        default=list,
+                        help_text="Ordered list of {status, label, visible} objects.",
+                    ),
+                ),
+                (
+                    "project",
+                    models.OneToOneField(
+                        on_delete=django.db.models.deletion.CASCADE,
+                        related_name="board_column_config",
+                        to="projects.project",
+                    ),
+                ),
+            ],
+            options={
+                "verbose_name": "board column config",
+                "verbose_name_plural": "board column configs",
+            },
+        ),
+    ]

trueppm_api/apps/projects/migrations/0018_estimation_governance.py

@@ -0,0 +1,62 @@
+# Generated by Django 6.0.3 on 2026-04-25 11:44
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("projects", "0017_boardcolumnconfig"),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name="historicalproject",
+            name="estimation_mode",
+            field=models.CharField(
+                choices=[
+                    ("open", "Open"),
+                    ("suggest_approve", "Suggest & Approve"),
+                    ("pm_only", "PM Only"),
+                ],
+                default="open",
+                max_length=16,
+            ),
+        ),
+        migrations.AddField(
+            model_name="historicaltask",
+            name="estimate_status",
+            field=models.CharField(
+                blank=True,
+                choices=[("pending", "Pending Approval"), ("accepted", "Accepted")],
+                db_index=True,
+                help_text="Approval state for three-point estimates (suggest_approve mode only).",
+                max_length=12,
+                null=True,
+            ),
+        ),
+        migrations.AddField(
+            model_name="project",
+            name="estimation_mode",
+            field=models.CharField(
+                choices=[
+                    ("open", "Open"),
+                    ("suggest_approve", "Suggest & Approve"),
+                    ("pm_only", "PM Only"),
+                ],
+                default="open",
+                max_length=16,
+            ),
+        ),
+        migrations.AddField(
+            model_name="task",
+            name="estimate_status",
+            field=models.CharField(
+                blank=True,
+                choices=[("pending", "Pending Approval"), ("accepted", "Accepted")],
+                db_index=True,
+                help_text="Approval state for three-point estimates (suggest_approve mode only).",
+                max_length=12,
+                null=True,
+            ),
+        ),
+    ]

trueppm_api/apps/projects/migrations/0019_backfill_wbs_paths.py

@@ -0,0 +1,28 @@
+"""Backfill wbs_path for tasks that were created before auto-assignment was added.
+
+Tasks with null wbs_path have no hierarchy information (parent_id is derived
+from wbs_path, not stored separately), so they are assigned sequential root-level
+paths within their project, ordered by short_id (project-scoped insertion order).
+"""
+
+from __future__ import annotations
+
+from django.db import migrations
+
+from trueppm_api.apps.projects.backfill import _backfill_wbs_paths
+
+
+def _noop(apps: object, schema_editor: object) -> None:
+    # Reversing would require knowing the original null state, which is not
+    # stored.  Accept data loss on reverse — this migration is additive only.
+    pass
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("projects", "0018_estimation_governance"),
+    ]
+
+    operations = [
+        migrations.RunPython(_backfill_wbs_paths, _noop, elidable=True),
+    ]

trueppm_api/apps/projects/migrations/0020_task_status_5col.py

@@ -0,0 +1,65 @@
+"""5-column board model: add BACKLOG and REVIEW to TaskStatus; migrate ON_HOLD → BACKLOG.
+
+Issue #178 — Claude Design handoff phase 0.
+"""
+
+from __future__ import annotations
+
+from typing import Any
+
+from django.db import migrations, models
+
+_NEW_CHOICES = [
+    ("BACKLOG", "Backlog"),
+    ("NOT_STARTED", "Not started"),
+    ("IN_PROGRESS", "In progress"),
+    ("REVIEW", "Review"),
+    ("ON_HOLD", "On hold"),
+    ("COMPLETE", "Complete"),
+]
+
+
+def _migrate_on_hold_to_backlog(apps: Any, schema_editor: object) -> None:
+    Task = apps.get_model("projects", "Task")
+    Task.objects.filter(status="ON_HOLD").update(status="BACKLOG")
+
+
+def _reverse_migrate(apps: Any, schema_editor: object) -> None:
+    # Reverse: BACKLOG has no direct predecessor in the old enum; map back to NOT_STARTED.
+    # REVIEW has no predecessor either; map back to IN_PROGRESS.
+    Task = apps.get_model("projects", "Task")
+    Task.objects.filter(status="BACKLOG").update(status="NOT_STARTED")
+    Task.objects.filter(status="REVIEW").update(status="IN_PROGRESS")
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("projects", "0019_backfill_wbs_paths"),
+    ]
+
+    operations = [
+        # 1. Expand choices on Task.status (no column-type change — still CharField max_length=12)
+        migrations.AlterField(
+            model_name="task",
+            name="status",
+            field=models.CharField(
+                choices=_NEW_CHOICES,
+                db_index=True,
+                default="NOT_STARTED",
+                max_length=12,
+            ),
+        ),
+        # 2. Expand choices on HistoricalTask.status
+        migrations.AlterField(
+            model_name="historicaltask",
+            name="status",
+            field=models.CharField(
+                choices=_NEW_CHOICES,
+                db_index=True,
+                default="NOT_STARTED",
+                max_length=12,
+            ),
+        ),
+        # 3. Data migration: ON_HOLD → BACKLOG
+        migrations.RunPython(_migrate_on_hold_to_backlog, _reverse_migrate, elidable=True),
+    ]