pre-golang-removal: snapshot before removing all golang integration (2026-05-01)
This commit is contained in:
Naeel
@@ -0,0 +1,158 @@
|
||||
# Анализ coupling кода (console/) — 2026-05-01
|
||||
|
||||
## Граф зависимостей (DAG)
|
||||
|
||||
```
|
||||
model runtime
|
||||
│ │
|
||||
└──────┴── fission ─── cloud ─── api (handlers, server, auth...)
|
||||
│
|
||||
ui
|
||||
```
|
||||
|
||||
Цикличных зависимостей нет. Направление правильное.
|
||||
|
||||
---
|
||||
|
||||
## Проблемы coupling (по приоритету)
|
||||
|
||||
### 🔴 HIGH — api/handlers.go — смешение HTTP-слоя и оркестрации Fission
|
||||
|
||||
Файл выполняет одновременно:
|
||||
- HTTP-роутинг и валидацию запросов
|
||||
- Построение `map[string]any{}` манифестов для Package, Function, HTTPTrigger прямо в handler-е
|
||||
- Логику отката (Delete при ошибке) — транзакционная оркестрация
|
||||
- Логику смены Package при обновлении кода (cache-bust через новое имя)
|
||||
|
||||
**Правильно:** всё что ниже `json.Decode(&req)` в `handleCreateFunction` — задача пакета `fission`.
|
||||
Handler должен вызывать `fission.CreateFunction(ctx, dyn, ns, params)`, а не строить K8s-схемы вручную.
|
||||
Fission-специфичная схема сейчас размазана между `handlers.go` и `fission/`.
|
||||
|
||||
### 🟡 MEDIUM — api/package.go берёт *Server вместо http.Client
|
||||
|
||||
func extractPackageSourceCode(ctx context.Context, s *Server, ...) string
|
||||
func fetchPackageArchive(ctx context.Context, s *Server, ...) ([]byte, error)
|
||||
|
||||
Обе функции используют только `s.http`. Зависимость от всего `*Server` — излишняя.
|
||||
Делает функции нетестируемыми без создания полного Server.
|
||||
|
||||
### 🟡 MEDIUM — Кэш токенов живёт на Server
|
||||
|
||||
`tokenMu`, `cachedJWT`, `tokenExpAt`, `tokenCache` — auth-сервис встроен в транспортный объект.
|
||||
При росте логики авторизации потребует правки Server.
|
||||
|
||||
### 🟢 LOW — Конфиг линтеров inline в ai_check.go
|
||||
|
||||
Карта `langs := map[string]linterCfg{...}` пересоздаётся при каждом вызове handler-а.
|
||||
|
||||
### 🟢 LOW — Legacy-роуты без auth-middleware в server.go
|
||||
|
||||
mux.HandleFunc("/api/functions", s.handleFunctionsRoot) // без auth!
|
||||
mux.HandleFunc("/console/api/functions", auth(s.handleFunctionsRoot)) // с auth
|
||||
|
||||
Одни и те же handlers зарегистрированы дважды — легко пропустить при добавлении нового роута.
|
||||
|
||||
---
|
||||
|
||||
## Что работает хорошо (не трогать)
|
||||
|
||||
| Пакет | Оценка |
|
||||
|---|---|
|
||||
| model/types.go | Чистый leaf-пакет, нет внутренних импортов |
|
||||
| runtime/ | Pure функции, нет зависимостей на api/cloud/fission — идеально |
|
||||
| fission/environment.go | Хорошая инкапсуляция EnsureEnvironment + Cleanup |
|
||||
| cloud/tenant.go | Singleflight + semaphore + cache — правильно изолировано |
|
||||
| cloud/quota.go, network.go | Атомарные, читаемые, независимые |
|
||||
|
||||
---
|
||||
|
||||
## Вывод
|
||||
|
||||
Глобального рефакторинга не нужно — структура пакетов правильная.
|
||||
Основная боль: handlers.go (~700 строк) делает слишком много.
|
||||
Решение: добавить в пакет fission функции CreateFunction / UpdateFunction / DeleteFunction,
|
||||
которые инкапсулируют построение K8s-манифестов.
|
||||
Handlers превратятся в тонкий HTTP-слой (~200 строк).
|
||||
Остальное — мелочи.
|
||||
~~~блока есть вложенные ` ``` ` — они его разрывают. Вот вариант с `~~~` снаружи:
|
||||
|
||||
~~~markdown
|
||||
# Анализ coupling кода (console/) — 2026-05-01
|
||||
|
||||
## Граф зависимостей (DAG)
|
||||
|
||||
```
|
||||
model runtime
|
||||
│ │
|
||||
└──────┴── fission ─── cloud ─── api (handlers, server, auth...)
|
||||
│
|
||||
ui
|
||||
```
|
||||
|
||||
Цикличных зависимостей нет. Направление правильное.
|
||||
|
||||
---
|
||||
|
||||
## Проблемы coupling (по приоритету)
|
||||
|
||||
### 🔴 HIGH — api/handlers.go — смешение HTTP-слоя и оркестрации Fission
|
||||
|
||||
Файл выполняет одновременно:
|
||||
- HTTP-роутинг и валидацию запросов
|
||||
- Построение `map[string]any{}` манифестов для Package, Function, HTTPTrigger прямо в handler-е
|
||||
- Логику отката (Delete при ошибке) — транзакционная оркестрация
|
||||
- Логику смены Package при обновлении кода (cache-bust через новое имя)
|
||||
|
||||
**Правильно:** всё что ниже `json.Decode(&req)` в `handleCreateFunction` — задача пакета `fission`.
|
||||
Handler должен вызывать `fission.CreateFunction(ctx, dyn, ns, params)`, а не строить K8s-схемы вручную.
|
||||
Fission-специфичная схема сейчас размазана между `handlers.go` и `fission/`.
|
||||
|
||||
### 🟡 MEDIUM — api/package.go берёт *Server вместо http.Client
|
||||
|
||||
func extractPackageSourceCode(ctx context.Context, s *Server, ...) string
|
||||
func fetchPackageArchive(ctx context.Context, s *Server, ...) ([]byte, error)
|
||||
|
||||
Обе функции используют только `s.http`. Зависимость от всего `*Server` — излишняя.
|
||||
Делает функции нетестируемыми без создания полного Server.
|
||||
|
||||
### 🟡 MEDIUM — Кэш токенов живёт на Server
|
||||
|
||||
`tokenMu`, `cachedJWT`, `tokenExpAt`, `tokenCache` — auth-сервис встроен в транспортный объект.
|
||||
При росте логики авторизации потребует правки Server.
|
||||
|
||||
### 🟢 LOW — Конфиг линтеров inline в ai_check.go
|
||||
|
||||
Карта `langs := map[string]linterCfg{...}` пересоздаётся при каждом вызове handler-а.
|
||||
|
||||
### 🟢 LOW — Legacy-роуты без auth-middleware в server.go
|
||||
|
||||
mux.HandleFunc("/api/functions", s.handleFunctionsRoot) // без auth!
|
||||
mux.HandleFunc("/console/api/functions", auth(s.handleFunctionsRoot)) // с auth
|
||||
|
||||
Одни и те же handlers зарегистрированы дважды — легко пропустить при добавлении нового роута.
|
||||
|
||||
---
|
||||
|
||||
## Что работает хорошо (не трогать)
|
||||
|
||||
| Пакет | Оценка |
|
||||
|---|---|
|
||||
| model/types.go | Чистый leaf-пакет, нет внутренних импортов |
|
||||
| runtime/ | Pure функции, нет зависимостей на api/cloud/fission — идеально |
|
||||
| fission/environment.go | Хорошая инкапсуляция EnsureEnvironment + Cleanup |
|
||||
| cloud/tenant.go | Singleflight + semaphore + cache — правильно изолировано |
|
||||
| cloud/quota.go, network.go | Атомарные, читаемые, независимые |
|
||||
|
||||
---
|
||||
|
||||
## Вывод
|
||||
|
||||
Глобального рефакторинга не нужно — структура пакетов правильная.
|
||||
Основная боль: handlers.go (~700 строк) делает слишком много.
|
||||
Решение: добавить в пакет fission функции CreateFunction / UpdateFunction / DeleteFunction,
|
||||
которые инкапсулируют построение K8s-манифестов.
|
||||
Handlers превратятся в тонкий HTTP-слой (~200 строк).
|
||||
Остальное — мелочи.
|
||||
|
||||
----------- «один блок, тильды снаружи» — я пойму.
|
||||
И кстати, Plan может писать в файл — но только в /memories/session/plan.md (session memory).
|
||||
@@ -0,0 +1,218 @@
|
||||
{
|
||||
"repo_summary": {
|
||||
"files_count": 5,
|
||||
"languages": ["go"],
|
||||
"frameworks": {
|
||||
"value": ["k8s.io/client-go", "k8s.io/apimachinery"],
|
||||
"confidence": "medium",
|
||||
"source": "explicit_code"
|
||||
}
|
||||
},
|
||||
"modules": [
|
||||
{
|
||||
"name": "console/internal/api/handlers.go",
|
||||
"imports": {
|
||||
"value": [
|
||||
"bytes", "context", "encoding/json", "errors", "fmt", "io", "log", "net", "net/http", "regexp", "strconv", "strings", "time",
|
||||
"fission-console/internal/fission",
|
||||
"fission-console/internal/model",
|
||||
"fission-console/internal/runtime",
|
||||
"k8s.io/apimachinery/pkg/api/errors",
|
||||
"k8s.io/apimachinery/pkg/apis/meta/v1",
|
||||
"k8s.io/apimachinery/pkg/apis/meta/v1/unstructured"
|
||||
],
|
||||
"confidence": "high",
|
||||
"source": "explicit_code"
|
||||
},
|
||||
"exports": {
|
||||
"value": [
|
||||
"handleFunctionsRoot", "handleFunctionsAction", "handleCreateFunction",
|
||||
"handleGetFunction", "handleUpdateFunctionCode",
|
||||
"handleInvokeFunction", "handleFissionFunctionGateway",
|
||||
"invokeInternalFunction", "handleInvokeRoute",
|
||||
"handleDeleteFunction", "handleAuth", "parseTTL", "normalizeMethods"
|
||||
],
|
||||
"confidence": "high",
|
||||
"source": "explicit_code"
|
||||
}
|
||||
},
|
||||
{
|
||||
"name": "console/internal/api/server.go",
|
||||
"imports": {
|
||||
"value": [
|
||||
"bytes", "context", "encoding/json", "fmt", "io", "net/http", "os", "strings", "sync", "time",
|
||||
"fission-console/internal/cloud", "fission-console/internal/fission", "fission-console/ui",
|
||||
"k8s.io/apimachinery/pkg/apis/meta/v1", "k8s.io/apimachinery/pkg/apis/meta/v1/unstructured",
|
||||
"k8s.io/apimachinery/pkg/runtime/schema", "k8s.io/client-go/dynamic"
|
||||
],
|
||||
"confidence": "high",
|
||||
"source": "explicit_code"
|
||||
},
|
||||
"exports": {
|
||||
"value": [
|
||||
"Server", "Config", "NewServer", "RegisterRoutes", "Handler", "NSManager", "handleList"
|
||||
],
|
||||
"confidence": "high",
|
||||
"source": "explicit_code"
|
||||
}
|
||||
},
|
||||
{
|
||||
"name": "console/internal/model/types.go",
|
||||
"imports": {
|
||||
"value": [],
|
||||
"confidence": "high",
|
||||
"source": "explicit_code"
|
||||
},
|
||||
"exports": {
|
||||
"value": [
|
||||
"CreateFunctionRequest", "CreateTimeTriggerRequest", "UpdateCodeRequest", "LangEnvDef", "LangEnvMap"
|
||||
],
|
||||
"confidence": "high",
|
||||
"source": "explicit_code"
|
||||
}
|
||||
},
|
||||
{
|
||||
"name": "console/internal/runtime/entrypoint.go",
|
||||
"imports": {
|
||||
"value": [],
|
||||
"confidence": "high",
|
||||
"source": "explicit_code"
|
||||
},
|
||||
"exports": {
|
||||
"value": ["DefaultEntrypoint"],
|
||||
"confidence": "high",
|
||||
"source": "explicit_code"
|
||||
}
|
||||
},
|
||||
{
|
||||
"name": "console/cmd/server/main.go",
|
||||
"imports": {
|
||||
"value": [
|
||||
"log", "net/http", "os", "strings", "time",
|
||||
"fission-console/internal/api",
|
||||
"k8s.io/client-go/dynamic", "k8s.io/client-go/rest", "k8s.io/client-go/tools/clientcmd"
|
||||
],
|
||||
"confidence": "high",
|
||||
"source": "explicit_code"
|
||||
},
|
||||
"exports": {
|
||||
"value": ["main", "buildConfig", "envDefault", "envDurationDefault"],
|
||||
"confidence": "high",
|
||||
"source": "explicit_code"
|
||||
}
|
||||
}
|
||||
],
|
||||
"symbols": [
|
||||
{
|
||||
"name": "main",
|
||||
"type": "function",
|
||||
"file": "console/cmd/server/main.go",
|
||||
"calls": {
|
||||
"value": [
|
||||
"buildConfig",
|
||||
"k8s.io/client-go/dynamic.NewForConfig",
|
||||
"fission-console/internal/api.NewServer",
|
||||
"nsm.StartExpiryReaper",
|
||||
"log.Printf",
|
||||
"log.Fatal"
|
||||
],
|
||||
"confidence": "high",
|
||||
"source": "explicit_code"
|
||||
},
|
||||
"called_by": {
|
||||
"value": [],
|
||||
"confidence": "unknown",
|
||||
"source": "unknown"
|
||||
},
|
||||
"inputs": {
|
||||
"value": [],
|
||||
"confidence": "high",
|
||||
"source": "explicit_code"
|
||||
},
|
||||
"returns": {
|
||||
"value": "UNKNOWN",
|
||||
"confidence": "unknown",
|
||||
"source": "unknown"
|
||||
},
|
||||
"side_effects": [
|
||||
{
|
||||
"type": "http_server",
|
||||
"confidence": "high",
|
||||
"source": "explicit_code",
|
||||
"evidence": "httpServer.ListenAndServe()"
|
||||
},
|
||||
{
|
||||
"type": "log",
|
||||
"confidence": "high",
|
||||
"source": "explicit_code",
|
||||
"evidence": "log.Printf, log.Fatal"
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"name": "DefaultEntrypoint",
|
||||
"type": "function",
|
||||
"file": "console/internal/runtime/entrypoint.go",
|
||||
"calls": {
|
||||
"value": [],
|
||||
"confidence": "high",
|
||||
"source": "explicit_code"
|
||||
},
|
||||
"called_by": {
|
||||
"value": [],
|
||||
"confidence": "unknown",
|
||||
"source": "unknown"
|
||||
},
|
||||
"inputs": {
|
||||
"value": ["lang"],
|
||||
"confidence": "high",
|
||||
"source": "explicit_code"
|
||||
},
|
||||
"returns": {
|
||||
"value": "string",
|
||||
"confidence": "high",
|
||||
"source": "explicit_code"
|
||||
},
|
||||
"side_effects": []
|
||||
}
|
||||
],
|
||||
"call_graph": [
|
||||
{
|
||||
"from": "main",
|
||||
"to": [
|
||||
"buildConfig",
|
||||
"k8s.io/client-go/dynamic.NewForConfig",
|
||||
"fission-console/internal/api.NewServer",
|
||||
"nsm.StartExpiryReaper",
|
||||
"log.Printf",
|
||||
"log.Fatal"
|
||||
],
|
||||
"confidence": "high",
|
||||
"source": "explicit_code"
|
||||
},
|
||||
{
|
||||
"from": "handleCreateFunction",
|
||||
"to": ["DefaultEntrypoint"],
|
||||
"confidence": "high",
|
||||
"source": "explicit_code"
|
||||
}
|
||||
],
|
||||
"entry_points": [
|
||||
{
|
||||
"name": "main",
|
||||
"type": "cli",
|
||||
"confidence": "high",
|
||||
"source": "explicit_code"
|
||||
}
|
||||
],
|
||||
"unknowns": [
|
||||
{
|
||||
"reason": "reverse call graph incomplete",
|
||||
"location": "global"
|
||||
}
|
||||
],
|
||||
"analysis_coverage": {
|
||||
"symbols_detected": 2,
|
||||
"modules_detected": 5
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user