Document scanner product roadmap and Gitea workflow

docs/GITEA_AUTH.md

@@ -1,4 +1,4 @@
-# Gitea authentication
+# Gitea Authentication
 
 Remote:
 
@@ -13,7 +13,8 @@ https://git.noveria.net/user/settings/applications
 ```
 
 Use the token as the HTTPS password when Git asks for credentials. Do not save
-tokens, passwords, or generated credentials in this repository.
+tokens, passwords, or generated credentials in this repository, in `.env`
+files, or in the remote URL.
 
 On Windows, this repository uses Git Credential Manager from the system Git
 config:
@@ -28,3 +29,24 @@ Credential Manager or let Git Credential Manager prompt again during:
 ```powershell
 git push origin main
 ```
+
+Recommended push check:
+
+```powershell
+git status --short --branch
+git remote -v
+git push origin main
+git status --short --branch
+```
+
+Expected clean result after a successful push:
+
+```text
+## main...origin/main
+```
+
+If Git reports `Failed to authenticate user`, do not change the remote to embed
+a token. Open the token page above, create or refresh a token with repository
+write access, clear the stale Windows credential for `git.noveria.net` if
+needed, and rerun the same push command so Git Credential Manager can store the
+new credential safely.