Activity Logging Patterns

Guide for implementing audit-compliant activity emission in OptAIC services.

When to Use

Apply when:

• Implementing service layer methods that mutate state
• Adding new domain resource operations (CRUD)
• Tracking execution events (runs, training, backtests)
• Implementing approval/promotion workflows
• Ensuring audit trail compliance

Core Rule

If it changes state, it MUST emit an activity.

All mutations must emit activities in the service layer (not API handlers or models).