ereuse/docs
9
0
Fork 0
Code Issues 2 Pull requests Packages Projects Releases Wiki Activity

diverse updates

Browse source
This commit is contained in:
leandro@ac.upc.edu 2025-02-28 17:29:28 +01:00
parent 660c8fe086
commit ce6873f833
7 changed files with 55 additions and 20 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

1
help/docs/ca/index.md Normal file
View file

@ -0,0 +1 @@
Pendent. Mentrestant visitar [ajuda en castellà](../es/index.md).

1
help/docs/en/index.md Normal file
View file

@ -0,0 +1 @@
Pending. In the meanwhile please visit [help in Spanish](../es/index.md).

4
help/docs/es/acerca.md
View file

@ -5,7 +5,7 @@ title: Acerca de DeviceHub
# Acerca de Nosotros
Bienvenido a DeviceHub que, combinado con workbench y otras herramientas, ofrece gestión de inventario de dispositivos para el sector social y solidario. Creado por el esfuerzo colaborativo de la iniciativa eReuse.org, entre ellos Pangea.org y UPC.EDU.
Bienvenido a DeviceHub que, combinado con workbench y otras herramientas, ofrece gestión de inventario de dispositivos para el sector social y solidario. Creado por el esfuerzo colaborativo de la iniciativa y los miembros de eReuse.org, entre ellos Pangea.org y UPC.EDU.
## Nuestra visión
@ -27,7 +27,7 @@ Motivamos e impulsamos la aparición de comunidades regionales locales abiertas
Los [miembros](https://www.ereuse.org/es/members/) de eReuse son principalmente organizaciones de la economía social que reacondicionan, reciclan y distribuyen dispositivos de segunda mano como portátiles u ordenadores de sobremesa o móviles.
Nuestros [socios](https://www.ereuse.org/es/partners/) son organizaciones que promueven el residuo cero, la economía circular y social, la electrónica justa, el derecho a la reparación y reducción de la brecha digital. En las ciudades, miembros y ayuntamientos colaboran y se coordinan en [circuitos](https://www.ereuse.org/es/circuits/) de reutilización con gran efecto en la creación de puestos de trabajo inclusivos, al iniciar o acelerar la eficiencia y en la ampliación del intercambio/mercado local de dispositivos de segunda mano.
Nuestros [socios](https://www.ereuse.org/es/partners/) son organizaciones que promueven el residuo cero, la economía circular y social, la electrónica justa, el derecho a la reparación y reducción de la brecha digital. En las ciudades, miembros y ayuntamientos colaboran y se coordinan en [circuitos](https://www.ereuse.org/es/circuits/), ecosistemas de reutilización con efecto en la creación de puestos de trabajo inclusivos, al iniciar o acelerar la eficiencia y ampliar el intercambio y mercado local de dispositivos de segunda mano.
La iniciativa eReuse.org comenzó en 2015 con el apoyo inicial de [Pangea.org](https://pangea.org/), una organización privada e independiente sin ánimo de lucro fundada en 1993 para promover el uso estratégico y ambiental de las TIC.

2
help/docs/es/admin.md
View file

@ -5,5 +5,5 @@ Este es el menú de administración después de iniciar sesión:
![Título de la imagen](../img/admin-menu.png){ align=left }
* Aceptar la política de privacidad del servicio de inventario = tus datos son tuyos.
* Usuarios/operadores: registrar y gestionar aquellos que pueden registrar y gesetionar dispositivos en nombre de tu organización. Los usuarios recibirán una invitación para entrar en deviceHub y obtener los datos para configurar su instancia de [workbench](workbench.md)
* Usuarios/operadores: registrar y gestionar aquellos que pueden registrar y gestionar dispositivos en nombre de la organización que soy administrador. Los usuarios recibirán una invitación por correo electrónico para entrar en deviceHub y obtener los datos para configurar su instancia de [workbench](workbench.md)
* Vincular la gestión de identidad a una instancia de IdHub.

18
help/docs/es/index.md
View file

@ -13,12 +13,18 @@
## [Para usuarios operadores](usuario.md)
* Ingresa en tu cuenta
* Sube datos (evidencias) de dispositivos:
* Desde el mismo dispositivo, con la herramienta [workbench](workbench.md)
* Desde el botón "+" para añadir
* uno con un formulario
* Dispositivos: que se han detectado a partir de evidencias. Un dispositivo puede tener asociadas varias evidencias. Se agrupan según un algoritmo (criterio) para asociarlas a un mismo dispositivo a pesar de algunos cambios de hardware durante su vida útil.
* Evidencias:
* Ver evidencias recogidas desde cada dispositivo, generadas ejecutando la herramienta [workbench](workbench.md). Llegan a la "Bandeja de Entrada".
* Añadir evidencias (datos) de dispositivos:
* uno, con un formulario web.
* uno, subiendo un archivo .json generado por workbench en ese dispositivo.
* varios, con una hoja de cálculo.
* Evidencias: mira las evidencias recogidas
* Lotes: organiza dispositivos por grupos
* Lotes: Permite organizar dispositivos por lotes (conjuntos).
* Se pueden crear varios, tantos como haga falta para organizar entregas y donacionaciones de dispositivos (B2B), asignación a usuarios finales (B2C) u otros procesos.
* Se pueden mover de la "Bandeja de Entrada" o entre diferentes lotes.
* Como corresponde a dispositivos físicos, uno no puede estar en dos lotes. Borrar un lote desasignar los dispositivos que incluía.
## [Acerca de nosotros](acerca.md)

27
help/docs/es/usuario.md
View file

@ -14,7 +14,6 @@ La primera vez tienes que aceptar las condiciones de privacidad. En resumen: tus
* Dispositivos
* Lotes
* Evidencias
* Añadir dispositivos
# Mis datos
@ -22,21 +21,27 @@ Aquí puedes consultar la información que tu organización guarda sobre ti. _(n
# Dispositivos
Aquí puedes ver detalles de los dispositivos que tienes asociados a tí o a tu organización. Estos han entrado en deviceHub:
Aquí puedes ver detalles de los dispositivos que tienes asociados a tí o a tu organización.
Un dispositivo puede tener asociadas varias evidencias. Se agrupan según un algoritmo (criterio) para asociarlas a un mismo dispositivo a pesar de algunos cambios de hardware durante su vida útil.
* desde el propio dispositivo con tu herramienta [workbench](workbench.md)
* desde el botón para añadir dispositivo, en un formulario, o varios, en una hoja de cálculo.
Estos han entrado en deviceHub:
* Desde el propio dispositivo con tu herramienta [workbench](workbench.md)
* Desde la sección para añadir evidencias de dispositivos.
# Lotes
Permite organizar dispositivos por conjuntos
Permite organizar dispositivos por lotes (conjuntos).
* Se pueden crear varios, tantos como haga falta para organizar entregas y donacionaciones de dispositivos (B2B), asignación a usuarios finales (B2C) u otros procesos.
* Se pueden mover de la "Bandeja de Entrada" o entre diferentes lotes.
* Como corresponde a dispositivos físicos, uno no puede estar en dos lotes. Borrar un lote desasignar los dispositivos que incluía.
# Evidencias
Permite ver las evidencias recogidas acerca de dispositivos
* Ver evidencias recopiladas acerca de dispositivos, aportadas por diferentes métodos:
* Recibidas en la ejecución de la herramienta [workbench](workbench.md) en un dispositivo. Llegan a la "Bandeja de Entrada".
* Añadidas en esta web.
# Añadir dispositivos
* Sube datos de dispositivos:
* con un formulario para añadir uno
* con una hoja de cálculo, para añadir varios
* Añadir evidencias (datos) de dispositivos:
* Uno, con un formulario web.
* Uno, subiendo un archivo .json generado por workbench en ese dispositivo.
* Varios, con una hoja de cálculo.

22
help/docs/es/workbench.md
View file

@ -10,4 +10,26 @@ Los PC pueden botar por USB, insertando en el PC una memoria con la imagen de wo
Los datos de PCs se pueden recoger en un USB y subir después o enviarse directamente a un inventario DeviceHub. Los datos pueden incorporar trazabilidad con una firma gestionada por el servicio de identidad IdHub.
## Preparación
Preparar un disco de arranque para iniciar dispositivos con arranque por USB o red que incluye workbench.
En un dispositivo ya arrancado con Linux Debian, instalar 'workbench-script', configurar preferencias 'settings.ini', ejecutar 'workbench-script'. Puede dejar las evidencias (snapshots) en una carpeta local o enviarlas por red a la instancia de deviceHub seleccionada en settings.ini.
Para enviar las evidencias directamente a una instancia de deviceHub, hay que conocer el URL del servicio y el testimonio de autenticación (token). Este URL y token se puede obtener de ...
# Ejecución
Una de las siguientes:
* Reiniciar un dispositivo por USB o red desde una imagen (ISO) que incluyen workbench.
* Iniciar un dispositivo con Debian Linux, instalar y ejecutar workbench.
* Si las evidencias se guardan en el USB o en una carpeta remota compartida (NFS), estas se han de subir en una instancia de DeviceHub.
* Si se envían las evidencias se envían por red el proceso ha acabado.
Cada evidencia puede generar un código QR en la pantalla y al escaneario envía a un URL de la evidencia ya subida a una instancia de deviceHub.
Más detalles en el repositorio de [workbench-script](https://github.com/eReuse/workbench-script/blob/main/README-es.md)