ARC Control Schema v1.0

 

Derived From: ARC Canon v1.0 (Frozen)

Status: IMPLEMENTATION BASELINE

Scope: Internal Control Layer (the system of record) — dashboards are a projection of this schema, not the other way around.

 

⸻

 

0) Process Chain

 

Canon v1.0 → Canonical Object Model → State Machine → Permission Model → Audit & Event Log → Control Surfaces (Dashboards) → API Contracts → Program Pipelines → Platform Exposure

 

⸻

 

1) Canonical Objects (System of Record)

 

These are the minimum objects required to operationalize the Canon without drift.

 

1.1 Core Objects (Primary)

 

A) Person - Represents humans (artists, operators, collectors, staff).

 

Fields

• person_id (UUID)

• legal_name

• display_name

• email

• phone

• roles[] (system roles; see §4)

• status (active/inactive)

• created_at, updated_at

 

⸻

 

B) Organization

 

Studios, galleries, partners, vendors.

 

Fields

• org_id

• name

• type (studio/gallery/partner/vendor/brand)

• primary_contact_person_id

• status

• created_at, updated_at

 

⸻

 

C) Era

 

Bounded temporal phase.

 

Fields

• era_id

• name

• start_at, end_at (nullable end only if “announced but not closed”)

• ruleset_id (see RuleSet)

• narrative_tone (descriptor)

• economic_profile_id (see EconomicProfile)

• status (planned/active/closed)

 

Invariant

• Every asset and issuance must reference an era_id.

 

⸻

 

D) MasterAsset

 

The root economic event object.

 

Fields

• master_id

• title

• creator_person_id (artist)

• source_physical_work_id (see PhysicalWork)

• era_id (creation-era anchor)

• capture_session_id

• archive_package_id

• metadata_core_id

• state (see §3)

• fingerprint_hash (content-based hash)

• canonical_preview_derivative_id (optional)

• created_at, updated_at

 

Invariants

• No derivatives without a master.

• Master primacy cannot be superseded.

 

⸻

 

E) MetadataCore

 

Governing data layer.

 

Fields

• metadata_core_id

• master_id

• authorship (structured block)

• capture_conditions (lighting, lens, calibration notes)

• rights_profile_id

• edition_policy_id

• usage_policy_id

• tags[]

• jurisdiction (if needed)

• metadata_version

• created_at, updated_at

 

Invariant

• Metadata is governing; state transitions and distribution checks consult this first.

 

⸻

 

F) Derivative

 

Any generated artifact from master.

 

Fields

• derivative_id

• master_id

• type (print_file/web_image/crop/video/mockup/ai_render/etc.)

• spec (format, color space, dimensions, DPI)

• source_chain[] (links to other derivatives if derived-from-derivative)

• storage_ref

• fingerprint_hash

• created_by_person_id

• created_at

 

Invariant

• Derivatives inherit provenance; never outrank Master.

 

⸻

 

G) Utility

 

Rights, access, unlocks, experiences.

 

Fields

• utility_id

• master_id

• era_id

• type (display/license/governance/access/revenue-share/etc.)

• unlock_model (time-based, ownership-based, event-based)

• start_at, end_at (nullable)

• conditions (policy rules, thresholds)

• status (available/locked/expired)

 

⸻

 

1.2 Operations Objects (Control Layer)

 

H) PhysicalWork

 

Represents the real-world object being captured.

 

Fields

• physical_work_id

• title

• artist_person_id

• medium

• dimensions

• notes

• intake_status (received/returned)

• created_at

 

⸻

 

I) CaptureSession

 

A controlled imaging event.

 

Fields

• capture_session_id

• physical_work_id

• operator_person_id

• studio_org_id

• calibration_profile_id

• timestamp_start, timestamp_end

• equipment_manifest_id

• result (pass/fail + notes)

• created_at

 

⸻

 

J) ArchivePackage

 

Archival bundle for master + dependencies.

 

Fields

• archive_package_id

• master_id

• storage_locations[] (primary, backup, cold)

• checksums[]

• restore_test_status

• retention_policy

• created_at

 

⸻

 

K) RuleSet

 

Era governing rules.

 

Fields

• ruleset_id

• era_id

• rules[] (machine-checkable conditions)

• effective_at

• supersedes_ruleset_id (rare; only via Amendment)

 

⸻

 

L) EconomicProfile

 

All parameters for scarcity axes, pricing baselines, multipliers.

 

Fields

• economic_profile_id

• era_id

• physical_scarcity_model

• digital_scarcity_model

• temporal_scarcity_model

• pricing_parameters

• created_at

 

⸻

 

M) Program

 

Repeatable pipelines.

 

Fields

• program_id

• type (Masterwork / EraContent / Onboarding)

• owner_person_id

• SOP_version

• inputs[] (object types)

• outputs[] (object types)

• status (active/paused)

• created_at

 

⸻

 

N) ProgramRun

 

A single execution instance.

 

Fields

• program_run_id

• program_id

• era_id

• initiated_by_person_id

• state (running/completed/failed)

• run_log_ref

• created_at

 

⸻

 

O) License

 

Contractual permission issuance.

 

Fields

• license_id

• master_id

• licensee_person_id or licensee_org_id

• scope (display/print/digital/etc.)

• territory, term_start, term_end

• rev_share_terms_id (optional)

• status (draft/active/expired/revoked)

 

⸻

 

P) Order

 

Commercial transaction object.

 

Fields

• order_id

• customer_person_id

• line_items[] (prints, licenses, utilities)

• pricing_snapshot

• fulfillment_state

• created_at

 

⸻

 

Q) AuditEvent (Non-negotiable)

 

Everything important produces an event.

 

Fields

• event_id

• timestamp

• actor_person_id

• action (create/update/transition/issue/revoke)

• object_type, object_id

• before_snapshot_ref, after_snapshot_ref

• reason_code

• ip/device_ref (optional)

• signature_hash

 

Invariant

• State transitions are logged, irreversible, auditable.

 

⸻

2) Relationship Diagram (Canonical)