Cerbi.Governance.Schemas 1.0.2

Cerbi.Governance.Schemas

Canonical governance schema models for the Cerbi logging governance ecosystem. Defines GovernedEvent, GovernanceProfileDefinition, EventFieldDefinition, and EventTemplateDefinition — the shared contracts used by all Cerbi logger plugins and signature libraries.

Features

• GovernedEvent schema - Core structure for all governed log events
• Governance profile definitions - Schema for governance policy configuration
• Event field definitions - Structured metadata for log event fields
• Event template definitions - Reusable event structure patterns
• Compliance-ready structures - Built for audit and governance requirements
• Cross-platform compatibility - Works with .NET, Java, and other platforms

Core Types

GovernedEvent

The foundational event structure used throughout the Cerbi ecosystem:

public class GovernedEvent
{
    public string EventId { get; set; }
    public DateTime Timestamp { get; set; }
    public string AppName { get; set; }
    public string Environment { get; set; }
    public string EventType { get; set; }
    public Dictionary<string, object> Fields { get; set; }
    public GovernanceMetadata Governance { get; set; }
}

GovernanceProfileDefinition

Defines governance policies and validation rules:

public class GovernanceProfileDefinition
{
    public string Name { get; set; }
    public string AppName { get; set; }
    public List<string> RequiredFields { get; set; }
    public List<string> DisallowedFields { get; set; }
    public Dictionary<string, FieldSeverity> FieldSeverities { get; set; }
    public Dictionary<string, FieldType> FieldTypes { get; set; }
}

Usage

This library serves as the foundation for all other Cerbi packages:

• Logger integrations (Serilog, NLog, Log4j, Logback) use these schemas
• Signature libraries (API, Security, Audit) create events with these types
• CerbiShield platform validates and processes events using these schemas
• Custom integrations can extend these base types for specific needs

Integration

Essential dependency for:

• Cerbi.Signatures.* - All signature libraries depend on these schemas
• Cerbi.*.Governance - All logger integrations use these event structures
• CerbiShield platform - Dashboard, APIs, and governance services
• Custom governance solutions - Build on these canonical types

License

MIT License - see LICENSE file for details.