Workflow Overview
Risk Specification documents follow a four-state approval workflow with controlled transitions and signature requirements:
Workflow States
| State | Purpose | Editable | Signature | Usage |
|---|
| Draft | Initial creation and iterative development | Yes | None | Risk analysis under development; multiple rework cycles expected |
| In Review | Formal review by project approvers | Limited | Required signers added | Waiting for approval decision; reviewers validating content |
| Approved | Formal approval completed and signed | Limited | Signatures satisfied | Ready for publication; stable for reference |
| Published | Final release and baseline | No (read-only in practice) | All signed | Finalized risk specification; used for compliance audits and downstream traceability |
The Draft state is fully editable, allowing iterative development of risk analysis content. Transitions to In Review trigger automatic addition of project approvers as required signers. Approved status indicates formal sign-off, making the risk specification suitable for publication. Published documents serve as stable baselines and are typically referenced by downstream safety activities.
Workflow Actions
sendForReview — Draft → In Review
Initiates the formal review process and creates approval requirements.
| Property | Value |
|---|
| From State | Draft |
| To State | In Review |
| Role Required | Document owner or project admin |
| Auto-Signers Added | All users with project_approver role |
| Signer Role Label | Approver |
| Signature Policy | At least one (atLeastOne) |
What happens:
- Document transitions from editable Draft to In Review state
- All users with the
project_approver role are automatically added as required signers
- Users with
project_approver role can auto-sign using their role credentials
- Review cycle begins; reviewers should validate completeness and accuracy of risk analysis
When to use:
- Risk identification is complete (all hazards/failure modes identified)
- Mitigation measures and risk controls are proposed
- Risksheet data is complete and consistent
approve — In Review → Approved
Records formal approval via signature and advances document to Approved state.
| Property | Value |
|---|
| From State | In Review |
| To State | Approved |
| Requirement | At least one project_approver signature |
| Auto-Signature | Yes, for users with project_approver role |
| Signature Verdict | Approval (document is acceptable) |
What happens:
- Document transitions to Approved state only after signature requirement is satisfied
- At least one project approver must sign (signature policy: atLeastOne)
- Users with
project_approver role can auto-approve without manual action
- Document remains editable but approval is documented
When to use:
- Reviewers have validated risk analysis
- All action items from review are resolved
- Risk specification is ready for publication
publish — Approved → Published
Releases the risk specification as a finalized baseline.
| Property | Value |
|---|
| From State | Approved |
| To State | Published |
| Role Required | Document owner or project admin |
| Signatures | Carried forward from Approved state |
| Finality | Risk specification is now baseline |
What happens:
- Document transitions to Published state, indicating final release
- Signatures from Approved state are maintained and visible
- Risk specification becomes the stable reference for downstream activities
- Published documents are typically used for compliance audits, V&V evidence, and traceability
When to use:
- Risk analysis is complete and approved
- Signatures are obtained and verified
- Content is stable and will not change (except via rework cycle)
- Project milestone or compliance gate is reached
rework — Any State → Draft
Allows return to Draft for corrections or major revisions; invalidates all existing signatures.
| Property | Value |
|---|
| From States | In Review, Approved, or Published |
| To State | Draft |
| Role Required | Document owner or project admin |
| Signature Handling | All signatures marked obsolete; verdict reset |
| Document Mode | Fully editable |
What happens:
- Document transitions back to Draft state regardless of current state
- All existing signatures are marked as obsolete using
MarkWorkflowSignaturesAsObsolete() function
- Signature verdict is reset via
ResetSignaturesVerdict() function
- Document becomes fully editable; review/approval cycle must be repeated
When to use:
- Reviewers identify significant issues requiring rework
- Risk analysis needs major corrections or additions
- Substantial changes to hazard identification or mitigation measures
- ASIL classifications need to be revised
Using the rework action invalidates all previous approvals. After returning to Draft, the document must go through the full sendForReview → approve → publish cycle again. Plan rework carefully to avoid delays in safety compliance activities.
Signature Management
Automatic Signer Addition
When sendForReview is executed, the workflow automatically:
- Queries all users with the
project_approver role in the project
- Adds each approver as a required signer
- Assigns the signer role label: Approver
- Sets signature policy: atLeastOne (at least one signature required)
Signature Policy: atLeastOne
The atLeastOne signature policy means:
- At least one project approver must sign the document
- Multiple approvers can sign; only one signature is required for approval
- Users with
project_approver role can auto-sign (self-approval)
- Document cannot transition to Approved until signature requirement is satisfied
Signature Reset on Rework
When rework is executed:
- All existing signatures are marked as obsolete (no longer valid)
- Signature verdict is reset to “pending”
- Document state returns to Draft
- All signatures are cleared; no signers carry forward
- Next sendForReview cycle creates fresh signature requirements
Document Workflow Integration
Risk Specification documents participate in the TestAuto2 approval workflow alongside other document types. The workflow ensures:
- Controlled approval gates — Risk specifications cannot be published without formal review and signature
- Audit trail — All approvals, signatures, and state transitions are recorded
- Iterative development — Rework action enables refinement cycles without workflow restart
- Compliance evidence — Published documents with signatures serve as evidence of formal risk assessment completion
| Document Type | Workflow | Initial State | Publication Path |
|---|
| riskSpecification | Risk Specification | Draft | Draft → In Review → Approved → Published |
| riskSpecification (FMEA) | Risk Specification | Draft | Draft → In Review → Approved → Published |
| riskSpecification (HARA) | Risk Specification | Draft | Draft → In Review → Approved → Published |
| riskSpecification (Control Plan) | Risk Specification | Draft | Draft → In Review → Approved → Published |
Typical Risk Specification Workflow Sequence
Phase 1: Development (Draft)
- Create new risk specification module (FMEA, HARA, HAZID, or Control Plan)
- Configure Risksheet columns and hierarchies per module type
- Populate risk data iteratively:
- Identify hazards/failure modes
- Assess severity/occurrence/detection ratings
- Define risk controls and mitigations
- Calculate risk priority (RPN, ASIL, etc.)
- Validate completeness using coverage reports and dashboard metrics
Phase 2: Review (In Review)
- Execute sendForReview action
- Approvers are automatically added as required signers
- Document state changes to In Review
- Project approvers review risk analysis:
- Validate hazard identification completeness
- Check rating consistency and justification
- Verify risk controls are adequate
- Identify any gaps or inconsistencies
- If issues found, return to Draft via rework action and repeat Phase 1
- If satisfied, approvers sign the document
Phase 3: Approval (Approved)
- Execute approve action once at least one approver has signed
- Document transitions to Approved state
- Signatures are finalized and documented
- Document is now authorized for publication
Phase 4: Publication (Published)
- Execute publish action to release risk specification
- Document transitions to Published state
- Risk specification becomes the official baseline
- Used as reference for:
- Traceability to downstream safety activities
- Compliance audit evidence
- V&V test case derivation
- Risk control implementation tracking
Common Workflow Patterns
Single Rework Cycle (Minor Issues)
After rework, return to Draft and repeat the development and review cycle.
Multiple Rework Cycles (Major Revisions)
Multiple iterations may be needed for complex risk analyses with ASIL changes or major control plan revisions.
Fast-Track Approval (Straightforward Analysis)
For well-defined, straightforward risk analyses that require minimal rework.
Role-Based Responsibilities
| Role | Responsibilities | Workflow Actions |
|---|
| Risk Analyst | Develop hazard identification, complete Risksheet data, calculate risk ratings | Work in Draft state; populate risk data |
| Safety Engineer | Review risk identification completeness, validate ASIL/RPN calculations, approve scope | Review in In Review state; sign document |
| Design Engineer | Propose risk controls, verify feasibility of mitigations | Contribute control descriptions in Draft |
| Project Manager | Gate risk analysis completion, coordinate reviews, approve publication | Execute publish action; monitor metrics |
| Project Approver | Formal approval authority; sign off on risk analysis | Execute approve action; sign when required |
Workflow State Transitions Reference
| Action | From | To | Signature | Requirements |
|---|
| sendForReview | Draft | In Review | Added auto | Owner/Admin |
| approve | In Review | Approved | ≥1 signed | Approver signature |
| publish | Approved | Published | Carried | Owner/Admin |
| rework | In Review / Approved / Published | Draft | Reset | Owner/Admin |
Integration with TestAuto2 Standards
The Risk Specification Workflow supports compliance with:
- ISO 26262 — Formal approval of Hazard Analysis and Risk Assessment (HARA) and failure mode analysis documents
- AIAG-VDA FMEA — Controlled release of System FMEA, Design FMEA, and Process FMEA analyses
- ISO 14971 — Formal risk management documentation and sign-off
- IATF 16949 — Control Plan release and process risk assessment approval
See Workflow Lifecycle for broader workflow concepts and Document Workflow States for general document approval patterns.