ci: imagem construída do código, esteira para os runners do Gitea e changelog

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

README.en.md

@@ -35,7 +35,7 @@ A live demo is available at: **https://pss.lucasrguerra.dev.br/**
 
 ```bash
 # Clone the repository
-git clone https://github.com/lucasrguerra/pss.git
+git clone https://git.lucasrguerra.dev.br/lucasrguerra/pss.git
 cd pss
 
 # Install dependencies
@@ -57,9 +57,36 @@ npm run preview
 ### With Docker
 
 ```bash
-docker compose up
+docker compose up --build
 ```
 
+The `Dockerfile` builds Vite inside the image (Node 22) and serves the static files
+with nginx. There is no pre-built artifact in the repository.
+
+### Published image
+
+Every version is published to the Gitea container registry (linux/arm64):
+
+```bash
+docker run -p 8080:80 git.lucasrguerra.dev.br/lucasrguerra/pss:latest
+```
+
+Tags: `latest`, `X.Y.Z`, `X.Y` and `sha-<commit>`. The public instance runs at
+[pss.lucasrguerra.dev.br](https://pss.lucasrguerra.dev.br).
+
+### Continuous integration and releases
+
+- `.gitea/workflows/ci.yml`: types (`tsc -b`), tests, Trivy (dependencies and secrets),
+  image build, Trivy on the image and a smoke test (the SPA responds, falls back to the
+  index on internal routes and serves assets with immutable caching). Runs on branches
+  and every Monday.
+- `.gitea/workflows/release.yml`: on `main` and `vX.Y.Z` tags. If the registry already
+  has the image for the same content (`inputs-<hash>`), nothing is rebuilt: only the new
+  tags are applied. On a tag, it creates the Gitea release with the [CHANGELOG](CHANGELOG.md) notes.
+- To release: update the CHANGELOG, the version in `package.json` and the label in
+  `src/components/Layout/Sidebar.tsx`, commit, and push the tag
+  (`git tag vX.Y.Z && git push gitea vX.Y.Z`).
+
 ---
 
 ## 🎮 How to use
@@ -229,4 +256,4 @@ Contributions are welcome! Please read our [CONTRIBUTING.md](./CONTRIBUTING.md)
 
 ## 📜 License
 
-Distributed under the [MIT License](./LICENSE). Developed by [Lucas Rayan Guerra](https://github.com/lucasrguerra).
+Distributed under the [MIT License](./LICENSE). Developed by [Lucas Rayan Guerra](https://git.lucasrguerra.dev.br/lucasrguerra).