┌─────────────────────────────────────────────────────────────────────────┐
│                          AUDIT_LOGS (centralizado)                      │
├─────────────────────────────────────────────────────────────────────────┤
│  auditable_type: "App\Models\Order" | "App\Models\Proposal"             │
│  auditable_id: ID da entidade                                           │
│  event: código do evento (ex: "order.created", "proposal.submitted")    │
│  description: texto descritivo em português                             │
│  old_values / new_values: JSON com mudanças                             │
│  metadata: { reason_type, reason_notes, extra_data }                    │
│  user_id: quem fez a ação                                               │
│  user_type: 'producer' | 'supplier' | 'admin' | 'system'                │
│  ip_address, user_agent: rastreabilidade                                │
│  show_in_activity_feed: boolean (para feed de atividades)               │
└─────────────────────────────────────────────────────────────────────────┘
                                   │
         ┌─────────────────────────┼─────────────────────────┐
         ▼                         ▼                         ▼
   Producer Portal           Supplier Portal           Admin Portal
   ┌─────────────┐           ┌─────────────┐           ┌─────────────┐
   │ Order       │           │ Proposal    │           │ Logs        │
   │ Timeline    │           │ Timeline    │           │ (tempo real)│
   │             │           │             │           │             │
   │ - Filtra    │           │ - Filtra    │           │ - Vê TUDO   │
   │   por Order │           │   por       │           │ - Filtros   │
   │ - Eventos   │           │   Proposal  │           │ - Busca     │
   │   do prod.  │           │ - Eventos   │           │             │
   │             │           │   do suppl. │           │ + Order e   │
   │ ANÔNIMO:    │           │             │           │   Proposal  │
   │ não mostra  │           │ ANÔNIMO:    │           │   views     │
   │ supplier    │           │ não mostra  │           │   (anônimo) │
   └─────────────┘           │ producer    │           └─────────────┘
                             └─────────────┘

CREATE TABLE audit_logs (
    id BIGSERIAL PRIMARY KEY,
    
    -- Entidade auditada (polimórfico)
    auditable_type VARCHAR(255) NOT NULL,  -- 'App\Models\Order', 'App\Models\Proposal'
    auditable_id BIGINT NOT NULL,
    
    -- Evento
    event VARCHAR(100) NOT NULL,           -- 'order.created', 'proposal.submitted'
    description TEXT,                       -- Descrição em português
    
    -- Valores (JSON)
    old_values JSONB,                       -- Estado anterior
    new_values JSONB,                       -- Estado novo
    metadata JSONB,                         -- Dados extras (reason_type, reason_notes, etc)
    
    -- Usuário que fez a ação
    user_id BIGINT,                         -- Pode ser NULL (sistema)
    user_type VARCHAR(50),                  -- 'producer', 'supplier', 'admin', 'system'
    
    -- Rastreabilidade
    ip_address VARCHAR(45),
    user_agent TEXT,
    
    -- Controle de exibição
    show_in_activity_feed BOOLEAN DEFAULT TRUE,
    
    -- Timestamp
    created_at TIMESTAMP NOT NULL DEFAULT NOW(),
    
    -- Índices
    CONSTRAINT fk_audit_user FOREIGN KEY (user_id) REFERENCES users(id) ON DELETE SET NULL
);

-- Índices para performance
CREATE INDEX idx_audit_auditable ON audit_logs(auditable_type, auditable_id);
CREATE INDEX idx_audit_event ON audit_logs(event);
CREATE INDEX idx_audit_user ON audit_logs(user_id);
CREATE INDEX idx_audit_created ON audit_logs(created_at DESC);
CREATE INDEX idx_audit_activity_feed ON audit_logs(show_in_activity_feed, created_at DESC);

apps/api/
├── app/
│   ├── Enums/
│   │   └── AuditEvent.php              # Enum com todos os eventos
│   │
│   ├── Models/
│   │   └── AuditLog.php                # Model (já existe, atualizar)
│   │
│   ├── Traits/
│   │   └── Auditable.php               # Trait para models
│   │
│   ├── Services/
│   │   └── AuditService.php            # Service para registrar eventos
│   │
│   ├── Http/
│   │   ├── Controllers/Api/
│   │   │   └── AuditController.php     # Endpoints de histórico
│   │   │
│   │   └── Resources/
│   │       └── AuditLogResource.php    # Resource para API
│   │
│   └── Observers/
│       ├── OrderObserver.php           # Observer para Order (atualizar)
│       └── ProposalObserver.php        # Observer para Proposal (criar)
│
└── database/
    └── migrations/
        └── 2026_02_10_create_audit_logs_table.php

apps/shared/                             # Componentes compartilhados
└── components/
    └── audit/
        ├── AuditTimeline.vue           # Timeline genérica reutilizável
        ├── AuditTimelineItem.vue       # Item individual da timeline
        └── AuditEventBadge.vue         # Badge de evento

apps/producer/
└── components/
    └── order/
        └── OrderHistory.vue            # Usa AuditTimeline filtrado por Order

apps/supplier/
└── components/
    └── proposal/
        └── ProposalHistory.vue         # Usa AuditTimeline filtrado por Proposal

apps/admin/
└── pages/
    └── logs/
        └── index.vue                   # View geral de logs (tempo real)
└── components/
    └── audit/
        └── AdminAuditTimeline.vue      # Timeline com mais detalhes

// Migrar order_status_history para audit_logs
OrderStatusHistory::chunk(100, function ($histories) {
    foreach ($histories as $history) {
        AuditLog::create([
            'auditable_type' => Order::class,
            'auditable_id' => $history->order_id,
            'event' => 'order.status_changed',
            'description' => $history->getChangeDescription(),
            'old_values' => ['status' => $history->from_status?->value],
            'new_values' => ['status' => $history->to_status->value],
            'metadata' => [
                'reason_type' => $history->reason_type?->value,
                'reason_notes' => $history->reason_notes,
            ],
            'user_id' => $history->changed_by,
            'user_type' => 'producer',
            'ip_address' => $history->ip_address,
            'user_agent' => $history->user_agent,
            'created_at' => $history->created_at,
        ]);
    }
});