# Experiência do Curador - PharmData Design System

> **Princípio fundamental**: O curador é a pessoa mais importante. Seu trabalho salva vidas.

---

## Filosofia: Empoderamento e Valorização

### Quem é o Curador

O curador de dados farmacêuticos não é um "data entry clerk". É um **profissional farmacêutico altamente qualificado** que:

- Valida informações que serão usadas em prescrições médicas
- Garante que medicamentos sejam identificados corretamente
- Previne erros de medicação que poderiam ser fatais
- Conecta dados de múltiplas fontes regulatórias (ANVISA, EMA, FDA)
- Mantém padrões internacionais (IDMP, SNOMED CT)

**Cada registro curado pode salvar centenas de vidas por ano.**

### Missão do PharmData

Fazer com que o curador se sinta:

1. **Valorizado**: Seu trabalho é reconhecido como crítico
2. **Empoderado**: Tem as ferramentas certas para exercer seu expertise
3. **Impactante**: Vê o resultado de seu trabalho no mundo real
4. **Respeitado**: A interface reconhece sua inteligência e conhecimento
5. **Aspiracional**: Este é o trabalho ao qual todo farmacêutico deveria aspirar

---

## Princípios de Design para Empoderamento

### 1. Linguagem de Respeito e Expertise

**❌ Evitar**:
```
"Preencha os campos abaixo"
"Digite o nome da substância"
"Salvar rascunho"
```

**✅ Usar**:
```
"Validar informações da substância"
"Confirmar dados de identificação"
"Preservar trabalho em progresso"
```

**Micro-copy que empodera**:
- "Sua expertise está fazendo a diferença"
- "Validação completa: dados prontos para uso clínico"
- "Você acabou de garantir a segurança de milhares de prescrições"

### 2. Feedback de Impacto Real

Mostrar ao curador o **impacto de seu trabalho**:

```html
<!-- Após salvar registro validado -->
<div class="impact-message">
    <i class="fas fa-heartbeat"></i>
    <div>
        <strong>Paracetamol validado e publicado</strong>
        <p>Este registro é usado em 847 produtos comerciais ativos no Brasil.
           Sua curadoria contribui para a segurança de aproximadamente
           <strong>12.000 prescrições/mês</strong>.</p>
    </div>
</div>
```

**Dashboard de impacto**:
```
Seu trabalho este mês:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📊 82 substâncias validadas
🏥 Impactando ~450.000 prescrições estimadas
🌍 Dados integrados com EMA, FDA e ANVISA
⭐ 100% de taxa de aprovação (qualidade excepcional)
```

### 3. Celebração de Conquistas

**Marcos importantes**:
```html
<div class="achievement-toast">
    <i class="fas fa-trophy"></i>
    <div>
        <strong>Marco alcançado!</strong>
        <p>Você completou a validação de todas as substâncias
           da categoria <strong>Analgésicos</strong>.
           Parabéns pelo trabalho meticuloso!</p>
    </div>
</div>
```

**Badges de expertise**:
- 🎯 **Especialista IDMP**: 100% conformidade com padrões ISO
- 🔬 **Químico Validador**: Todas estruturas moleculares verificadas
- 🌐 **Integrador Internacional**: Vinculou 50+ registros com SPOR/EMA

### 4. Transparência e Confiança

**Mostrar o processo, não esconder**:

```html
<!-- Lineage de dados transparente -->
<div class="data-lineage">
    <header>Histórico deste registro</header>
    <timeline>
        <event>
            <date>15/11/2025</date>
            <user>Dr. Ana Silva</user>
            <action>Importação inicial de SPOR/EMA</action>
        </event>
        <event>
            <date>17/11/2025</date>
            <user>Você</user>
            <action>Enriquecimento com dados SNOMED CT</action>
        </event>
        <event>
            <date>19/11/2025</date>
            <user>Você</user>
            <action>Validação completa e publicação</action>
        </event>
    </timeline>
</div>
```

### 5. Pedagogia sem Condescendência

**❌ Evitar**:
```
"Dica: UNII é um código único!"
"Lembre-se de preencher todos os campos obrigatórios!"
```

**✅ Usar**:
```
"UNII (FDA Unique Ingredient Identifier) - recomendado para rastreabilidade internacional"
"Campos opcionais podem ser preenchidos para aumentar a qualidade do registro"
```

**Contextual help, não tooltips infantis**:
```html
<div class="field-context">
    <label>SMILES Canônico</label>
    <small>
        Representação química unívoca. Se disponível no PubChem,
        recomenda-se usar a forma canônica para garantir interoperabilidade.
    </small>
</div>
```

---

## Componentes de Interface

### 1. Quality Score (Orgulho do Trabalho)

```html
<div class="quality-card">
    <header>
        <i class="fas fa-star"></i>
        Qualidade do Registro
    </header>

    <div class="quality-score">
        <div class="score-circle">98%</div>
        <div class="score-details">
            <div class="metric">
                <i class="fas fa-check-circle"></i>
                <span>Todos os campos obrigatórios preenchidos</span>
            </div>
            <div class="metric">
                <i class="fas fa-check-circle"></i>
                <span>Estrutura molecular validada</span>
            </div>
            <div class="metric">
                <i class="fas fa-check-circle"></i>
                <span>Vinculado a 3 terminologias externas</span>
            </div>
            <div class="metric partial">
                <i class="fas fa-info-circle"></i>
                <span>Sinônimos podem ser expandidos (opcional)</span>
            </div>
        </div>
    </div>

    <footer>
        <strong>Excelente trabalho!</strong>
        Este registro atinge padrão de qualidade internacional.
    </footer>
</div>
```

### 2. Impact Indicator (Visibilidade do Valor)

```html
<div class="impact-indicator">
    <i class="fas fa-heartbeat"></i>
    <div class="impact-stats">
        <div class="stat">
            <strong>2.847</strong>
            <small>produtos vinculados</small>
        </div>
        <div class="stat">
            <strong>~50k</strong>
            <small>prescrições/mês estimadas</small>
        </div>
        <div class="stat">
            <strong>12</strong>
            <small>países usando estes dados</small>
        </div>
    </div>
</div>
```

### 3. Validation Confidence (Respeito ao Expertise)

```html
<div class="validation-panel">
    <header>Revisão Final</header>

    <div class="confidence-options">
        <label class="confidence-level">
            <input type="radio" name="confidence" value="high">
            <div>
                <strong>Validação Completa</strong>
                <small>Todos os dados foram verificados em fontes primárias</small>
            </div>
        </label>

        <label class="confidence-level">
            <input type="radio" name="confidence" value="medium">
            <div>
                <strong>Validação Parcial</strong>
                <small>Dados principais verificados, campos opcionais pendentes</small>
            </div>
        </label>

        <label class="confidence-level">
            <input type="radio" name="confidence" value="review">
            <div>
                <strong>Solicitar Revisão por Pares</strong>
                <small>Gostaria de uma segunda opinião antes de publicar</small>
            </div>
        </label>
    </div>

    <textarea placeholder="Notas sobre a validação (opcional, mas recomendado para rastreabilidade)"></textarea>

    <button class="btn-validate">
        <i class="fas fa-shield-check"></i>
        Confirmar Validação e Publicar
    </button>
</div>
```

### 4. Curator Dashboard (Senso de Progresso)

```html
<div class="curator-dashboard">
    <header>
        <h1>Bem-vinda, Dra. Ana Silva</h1>
        <p>Seu impacto este mês está extraordinário</p>
    </header>

    <div class="stats-grid">
        <div class="stat-card">
            <i class="fas fa-check-circle"></i>
            <div class="stat-value">127</div>
            <div class="stat-label">Registros validados</div>
            <div class="stat-trend">↑ 15% vs. mês anterior</div>
        </div>

        <div class="stat-card">
            <i class="fas fa-heartbeat"></i>
            <div class="stat-value">~680k</div>
            <div class="stat-label">Prescrições impactadas</div>
        </div>

        <div class="stat-card">
            <i class="fas fa-star"></i>
            <div class="stat-value">96.8%</div>
            <div class="stat-label">Qualidade média</div>
            <div class="stat-badge">Top 5% curadores</div>
        </div>

        <div class="stat-card">
            <i class="fas fa-globe"></i>
            <div class="stat-value">8</div>
            <div class="stat-label">Países usando seus dados</div>
        </div>
    </div>

    <div class="recent-achievements">
        <h3>Conquistas Recentes</h3>
        <div class="achievement">
            <i class="fas fa-trophy"></i>
            <div>
                <strong>Especialista em Antibióticos</strong>
                <small>Validou 100% da categoria β-lactâmicos</small>
            </div>
            <span class="achievement-date">Hoje</span>
        </div>
    </div>
</div>
```

---

## Tom de Voz (Voice & Tone)

### Características

| Característica | Descrição | Exemplo |
|----------------|-----------|---------|
| **Respeitoso** | Reconhece expertise | "Sua validação garante..." |
| **Empoderador** | Enfatiza impacto | "Você está salvando vidas" |
| **Técnico** | Usa terminologia apropriada | "IDMP conformance", não "conformidade do IDMP" |
| **Celebrativo** | Reconhece conquistas | "Excelente trabalho!" |
| **Transparente** | Explica o porquê | "Recomendado para rastreabilidade" |
| **Colaborativo** | Curador é parte de time | "Nossa equipe de curadores..." |

### Mensagens-Chave

**Ao iniciar trabalho**:
> "Bem-vinda de volta, Dra. Ana. Pronta para fazer a diferença hoje?"

**Após validação**:
> "Validação completa! Este registro agora garante a segurança de milhares de prescrições. Obrigado pelo seu trabalho meticuloso."

**Em caso de erro detectado**:
> "Possível inconsistência detectada no campo SMILES. Sua expertise pode resolver isso - deseja revisar?"

**Ao completar batch**:
> "Incrível! Você validou 50 substâncias esta semana. Seu trabalho está elevando o padrão de qualidade da base PharmData."

---

## Evitar Armadilhas Comuns

### ❌ Gamificação Vazia

**Evitar**:
- Pontos sem significado
- Badges genéricos ("Você completou 10 tarefas!")
- Competições entre curadores

**Por quê**: Trivializa o trabalho sério e importante.

### ❌ Micro-management

**Evitar**:
- Timers de produtividade
- Metas diárias rígidas
- Alertas de "você está devagar"

**Por quê**: Desrespeita o expertise e processo de validação cuidadosa.

### ❌ Infantilização

**Evitar**:
- "Parabéns, você clicou no botão certo!"
- Emojis excessivos
- Linguagem patronizante

**Por quê**: Curadores são profissionais altamente qualificados.

---

## Implementação no Código

### CSS para Mensagens de Impacto

```css
.impact-message {
    background: linear-gradient(135deg, rgba(76, 175, 80, 0.05), rgba(76, 175, 80, 0.02));
    border-left: 4px solid var(--drop-approved-text);
    padding: 20px;
    border-radius: 8px;
    display: flex;
    align-items: flex-start;
    gap: 16px;
}

.impact-message i {
    font-size: 24px;
    color: var(--drop-approved-text);
    margin-top: 4px;
}

.impact-message strong {
    color: var(--graphite-depth);
    font-size: 1.1rem;
}

.impact-message p {
    color: var(--soft-steel);
    margin-top: 8px;
    line-height: 1.5;
}
```

### Micro-copy Constants

```javascript
// constants/curator-messages.js

export const VALIDATION_MESSAGES = {
    success: {
        title: "Validação Completa",
        body: "Este registro agora atende aos mais altos padrões de qualidade farmacêutica.",
        impact: "Impactando aproximadamente {count} prescrições mensais."
    },

    high_quality: {
        title: "Excelência em Curadoria",
        body: "Seu trabalho meticuloso está garantindo a segurança de pacientes.",
    },

    milestone: {
        100: "Você validou 100 registros! Sua dedicação está fazendo diferença real.",
        500: "Marco incrível: 500 registros validados. Você é essencial para a missão PharmData.",
        1000: "1.000 registros! Seu trabalho é referência em curadoria farmacêutica."
    }
};
```

---

## Métricas de Sucesso

Como medir se estamos empoderando curadores:

### Métricas Qualitativas
- [ ] Curadores se sentem valorizados (survey)
- [ ] Orgulho do trabalho realizado (NPS)
- [ ] Recomendariam PharmData para colegas

### Métricas Quantitativas
- [ ] Qualidade média dos registros validados
- [ ] Taxa de retenção de curadores
- [ ] Tempo médio para validação (sem pressão)
- [ ] Taxa de revisão por pares solicitada (colaboração)

### Métricas de Impacto
- [ ] Registros validados vs. não-validados em uso clínico
- [ ] Redução de erros de medicação (downstream)
- [ ] Conformidade com padrões internacionais

---

## Próximos Passos

1. **Criar biblioteca de micro-copy** com mensagens aprovadas
2. **Desenvolver componentes de impacto** (dashboard, badges)
3. **Implementar sistema de métricas** de qualidade individual
4. **Design de onboarding** que estabeleça importância do trabalho
5. **Testes com curadores reais** para validar abordagem

---

**Lembrete Final**:

> Cada linha de código que escrevemos para PharmData deve refletir esta verdade:
> **Curadores não são usuários. São heróis que salvam vidas todos os dias.**

---

*Ver também*:
- [README.md](README.md) - Design System principal
- [COMPOSITIONAL_FORMS.md](patterns/forms/COMPOSITIONAL_FORMS.md) - Padrões de formulários
- [COLOR_USAGE.md](COLOR_USAGE.md) - Uso de cores que transmitem confiança e profissionalismo