mirror of
https://github.com/fsolla/teqo.git
synced 2026-11-16 11:33:07 +00:00
Modo "Por tema" no acervo de falas: expansão determinística do tema via DeepSeek (generateObject, timeout, fallback null) alimenta o motor lexical existente (searchText/keywords OR), mantendo facetas AND, paginação por fala, o OR de cortes do C174 e o access control intacto. Resultado de tema mostra selo e "Por que apareceu" com trecho real (frase contínua), sem score; degradação honesta para termo exato com aviso e vazio honesto com saídas. - URL: mode=tema (default omitido; canonicaliza sem q), seletor otimista - ai/expandSpeechSearchTheme + lib/speechThemeTerms (sanitiza saída do modelo) - view model com themeMatchTerm + espelho speechMatchesSearchTerm - UI do card de tema (selos, proveniência, ações) e aviso degradado - sem migration/Consent/exposição pública; gate de leitura inalterado - testes unit/int/e2e; design hi-fi estendido e certificado pelo designer
277 lines
7.9 KiB
TypeScript
277 lines
7.9 KiB
TypeScript
/**
|
|
* Speech acervo omnibox adapter (C154). Pure / client-safe: builds the active
|
|
* chips, the suggestion seeds (facet constants plus server-loaded years/phases/
|
|
* municipalities) and the toggle/remove/clear actions over the URL state.
|
|
*/
|
|
import {
|
|
createOmniboxSuggestionSeed,
|
|
filterOmniboxSuggestionSeeds,
|
|
type CampaignListOmniboxChip,
|
|
type CampaignListOmniboxSuggestion,
|
|
} from '@/lib/campaignListOmnibox'
|
|
import {
|
|
SPEECH_SCOPES,
|
|
SPEECH_TOPICS,
|
|
type SpeechScope,
|
|
type SpeechTopic,
|
|
} from '@/lib/speechFacets'
|
|
import {
|
|
SPEECH_DURATION_BUCKETS,
|
|
speechDurationLabels,
|
|
speechScopeLabels,
|
|
speechTopicLabels,
|
|
type SpeechDurationBucket,
|
|
type SpeechListState,
|
|
type SpeechSearchMode,
|
|
} from '@/utilities/speech/speechListUrl'
|
|
|
|
export type SpeechFilterOption = {
|
|
value: string
|
|
label: string
|
|
}
|
|
|
|
/**
|
|
* C192 — the omnibox input's DOM id, shared by the filters bar and the empty
|
|
* state's "Reformular busca" focus action.
|
|
*/
|
|
export const SPEECH_OMNIBOX_ID = 'speech-omnibox'
|
|
|
|
export type SpeechOmniboxAction =
|
|
| { kind: 'url'; state: SpeechListState }
|
|
| { kind: 'clear'; state: SpeechListState }
|
|
|
|
const chipLabel = (dimension: string, value: string): string => `${dimension}: ${value}`
|
|
|
|
const withPageReset = (state: SpeechListState): SpeechListState => ({ ...state, page: 1 })
|
|
|
|
const toggleValue = <T>(values: T[] | undefined, value: T): T[] | undefined => {
|
|
const current = values ?? []
|
|
const next = current.includes(value)
|
|
? current.filter((item) => item !== value)
|
|
: [...current, value]
|
|
return next.length ? next : undefined
|
|
}
|
|
|
|
const removeValue = <T>(values: T[] | undefined, value: T): T[] | undefined => {
|
|
const next = (values ?? []).filter((item) => item !== value)
|
|
return next.length ? next : undefined
|
|
}
|
|
|
|
const chipPrefix = (chipId: string): { key: string; value: string } => {
|
|
const separator = chipId.indexOf(':')
|
|
if (separator === -1) return { key: chipId, value: '' }
|
|
return { key: chipId.slice(0, separator), value: chipId.slice(separator + 1) }
|
|
}
|
|
|
|
type FacetMutation = 'toggle' | 'remove'
|
|
|
|
/**
|
|
* ONE facet mutation for both omnibox actions: `toggle` (selecting a
|
|
* suggestion) and `remove` (dropping a chip) differ only in the values
|
|
* operation. Returns null when the id carries an invalid numeric value.
|
|
*/
|
|
const mutateFacet = (
|
|
state: SpeechListState,
|
|
key: string,
|
|
value: string,
|
|
mode: FacetMutation,
|
|
): SpeechListState | null => {
|
|
const mutate = mode === 'toggle' ? toggleValue : removeValue
|
|
switch (key) {
|
|
case 'year': {
|
|
const year = Number(value)
|
|
if (!Number.isSafeInteger(year)) return null
|
|
return { ...state, years: mutate(state.years, year) }
|
|
}
|
|
case 'topic':
|
|
return { ...state, topics: mutate(state.topics, value as SpeechTopic) }
|
|
case 'scope':
|
|
return { ...state, scopes: mutate(state.scopes, value as SpeechScope) }
|
|
case 'phase':
|
|
return { ...state, phases: mutate(state.phases, value) }
|
|
case 'municipality': {
|
|
const municipality = Number(value)
|
|
if (!Number.isSafeInteger(municipality)) return null
|
|
return { ...state, municipalities: mutate(state.municipalities, municipality) }
|
|
}
|
|
case 'duration':
|
|
return { ...state, durations: mutate(state.durations, value as SpeechDurationBucket) }
|
|
default:
|
|
return null
|
|
}
|
|
}
|
|
|
|
export const buildSpeechOmniboxChips = ({
|
|
state,
|
|
municipalityLabelsById,
|
|
}: {
|
|
state: SpeechListState
|
|
municipalityLabelsById: ReadonlyMap<number, string>
|
|
}): CampaignListOmniboxChip[] => {
|
|
const chips: CampaignListOmniboxChip[] = []
|
|
|
|
if (state.q) chips.push({ id: 'q', label: chipLabel('Busca', state.q) })
|
|
for (const year of state.years ?? []) {
|
|
chips.push({ id: `year:${year}`, label: chipLabel('Ano', String(year)) })
|
|
}
|
|
for (const topic of state.topics ?? []) {
|
|
chips.push({ id: `topic:${topic}`, label: chipLabel('Tema', speechTopicLabels[topic]) })
|
|
}
|
|
for (const scope of state.scopes ?? []) {
|
|
chips.push({ id: `scope:${scope}`, label: chipLabel('Alcance', speechScopeLabels[scope]) })
|
|
}
|
|
for (const phase of state.phases ?? []) {
|
|
chips.push({ id: `phase:${phase}`, label: chipLabel('Fase', phase) })
|
|
}
|
|
for (const municipality of state.municipalities ?? []) {
|
|
chips.push({
|
|
id: `municipality:${municipality}`,
|
|
label: chipLabel(
|
|
'Município',
|
|
municipalityLabelsById.get(municipality) ?? `Município #${municipality}`,
|
|
),
|
|
})
|
|
}
|
|
for (const duration of state.durations ?? []) {
|
|
chips.push({
|
|
id: `duration:${duration}`,
|
|
label: chipLabel('Duração', speechDurationLabels[duration]),
|
|
})
|
|
}
|
|
|
|
return chips
|
|
}
|
|
|
|
export const buildSpeechOmniboxSuggestionSeeds = ({
|
|
years,
|
|
phases,
|
|
municipalityOptions,
|
|
}: {
|
|
years: readonly number[]
|
|
phases: readonly string[]
|
|
municipalityOptions: readonly SpeechFilterOption[]
|
|
}) => {
|
|
const seeds = []
|
|
|
|
for (const { value, label } of SPEECH_TOPICS) {
|
|
seeds.push(
|
|
createOmniboxSuggestionSeed(
|
|
{ id: `topic:${value}`, group: 'Tema', label, keywords: ['tema'] },
|
|
{ emptyQueryVisible: true },
|
|
),
|
|
)
|
|
}
|
|
|
|
for (const { value, label } of SPEECH_SCOPES) {
|
|
seeds.push(
|
|
createOmniboxSuggestionSeed(
|
|
{ id: `scope:${value}`, group: 'Alcance', label, keywords: ['alcance'] },
|
|
{ emptyQueryVisible: true },
|
|
),
|
|
)
|
|
}
|
|
|
|
for (const { value, label } of SPEECH_DURATION_BUCKETS) {
|
|
seeds.push(
|
|
createOmniboxSuggestionSeed(
|
|
{ id: `duration:${value}`, group: 'Duração', label, keywords: ['duracao', 'tempo'] },
|
|
{ emptyQueryVisible: true },
|
|
),
|
|
)
|
|
}
|
|
|
|
for (const year of years) {
|
|
seeds.push(
|
|
createOmniboxSuggestionSeed({
|
|
id: `year:${year}`,
|
|
group: 'Ano',
|
|
label: String(year),
|
|
keywords: ['ano'],
|
|
}),
|
|
)
|
|
}
|
|
|
|
for (const phase of phases) {
|
|
seeds.push(
|
|
createOmniboxSuggestionSeed({
|
|
id: `phase:${phase}`,
|
|
group: 'Fase',
|
|
label: phase,
|
|
keywords: ['fase', 'sessao'],
|
|
}),
|
|
)
|
|
}
|
|
|
|
for (const option of municipalityOptions) {
|
|
seeds.push(
|
|
createOmniboxSuggestionSeed({
|
|
id: `municipality:${option.value}`,
|
|
group: 'Município',
|
|
label: option.label,
|
|
keywords: ['municipio', 'cidade'],
|
|
}),
|
|
)
|
|
}
|
|
|
|
return seeds
|
|
}
|
|
|
|
export const filterSpeechOmniboxSuggestions = (
|
|
seeds: ReturnType<typeof buildSpeechOmniboxSuggestionSeeds>,
|
|
query: string,
|
|
): CampaignListOmniboxSuggestion[] => filterOmniboxSuggestionSeeds(seeds, query)
|
|
|
|
export const applySpeechOmniboxSuggestion = ({
|
|
state,
|
|
suggestionId,
|
|
}: {
|
|
state: SpeechListState
|
|
suggestionId: string
|
|
}): SpeechOmniboxAction => {
|
|
if (suggestionId.startsWith('q:')) {
|
|
const q = suggestionId.slice(2).trim()
|
|
return { kind: 'url', state: withPageReset({ ...state, q: q || undefined }) }
|
|
}
|
|
|
|
const { key, value } = chipPrefix(suggestionId)
|
|
const next = mutateFacet(withPageReset(state), key, value, 'toggle')
|
|
return { kind: 'url', state: next ?? state }
|
|
}
|
|
|
|
export const removeSpeechOmniboxChip = ({
|
|
state,
|
|
chipId,
|
|
}: {
|
|
state: SpeechListState
|
|
chipId: string
|
|
}): SpeechOmniboxAction => {
|
|
// Dropping the query also drops the theme mode: a theme without a query has
|
|
// nothing to expand.
|
|
if (chipId === 'q') {
|
|
return { kind: 'url', state: withPageReset({ ...state, q: undefined, mode: undefined }) }
|
|
}
|
|
|
|
const { key, value } = chipPrefix(chipId)
|
|
const next = mutateFacet(withPageReset(state), key, value, 'remove')
|
|
return { kind: 'url', state: next ?? state }
|
|
}
|
|
|
|
/**
|
|
* C192 — the search mode toggle. `tema` only sticks with a query; `termo`
|
|
* (the default) clears the param so the URL stays canonical and shareable.
|
|
*/
|
|
export const applySpeechSearchMode = ({
|
|
state,
|
|
mode,
|
|
}: {
|
|
state: SpeechListState
|
|
mode: SpeechSearchMode
|
|
}): SpeechOmniboxAction => ({
|
|
kind: 'url',
|
|
state: withPageReset({ ...state, mode: mode === 'tema' && state.q ? 'tema' : undefined }),
|
|
})
|
|
|
|
export const clearSpeechOmnibox = (_state: SpeechListState): SpeechOmniboxAction => ({
|
|
kind: 'clear',
|
|
state: { page: 1 },
|
|
})
|