Interface reescrita (design próprio, tema claro/escuro, a11y WCAG 2.2 AA), seções do site e artigo IDEIA @ CSBC 2025. Tradutor portado para JS com paridade 100% contra o Python; sem Tailwind nem axios. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
5.3 KiB
Changelog
Everything notable in InBraille is recorded here. The format follows Keep a Changelog and the project follows Semantic Versioning.
Note on history. The original Git history and the project files that are not part of the container image were lost with the previous GitHub account. This repository was rebuilt on 2026-11-02 from the production image
1.3.1(the exact deployed code insrc/,public/,index.htmlandmain.py) and from the records of the work sessions that created the tests, the Dockerfile, the CI and the documentation. Entries for 1.2.0 and 1.3.0 left no record and are described only by what the code shows.
Unreleased
[1.4.0] - 2026-11-15
Added
- New website around the converter: hero with a tactile Braille plate, "How it works", 3D printing specs and tips, privacy, the peer-reviewed paper (IDEIA @ CSBC 2025, DOI 10.5753/ideia.2025.9057) with copyable BibTeX and ABNT citations, credits and FAQ.
- Light/dark theme (follows the system, toggle persisted), mobile navigation menu, keyboard shortcuts (Ctrl/Cmd+Enter converts; arrow keys move between tabs; Esc closes menus), toasts and screen-reader announcements for conversion and STL generation.
- Text↔Braille translation now runs in the browser (
public/modules/translator.js, a port ofsrc/translationandsrc/domain, Chinese pinyin data loaded on demand). A parity script (scripts/paridade-tradutor.mjs) checks it against the Python translator: 337,176 cases, 0 differences.
Changed
- Interface rewritten from scratch: Tailwind CDN and axios removed, own design system
(Atkinson Hyperlegible, embossed-dot motif), WCAG 2.2 AA focus, contrast, targets, reduced
motion and forced colors. All rewritten copy in Portuguese, English and Chinese, plus new
title, description, Open Graph and JSON-LD (including the
ScholarlyArticle). - Nothing the user types leaves the browser: conversion, STL generation and preview are local.
The
/api/*routes stay available for existing integrations.
1.3.3 - 2026-11-02
Changed
- The image now ships
curl, so the Coolify healthcheck (which runscurlinside the container) works; it is enabled on/. The imageHEALTHCHECKstill uses Python. - The
org.opencontainers.image.versionlabel comes from the first numbered CHANGELOG entry instead of the branch name (it saidmainon the 1.3.2 image).
1.3.2 - 2026-11-02
Changed
- The code, the container image and the releases now live on Gitea (
git.lucasrguerra.dev.br); the deployment pulls the image from its registry instead of GitHub Container Registry. - CI moved from GitHub Actions to the Gitea runners (
.gitea/workflows): Trivy on the repository and on the image, the pytest suite in a Dockerfileteststage, an arm64 image build and a smoke test that exercises the pages, the SEO files, the API (including a real STL generation) and the production isolation (--read-only, no capabilities, non-root). The image is built once per content hash and reused by the release. - Dockerfile split into
base,testandruntimestages; the runtime image is unchanged (Python 3.14, non-root user 10001, read-only friendly). SECURITY.md: vulnerabilities are reported by e-mail instead of GitHub Security Advisories..gitattributesforces LF line endings.
Security
pillow12.3.0 → 13.0.0, which clears 28 advisories (5 critical, 23 high) reported by Trivy on the pinned requirements. Pillow is pulled in bymatplotlib(a VTK dependency);pip checkis clean.
Fixed
/robots.txtand/sitemap.xmlreturned 500 in production since the image never contained those files (the Dockerfile did not copy them). Both files are now part of the repository and the image, with thehreflangalternates forpt-BR,enandzh.
1.3.1
- Fixed returning visitors running stale frontend code after a deploy: HTML and
/publicassets are now served withCache-Control: no-cacheso browsers revalidate them. - Release workflow now also pins
INBRAILLE_VERSIONfor the Coolify preview environment, which was stuck on 1.1.0.
[1.3.0] and [1.2.0]
No changelog was kept for these releases, so nothing is claimed here beyond what survived: the
sources of the live plate preview (public/preview.js) and of the browser-side STL generator
(public/modules/client_stl_generator.js) are part of the deployed code.
1.1.0
- STL generation now goes through a bounded FIFO queue instead of rejecting requests when busy.
1.0.0
- First tagged release, published as a Docker image on GitHub Container Registry.
- Security hardening of the API and the container (see SECURITY.md).
- Dependencies upgraded; all Trivy findings (critical, high and medium) resolved.