3f1444541f
Split 4 oversized files (503-679 LOC each) into focused units all under 500 LOC: - tech_file_generator.go → +_prompts, +_prompt_builder, +_fallback - hazard_patterns_extended.go → +_extended2.go (HP074-HP102 extracted) - models.go → +_entities.go, +_api.go (enums / DB entities / API types) - completeness.go → +_gates.go (gate definitions extracted) All files remain in package iace. Zero behavior changes. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
237 lines
12 KiB
Go
237 lines
12 KiB
Go
package iace
|
|
|
|
import (
|
|
"encoding/json"
|
|
"time"
|
|
|
|
"github.com/google/uuid"
|
|
)
|
|
|
|
// ============================================================================
|
|
// Main Entities
|
|
// ============================================================================
|
|
|
|
// Project represents an IACE compliance project for a machine or system
|
|
type Project struct {
|
|
ID uuid.UUID `json:"id"`
|
|
TenantID uuid.UUID `json:"tenant_id"`
|
|
MachineName string `json:"machine_name"`
|
|
MachineType string `json:"machine_type"`
|
|
Manufacturer string `json:"manufacturer"`
|
|
Description string `json:"description,omitempty"`
|
|
NarrativeText string `json:"narrative_text,omitempty"`
|
|
Status ProjectStatus `json:"status"`
|
|
CEMarkingTarget string `json:"ce_marking_target,omitempty"`
|
|
CompletenessScore float64 `json:"completeness_score"`
|
|
RiskSummary map[string]int `json:"risk_summary,omitempty"`
|
|
TriggeredRegulations json.RawMessage `json:"triggered_regulations,omitempty"`
|
|
Metadata json.RawMessage `json:"metadata,omitempty"`
|
|
CreatedAt time.Time `json:"created_at"`
|
|
UpdatedAt time.Time `json:"updated_at"`
|
|
ArchivedAt *time.Time `json:"archived_at,omitempty"`
|
|
}
|
|
|
|
// Component represents a system component within a project
|
|
type Component struct {
|
|
ID uuid.UUID `json:"id"`
|
|
ProjectID uuid.UUID `json:"project_id"`
|
|
ParentID *uuid.UUID `json:"parent_id,omitempty"`
|
|
Name string `json:"name"`
|
|
ComponentType ComponentType `json:"component_type"`
|
|
Version string `json:"version,omitempty"`
|
|
Description string `json:"description,omitempty"`
|
|
IsSafetyRelevant bool `json:"is_safety_relevant"`
|
|
IsNetworked bool `json:"is_networked"`
|
|
Metadata json.RawMessage `json:"metadata,omitempty"`
|
|
SortOrder int `json:"sort_order"`
|
|
CreatedAt time.Time `json:"created_at"`
|
|
UpdatedAt time.Time `json:"updated_at"`
|
|
}
|
|
|
|
// RegulatoryClassification represents the classification result for a regulation
|
|
type RegulatoryClassification struct {
|
|
ID uuid.UUID `json:"id"`
|
|
ProjectID uuid.UUID `json:"project_id"`
|
|
Regulation RegulationType `json:"regulation"`
|
|
ClassificationResult string `json:"classification_result"`
|
|
RiskLevel RiskLevel `json:"risk_level"`
|
|
Confidence float64 `json:"confidence"`
|
|
Reasoning string `json:"reasoning,omitempty"`
|
|
RAGSources json.RawMessage `json:"rag_sources,omitempty"`
|
|
Requirements json.RawMessage `json:"requirements,omitempty"`
|
|
CreatedAt time.Time `json:"created_at"`
|
|
UpdatedAt time.Time `json:"updated_at"`
|
|
}
|
|
|
|
// HazardLibraryEntry represents a reusable hazard template from the library
|
|
type HazardLibraryEntry struct {
|
|
ID uuid.UUID `json:"id"`
|
|
Category string `json:"category"`
|
|
SubCategory string `json:"sub_category,omitempty"`
|
|
Name string `json:"name"`
|
|
Description string `json:"description,omitempty"`
|
|
DefaultSeverity int `json:"default_severity"`
|
|
DefaultProbability int `json:"default_probability"`
|
|
DefaultExposure int `json:"default_exposure,omitempty"`
|
|
DefaultAvoidance int `json:"default_avoidance,omitempty"`
|
|
ApplicableComponentTypes []string `json:"applicable_component_types"`
|
|
RegulationReferences []string `json:"regulation_references"`
|
|
SuggestedMitigations json.RawMessage `json:"suggested_mitigations,omitempty"`
|
|
TypicalCauses []string `json:"typical_causes,omitempty"`
|
|
TypicalHarm string `json:"typical_harm,omitempty"`
|
|
RelevantLifecyclePhases []string `json:"relevant_lifecycle_phases,omitempty"`
|
|
RecommendedMeasuresDesign []string `json:"recommended_measures_design,omitempty"`
|
|
RecommendedMeasuresTechnical []string `json:"recommended_measures_technical,omitempty"`
|
|
RecommendedMeasuresInformation []string `json:"recommended_measures_information,omitempty"`
|
|
SuggestedEvidence []string `json:"suggested_evidence,omitempty"`
|
|
RelatedKeywords []string `json:"related_keywords,omitempty"`
|
|
Tags []string `json:"tags,omitempty"`
|
|
IsBuiltin bool `json:"is_builtin"`
|
|
TenantID *uuid.UUID `json:"tenant_id,omitempty"`
|
|
CreatedAt time.Time `json:"created_at"`
|
|
}
|
|
|
|
// Hazard represents a specific hazard identified within a project
|
|
type Hazard struct {
|
|
ID uuid.UUID `json:"id"`
|
|
ProjectID uuid.UUID `json:"project_id"`
|
|
ComponentID uuid.UUID `json:"component_id"`
|
|
LibraryHazardID *uuid.UUID `json:"library_hazard_id,omitempty"`
|
|
Name string `json:"name"`
|
|
Description string `json:"description,omitempty"`
|
|
Scenario string `json:"scenario,omitempty"`
|
|
Category string `json:"category"`
|
|
SubCategory string `json:"sub_category,omitempty"`
|
|
Status HazardStatus `json:"status"`
|
|
MachineModule string `json:"machine_module,omitempty"`
|
|
Function string `json:"function,omitempty"`
|
|
LifecyclePhase string `json:"lifecycle_phase,omitempty"`
|
|
HazardousZone string `json:"hazardous_zone,omitempty"`
|
|
TriggerEvent string `json:"trigger_event,omitempty"`
|
|
AffectedPerson string `json:"affected_person,omitempty"`
|
|
PossibleHarm string `json:"possible_harm,omitempty"`
|
|
ReviewStatus ReviewStatus `json:"review_status,omitempty"`
|
|
CreatedAt time.Time `json:"created_at"`
|
|
UpdatedAt time.Time `json:"updated_at"`
|
|
}
|
|
|
|
// RiskAssessment represents a quantitative risk assessment for a hazard
|
|
type RiskAssessment struct {
|
|
ID uuid.UUID `json:"id"`
|
|
HazardID uuid.UUID `json:"hazard_id"`
|
|
Version int `json:"version"`
|
|
AssessmentType AssessmentType `json:"assessment_type"`
|
|
Severity int `json:"severity"`
|
|
Exposure int `json:"exposure"`
|
|
Probability int `json:"probability"`
|
|
Avoidance int `json:"avoidance,omitempty"` // 0=disabled, 1-5 (3=neutral)
|
|
InherentRisk float64 `json:"inherent_risk"`
|
|
ControlMaturity int `json:"control_maturity"`
|
|
ControlCoverage float64 `json:"control_coverage"`
|
|
TestEvidenceStrength float64 `json:"test_evidence_strength"`
|
|
CEff float64 `json:"c_eff"`
|
|
ResidualRisk float64 `json:"residual_risk"`
|
|
RiskLevel RiskLevel `json:"risk_level"`
|
|
IsAcceptable bool `json:"is_acceptable"`
|
|
AcceptanceJustification string `json:"acceptance_justification,omitempty"`
|
|
AssessedBy uuid.UUID `json:"assessed_by"`
|
|
CreatedAt time.Time `json:"created_at"`
|
|
}
|
|
|
|
// Mitigation represents a risk reduction measure applied to a hazard
|
|
type Mitigation struct {
|
|
ID uuid.UUID `json:"id"`
|
|
HazardID uuid.UUID `json:"hazard_id"`
|
|
ReductionType ReductionType `json:"reduction_type"`
|
|
Name string `json:"name"`
|
|
Description string `json:"description,omitempty"`
|
|
Status MitigationStatus `json:"status"`
|
|
VerificationMethod VerificationMethod `json:"verification_method,omitempty"`
|
|
VerificationResult string `json:"verification_result,omitempty"`
|
|
VerifiedAt *time.Time `json:"verified_at,omitempty"`
|
|
VerifiedBy uuid.UUID `json:"verified_by,omitempty"`
|
|
CreatedAt time.Time `json:"created_at"`
|
|
UpdatedAt time.Time `json:"updated_at"`
|
|
}
|
|
|
|
// Evidence represents an uploaded file that serves as evidence for compliance
|
|
type Evidence struct {
|
|
ID uuid.UUID `json:"id"`
|
|
ProjectID uuid.UUID `json:"project_id"`
|
|
MitigationID *uuid.UUID `json:"mitigation_id,omitempty"`
|
|
VerificationPlanID *uuid.UUID `json:"verification_plan_id,omitempty"`
|
|
FileName string `json:"file_name"`
|
|
FilePath string `json:"file_path"`
|
|
FileHash string `json:"file_hash"`
|
|
FileSize int64 `json:"file_size"`
|
|
MimeType string `json:"mime_type"`
|
|
Description string `json:"description,omitempty"`
|
|
UploadedBy uuid.UUID `json:"uploaded_by"`
|
|
CreatedAt time.Time `json:"created_at"`
|
|
}
|
|
|
|
// VerificationPlan represents a plan for verifying compliance measures
|
|
type VerificationPlan struct {
|
|
ID uuid.UUID `json:"id"`
|
|
ProjectID uuid.UUID `json:"project_id"`
|
|
HazardID *uuid.UUID `json:"hazard_id,omitempty"`
|
|
MitigationID *uuid.UUID `json:"mitigation_id,omitempty"`
|
|
Title string `json:"title"`
|
|
Description string `json:"description,omitempty"`
|
|
AcceptanceCriteria string `json:"acceptance_criteria,omitempty"`
|
|
Method VerificationMethod `json:"method"`
|
|
Status string `json:"status"`
|
|
Result string `json:"result,omitempty"`
|
|
CompletedAt *time.Time `json:"completed_at,omitempty"`
|
|
CompletedBy uuid.UUID `json:"completed_by,omitempty"`
|
|
CreatedAt time.Time `json:"created_at"`
|
|
UpdatedAt time.Time `json:"updated_at"`
|
|
}
|
|
|
|
// TechFileSection represents a section of the technical documentation file
|
|
type TechFileSection struct {
|
|
ID uuid.UUID `json:"id"`
|
|
ProjectID uuid.UUID `json:"project_id"`
|
|
SectionType string `json:"section_type"`
|
|
Title string `json:"title"`
|
|
Content string `json:"content,omitempty"`
|
|
Version int `json:"version"`
|
|
Status TechFileSectionStatus `json:"status"`
|
|
ApprovedBy uuid.UUID `json:"approved_by,omitempty"`
|
|
ApprovedAt *time.Time `json:"approved_at,omitempty"`
|
|
Metadata json.RawMessage `json:"metadata,omitempty"`
|
|
CreatedAt time.Time `json:"created_at"`
|
|
UpdatedAt time.Time `json:"updated_at"`
|
|
}
|
|
|
|
// MonitoringEvent represents a post-market monitoring event
|
|
type MonitoringEvent struct {
|
|
ID uuid.UUID `json:"id"`
|
|
ProjectID uuid.UUID `json:"project_id"`
|
|
EventType MonitoringEventType `json:"event_type"`
|
|
Title string `json:"title"`
|
|
Description string `json:"description,omitempty"`
|
|
Severity string `json:"severity"`
|
|
ImpactAssessment string `json:"impact_assessment,omitempty"`
|
|
Status string `json:"status"`
|
|
ResolvedAt *time.Time `json:"resolved_at,omitempty"`
|
|
ResolvedBy uuid.UUID `json:"resolved_by,omitempty"`
|
|
Metadata json.RawMessage `json:"metadata,omitempty"`
|
|
CreatedAt time.Time `json:"created_at"`
|
|
UpdatedAt time.Time `json:"updated_at"`
|
|
}
|
|
|
|
// AuditTrailEntry represents an immutable audit log entry for compliance traceability
|
|
type AuditTrailEntry struct {
|
|
ID uuid.UUID `json:"id"`
|
|
ProjectID uuid.UUID `json:"project_id"`
|
|
EntityType string `json:"entity_type"`
|
|
EntityID uuid.UUID `json:"entity_id"`
|
|
Action AuditAction `json:"action"`
|
|
UserID uuid.UUID `json:"user_id"`
|
|
OldValues json.RawMessage `json:"old_values,omitempty"`
|
|
NewValues json.RawMessage `json:"new_values,omitempty"`
|
|
Hash string `json:"hash"`
|
|
CreatedAt time.Time `json:"created_at"`
|
|
}
|