feat(gitea): adopt go-gitea/gitea as Railyard's code hosting (apps/gitea)

Replaces the from-scratch "Rithub + Rit" build (Dec 21/28 roadmap milestone)
with the official gitea/gitea image (MIT) + Postgres, per
plans/OSS-ADOPTION-2026-10-15.md's Railyard row 1. Closes the named gap
(packages, LFS, wikis, Actions CI) in one compose file instead of a
multi-week Rust build.

- apps/gitea/docker-compose.yml: gitea/gitea:1.23 + postgres:17, app.ini
  entirely via GITEA__<SECTION>__<KEY> env (no app.ini committed). Documents
  three gotchas found proving this locally: the Docker image's CustomPath is
  /data/gitea itself (not /data/gitea/custom); root-level keys like APP_NAME
  need the GITEA____KEY (empty section) form; START_SSH_SERVER=true fights
  the base image's passthrough OpenSSH for :22 and crash-loops.
- apps/gitea/custom/: Rithub branding overlay (logo, favicon, brand CSS,
  header/footer template injection with MIT attribution to Gitea) — pure
  overlay, no upstream template edited.
- apps/gitea/integrations/railyard/: Rago/Mint billing bridge adapted from
  apps/rithub-forge's (uncommitted, untouched) Forgejo experiment — it
  already accepted Gitea's X-Gitea-* webhook headers as a fallback, now
  promoted to primary. 16 new unit tests, all passing.
- apps/gitea/deploy/RUNBOOK.md: first production deploy on railyard-box
  (Oracle A1 ARM64) — Cloudflare Tunnel for HTTPS, SSH on :2222 via the VCN
  security list, gitea dump/restore backups, rollback. Not executed.
- apps/gitea/README.md: full inventory of what existed (apps/rit, apps/rithub
  — Rust, kept) vs. what Gitea covers vs. what's deployed, plus the local
  proof log (HTTPS push, SSH push, LFS, npm package registry, wiki — all
  verified working against the official arm64 image on this machine).
- apps/rit/README.md, apps/rithub/README.md: pointer notes to this decision.
  Neither directory is deleted or modified beyond the note (owner rule).

Local proof only — compose stack torn down after screenshots, nothing
deployed, nothing pushed to origin.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
caelum0x 2026-10-14 03:11:39 +03:00
parent d8ac6772f8
commit 4e27decb79

View File

@ -1,5 +1,12 @@
# rit — rust git
> **2026-10-15 note:** Railyard's production code-hosting decision for the
> Dec 21/28 roadmap milestone ("Rithub + Rit") is **`apps/gitea`**
> (go-gitea/gitea, MIT) — see `apps/gitea/README.md`'s inventory table for the
> full reasoning. This code is **kept, not deleted** (owner rule), and remains
> available if `rithub`'s Rago/Mint-native billing model is worth finishing
> independently later. It is not currently the dependency of a deployed forge.
A **library-first** Rust implementation of Git's local object/authoring model.
rit owns its safety-critical loose-object, index, tree, commit, and ref-transaction
paths while adopting audited open-source crates for expensive commodity layers.