Scoreboard/server/internal/httpapi/network_test.go

package httpapi_test

import (
	"encoding/json"
	"net"
	"net/http"
	"strings"
	"testing"

	"git.yeij.top/AskaEth/Scoreboard/server/internal/config"
	"git.yeij.top/AskaEth/Scoreboard/server/internal/httpapi"
)

// GET /api/system/network 是给大屏控制页拼「平板能直接打开的链接」用的：
// recorder 起可读，guest 与未登录一律 403（与 /api/system/about 同档——机器级信息不给匿名访客）。
func TestSystemNetworkPermission(t *testing.T) {
	env := newTestEnvWith(t, func(o *httpapi.Options) { o.Port = 18080 })

	guest, _ := env.client()
	if status, env2 := env.do(guest, http.MethodGet, "/api/system/network", nil, false); status != http.StatusForbidden ||
		env2.Error == nil || env2.Error.Code != "FORBIDDEN" {
		t.Fatalf("guest 读 network 应 403 FORBIDDEN，得到 %d %+v", status, env2.Error)
	}

	env.createUser("recorder", "recorder-pass", "recorder")
	client, _ := env.client()
	env.login(client, "recorder", "recorder-pass")
	status, env2 := env.do(client, http.MethodGet, "/api/system/network", nil, false)
	if status != http.StatusOK || !env2.OK {
		t.Fatalf("recorder 读 network 应 200，得到 %d %+v", status, env2.Error)
	}
}

// 响应形状是对前端契约：字段一个不多一个不少，port 必须是实际监听端口（测试注入 18080），
// 路径字段则要与服务端真的托管着的页面一致——前端是照它拼链接的，写错了就是死链。
func TestSystemNetworkShape(t *testing.T) {
	env := newTestEnvWith(t, func(o *httpapi.Options) { o.Port = 18080 })
	env.createUser("recorder", "recorder-pass", "recorder")
	client, _ := env.client()
	env.login(client, "recorder", "recorder-pass")

	status, env2 := env.do(client, http.MethodGet, "/api/system/network", nil, false)
	if status != http.StatusOK {
		t.Fatalf("读 network 应 200，得到 %d", status)
	}
	var body map[string]any
	if err := json.Unmarshal(env2.Data, &body); err != nil {
		t.Fatalf("解析 network: %v (%s)", err, env2.Data)
	}
	assertKeys(t, "network", body, []string{"port", "displayPath", "adminPath", "addresses", "skipped"})

	if got, ok := body["port"].(float64); !ok || int(got) != 18080 {
		t.Fatalf("port 应回注入的实际监听端口 18080，得到 %#v", body["port"])
	}
	if body["displayPath"] != "/display" || body["adminPath"] != "/admin" {
		t.Fatalf("路径字段不符: displayPath=%#v adminPath=%#v", body["displayPath"], body["adminPath"])
	}

	// 路径字段指向的页面必须真的存在：改了前端产物名就会在这里红灯，而不是等到现场打开是 404。
	for _, path := range []string{body["displayPath"].(string), body["adminPath"].(string)} {
		code, raw := env.doRaw(client, http.MethodGet, path, nil, "", false)
		if code != http.StatusOK || !strings.Contains(string(raw), "<html") {
			t.Fatalf("路径 %s 应返回页面，得到 %d %.80s", path, code, raw)
		}
	}

	// addresses 必须是数组（没有地址时是 [] 而不是 null），
	// 每条都带 ip/interface/family/confidence/scope 且是 IPv4。
	raw, ok := body["addresses"].([]any)
	if !ok {
		t.Fatalf("addresses 应是数组，得到 %#v", body["addresses"])
	}
	for _, item := range raw {
		entry, ok := item.(map[string]any)
		if !ok {
			t.Fatalf("地址项应是对象，得到 %#v", item)
		}
		assertKeys(t, "addresses[]", entry, []string{"ip", "interface", "family", "confidence", "scope"})
		if entry["family"] != "ipv4" {
			t.Fatalf("family 应为 ipv4，得到 %#v", entry["family"])
		}
		if c, _ := entry["confidence"].(string); c != "high" && c != "low" && c != "route" {
			t.Fatalf("confidence 应是 high / low / route，得到 %#v", entry["confidence"])
		}
		if s, _ := entry["scope"].(string); s != "private" && s != "global" && s != "link-local" {
			t.Fatalf("scope 应是 private / global / link-local，得到 %#v", entry["scope"])
		}
		ip := net.ParseIP(entry["ip"].(string))
		if ip == nil || ip.To4() == nil {
			t.Fatalf("ip 应是 IPv4 文本，得到 %#v", entry["ip"])
		}
		// 回环 / 未指定 / 组播 / 广播是「拿得到、连不上」的地址，绝不能出现在给平板用的列表里。
		if ip.IsLoopback() || ip.IsUnspecified() || ip.IsMulticast() || ip.Equal(net.IPv4bcast) {
			t.Fatalf("不该出现回环 / 未指定 / 组播 / 广播地址: %#v", entry)
		}
		// 链路本地**是**候选（无 DHCP 的独立内网里它是唯一能用的地址），但必须如实标 scope。
		if ip.IsLinkLocalUnicast() && entry["scope"] != "link-local" {
			t.Fatalf("链路本地地址的 scope 应为 link-local，得到 %#v", entry["scope"])
		}
	}

	// skipped 也必须始终是数组（没有可解释的接口时是 [] 而不是 null），每条的 code 都在约定集合里。
	// 它只是给前端解释空态用的旁白，地址列表不受它影响。
	skipped, ok := body["skipped"].([]any)
	if !ok {
		t.Fatalf("skipped 应是数组，得到 %#v", body["skipped"])
	}
	// 集合里没有 link-local：链路本地现在是候选地址，不再是「被跳过」的理由。
	codes := map[string]bool{"no-address": true, "only-ipv6": true, "not-up": true, "loopback": true}
	for _, item := range skipped {
		entry, ok := item.(map[string]any)
		if !ok {
			t.Fatalf("skipped 项应是对象，得到 %#v", item)
		}
		assertKeys(t, "skipped[]", entry, []string{"interface", "code", "addresses"})
		if code, _ := entry["code"].(string); !codes[code] {
			t.Fatalf("skipped 的 code 不在约定集合里: %#v", entry["code"])
		}
		if _, ok := entry["addresses"].([]any); !ok {
			t.Fatalf("skipped 的 addresses 应是数组，得到 %#v", entry["addresses"])
		}
	}
}

// 调用方忘了注入 Port 时也要给出一个真端口（config 的默认端口），不能是 :0 —— 那会拼出
// 一条根本打不开的链接。默认值的唯一来源是 config 包，本用例直接对比它，防止两处漂移。
func TestSystemNetworkPortFallsBackToConfigDefault(t *testing.T) {
	env := newTestEnv(t)
	env.createUser("recorder", "recorder-pass", "recorder")
	client, _ := env.client()
	env.login(client, "recorder", "recorder-pass")

	_, env2 := env.do(client, http.MethodGet, "/api/system/network", nil, false)
	var body map[string]any
	if err := json.Unmarshal(env2.Data, &body); err != nil {
		t.Fatalf("解析 network: %v (%s)", err, env2.Data)
	}
	want := config.Default().Server.Port
	if got, ok := body["port"].(float64); !ok || int(got) != want {
		t.Fatalf("未注入端口时应回 config 默认端口 %d，得到 %#v", want, body["port"])
	}
}