feat: implement automation module

- Event-based triggers (Phase 1):
  - Trigger/TriggerLog models with field_change type
  - TriggerService for condition evaluation and action execution
  - Trigger CRUD API endpoints
  - Task integration (status, assignee, priority changes)
  - Frontend: TriggerList, TriggerForm components

- Weekly reports (Phase 2):
  - ScheduledReport/ReportHistory models
  - ReportService for stats generation
  - APScheduler for Friday 16:00 job
  - Report preview/generate/history API
  - Frontend: WeeklyReportPreview, ReportHistory components

- Tests: 23 new tests (14 triggers + 9 reports)
- OpenSpec: add-automation change archived

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
beabigegg
2025-12-29 22:59:00 +08:00
parent 3108fe1dff
commit 95c281d8e1
32 changed files with 3163 additions and 3 deletions

View File

@@ -14,10 +14,16 @@ from app.models.audit_log import AuditLog, AuditAction, SensitivityLevel, EVENT_
from app.models.audit_alert import AuditAlert
from app.models.attachment import Attachment
from app.models.attachment_version import AttachmentVersion
from app.models.trigger import Trigger, TriggerType
from app.models.trigger_log import TriggerLog, TriggerLogStatus
from app.models.scheduled_report import ScheduledReport, ReportType
from app.models.report_history import ReportHistory, ReportHistoryStatus
__all__ = [
"User", "Role", "Department", "Space", "Project", "TaskStatus", "Task", "WorkloadSnapshot",
"Comment", "Mention", "Notification", "Blocker",
"AuditLog", "AuditAlert", "AuditAction", "SensitivityLevel", "EVENT_SENSITIVITY", "ALERT_EVENTS",
"Attachment", "AttachmentVersion"
"Attachment", "AttachmentVersion",
"Trigger", "TriggerType", "TriggerLog", "TriggerLogStatus",
"ScheduledReport", "ReportType", "ReportHistory", "ReportHistoryStatus"
]

View File

@@ -38,3 +38,4 @@ class Project(Base):
department = relationship("Department", back_populates="projects")
task_statuses = relationship("TaskStatus", back_populates="project", cascade="all, delete-orphan")
tasks = relationship("Task", back_populates="project", cascade="all, delete-orphan")
triggers = relationship("Trigger", back_populates="project", cascade="all, delete-orphan")

View File

@@ -0,0 +1,28 @@
import uuid
import enum
from sqlalchemy import Column, String, Text, DateTime, ForeignKey, Enum, JSON
from sqlalchemy.sql import func
from sqlalchemy.orm import relationship
from app.core.database import Base
class ReportHistoryStatus(str, enum.Enum):
SENT = "sent"
FAILED = "failed"
class ReportHistory(Base):
__tablename__ = "pjctrl_report_history"
id = Column(String(36), primary_key=True, default=lambda: str(uuid.uuid4()))
report_id = Column(String(36), ForeignKey("pjctrl_scheduled_reports.id", ondelete="CASCADE"), nullable=False)
generated_at = Column(DateTime, server_default=func.now(), nullable=False)
content = Column(JSON, nullable=False)
status = Column(
Enum("sent", "failed", name="report_history_status_enum"),
nullable=False
)
error_message = Column(Text, nullable=True)
# Relationships
report = relationship("ScheduledReport", back_populates="history")

View File

@@ -0,0 +1,28 @@
import uuid
import enum
from sqlalchemy import Column, String, Boolean, DateTime, ForeignKey, Enum
from sqlalchemy.sql import func
from sqlalchemy.orm import relationship
from app.core.database import Base
class ReportType(str, enum.Enum):
WEEKLY = "weekly"
class ScheduledReport(Base):
__tablename__ = "pjctrl_scheduled_reports"
id = Column(String(36), primary_key=True, default=lambda: str(uuid.uuid4()))
report_type = Column(
Enum("weekly", name="report_type_enum"),
nullable=False
)
recipient_id = Column(String(36), ForeignKey("pjctrl_users.id", ondelete="CASCADE"), nullable=False)
is_active = Column(Boolean, default=True, nullable=False)
last_sent_at = Column(DateTime, nullable=True)
created_at = Column(DateTime, server_default=func.now(), nullable=False)
# Relationships
recipient = relationship("User", back_populates="scheduled_reports")
history = relationship("ReportHistory", back_populates="report", cascade="all, delete-orphan")

View File

@@ -48,3 +48,4 @@ class Task(Base):
comments = relationship("Comment", back_populates="task", cascade="all, delete-orphan")
blockers = relationship("Blocker", back_populates="task", cascade="all, delete-orphan")
attachments = relationship("Attachment", back_populates="task", cascade="all, delete-orphan")
trigger_logs = relationship("TriggerLog", back_populates="task")

View File

@@ -0,0 +1,35 @@
import uuid
import enum
from sqlalchemy import Column, String, Text, Boolean, DateTime, ForeignKey, Enum, JSON
from sqlalchemy.sql import func
from sqlalchemy.orm import relationship
from app.core.database import Base
class TriggerType(str, enum.Enum):
FIELD_CHANGE = "field_change"
SCHEDULE = "schedule"
class Trigger(Base):
__tablename__ = "pjctrl_triggers"
id = Column(String(36), primary_key=True, default=lambda: str(uuid.uuid4()))
project_id = Column(String(36), ForeignKey("pjctrl_projects.id", ondelete="CASCADE"), nullable=False)
name = Column(String(200), nullable=False)
description = Column(Text, nullable=True)
trigger_type = Column(
Enum("field_change", "schedule", name="trigger_type_enum"),
nullable=False
)
conditions = Column(JSON, nullable=False)
actions = Column(JSON, nullable=False)
is_active = Column(Boolean, default=True, nullable=False)
created_by = Column(String(36), ForeignKey("pjctrl_users.id", ondelete="SET NULL"), nullable=True)
created_at = Column(DateTime, server_default=func.now(), nullable=False)
updated_at = Column(DateTime, server_default=func.now(), onupdate=func.now(), nullable=False)
# Relationships
project = relationship("Project", back_populates="triggers")
creator = relationship("User", back_populates="created_triggers")
logs = relationship("TriggerLog", back_populates="trigger", cascade="all, delete-orphan")

View File

@@ -0,0 +1,30 @@
import uuid
import enum
from sqlalchemy import Column, String, Text, DateTime, ForeignKey, Enum, JSON
from sqlalchemy.sql import func
from sqlalchemy.orm import relationship
from app.core.database import Base
class TriggerLogStatus(str, enum.Enum):
SUCCESS = "success"
FAILED = "failed"
class TriggerLog(Base):
__tablename__ = "pjctrl_trigger_logs"
id = Column(String(36), primary_key=True, default=lambda: str(uuid.uuid4()))
trigger_id = Column(String(36), ForeignKey("pjctrl_triggers.id", ondelete="CASCADE"), nullable=False)
task_id = Column(String(36), ForeignKey("pjctrl_tasks.id", ondelete="SET NULL"), nullable=True)
executed_at = Column(DateTime, server_default=func.now(), nullable=False)
status = Column(
Enum("success", "failed", name="trigger_log_status_enum"),
nullable=False
)
details = Column(JSON, nullable=True)
error_message = Column(Text, nullable=True)
# Relationships
trigger = relationship("Trigger", back_populates="logs")
task = relationship("Task", back_populates="trigger_logs")

View File

@@ -36,3 +36,7 @@ class User(Base):
notifications = relationship("Notification", back_populates="user", cascade="all, delete-orphan")
reported_blockers = relationship("Blocker", foreign_keys="Blocker.reported_by", back_populates="reporter")
resolved_blockers = relationship("Blocker", foreign_keys="Blocker.resolved_by", back_populates="resolver")
# Automation relationships
created_triggers = relationship("Trigger", back_populates="creator")
scheduled_reports = relationship("ScheduledReport", back_populates="recipient", cascade="all, delete-orphan")