feat(score): reweight wind up to 25 and flag down to 10

Wind is the factor that most often ruins a day on this coast, yet it
carried 15 points while the flag carried 20. Swap the weights: wind
0-25 (curve rescaled, no-data 12) and flag 0-10 (green 10, yellow or
unknown 5, red/black 0). Reason thresholds for "viento fuerte" scale
with it (caution <=5, downgrade <=8). Frontend defaults and factor
order follow; comments updated to the new numbers.

Claude-Session: https://claude.ai/code/session_01CZeTJqzoJxUKi7uWcVDnoj

Author: oscaruiz

backend/src/__tests__/BeachScorer.test.ts

@@ -154,11 +154,11 @@ describe('computeTemperatureScore', () => {
 
 describe('computeFlagScore', () => {
   it('returns max for green', () => {
-    expect(computeFlagScore(makeFlag({ color: 'green' }))).toBe(20);
+    expect(computeFlagScore(makeFlag({ color: 'green' }))).toBe(10);
   });
 
-  it('returns 10 for yellow', () => {
-    expect(computeFlagScore(makeFlag({ color: 'yellow' }))).toBe(10);
+  it('returns 5 for yellow', () => {
+    expect(computeFlagScore(makeFlag({ color: 'yellow' }))).toBe(5);
   });
 
   it('returns 0 for red and black', () => {
@@ -167,14 +167,14 @@ describe('computeFlagScore', () => {
   });
 
   it('returns neutral for null (no Cruz Roja coverage)', () => {
-    expect(computeFlagScore(null)).toBe(10);
+    expect(computeFlagScore(null)).toBe(5);
   });
 
   it('una bandera que no podemos leer puntúa igual que no tener servicio', () => {
     // "Hay bandera, lo que no tenemos es información": restar por eso castigaba
     // a la playa por un fallo nuestro, y encima MÁS que a una playa sin
-    // vigilancia, que se llevaba el 10 neutro.
-    expect(computeFlagScore(makeFlag({ color: 'unknown' }))).toBe(10);
+    // vigilancia, que se llevaba el 5 neutro.
+    expect(computeFlagScore(makeFlag({ color: 'unknown' }))).toBe(5);
     expect(computeFlagScore(makeFlag({ color: 'unknown' }))).toBe(computeFlagScore(null));
   });
 });
@@ -185,8 +185,8 @@ describe('computeFlagScore', () => {
 
 describe('computeWindScore', () => {
   it('returns max for calm', () => {
-    expect(computeWindScore(0)).toBe(15);
-    expect(computeWindScore(2)).toBe(15);
+    expect(computeWindScore(0)).toBe(25);
+    expect(computeWindScore(2)).toBe(25);
   });
 
   it('decreases with stronger wind', () => {
@@ -199,7 +199,7 @@ describe('computeWindScore', () => {
   });
 
   it('returns neutral for null', () => {
-    expect(computeWindScore(null)).toBe(7);
+    expect(computeWindScore(null)).toBe(12);
   });
 });
 
@@ -575,9 +575,9 @@ describe('región sin servicio de banderas', () => {
     const sinOperador = computeBeachScore(
       buenTiempo(), null, enrichment, undefined, null, null, SIN_OPERADOR,
     ).score;
-    // The 12 points it cannot reach (10 neutral flag + the 2 from "datos"
+    // The 7 points it cannot reach (5 neutral flag + the 2 from "datos"
     // that need a reading) are the ones that used to cap a whole region.
-    expect(conOperador).toBe(88);
+    expect(conOperador).toBe(93);
     expect(sinOperador).toBe(100);
   });
 
@@ -835,7 +835,7 @@ describe('computeBeachScore — el tope que se aplicó', () => {
  */
 describe('buildRankingReason — de noche no hay sol que nombrar', () => {
   const base: SubScores = {
-    cielo: 25, temperatura: 25, bandera: 20, viento: 15, oleaje: 10, datos: 5,
+    cielo: 25, temperatura: 25, bandera: 10, viento: 25, oleaje: 10, datos: 5,
   };
   const cielo = (icon: string, description: string): Weather => ({
     source: 'OpenWeather',

backend/src/__tests__/FeaturedBeachClima.test.ts

@@ -58,7 +58,7 @@ describe('FeaturedBeachMapper.descripcionClima — observación real con priorid
 });
 
 describe('buildRankingReason — palabra de cielo desde la observación', () => {
-  const subScores: SubScores = { cielo: 22, temperatura: 22, bandera: 20, viento: 15, oleaje: 10, datos: 5 };
+  const subScores: SubScores = { cielo: 22, temperatura: 22, bandera: 10, viento: 25, oleaje: 10, datos: 5 };
 
   it('prefiere la observación OpenWeather sobre enrichment.summary', () => {
     const reason = buildRankingReason(subScores, makeWeather({ description: 'algo de nubes' }), null, makeEnrichment({ summary: 'Despejado' }));
@@ -107,7 +107,7 @@ describe('FeaturedBeachMapper — desglose, pronóstico y tope', () => {
     const dto = FeaturedBeachMapper.toDTO([makeResult({ subScores })], [], [], 1750000000000);
 
     expect(dto.maximos).toEqual({
-      cielo: 25, temperatura: 25, bandera: 20, viento: 15, oleaje: 10, datos: 5,
+      cielo: 25, temperatura: 25, bandera: 10, viento: 25, oleaje: 10, datos: 5,
     });
     expect(Object.keys(dto.playas[0])).not.toContain('maximos');
   });

backend/src/__tests__/featuredFlagVigencia.test.ts

@@ -126,7 +126,7 @@ describe('GetFeaturedBeaches — banderas fuera de horario', () => {
 
   it('sigue contando la bandera dentro del horario', async () => {
     // Un horario que cubre todo el día: la bandera es vigente se ejecute cuando
-    // se ejecute la suite, y debe sumar sus 20 puntos.
+    // se ejecute la suite, y debe sumar sus 10 puntos.
     const vigente: FlagStatus = {
       ...banderaFueraDeHorario(new Date()),
       schedule: '00:00 - 23:59',

backend/src/__tests__/featuredOutlook.test.ts

@@ -30,7 +30,7 @@ function tramos(nubes: number): HourlyOutlookSlot[] {
     timestamp: AHORA.getTime() + (i + 1) * 3_600_000,
     cloudCoverPct: nubes,
     temperatureC: 20,
-    windSpeedMs: 3.3,
+    windSpeedMs: 5.4,
   }));
 }
 
@@ -55,7 +55,7 @@ function construir(rain: RainNowcast) {
       temperatureC: 19.91,
       description: 'nubes',
       icon: '04d',
-      windSpeedMs: 3.34,
+      windSpeedMs: 5.4,
       windDirectionDeg: 0,
       humidityPct: 70,
       pressureHPa: 1015,
@@ -130,7 +130,7 @@ describe('GetFeaturedBeaches — previsión de las próximas horas', () => {
           timestamp: medianoche.getTime() + (i + 1) * 3_600_000,
           cloudCoverPct: 0,
           temperatureC: 20,
-          windSpeedMs: 3.3,
+          windSpeedMs: 5.4,
         })),
       ),
     ).execute();

backend/src/domain/use-cases/BeachScorer.ts

@@ -86,7 +86,7 @@ export interface ForecastEnrichment {
 export const LEGACY_FLAG_OPERATORS: readonly string[] = ['Cruz Roja'];
 
 /** Weight of the flag factor in the 0-100 total, and the total itself. */
-const FLAG_MAX = 20;
+const FLAG_MAX = 10;
 const SCORE_MAX = 100;
 
 /**
@@ -99,21 +99,21 @@ export const SUBSCORE_MAX = {
   cielo: 25,
   temperatura: 25,
   bandera: FLAG_MAX,
-  viento: 15,
+  viento: 25,
   oleaje: 10,
   datos: 5,
 } as const;
 
 /**
  * Reachable maximum when the region has no flag service: the flag factor
- * disappears (-20) and `datos` can never award the 2 points that came from
+ * disappears (-10) and `datos` can never award the 2 points that came from
  * having a flag reading (-2).
  */
 const SCORE_MAX_WITHOUT_FLAG = SCORE_MAX - FLAG_MAX - 2;
 
 /**
  * Rescales to 0-100 the score of a region with no flag service. Without this
- * every beach in such a region would lose the same ~22 points, and the bands
+ * every beach in such a region would lose the same ~12 points, and the bands
  * (green ≥60) would read the absence of an operator as bad conditions —
  * penalising the whole region for something that has nothing to do with the
  * beach.
@@ -254,47 +254,47 @@ export function computeTemperatureScore(tempC: number | null): number {
 }
 
 // ---------------------------------------------------------------------------
-// Flag score (0-20)
+// Flag score (0-10)
 // ---------------------------------------------------------------------------
 
 /**
  * `unknown` scores the SAME neutral as having no flag service at all, and that
  * is the whole point: there is a flag flying, what is missing is our reading of
  * it. Docking points for it punished the beach for a failure of ours — and
  * punished it HARDER than a beach with no lifeguards, which walks away with the
- * neutral 10. Ignorance is not evidence of bad conditions.
+ * neutral 5. Ignorance is not evidence of bad conditions.
  *
  * Safety does not rest on this number: a stale black or red keeps its colour
  * (see `GetFeaturedBeaches.getFlagForBeach`) and keeps excluding the beach, so
  * what degrades to `unknown` is only ever a green or a yellow.
  */
 const FLAG_SCORE: Record<FlagColor, number> = {
-  green: 20,
-  yellow: 10,
+  green: 10,
+  yellow: 5,
   red: 0,
   black: 0,
-  unknown: 10,
+  unknown: 5,
 };
 
 /** Neutral when there is nothing to judge: no service, or no reading of it. */
-const FLAG_NEUTRAL = 10;
+const FLAG_NEUTRAL = 5;
 
 export function computeFlagScore(flag: FlagStatus | null): number {
   if (!flag || !flag.color) return FLAG_NEUTRAL; // no CR coverage → neutral
   return FLAG_SCORE[flag.color] ?? FLAG_NEUTRAL;
 }
 
 // ---------------------------------------------------------------------------
-// Wind score (0-15)
+// Wind score (0-25)
 // ---------------------------------------------------------------------------
 
 export function computeWindScore(windSpeedMs: number | null): number {
-  if (windSpeedMs == null) return 7;
-  if (windSpeedMs <= 3) return 15;
-  if (windSpeedMs <= 5) return interpolate(windSpeedMs, 3, 5, 15, 12);
-  if (windSpeedMs <= 8) return interpolate(windSpeedMs, 5, 8, 12, 8);
-  if (windSpeedMs <= 12) return interpolate(windSpeedMs, 8, 12, 8, 3);
-  return interpolate(Math.min(windSpeedMs, 20), 12, 20, 3, 0);
+  if (windSpeedMs == null) return 12;
+  if (windSpeedMs <= 3) return 25;
+  if (windSpeedMs <= 5) return interpolate(windSpeedMs, 3, 5, 25, 20);
+  if (windSpeedMs <= 8) return interpolate(windSpeedMs, 5, 8, 20, 13);
+  if (windSpeedMs <= 12) return interpolate(windSpeedMs, 8, 12, 13, 5);
+  return interpolate(Math.min(windSpeedMs, 20), 12, 20, 5, 0);
 }
 
 // ---------------------------------------------------------------------------
@@ -417,7 +417,7 @@ export function computeBeachScore(
     cielo: computeSkyScore(weather),
     temperatura: computeTemperatureScore(weather?.temperatureC ?? null),
     // 0 and out of the sum with no operator in the region: there is no flag to
-    // judge, so a neutral 10/20 would be inventing a middling reading.
+    // judge, so a neutral 5/10 would be inventing a middling reading.
     bandera: hasFlagService ? computeFlagScore(effectiveFlag) : 0,
     viento: computeWindScore(weather?.windSpeedMs ?? null),
     oleaje: computeWavesScore(enrichment, weather, isSurf),
@@ -573,7 +573,7 @@ export function buildCautionReason(
   const forecastPart = rainPart ? null : rainForecastReasonFragment(rainForecast);
   if (forecastPart) parts.push(forecastPart);
 
-  if (subScores.viento <= 3) parts.push('viento fuerte');
+  if (subScores.viento <= 5) parts.push('viento fuerte');
   if (subScores.oleaje <= 2) parts.push('oleaje fuerte');
   if (subScores.cielo <= 3 && !rainPart && !forecastPart) parts.push('lluvia o tormenta');
   if (subScores.temperatura <= 5) parts.push('temperatura baja');
@@ -632,7 +632,7 @@ export function buildDowngradeFactors(
   else if (flag?.color === 'red') parts.push('bandera roja');
   else if (!flag?.color && operador && !hasFlagStation) parts.push(`sin cobertura ${operador}`);
 
-  if (subScores.viento <= 5) parts.push('viento fuerte');
+  if (subScores.viento <= 8) parts.push('viento fuerte');
   if (subScores.oleaje <= 3) parts.push('oleaje fuerte');
 
   if (outlook?.direccion === 'empeora') {

backend/src/domain/use-cases/BeachWindowScorer.ts

@@ -38,7 +38,7 @@ const UMBRAL_CALIDAD = 60;
  * How far below the day's own peak an hour may fall and still belong to the
  * best stretch. The bar is RELATIVE on purpose: an absolute one cannot see the
  * change that matters most on this coast — clear sky and 24° with a gale still
- * normalizes to ~77 (wind is 15 of 65 points), so "a partir de las 17:00
+ * normalizes to ~67 (wind is 25 of 75 points), so "a partir de las 17:00
  * aumenta el viento" would never be said. Twelve points keeps one sky band
  * (01d→02d, −4.6) and a light breeze pickup (−4.6) inside the stretch, and
  * pushes a closed sky (−13.8) or a real blow (−20) out of it.

backend/src/domain/use-cases/GetFeaturedBeaches.ts

@@ -293,13 +293,13 @@ export class GetFeaturedBeaches {
    * That last part is the point. Outside lifeguard hours the interface already
    * refuses to paint a colour, but the score and the ranking reason were still
    * built from the raw flag: at midnight the app published `bandera: null` and,
-   * in the same object, "bandera verde" worth 20 points. It contradicted
+   * in the same object, "bandera verde" worth 10 points. It contradicted
    * itself, and it inflated the rating with a flag captured hours earlier.
    *
    * Discarding is only right when there is NO service. A reading that goes
    * stale during the watch means the delivery broke, not that the beach was
    * cleared: turning it into `null` there let a lost black flag score as
-   * "no coverage" (neutral 10/20) and re-enter the ranking. So a restrictive
+   * "no coverage" (neutral 5/10) and re-enter the ranking. So a restrictive
    * colour survives its own staleness — it keeps excluding until something
    * tells us it was taken down — and any other stale colour degrades to
    * `unknown`, which neither publishes a colour nor scores as good.

frontend/src/pages/playa-detalle/ScoreCard.tsx

@@ -23,7 +23,7 @@ const TOPES: Record<'lluvia' | 'lluvia_prevista', { clave: ClaveTexto; valor: nu
 
 /** Reachable maximum of each factor when the backend does not send `maximos`. */
 const MAXIMOS_POR_DEFECTO: SubPuntuaciones = {
-  cielo: 25, temperatura: 25, bandera: 20, viento: 15, oleaje: 10, datos: 5,
+  cielo: 25, temperatura: 25, bandera: 10, viento: 25, oleaje: 10, datos: 5,
 };
 
 /**
@@ -39,8 +39,8 @@ const MAXIMOS_POR_DEFECTO: SubPuntuaciones = {
 const FACTORES: Array<{ campo: keyof SubPuntuaciones; clave: ClaveTexto }> = [
   { campo: 'cielo', clave: 'detalle.scoreInfo.sol' },
   { campo: 'temperatura', clave: 'detalle.scoreInfo.temp' },
-  { campo: 'bandera', clave: 'detalle.scoreInfo.bandera' },
   { campo: 'viento', clave: 'detalle.scoreInfo.viento' },
+  { campo: 'bandera', clave: 'detalle.scoreInfo.bandera' },
   { campo: 'oleaje', clave: 'detalle.scoreInfo.oleaje' },
   { campo: 'datos', clave: 'detalle.scoreInfo.datos' },
 ];

frontend/src/test/characterization/beachDetailPage.test.tsx

@@ -556,7 +556,7 @@ describe('PlayaDetalle — puntuación', () => {
 
     expect(valores[0]).toBe('cielo despejado');   // cielo
     expect(valores[1]).toBe('22°');               // temperatura
-    expect(valores[2]).toBe('Verde');             // bandera
+    expect(valores[3]).toBe('Verde');             // bandera (viento va antes: pesa más)
     expect(valores[4]).toBe('marejadilla');       // oleaje
     expect(valores[5]).toBe('clima y bandera');   // datos
   });

frontend/src/test/fixtures/featured.ts

@@ -44,7 +44,7 @@ export const featuredLaConcha: FeaturedBeach = {
   puntuacion: 93,
   razonRanking: 'cielo despejado, viento flojo, bandera verde, mejora en las próximas horas',
   subpuntuaciones: {
-    cielo: 25, temperatura: 22, bandera: 20, viento: 15, oleaje: 6, datos: 5,
+    cielo: 25, temperatura: 22, bandera: 10, viento: 25, oleaje: 6, datos: 5,
   },
   pronostico: { direccion: 'mejora', delta: 6, causa: 'despeja' },
   topeAplicado: null,
@@ -234,5 +234,5 @@ export const featuredResponse: FeaturedBeachesResponse = {
   revisar: [featuredBerria, featuredLangre],
   resumenTodas,
   // Scale of each factor, sent once for the whole response.
-  maximos: { cielo: 25, temperatura: 25, bandera: 20, viento: 15, oleaje: 10, datos: 5 },
+  maximos: { cielo: 25, temperatura: 25, bandera: 10, viento: 25, oleaje: 10, datos: 5 },
 };