feat: add Docker infrastructure, migrations, CI/CD client, session cleanup, tests

Docker & Deployment:
- Add Dockerfile (multi-stage, alpine, non-root)
- Add docker-compose.yml (caddy, backend, postgres, watchtower)
- Add Caddyfile (TLS, file_server, reverse proxy)
- Add .env.example

Database:
- Add migrations/001_init.sql (all tables + indexes)

CI/CD:
- Add cmd/ci-release/main.go (launcher binary upload tool)

Session management:
- Add internal/session/cleanup.go (background expired session cleanup)
- Integrate cleanup worker into main.go

Bug fixes:
- Fix launcherLatest download URL to include version segment
- Fix serveLauncherAsset path to match route pattern
- Add Content-Type detection from file extension in CAS serveFile
- Add empty-field validation in webLogin
- Format string fix in ci-release (%d → %s for resp.Status)

Tests:
- Add internal/auth/auth_test.go (8 tests)
- Add internal/cas/cas_test.go (7 tests)
- Add internal/session/cleanup_test.go (1 test)
- Add internal/api/api_test.go (5 tests)
- All tests passing, go vet clean

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
2026-05-29 20:09:00 +03:00
parent 81c42e1a9a
commit 5fba2e78d5
14 changed files with 986 additions and 4 deletions

View File

@@ -18,6 +18,33 @@ import (
"gitea.mrixs.me/Mrixs/MrixsCraft-server/internal/database"
)
// mimeByExtension maps common file extensions to MIME types for CAS serving.
var mimeByExtension = map[string]string{
".jar": "application/java-archive",
".json": "application/json",
".png": "image/png",
".zip": "application/zip",
".toml": "application/toml",
".cfg": "text/plain",
".conf": "text/plain",
".txt": "text/plain",
".log": "text/plain",
".xml": "application/xml",
".yml": "application/x-yaml",
".yaml": "application/x-yaml",
".properties": "text/plain",
}
// detectContentType returns a MIME type based on the file's extension.
// Falls back to application/octet-stream for unknown types.
func detectContentType(fileName string) string {
ext := strings.ToLower(filepath.Ext(fileName))
if mime, ok := mimeByExtension[ext]; ok {
return mime
}
return "application/octet-stream"
}
// Handler serves CAS endpoints.
type Handler struct {
db *database.DB
@@ -34,12 +61,13 @@ func (h *Handler) RegisterRoutes(mux *http.ServeMux) {
// Public file serving — immutable, long cache.
mux.HandleFunc("GET /files/{hash}", h.serveFile)
// Launcher binary downloads — also served from CAS-like paths.
// Launcher binary downloads — served from /files/launcher/{version}/{os}/{arch}/{filename}.
mux.HandleFunc("GET /files/launcher/{version}/{os}/{arch}/{filename}", h.serveLauncherAsset)
}
// serveFile serves a file from CAS by its SHA-1 hash.
// Files are immutable, so we set Cache-Control: public, max-age=31536000 (1 year).
// Content-Type is detected from the original file name stored in global_files.
func (h *Handler) serveFile(w http.ResponseWriter, r *http.Request) {
hash := r.PathValue("hash")
if !isValidHash(hash) {
@@ -54,6 +82,16 @@ func (h *Handler) serveFile(w http.ResponseWriter, r *http.Request) {
return
}
// Look up the original file name for Content-Type detection.
var fileName string
err = h.db.Pool().QueryRow(r.Context(),
`SELECT file_name FROM global_files WHERE sha1 = $1`, hash,
).Scan(&fileName)
if err != nil {
fileName = hash // fallback: no extension info
}
w.Header().Set("Content-Type", detectContentType(fileName))
w.Header().Set("Cache-Control", "public, max-age=31536000, immutable")
w.Write(data)
}
@@ -89,6 +127,7 @@ func (h *Handler) serveLauncherAsset(w http.ResponseWriter, r *http.Request) {
return
}
w.Header().Set("Content-Type", detectContentType(filename))
w.Header().Set("Cache-Control", "public, max-age=31536000, immutable")
w.Write(data)
}

131
internal/cas/cas_test.go Normal file
View File

@@ -0,0 +1,131 @@
package cas
import (
"os"
"path/filepath"
"testing"
)
func TestIsValidHash(t *testing.T) {
tests := []struct {
hash string
want bool
}{
{"a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2", true},
{"0000000000000000000000000000000000000000", true},
{"ffffffffffffffffffffffffffffffffffffffff", true},
{"A1B2C3D4E5F6A1B2C3D4E5F6A1B2C3D4E5F6A1B2", false}, // uppercase
{"g1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2", false}, // non-hex
{"a1b2c3d4e5f6", false}, // too short
{"", false}, // empty
{"a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3", false}, // too long (41)
}
for _, tt := range tests {
got := isValidHash(tt.hash)
if got != tt.want {
t.Errorf("isValidHash(%q) = %v, want %v", tt.hash, got, tt.want)
}
}
}
func TestStoreFile(t *testing.T) {
dir := t.TempDir()
data := []byte("hello minecraft world")
hash, err := StoreFile(dir, data)
if err != nil {
t.Fatalf("StoreFile failed: %v", err)
}
if len(hash) != 40 {
t.Errorf("expected 40-char hash, got %d", len(hash))
}
// File should exist at dir/<prefix>/<hash>.
path := filepath.Join(dir, hash[:2], hash)
info, err := os.Stat(path)
if err != nil {
t.Fatalf("stored file not found: %v", err)
}
if info.Size() != int64(len(data)) {
t.Errorf("stored file size = %d, want %d", info.Size(), len(data))
}
}
func TestStoreFile_Duplicate(t *testing.T) {
dir := t.TempDir()
data := []byte("same content")
h1, err := StoreFile(dir, data)
if err != nil {
t.Fatalf("first StoreFile failed: %v", err)
}
h2, err := StoreFile(dir, data)
if err != nil {
t.Fatalf("second StoreFile failed: %v", err)
}
if h1 != h2 {
t.Errorf("same data produced different hashes: %s vs %s", h1, h2)
}
}
func TestFileExists(t *testing.T) {
dir := t.TempDir()
data := []byte("test data")
hash, _ := StoreFile(dir, data)
if !FileExists(dir, hash) {
t.Error("FileExists returned false for stored file")
}
if FileExists(dir, "0000000000000000000000000000000000000000") {
t.Error("FileExists returned true for non-existent file")
}
}
func TestVerifyAndStore(t *testing.T) {
dir := t.TempDir()
data := []byte("verify me")
hash, _ := StoreFile(dir, data)
// Correct hash → should succeed (idempotent).
got, err := VerifyAndStore(dir, data, hash)
if err != nil {
t.Errorf("VerifyAndStore with correct hash failed: %v", err)
}
if got != hash {
t.Errorf("hash mismatch: got %s, want %s", got, hash)
}
// Wrong hash → should fail.
_, err = VerifyAndStore(dir, data, "0000000000000000000000000000000000000000")
if err == nil {
t.Error("VerifyAndStore with wrong hash should have failed")
}
}
func TestDetectContentType(t *testing.T) {
tests := []struct {
fileName string
want string
}{
{"mod.jar", "application/java-archive"},
{"config.json", "application/json"},
{"skin.png", "image/png"},
{"pack.zip", "application/zip"},
{"options.toml", "application/toml"},
{"server.cfg", "text/plain"},
{"notes.txt", "text/plain"},
{"data.xml", "application/xml"},
{"config.yml", "application/x-yaml"},
{"config.yaml", "application/x-yaml"},
{"game.properties", "text/plain"},
{"unknown.dat", "application/octet-stream"},
{"noext", "application/octet-stream"},
{"UPPER.JAR", "application/java-archive"},
}
for _, tt := range tests {
got := detectContentType(tt.fileName)
if got != tt.want {
t.Errorf("detectContentType(%q) = %q, want %q", tt.fileName, got, tt.want)
}
}
}