mirror of
https://github.com/fsolla/teqo.git
synced 2026-11-21 02:53:06 +00:00
- Make engagement level note optional in schema and UI - Remove reversalSignals field from popover, action snapshot and DB - Add data migration to strip reversalSignals from movimento snapshots - Wizard trend note step no longer requires text; labels show (opcional) Co-authored-by: Francisco Solla <fsolla@users.noreply.github.com>
3.3 KiB
3.3 KiB
Impl: Motivo opcional — tendência (wizard) + nível; remover voltar atrás do DB (B134)
Status: aprovado Atualizado em: 2026-08-02 Issue: #288 Intenção: docs/plans/motivo-opcional-tendencia-e-nivel.md Appetite restante: herdado (~1 dia eng)
Leitura da intenção
- Outcome: staff grava tendência ou nível sem texto obrigatório; Motivo permanece opcional nos dois ritos;
reversalSignalssome da UI, write path e snapshots persistidos. - O que NÃO negociar: histerese/override/choque triangulado intactos;
leaderlockdown; sem auto-save no nível; motivo vazio gravanull(não preserva anterior); dados históricos dereversalSignalsapagados do DB. - O que reavaliar: não há coluna dedicada —
reversalSignalsvive só no JSONallocation_decision.snapshot; migration é data-only, sem alterarAllocationDecisionconfig.
Abordagem recomendada
flowchart LR
UI[Popover / wizard] --> schema[municipalityEngagementLevelSchema]
schema --> action[setMunicipalityEngagementLevelRecord]
action --> mun[municipality.levelNote nullable]
action --> ad[allocationDecision snapshot sem reversalSignals]
mig[migration SQL] --> ad
Opções consideradas: A remover só da UI/schema | B migration JSON strip + schema/UI/action
Recomendação: B — aceite exige apagar do banco, não só esconder.
Rejeitadas: A (órfãos no snapshot); tornar rationale opcional na collection (escopo desnecessário — string vazia basta quando motivo ausente).
Componentes / mudanças
municipalityEngagementLevelSchema(src/lib/schemas/municipality.ts):note→trimmedNullableText; removerreversalSignals.setMunicipalityEngagementLevelRecord(actions/municipality.ts): snapshot semreversalSignals;rationale: note ?? ''.MunicipalityListLevelControl: um campo Motivo (opcional);canSubmitsó exige movimento + override quando violações.WizardTrendNoteStep: removerrequired; label com “(opcional)”.- Migration:
20260802_*_strip_engagement_reversal_signals—UPDATE allocation_decision SET snapshot = snapshot - 'reversalSignals' WHERE …. - Access / Consent: inalterado (
canManageMunicipalityEngagementLevel).
Dados → forma
- Tendência: schema já usa
trimmedNullableText— só UI wizard tinharequiredHTML. - Nível:
levelNotenullable no município;allocationDecision.rationalestring (vazia se sem motivo).
Fases verificáveis
- Schema+server — schema, action, migration, int test com motivo vazio + snapshot sem reversalSignals.
- UI — labels “(opcional)”, remover segundo textarea.
- Gates —
pnpm gate:fast; push viapnpm push.
Rabbit holes / Não escopo (engenharia)
- Alterar copy do glossário
campaignIntelligenceConcepts(prosa conceitual, não o campo). rationalerequired na collection — string vazia, não relaxar schema Payload.
Riscos e mitigação
- Rationale vazio rejeitado pelo Payload: int test com
noteomitido; se falhar, usar''explicitamente (textarea required aceita vazio). - Migration idempotente: operador JSONB
-só onde chave existe; log de row count.
Aceite de engenharia
- Aceite de produto da intenção ainda coberto
- Invariantes AGENTS/engineering-standards
- Testes de domínio previstos (int engagement level + migration unit)