restructure: console→client-console, add admin-console skeleton, move docs to doc/

client-console/internal/billing/billing.go

@@ -0,0 +1,42 @@
+// Package billing — слой записи статистики вызовов функций.
+//
+// Независим от типа БД: снаружи виден только интерфейс Store.
+// Если BILLING_DSN не задан — работает NoopStore (тихо, не крашит).
+package billing
+
+import "time"
+
+// TriggerType описывает источник вызова.
+const (
+	TriggerHTTP    = "http"    // вызов через /fn/... снаружи
+	TriggerCron    = "cron"    // вызов по расписанию
+	TriggerConsole = "console" // вызов через кнопку «Вызов» в UI
+	TriggerEvent   = "event"   // lifecycle: create/delete/clone/update
+)
+
+// Invocation — одна запись о вызове или событии функции.
+type Invocation struct {
+	Namespace     string    // пользовательский namespace (= пользователь)
+	FunctionName  string    // имя функции
+	TriggerType   string    // TriggerHTTP / TriggerCron / TriggerConsole / TriggerEvent
+	Route         string    // HTTP маршрут (/abc123/my-func), пусто для event
+	HTTPMethod    string    // GET/POST/... пусто для event
+	StartedAt     time.Time // время начала
+	DurationMS    int64     // длительность в миллисекундах (0 для event)
+	StatusCode    int       // HTTP статус ответа (0 для event)
+	ColdStart     bool      // true = первый вызов после создания/простоя
+	RequestBytes  int64     // размер тела запроса
+	ResponseBytes int64     // размер тела ответа
+	ErrorMsg      string    // сообщение об ошибке, пусто если успех
+	RecordedBy    string    // "console" | "router"
+	EventType     string    // для TriggerEvent: "create" | "delete" | "clone" | "update" | "invoke"
+}
+
+// Store — интерфейс записи статистики.
+// Реализации: pgStore (PostgreSQL через pgx), NoopStore (заглушка).
+type Store interface {
+	// RecordInvocation записывает одно событие асинхронно (fire-and-forget).
+	RecordInvocation(inv Invocation)
+	// Close освобождает ресурсы (пул соединений и т.д.).
+	Close()
+}

client-console/internal/billing/factory.go

@@ -0,0 +1,23 @@
+package billing
+
+import (
+	"context"
+	"log"
+	"os"
+)
+
+// NewStore создаёт Store из переменной окружения BILLING_DSN.
+// Если DSN пустой — возвращает NoopStore (статистика отключена, сервер работает нормально).
+func NewStore() Store {
+	dsn := os.Getenv("BILLING_DSN")
+	if dsn == "" {
+		log.Printf("billing: BILLING_DSN not set, statistics disabled")
+		return NoopStore{}
+	}
+	store, err := NewPostgresStore(context.Background(), dsn)
+	if err != nil {
+		log.Printf("billing: failed to connect to PostgreSQL: %v — statistics disabled", err)
+		return NoopStore{}
+	}
+	return store
+}

client-console/internal/billing/noop.go

@@ -0,0 +1,8 @@
+package billing
+
+// NoopStore — заглушка Store, которая тихо игнорирует все записи.
+// Используется когда BILLING_DSN не задан.
+type NoopStore struct{}
+
+func (NoopStore) RecordInvocation(_ Invocation) {}
+func (NoopStore) Close()                        {}

client-console/internal/billing/pg.go

@@ -0,0 +1,90 @@
+package billing
+
+import (
+	"context"
+	"log"
+	"time"
+
+	"github.com/jackc/pgx/v5/pgxpool"
+)
+
+// pgStore — реализация Store поверх PostgreSQL через pgx connection pool.
+type pgStore struct {
+	pool *pgxpool.Pool
+}
+
+// NewPostgresStore создаёт Store с пулом соединений к PostgreSQL.
+// dsn — строка вида postgres://user:pass@host:5432/dbname
+// При ошибке подключения — возвращает ошибку, вызывающий код решает как реагировать.
+func NewPostgresStore(ctx context.Context, dsn string) (Store, error) {
+	cfg, err := pgxpool.ParseConfig(dsn)
+	if err != nil {
+		return nil, err
+	}
+	cfg.MaxConns = 4
+	cfg.MinConns = 1
+	cfg.MaxConnIdleTime = 5 * time.Minute
+
+	pool, err := pgxpool.NewWithConfig(ctx, cfg)
+	if err != nil {
+		return nil, err
+	}
+	// Проверяем живость соединения
+	if err := pool.Ping(ctx); err != nil {
+		pool.Close()
+		return nil, err
+	}
+	log.Printf("billing: connected to PostgreSQL")
+	return &pgStore{pool: pool}, nil
+}
+
+// RecordInvocation вставляет запись асинхронно — не блокирует основной поток.
+func (s *pgStore) RecordInvocation(inv Invocation) {
+	go func() {
+		ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
+		defer cancel()
+
+		_, err := s.pool.Exec(ctx, `
+			INSERT INTO invocations (
+				namespace, function_name, trigger_type, route, http_method,
+				started_at, duration_ms, status_code, cold_start,
+				request_bytes, response_bytes, error_msg, recorded_by, event_type
+			) VALUES (
+				$1,$2,$3,$4,$5,
+				$6,$7,$8,$9,
+				$10,$11,$12,$13,$14
+			)`,
+			inv.Namespace,
+			inv.FunctionName,
+			inv.TriggerType,
+			inv.Route,
+			inv.HTTPMethod,
+			inv.StartedAt,
+			inv.DurationMS,
+			inv.StatusCode,
+			inv.ColdStart,
+			inv.RequestBytes,
+			inv.ResponseBytes,
+			nullIfEmpty(inv.ErrorMsg),
+			inv.RecordedBy,
+			nullIfEmpty(inv.EventType),
+		)
+		if err != nil {
+			log.Printf("billing: insert invocation: %v", err)
+		}
+	}()
+}
+
+// Close закрывает пул соединений.
+func (s *pgStore) Close() {
+	s.pool.Close()
+	log.Printf("billing: connection pool closed")
+}
+
+// nullIfEmpty возвращает nil для пустой строки (SQL NULL вместо пустой строки).
+func nullIfEmpty(s string) interface{} {
+	if s == "" {
+		return nil
+	}
+	return s
+}