Skip to main content

Workflow Database Documentation

Audience

Backend engineers, database engineers, QA, support, security engineers, solution architects and implementation partners.

Overview

This section documents the verified EF Core persistence model owned by Workflow Service. It does not provide connection details, operational commands or executable database statements.

Summary

Workflow persistence is Foundation/Transitional. One runtime DbContext owns a dedicated schema and 11 entity sets. Definition and instance aggregates use cascade relationships; audit, timeline, processed-event and outbox records share the same context.

One initial migration and one model snapshot exist. Development startup can migrate and seed five published definitions. No retention worker, concurrency token, database-specific test project or production migration procedure was found.

Documentation map

Start with database overview, persistence architecture and DbContext inventory. Entity pages cover definitions, versions, steps, conditions, instances, tasks, actions, audit/timeline, outbox and processed events.

Engineering references cover tenant isolation, mappings, relationships, indexes/constraints, value conversions, queries, transactions, concurrency, migrations, seeding, retention, testing, schema, limitations and source map.

Requires Confirmation

Production migration ownership, tenant trust, outbox/processed-event isolation, retention, concurrency policy, backup/recovery and database test ownership require confirmation.

Source References

  • microservices/src/workflow-service/Infrastructure/WorkflowDbContext.cs
  • microservices/src/workflow-service/Infrastructure/Persistence.cs
  • microservices/src/workflow-service/Infrastructure/Migrations/20260706165438_InitialWorkflowSchema.cs
  • microservices/src/workflow-service/Infrastructure/DevelopmentSeeder.cs

See Also

Keywords

Workflow database, EF Core, Workflow schema.

Revision Information

  • Status: Draft
  • Last reviewed: 2026-07-20
  • Next review: 2026-10-20