Principios de diseno de la wiki

Resumen

Esta wiki documenta la metodologia detras de cada calculadora en everycalc. Cada articulo explica que formula se utiliza, de donde proviene, que supuestos se aplican y como verificamos la precision contra fuentes oficiales.

Por que existe

Cada calculadora en everycalc esta construida usando fuentes autorizadas: gov.uk para impuestos del Reino Unido, HMRC para umbrales de National Insurance (Seguro Nacional), la OMS para metricas de salud e investigaciones revisadas por pares para formulas de fitness. Pero sin documentacion, los usuarios no tienen forma de verificar nuestros calculos ni de comprender nuestros supuestos.

Esta wiki resuelve tres problemas:

1. Confianza — los usuarios pueden ver exactamente como se calculan los resultados y comprobar nuestras fuentes
2. Precision — documentar la metodologia nos obliga a verificar cada constante y formula
3. Mantenimiento — cuando las tasas impositivas cambian cada abril, sabemos exactamente que articulos y constantes actualizar

Estructura de los articulos

Cada entrada de la wiki sigue la misma plantilla:

1. Resumen — que hace la calculadora, en 50 palabras
2. Como funciona — la metodologia en lenguaje sencillo
3. La formula — la formula matematica con una leyenda de variables
4. Ejemplo practico — calculo paso a paso con numeros reales
5. Entradas explicadas — que significa cada entrada y donde encontrar el valor real
6. Resultados explicados — que significa cada resultado en contexto
7. Supuestos y limitaciones — que NO cubre la calculadora
8. Verificacion — casos de prueba comprobados contra herramientas oficiales, con fechas

Tipos de fuentes

Cada articulo debe citar al menos una fuente autorizada. Las fuentes se clasifican por tipo:

Estandares de verificacion

• Las calculadoras financieras deben verificarse contra la calculadora oficial del gobierno (por ejemplo, la calculadora SDLT de gov.uk, la calculadora de impuestos de HMRC)
• Las calculadoras de salud deben citar el articulo de investigacion original o la guia clinica que define la formula
• Todas las calculadoras deben incluir una prueba de identidad contable en su suite de pruebas unitarias (por ejemplo, gross = net + tax + NI + pension)
• Las fechas de verificacion se registran — los articulos con mas de 6 meses muestran una insignia de advertencia ambar

Control de calidad

Un script en tiempo de compilacion comprueba que cada calculadora en nav.ts tenga una entrada correspondiente en la wiki. Las entradas faltantes generan advertencias (eventualmente, errores de compilacion).

Como contribuir con un nuevo articulo

1. Crear un nuevo archivo .mdx en src/content/wiki/
2. Agregar el frontmatter requerido (titulo, descripcion, fuentes, etc.)
3. Seguir la estructura de plantilla de articulo descrita arriba
4. Agregar el mapeo de ruta de calculadora a slug de wiki en src/data/wikiSlugs.ts
5. Ejecutar npm run build para validar el esquema del frontmatter
6. El articulo aparecera automaticamente en la pagina central de la wiki