Merge branch 'main' into redfish-firmware

Author: nmgaston

.github/CODEOWNERS

@@ -0,0 +1,5 @@
+# This file defines the code owners for the console repository
+# See https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners
+
+# Default owners for the entire repository
+* @device-management-toolkit/owner-open-amt-cloud-toolkit

Dockerfile

@@ -1,3 +1,8 @@
+#*********************************************************************
+# * Copyright (c) Intel Corporation 2025
+# * SPDX-License-Identifier: Apache-2.0
+# **********************************************************************
+
 # Step 1: Modules caching
 FROM golang:1.25.3-alpine@sha256:aee43c3ccbf24fdffb7295693b6e33b21e01baec1b2a55acc351fde345e9ec34 AS modules
 COPY go.mod go.sum /modules/

cmd/app/main.go

@@ -12,13 +12,23 @@ import (
 
 	"github.com/device-management-toolkit/console/config"
 	"github.com/device-management-toolkit/console/internal/app"
+	"github.com/device-management-toolkit/console/internal/controller/openapi"
+	"github.com/device-management-toolkit/console/internal/usecase"
+	"github.com/device-management-toolkit/console/pkg/logger"
 )
 
 // Function pointers for better testability.
 var (
 	initializeConfigFunc = config.NewConfig
 	initializeAppFunc    = app.Init
 	runAppFunc           = app.Run
+	// NewGeneratorFunc allows tests to inject a fake OpenAPI generator.
+	NewGeneratorFunc = func(u usecase.Usecases, l logger.Interface) interface {
+		GenerateSpec() ([]byte, error)
+		SaveSpec([]byte, string) error
+	} {
+		return openapi.NewGenerator(u, l)
+	}
 )
 
 func main() {
@@ -41,11 +51,39 @@ func main() {
 				panic(browserError)
 			}
 		}()
+	} else {
+		err = handleOpenAPIGeneration()
+		if err != nil {
+			log.Fatalf("Failed to generate OpenAPI spec: %s", err)
+		}
 	}
 
 	runAppFunc(cfg)
 }
 
+func handleOpenAPIGeneration() error {
+	l := logger.New("info")
+	usecases := usecase.Usecases{}
+
+	// Create OpenAPI generator
+	generator := NewGeneratorFunc(usecases, l)
+
+	// Generate specification
+	spec, err := generator.GenerateSpec()
+	if err != nil {
+		return err
+	}
+
+	// Save to file
+	if err := generator.SaveSpec(spec, "doc/openapi.json"); err != nil {
+		return err
+	}
+
+	log.Println("OpenAPI specification generated at doc/openapi.json")
+
+	return nil
+}
+
 func handleEncryptionKey(cfg *config.Config) {
 	toolkitCrypto := security.Crypto{}
 

cmd/app/main_test.go

@@ -8,6 +8,8 @@ import (
 	"github.com/stretchr/testify/mock"
 
 	"github.com/device-management-toolkit/console/config"
+	"github.com/device-management-toolkit/console/internal/usecase"
+	"github.com/device-management-toolkit/console/pkg/logger"
 )
 
 type MockCommandExecutor struct {
@@ -70,3 +72,66 @@ func TestOpenBrowserLinux(t *testing.T) { //nolint:paralleltest // cannot have s
 	assert.NoError(t, err)
 	mockCmdExecutor.AssertExpectations(t)
 }
+
+type MockGenerator struct {
+	mock.Mock
+}
+
+func (m *MockGenerator) GenerateSpec() ([]byte, error) {
+	args := m.Called()
+
+	var b []byte
+	if v := args.Get(0); v != nil {
+		if bb, ok := v.([]byte); ok {
+			b = bb
+		}
+	}
+
+	return b, args.Error(1)
+}
+
+func (m *MockGenerator) SaveSpec(b []byte, path string) error {
+	args := m.Called(b, path)
+
+	return args.Error(0)
+}
+
+//nolint:paralleltest // modifies package-level NewGeneratorFunc
+func TestHandleOpenAPIGeneration_Success(t *testing.T) {
+	mockGen := new(MockGenerator)
+
+	NewGeneratorFunc = func(_ usecase.Usecases, _ logger.Interface) interface {
+		GenerateSpec() ([]byte, error)
+		SaveSpec([]byte, string) error
+	} {
+		return mockGen
+	}
+
+	expectedSpec := []byte("{}")
+	mockGen.On("GenerateSpec").Return(expectedSpec, nil)
+	mockGen.On("SaveSpec", expectedSpec, "doc/openapi.json").Return(nil)
+
+	err := handleOpenAPIGeneration()
+	assert.NoError(t, err)
+
+	mockGen.AssertExpectations(t)
+}
+
+//nolint:paralleltest // modifies package-level NewGeneratorFunc
+func TestHandleOpenAPIGeneration_GenerateFails(t *testing.T) {
+	mockGen := new(MockGenerator)
+
+	NewGeneratorFunc = func(_ usecase.Usecases, _ logger.Interface) interface {
+		GenerateSpec() ([]byte, error)
+		SaveSpec([]byte, string) error
+	} {
+		return mockGen
+	}
+
+	mockGen.On("GenerateSpec").Return([]byte(nil), assert.AnError)
+
+	err := handleOpenAPIGeneration()
+	assert.Error(t, err)
+
+	mockGen.AssertExpectations(t)
+}