refactor(openflare): migrate console APIs to v1 and centralize routing

Move OpenFlare management endpoints to /api/v1/custom/openflare with
Wavelet response envelopes and Abort* error handling. Keep agent, relay,
and flared protocol routes on /api/* with the legacy compat format.

- Add apiutil helpers and Swagger annotations for console handlers
- Register all OpenFlare routes in internal/router/openflare (not apps)
- Switch frontend services to OpenFlareBaseService and v1 paths
- Remove dead auth/compat code and legacy-base.service.ts
- Update integration tests and changelog

Wavelet/internal/apps/openflare/integration/helpers_test.go

@@ -11,9 +11,29 @@ import (
 	"testing"
 
 	"github.com/Rain-kl/Wavelet/internal/apps/openflare/compat"
+	"github.com/Rain-kl/Wavelet/internal/common/response"
+	v1 "github.com/Rain-kl/Wavelet/internal/router/v1"
+	ofrouter "github.com/Rain-kl/Wavelet/internal/router/v1/openflare"
+	"github.com/gin-gonic/gin"
 	"github.com/stretchr/testify/require"
 )
 
+func decodeAPIResponse(t *testing.T, rec *httptest.ResponseRecorder) response.Any {
+	t.Helper()
+
+	var resp response.Any
+	require.NoError(t, json.Unmarshal(rec.Body.Bytes(), &resp))
+	return resp
+}
+
+func requireAPIOK(t *testing.T, rec *httptest.ResponseRecorder) response.Any {
+	t.Helper()
+
+	resp := decodeAPIResponse(t, rec)
+	require.Empty(t, resp.ErrorMsg, "unexpected API error: %s", resp.ErrorMsg)
+	return resp
+}
+
 func decodeEnvelope(t *testing.T, rec *httptest.ResponseRecorder) compat.Envelope {
 	t.Helper()
 
@@ -22,7 +42,7 @@ func decodeEnvelope(t *testing.T, rec *httptest.ResponseRecorder) compat.Envelop
 	return envelope
 }
 
-func unmarshalEnvelopeData(t *testing.T, data any, target any) {
+func unmarshalAPIData(t *testing.T, data any, target any) {
 	t.Helper()
 
 	payload, err := json.Marshal(data)
@@ -30,20 +50,47 @@ func unmarshalEnvelopeData(t *testing.T, data any, target any) {
 	require.NoError(t, json.Unmarshal(payload, target))
 }
 
-func unmarshalEnvelopeMap(t *testing.T, data any) map[string]any {
+func unmarshalEnvelopeData(t *testing.T, data any, target any) {
+	t.Helper()
+	unmarshalAPIData(t, data, target)
+}
+
+func unmarshalAPIMap(t *testing.T, data any) map[string]any {
 	t.Helper()
 
 	var result map[string]any
-	unmarshalEnvelopeData(t, data, &result)
+	unmarshalAPIData(t, data, &result)
+	return result
+}
+
+func unmarshalEnvelopeMap(t *testing.T, data any) map[string]any {
+	t.Helper()
+	return unmarshalAPIMap(t, data)
+}
+
+func unmarshalAPISlice(t *testing.T, data any) []any {
+	t.Helper()
+
+	var result []any
+	unmarshalAPIData(t, data, &result)
 	return result
 }
 
 func unmarshalEnvelopeSlice(t *testing.T, data any) []any {
 	t.Helper()
+	return unmarshalAPISlice(t, data)
+}
 
-	var result []any
-	unmarshalEnvelopeData(t, data, &result)
-	return result
+func mountOpenFlareTestRoutes(engine *gin.Engine) {
+	api := engine.Group("/api")
+	ofrouter.RegisterRoutes(api)
+
+	apiV1 := api.Group("/v1")
+	v1.RegisterV1Routes(apiV1, api)
+}
+
+func apiPath(subpath string) string {
+	return ofrouter.V1BasePath + subpath
 }
 
 func performJSONRequest(