import { useId, useState } from 'react'; export type QuantitativeMapContext = { state: 'available' | 'unavailable' | 'not_included' | 'error'; records: { id: string; zone_id: string; zone_name: string; zone_version: number; url: string; theme: 'workforce' | 'economic_potential'; indicator: string; label?: string | null; description?: string | null; value: string | null; unit?: string | null; period_start?: string | null; period_end?: string | null; scope?: string | null; population?: string | null; methodology?: string | null; source_reference?: string | null; source_date?: string | null; knowledge: string; measure_kind?: 'unknown' | 'observed' | 'planned' | 'projected'; missing_metadata: string[]; }[]; zones_consulted?: number; zone_limit?: number; record_limit?: number; truncated: boolean; }; const labels: Record = { employment: 'Emprego', investment: 'Investimento', production: 'Produção', exports: 'Exportações', local_procurement: 'Compras locais', }; const metadataLabels: Record = { unit: 'unidade', period_start: 'início do período', period_end: 'fim do período', scope: 'âmbito', population: 'população/base', methodology: 'metodologia', source_reference: 'fonte', source_date: 'data da fonte', }; const text = (value?: string | null) => value?.trim() || 'Não indicado'; const measureKinds: Record = { unknown: 'Por confirmar', observed: 'Observado / efectivo', planned: 'Planeado / meta', projected: 'Projectado / estimado', }; const measureKind = (row: QuantitativeMapContext['records'][number]) => row.measure_kind && ['observed', 'planned', 'projected'].includes(row.measure_kind) ? row.measure_kind : 'unknown'; const completeDate = (value?: string | null) => Boolean( value && /^\d{4}-\d{2}-\d{2}$/.test(value) && !Number.isNaN(Date.parse(value)) && new Date(value).toISOString().slice(0, 10) === value, ); type MapObservation = QuantitativeMapContext['records'][number]; // Calendar metadata only: inclusive source dates, never a rate or annualisation. function periodDays(row: MapObservation): number | null { if ( !completeDate(row.period_start) || !completeDate(row.period_end) || row.period_start! > row.period_end! ) return null; return ( (Date.parse(row.period_end!) - Date.parse(row.period_start!)) / 86_400_000 + 1 ); } const observationKey = (row: MapObservation) => JSON.stringify([row.zone_id, row.id, row.zone_version]); export function compareMapObservations( first: MapObservation, second: MapObservation, ) { const issues: string[] = []; if (observationKey(first) === observationKey(second)) issues.push('Escolha duas observações distintas.'); if (first.zone_id !== second.zone_id) issues.push( 'Territórios distintos: os valores não representam uma série do mesmo local.', ); for (const [label, row] of [ ['Primeira', first], ['Segunda', second], ] as const) { if (measureKind(row) === 'unknown') issues.push( `${label} observação: natureza do valor por confirmar na fonte.`, ); if (row.knowledge !== 'documented') issues.push( `${label} observação: informação desconhecida ou em divergência.`, ); if ( row.value === null || !/^[+-]?(?:\d+(?:\.\d*)?|\.\d+)(?:e[+-]?\d+)?$/i.test(row.value) ) issues.push( `${label} observação: valor quantitativo por confirmar.`, ); const comparisonMetadata: Record = { ...metadataLabels, description: 'descrição/natureza da grandeza', }; const missing = Object.keys(comparisonMetadata).filter( (field) => !row[field as keyof MapObservation]?.toString().trim(), ); if (missing.length) issues.push( `${label} observação sem ${missing.map((field) => comparisonMetadata[field]).join(', ')}.`, ); if ( !completeDate(row.period_start) || !completeDate(row.period_end) || (row.period_start ?? '') > (row.period_end ?? '') ) issues.push(`${label} observação: período incompleto ou inválido.`); if (!completeDate(row.source_date)) issues.push( `${label} observação: data da fonte incompleta ou inválida.`, ); } const firstDays = periodDays(first); const secondDays = periodDays(second); if (firstDays !== null && secondDays !== null) { if (firstDays !== secondDays) issues.push( 'Duração dos períodos diferente; não trate os valores como bases temporais equivalentes.', ); if ( (first.period_start !== second.period_start || first.period_end !== second.period_end) && first.period_start! <= second.period_end! && second.period_start! <= first.period_end! ) issues.push( 'Os períodos sobrepõem-se; as observações podem abranger os mesmos dias.', ); } if (measureKind(first) !== measureKind(second)) issues.push( 'Natureza do valor diferente: observado, planeado e projectado não são equivalentes.', ); for (const [field, label] of Object.entries({ indicator: 'Indicador', unit: 'Unidade', scope: 'Âmbito', population: 'População/base', methodology: 'Metodologia', })) { if ( (first[field as keyof MapObservation] ?? '').toString().trim() !== (second[field as keyof MapObservation] ?? '').toString().trim() ) issues.push(`${label} diferente entre as observações.`); } return { state: issues.length ? 'review_required' : 'metadata_aligned', issues, }; } export function MapObservationComparison({ first, second, }: { first?: MapObservation; second?: MapObservation; }) { if (!first || !second) return (

Seleccione duas observações disponíveis nos filtros actuais.

); const assessment = compareMapObservations(first, second); const fields: [string, (row: MapObservation) => string][] = [ ['Território', (row) => row.zone_name], ['Observação', (row) => text(row.label)], ['Descrição e natureza da grandeza', (row) => text(row.description)], ['Natureza do valor', (row) => measureKinds[measureKind(row)]], ['Indicador', (row) => labels[row.indicator] ?? row.indicator], [ 'Valor original', (row) => (row.value === null ? 'Por confirmar' : row.value), ], ['Unidade', (row) => text(row.unit)], [ 'Período', (row) => `${text(row.period_start)} — ${text(row.period_end)}`, ], [ 'Duração do período (dias, limites incluídos)', (row) => { const days = periodDays(row); return days === null ? 'Por confirmar' : String(days); }, ], ['Âmbito', (row) => text(row.scope)], ['População/base', (row) => text(row.population)], ['Metodologia', (row) => text(row.methodology)], [ 'Situação da informação', (row) => row.knowledge === 'documented' ? 'Documentada' : row.knowledge === 'disputed' ? 'Em divergência' : 'Por confirmar', ], ['Fonte', (row) => text(row.source_reference)], ['Data da fonte', (row) => text(row.source_date)], ['Versão da ficha territorial', (row) => String(row.zone_version)], ]; return (

{assessment.state === 'metadata_aligned' ? 'Metadados alinhados; confirme nas fontes se os valores podem ser comparados.' : 'Há diferenças ou lacunas a conferir antes de comparar os valores.'}

{!!assessment.issues.length && (
    {assessment.issues.map((issue) => (
  • {issue}
  • ))}
)}

Períodos distintos ou sobrepostos exigem conferência da duração e da base na fonte. Esta apresentação não calcula evolução, soma, conversão, pontuação ou estimativa regional. A natureza declarada deve ser conferida com a descrição e a fonte.

{fields.map(([label, value]) => ( ))}
Conferência de duas observações quantitativas
Campo Primeira observação Segunda observação
{label} {value(first)} {value(second)}
); } function MapObservationComparisonPicker({ rows }: { rows: MapObservation[] }) { const id = useId(); const [firstKey, setFirst] = useState(''); const [secondKey, setSecond] = useState(''); const first = rows.find((row) => observationKey(row) === firstKey); const second = rows.find((row) => observationKey(row) === secondKey); return (
Comparar duas observações

Confronte os dados e as fontes antes de os usar na decisão. Selecções fora dos filtros deixam de ser comparadas; uma versão nova exige nova selecção.

{(['Primeira', 'Segunda'] as const).map((label, index) => ( ))}
); } export function filterMapIndicators( records: QuantitativeMapContext['records'], indicator: string, start: string, end: string, ) { if (start && end && start > end) return []; return records.filter((row) => { if (indicator !== 'all' && row.indicator !== indicator) return false; if (!start && !end) return true; // Incomplete or inverted source periods cannot establish overlap. if ( !completeDate(row.period_start) || !completeDate(row.period_end) || !row.period_start || !row.period_end || row.period_start > row.period_end ) return false; return ( (!start || row.period_end >= start) && (!end || row.period_start <= end) ); }); } export default function InvestmentMapIndicators({ context, theme, }: { context: QuantitativeMapContext | null; theme: string; }) { const filterId = useId(); const [indicator, setIndicator] = useState('all'); const [start, setStart] = useState(''); const [end, setEnd] = useState(''); if (!['all', 'workforce', 'economic_potential'].includes(theme)) return null; const themeRows = context?.records.filter( (row) => theme === 'all' || row.theme === theme, ) ?? []; const rows = filterMapIndicators(themeRows, indicator, start, end); const invalidPeriod = Boolean(start && end && start > end); const filtered = indicator !== 'all' || Boolean(start || end); return (

Indicadores quantitativos do contexto territorial

Observações públicas das zonas e parques devolvidos como contexto territorial, independentes das evidências das oportunidades. Emprego não mede trabalhadores disponíveis; investimento, produção e exportações não constituem um índice de potencial ou garantia de retorno. A natureza do valor é declarada segundo a fonte; sem essa indicação permanece por confirmar.

{!context ? (

A carregar indicadores quantitativos…

) : context.state === 'error' ? (

Não foi possível consultar os indicadores. Pode repetir a consulta do mapa.

) : context.state === 'not_included' ? (

O conjunto de zonas não está incluído com estes filtros específicos de oportunidades. Não foi feita uma medição quantitativa neste âmbito.

) : context.state === 'unavailable' ? (

Observações quantitativas indisponíveis nesta versão do cadastro; os restantes dados do mapa mantêm-se.

) : ( <>
Filtrar observações do contexto territorial

O período selecciona observações com sobreposição de datas, incluindo os limites. Datas incompletas ou invertidas na fonte ficam fora do filtro temporal. A data da fonte não substitui o período de referência. Estes filtros actuam apenas nas observações recebidas; não alteram oportunidades ou limites de cobertura.

{invalidPeriod && (

O início do período deve ser anterior ou igual ao fim.

)}

{rows.length}{' '} {rows.length === 1 ? 'observação' : 'observações'} nesta camada, de {themeRows.length} recebidas, em{' '} {context.zones_consulted}{' '} {context.zones_consulted === 1 ? 'ficha territorial consultada.' : 'fichas territoriais consultadas.'}{' '} A contagem não mede cobertura nacional.

{context.truncated && (

Cobertura incompleta: consulta limitada a{' '} {context.zone_limit} fichas e {context.record_limit}{' '} observações. Refine a localização.

)} {rows.length > 1 && ( )} {rows.length === 0 ? (

{filtered ? 'Nenhuma observação corresponde aos filtros dos indicadores.' : 'Sem observações públicas destes indicadores na resposta.'}{' '} Valor desconhecido não equivale a zero.

) : (
Consultar valores, unidades e fontes ( {rows.length})
{rows.map((row) => ( ))}
Cada linha conserva o âmbito da fonte. Sem somas, conversões de unidade ou moeda, médias ou comparação automática entre períodos e populações.
Ficha e indicador Valor e unidade Período e base Fonte e metodologia
{row.zone_name}

{labels[ row.indicator ] ?? row.indicator} : {text(row.label)}

{text(row.description)}

Versão pública{' '} {row.zone_version}

{row.value ?? 'Por determinar'}{' '} · {text(row.unit)}

Natureza:{' '} { measureKinds[ measureKind(row) ] }

{row.knowledge === 'documented' ? 'Documentado na fonte' : row.knowledge === 'disputed' ? 'Em divergência' : 'Desconhecido'}

{text(row.period_start)}{' '} a {text(row.period_end)}

Âmbito:{' '} {text(row.scope)}

População/base:{' '} {text(row.population)}

Fonte:{' '} {text( row.source_reference, )}{' '} · Data:{' '} {text(row.source_date)}

Metodologia:{' '} {text(row.methodology)}

{row.missing_metadata .length > 0 && (

Informação em falta:{' '} {row.missing_metadata .map( (key) => metadataLabels[ key ] ?? key, ) .join(', ')} . Não agregar ou comparar como se estivesse completa.

)}
)} )}
); }