Skip to content

docs: privacidad, seguridad y troubleshooting (TRUST-001) - #21

Merged
ChristianM023 merged 5 commits into
mainfrom
docs/trust-001-privacy-security
Aug 23, 2026
Merged

ChristianM023 merged 5 commits into
mainfrom
docs/trust-001-privacy-security

Conversation

@ChristianM023

Copy link
Copy Markdown
Owner

TRUST-001 — Documentar privacidad, seguridad y troubleshooting

Documenta privacidad, seguridad y troubleshooting para reforzar la confianza del usuario que llega por primera vez.

Cambios

  • Privacy + Security separadas (EN+ES) — la sección única Privacy/Privacidad de los README se dividió en dos: Privacy (datos: sin red, sin telemetría, sin persistencia del cuerpo, solo metadatos en memoria, app_meta en state.json) + Security (protecciones: eavesdrop=true explicado, sin secretos, O_NOFOLLOW, modo 0600).
  • Diagrama del flujo de datos (EN+ES) — diagrama ASCII del camino de una notificación (bus → dbus-monitor → parser → player) en How it works/Cómo funciona.
  • Troubleshooting ampliado (EN+ES) — 4 bullets nuevos: dependencias Fedora (dnf), Arch (pacman + AUR planeado), canberra-gtk-play por distro (dnf provides / pacman -Fy), dbus-monitor. Nombres de paquetes verificados contra repositorios oficiales.
  • Sección de privacidad en la landing (EN+ES) — nueva sección 10 Privacy/Privacidad en site/index.html y site/es/index.html, con enlace al README. Support the project renumerado a 11.

Verificación

  • scripts/quality.sh — py_compile 6/6 OK.
  • scripts/test-all.sh — 89 tests OK.
  • Cada subtarea auditada con verifier: OK.
  • session-review: OK.
  • DoD del ticket: grep -in 'privacidad\|privacy' README.md README.es.md encuentra las secciones.

Criterio de aceptación del ticket

  • Sección de privacidad: sin red, sin persistencia del cuerpo, solo metadatos en memoria.
  • Sección de seguridad: eavesdrop=true explicado, sin secretos, O_NOFOLLOW, 0600.
  • Flujo de datos diagramado (bus → dbus-monitor → parser → player).
  • Troubleshooting ampliado con casos de AUR/Fedora/Arch.

Closes TRUST-001.

Reemplaza la sección única Privacy por dos secciones consecutivas:
Privacy (datos: sin red, sin telemetría, sin persistencia del cuerpo,
solo metadatos en memoria) y Security (protecciones: eavesdrop=true
explicado, sin secretos, O_NOFOLLOW, modo 0600). Espejo fiel EN/ES.

Parte de TRUST-001.
Diagrama ASCII del camino de una notificación: bus → dbus-monitor
(eavesdrop) → parser → resolución del nombre de app → reglas de
reproducción → reproductor (canberra + fallback). Refuerza privacidad
(solo metadatos, nunca el cuerpo). Espejo fiel EN/ES.

Parte de TRUST-001.
Añade bullets de dependencias para Fedora (dnf) y Arch (pacman) con
nombres de paquetes verificados contra los repositorios oficiales,
busqueda de canberra-gtk-play por distro (dnf provides / pacman -F) y
dbus-monitor. Mencion del AUR planeado. Espejo fiel EN/ES.

Parte de TRUST-001.
Nueva sección 10 Privacy/Privacidad en site/index.html y
site/es/index.html: sin red, sin telemetría, sin persistencia del
cuerpo, solo metadatos en memoria, state.json con O_NOFOLLOW y 0600.
Enlace al README para detalles. Support the project renumerado a 11.

Parte de TRUST-001.
pacman -F consulta la files database, que se descarga con pacman -Fy.
Sin sincronizacion previa puede devolver 'no results' aunque el
paquete exista. pacman -Fy sincroniza y busca en un solo comando.

Correccion factual sobre TRUST-001.
@ChristianM023
ChristianM023 merged commit ae350dd into main Aug 23, 2026
1 check passed
@ChristianM023
ChristianM023 deleted the docs/trust-001-privacy-security branch August 23, 2026 15:49
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant