Esta página se está traducido el 2014-12-08.
Es posible que la versión inglés se actualizaba desde luego.

Glosario

Glosario de términos de Alaveteli, la plataforma de información pública de mySociety.

Definiciones

Alaveteli
Alaveteli es el nombre de la plataforma de software de código abierto creada por mySociety para enviar, gestionar y archivar solicitudes de información pública.

Se construyó a partir del exitoso proyecto de información pública de Reino Unido WhatDoTheyKnow. Utilizamos el nombre Alaveteli para distinguir el software que sustenta la plataforma respecto de cualquier sitio web específico que la utilice.

Más información:

imparcial respecto al solicitante
La ley de información pública normalmente considera que las respuestas ofrecidas por las autoridades son imparciales respecto al solicitante. Esto significa que la respuesta no debería cambiar en nada en relación a quién haya solicitado la información. Como consecuencia, la respuesta puede publicarse, ya que en teoría todo el mundo podría preguntar lo mismo y, por ley, debería recibir la misma información.

A pesar de ello, sigue siendo bastante común a nivel mundial que las autoridades respondan a las solicitudes de información pública de forma privada, en lugar de publicar ellas mismas sus respuestas. Por tanto, una de las funciones de Alaveteli consiste en actuar como repositorio público de las respuestas recibidas. Esto también sirve para reducir solicitudes duplicadas, pues la respuesta es pública y evita que la pregunta se tenga que repetir de nuevo.

autoridad
Llamamos autoridad a cualquier organismo, organización, departamento o compañía a los que los usuarios pueden enviar solicitudes.

Más información:

  • Un administrador puede añadir, editar o eliminar autoridades en el apartado de administración.
  • Las autoridades son habitualmente, aunque no siempre, organismos públicos obligados a responder por la ley local de información pública. A veces se establece un sitio basado en Alaveteli en una jurisdicción que aún no cuenta con una ley de información pública. En el Reino Unido hemos añadido a nuestro sitio WhaDoTheyKnow algunas autoridades que no están sujetas a la ley de información pública, pero que se han sometido a ella de forma voluntaria o creemos que deberían tenerse en cuenta en este ámbito.
agujero negro
Un agujero negro es una dirección de correo electrónico que acepta y destruye todos los mensajes de correo que recibe. Alaveteli lo utiliza para los mensajes de correo que no admiten respuestas, normalmente generados de forma automática por sistemas de correo. </p>

Más información:

  • Utilice la opción de configuración BLACKHOLE_PREFIX para especificar el aspecto de esta dirección de correo.
  • Por otra parte, revise CONTACT_EMAIL para especificar la dirección que recibirá mensajes de correo de los usuarios (por ejemplo, solicitudes de soporte).
mensaje rebotado
Un mensaje rebotado es generado automáticamente por un sistema de correo para informar al remitente de un mensaje sobre problemas ocurridos en la entrega de dicho mensaje. </p>

Más información:

Capistrano
Capistrano es una herramienta de implementación y automatización en un servidor remoto escrita en Ruby, utilizada por el mecanismo opcional de implementación de Alaveteli.

Más información:

norma de censura
Los administradores de Alaveteli pueden definir normas de censura para identificar qué partes de las respuestas deberían ser editadas. </p>

Más información:

  • Consulte el manual de administrador para obtener más información sobre las normas de censura.
  • Las normas de censura pueden simplemente editar texto que concuerde exactamente con una frase u oración en particular, así como utilizar expresiones regulares.
servidor de desarrollo
Un servidor de desarrollo soporta la ejecución de su sitio basado en Alaveteli para que pueda personalizarlo, experimentar con distintas opciones y ponerlo a prueba hasta conseguir que desempeñe las funciones deseadas. Es diferente de un servidor de producción, que es visitado por usuarios auténticos y funciona con datos reales, así como de un servidor de pruebas, utilizado para probar el código antes de publicarlo.

En el servidor de desarrollo debe asignar a STAGING_SITE el valor 1.

usuario de emergencia
Alaveteli incluye la configuración de un usuario de emergencia. Esta configuración ofrece un código de usuario y una contraseña para acceder a la página de administración, incluso si el usuario no aparece en la base de datos.

Cuando el sistema ha sido arrancado (es decir, cuando se ha utilizado el usuario de emergencia para proporcionar a una cuenta de usuario permisos totales de administrador), el usuario de emergencia debe deshabilitarse.

Más información:

Información pública
Las leyes de información pública permiten al público acceder a datos almacenados por los gobiernos nacionales. Establecen un proceso legal para el derecho a saber, que permite solicitar información guardada por los gobiernos y recibirla de forma gratuita por un mínimo coste, salvo excepciones estándar.
[Wikipedia]

Más información:

git (también llamado «github» o «repositorio git»)
Utilizamos un popular sistema de control de código fuente llamado git. Este sistema nos ayuda a monitorizar los cambios realizados en el código y también facilita a otras personas la duplicación de nuestro software y la colaboración en su elaboración.

El sitio web github.com es un lugar público central donde está disponible nuestro software. Debido a que se trata de código abierto, puede revisarlo (Alaveteli está en su mayoría escrito en el lenguaje de programación Ruby) e informar de errores, así como sugerir funcionalidades y otras numerosas características prácticas.

El conjunto completo de archivos que forman la plataforma Alaveteli se denomina repositorio git. Al instalar Alaveteli, está clonando nuestro repositorio en su propio equipo.

Más información:

sala de espera
La sala de espera es un lugar conceptual donde se almacenan los mensajes que no se han podido entregar y necesitan ser revisados por un administrador.

Más información:

  • Consulte la información incluida en el manual de administrador sobre cómo gestionar los mensajes de correo ubicados en la sala de espera.
MTA (servidor de correo)
Un servidor de correo es un programa que envía y recibe correo electrónico. Alaveteli envía correo a nombre de sus usuarios y procesa las respuestas que recibe. Todos los mensajes pasan por el servidor de correo, que constituye un servicio independiente de su sistema.

Más información:

  • Consulte estas instrucciones para configurar su MTA (incluye ejemplos para exim4 y postfix, dos de los más comunes)
New Relic
Alaveteli puede utilizar la herramienta de monitorización de aplicaciones de New Relic para revisar el rendimiento de su servidor de producción. Si se halla activado, el sitio web de New Relic recopila datos sobre su aplicación, que puede inspeccionar gracias a sus herramientas visuales. Sus funcionalidades básicas son gratuitas.

Más información:

  • Utilice la opción agent_enabled: del archivo de configuración newrelic.yml para activar el análisis de New Relic. Consulte las instrucciones de instalación manual.
  • Consulte también el repositorio de github y la documentación sobre el agente Ruby de New Relic.
  • Sitio web de New Relic: si tiene este servicio activado, puede iniciar sesión para revisar los análisis de rendimiento.
archivo .po (y archivo .pot)
Estos son los archivos requeridos por el mecanismo gettext que Alaveteli utiliza para la localización. Un archivo .pot contiene una lista con todas las cadenas de texto propias de la aplicación que necesitan ser traducidas. Cada archivo .po contiene la correspondencia entre estas cadenas, utilizadas como claves, y sus traducciones para un idioma en concreto. La clave se denomina msgid y su correspondiente traducción, msgstr.

Más información:

  • Consulte la traducción de Alaveteli para obtener una visión general desde el punto de vista de un traductor.
  • Consulte la internacionalización de Alaveteli para acceder a detalles más técnicos.
  • Alaveteli se halla en el sitio web Transifex, que permite a los traductores trabajar con Alaveteli en un navegador, sin necesidad de preocuparse por su estructura subyacente.
servidor de producción
Un servidor de producción es aquel donde se mantiene en funcionamiento su sitio web basado en Alaveteli para usuarios auténticos con datos reales. Es diferente de un servidor de desarrollo, que se utiliza para llevar a cabo modificaciones de entorno y personalización e intentar que todo funcione correctamente, así como de un servidor de pruebas, utilizado para probar y configurar el código ya finalizado antes de su publicación.

Su servidor de producción debe configurarse para funcionar de la forma más eficiente posible. Por ejemplo, con la memoria caché activada y la depuración desactivada. Rails cuenta con un «modo de producción», que se encarga de ello, solo debe asignar a STAGING_SITE el valor 0. Tenga en cuenta que si modifica esta opción después de la implementación, el archivo rails_env.rb, que permite el modo de producción de Rails, no se creará hasta que ejecute rails-post-deploy.

Si dispone de un servidor de pruebas, los entornos de sistema de sus servidores de pruebas y de producción deberían ser idénticos.

En ningún caso debería necesitar editar código directamente en su servidor de producción. Le recomendamos encarecidamente el uso del mecanismo de implementación de Alaveteli (mediante Capistrano) para efectuar cambios en su servidor de producción.

</dd>
publicar
Alaveteli trabaja mediante la publicación de las respuestas que recibe para las solicitudes de información pública enviadas por sus usuarios. Para ello procesa los correos electrónicos recibidos y los presenta como páginas (una por solicitud) en el sitio. Esto facilita que la gente encuentre, lea, enlace y comparta la solicitud y la información proporcionada como respuesta.
recaptcha
El mecanismo recaptcha permite detectar a usuarios no humanos, como robots automatizados, para evitar que envíen solicitudes de forma automática. Requiere que el usuario (humano) identifique un patrón de letras mostrado en una imagen, una tarea prácticamente imposible para los robots no humanos. Alaveteli utiliza esta herramienta para evitar recibir spam.

Más información:

editar (o edición)
Al editar se elimina u oculta parte de un mensaje para que no pueda leerse, se retira parte de un documento del sitio web.

Esta tarea puede ser necesaria por diversas razones. Por ejemplo, es posible que un usuario incluya por error información personal en su solicitud o que una autoridad la incluya en su respuesta. También es posible que necesite editar partes de solicitudes y respuestas que resulten difamatorias o puedan herir la sensibilidad.

Más información:

  • Consulte el manual de administrador para obtener más detalles sobre cómo y cuándo es posible que necesite editar información.
  • Puede llevar a cabo la edición exclusivamente de texto con las normas de censura de Alaveteli.
  • Algunos temas son más sencillos de editar que otros (en particular, los archivos PDF pueden contener firmas o imágenes difíciles de eliminar de forma parcial). El tal caso es posible que necesite eliminar el documento en su totalidad.
expresión regular
Una expresión regular es una forma concisa de describir un patrón o secuencia de caracteres, letras o palabras. Un administrador encontrará prácticas las expresiones regulares cuando necesite definir normas de censura. Por ejemplo, en lugar de editar solamente una frase específica, puede describir un conjunto completo de frases similares con una sola expresión regular.

Las expresiones regulares pueden resultar complejas, pero también potentes. Si no está familiarizado con su uso, es fácil cometer errores. ¡Úselas con precaución!

Más información:

  • Por ejemplo, la expresión regular Jo(e|ey|seph)\s+Blogg?s incluiría «Joe Bloggs», «Joey Bloggs» y «Joseph Bloggs», pero no «John Bloggs».
  • Consulte las expresiones regulares en wikibooks para obtener más información
actualización (o gestor de actualizaciones)
Publicamos nuevas actualizaciones de código para Alaveteli siempre que se añaden trabajos importantes (nuevas funcionalidades, mejoras, soluciones de errores, etc.) al código principal. Las actualizaciones se identifican con una etiqueta, que incluye dos o tres números: mayor, menor y, en caso necesario, el número de parche. Le recomendamos utilizar siempre la última versión. El proceso es supervisado por el gestor de actualizaciones de Alaveteli, encargado de decidir qué cambios deben incluirse en la actualización actual y la fecha límite del trabajo. Actualmente se trata del desarrollador principal de Alaveteli en mySociety.

Más información:

solicitud
En Alaveteli se denomina solicitud a la petición de información pública que un usuario envía y que el sitio manda por correo electrónico a la autoridad correspondiente. Alaveteli publica automáticamente las respuestas a todas las solicitudes enviadas.
respuesta
Se denomina respuesta al correo electrónico enviado por una autoridad como contestación a la solicitud de un usuario.
Ruby on Rails (también llamado «Rails»)
Alaveteli está escrito en el lenguaje de programación Ruby mediante la estructura de aplicación web «Ruby on Rails».

Más información:

Sass (para la generación de CSS)
Las hojas de estilo en cascada (CSS) de Alaveteli controlan la apariencia de las páginas y se definen utilizando Sass. Técnicamente se trata de una extensión del lenguaje CSS y lo utilizamos porque resulta más sencillo que el uso directo de CSS (por ejemplo, Sass permite realizar un solo cambio y que este se aplique a numerosos elementos ubicados en todo el sitio). Rails detecta los cambios realizados en cualquier archivo Sass y genera de nuevo automáticamente los archivos CSS utilizados por el sitio.

Más información:

servidor de pruebas
Un servidor de pruebas se utiliza para probar el código o la configuración antes de publicar el sitio. Es diferente de un servidor de desarrollo, donde se modifican el código y las opciones para conseguir que todo funcione, así como de un servidor de producción, que es el lugar visitado por los usuarios donde se hallan los datos reales.

En el servidor de pruebas debe asignar a STAGING_SITE el valor 1.

Si dispone de un servidor de pruebas, los entornos de sistema de sus servidores de pruebas y de producción deberían ser idénticos.

En ningún caso debería necesitar editar código directamente en sus servidores de producción y de pruebas. Le recomendamos encarecidamente el uso del mecanismo de implementación de Alaveteli (mediante Capistrano) para efectuar cambios en ellos.

estado
Cada solicitud pasa por distintos estados a medida que progresa a través del sistema. Los estados ayudan a los administradores de Alaveteli, así como al público, a comprender la situación actual respecto a cualquier solicitud y a saber qué acción se requiere en cada momento.

Los estados disponibles pueden personalizarse dentro del tema de su sitio.

Más información:

tema
Se denomina tema al conjunto de modificaciones realizadas en las plantillas y en el código que proporcionan al sitio un aspecto o un comportamiento distintos al predeterminado. Normalmente necesitará un tema para que Alaveteli muestre su propia marca.

Más información:

</dl>