Read-only mirrors. Development, issues and pull requests are on GitHub.

summaryrefslogtreecommitdiffhomepage
path: root/Documents
diff options
context:
space:
mode:
authorLeitwolf112026-09-28 01:10:53 +0300
committerLeitwolf112026-09-28 01:10:53 +0300
commit252ca8eae71faf1e4e4d00dc7a0489998df12f04 (patch)
treea84a3b6bfe6ab817bc8f433b94a100c2e3f477a9 /Documents
parentb38ddd55913442da31b6277724a391af2bcc77bc (diff)
downloadwebsite-252ca8eae71faf1e4e4d00dc7a0489998df12f04.tar.gz
Pin website dependencies and isolate Codecov credentials
Diffstat (limited to 'Documents')
-rw-r--r--Documents/OPERATIONS.md19
1 files changed, 17 insertions, 2 deletions
diff --git a/Documents/OPERATIONS.md b/Documents/OPERATIONS.md
index 830e8a8..96baa57 100644
--- a/Documents/OPERATIONS.md
+++ b/Documents/OPERATIONS.md
@@ -21,8 +21,10 @@ compatibility, but it does not make package functions part of this website.
Do not use a catch-all `/api/` proxy for this service. The production Nginx
configuration proxies exactly `/api/v1/site`; other `/api/` paths return 404.
-The Spring process listens only on `127.0.0.1:5080`. Its `/health` endpoint is
-for local process checks, not an advertised public route.
+The Spring process binds only to `127.0.0.1`. Local runs default to port 5080;
+the checked-in systemd unit sets `PORT=5086`, matching the future Nginx proxy.
+Its `/health` endpoint is for local process checks, not an advertised public
+route.
## Local gates
@@ -42,6 +44,19 @@ Run the backend gates from `backend/` with Temurin JDK 25:
gradle test bootJar --no-daemon
```
+The backend checks in Gradle dependency locks and SHA-256 verification metadata
+to keep transitive versions and downloaded artifacts stable. When intentionally
+updating dependencies, run these commands from `backend/`, review both generated
+files, then rerun the ordinary backend gates:
+
+```text
+gradle dependencies --write-locks --no-daemon
+gradle test jacocoTestReport bootJar --write-verification-metadata sha256 --no-daemon
+```
+
+Do not accept a checksum-only change without confirming the artifact version
+and source repository; the checksum is an integrity pin, not a trust review.
+
The frontend tests assert canonical metadata, sitemap membership, asset shape,
forum non-indexing, and the absence of retired site links. The Spring tests
assert site-only API behavior, health, read-only operation, and missing account