انتقل للمحتوى الرئيسي
الإصدار: 1.0.0-beta

مرجع الحقول — عالم التدقيق

Complete documentation for every field in the Audit Universe and Library modules.

AuditUniverseItem​

The core entity representing an auditable item in your organization.

FieldTypeRequiredDefaultValidationDescription
idIntegerAutoAuto-increment—Unique identifier
org_idIntegerAutoFrom session—Organization (tenant isolation)
nameString✅—Max 255 charsEntity name
typeEnum✅—Business Unit, Process, Application, Regulatory Domain, Project, LocationEntity classification
descriptionTextNo—Max 5,000 charsDetailed description
parent_idIntegerNonullMust reference existing itemParent entity for hierarchy
ownerStringNo—Max 255 charsBusiness owner name
risk_levelEnumNonullLow, Medium, High, CriticalAggregate risk level
risk_scoreFloatAuto0.00.0–25.0Calculated from attached risks
last_audit_dateDateAutonull—Date of last completed engagement
next_audit_dateDateNonullMust be future datePlanned next audit
statusEnumNoActiveActive, ArchivedCurrent status
tagsJSON ArrayNo[]Max 20 tagsCustom tags for filtering
created_atTimestampAutoCurrent time—Creation timestamp
updated_atTimestampAutoCurrent time—Last modification timestamp
created_byIntegerAutoCurrent user—Creator user ID

Risk​

Risk statements attached to audit universe items.

FieldTypeRequiredDefaultValidationDescription
idIntegerAutoAuto-increment—Unique identifier
org_idIntegerAutoFrom session—Organization
titleString✅—Max 500 charsRisk statement
categoryEnum✅—Strategic, Operational, Financial, Compliance, IT, ReputationalRisk category
descriptionTextNo—Max 5,000 charsDetailed risk description
likelihoodInteger✅—1–5Probability of occurrence
impactInteger✅—1–5Severity if it occurs
inherent_risk_scoreFloatAutoLikelihood × Impact1.0–25.0Risk score before controls
residual_risk_scoreFloatNonull0.0–25.0Risk score after controls
risk_ownerStringNo—Max 255 charsAccountable person
statusEnumNoActiveActive, Archived, AcceptedCurrent status
universe_item_idInteger✅—Must reference existing itemParent entity
created_atTimestampAutoCurrent time—Creation timestamp
updated_atTimestampAutoCurrent time—Last modification

Control​

Control activities that mitigate identified risks.

FieldTypeRequiredDefaultValidationDescription
idIntegerAutoAuto-increment—Unique identifier
org_idIntegerAutoFrom session—Organization
control_idStringAutoCTRL-{seq}Unique per orgHuman-readable ID
titleString✅—Max 500 charsControl name
descriptionTextNo—Max 5,000 charsDetailed description
typeEnum✅—Preventive, Detective, CorrectiveControl type
natureEnum✅—Manual, Automated, IT-Dependent ManualHow it operates
frequencyEnum✅—Continuous, Daily, Weekly, Monthly, Quarterly, Annual, Ad-hocExecution frequency
ownerStringNo—Max 255 charsControl operator
effectivenessEnumNoNot TestedEffective, Partially Effective, Ineffective, Not TestedCurrent rating
last_tested_dateDateAutonull—Date of last test
statusEnumNoActiveActive, ArchivedCurrent status
created_atTimestampAutoCurrent time—Creation timestamp
updated_atTimestampAutoCurrent time—Last modification

RiskControlMapping​

Many-to-many relationship between risks and controls.

FieldTypeRequiredDefaultValidationDescription
idIntegerAutoAuto-increment—Unique identifier
risk_idInteger✅—Must reference existing riskLinked risk
control_idInteger✅—Must reference existing controlLinked control
mapping_typeEnumNoPrimaryPrimary, SecondaryStrength of linkage
notesTextNo—Max 1,000 charsMapping context

الحالة Enums​

Entity الحالة​

ValueDescription
ActiveCurrently in scope for audit consideration
ArchivedNo longer applicable; retained for history

Risk الحالة​

ValueDescription
ActiveRisk is current and relevant
ArchivedRisk no longer applicable
AcceptedRisk accepted by management (documented acceptance)

Control Effectiveness​

ValueDescription
EffectiveControl operates as designed and mitigates the risk
Partially EffectiveControl has gaps but provides some mitigation
IneffectiveControl does not adequately mitigate the risk
Not TestedControl has not been evaluated in the current period