Комментирование, правки кода, исправление модальных окон

setup/main.go

@@ -3,9 +3,7 @@ package setup
 import (
 	"bubble/bootstrap"
 	"bubble/types"
-	"fmt"
 	tea "github.com/charmbracelet/bubbletea"
-	"github.com/sirupsen/logrus"
 )
 
 func Start() {
@@ -15,23 +13,27 @@ func Start() {
 	}
 }
 
+// Main структура описывающая объект настроек
 type Main struct {
-	current            tea.Model
-	overlay            tea.Model
-	Applications       []types.PackageApplication
-	CurrentApplication *types.PackageApplication
-	CurrentSection     *types.Section
-	CurrentSectionIdx  int
-	Width              int
-	Height             int
+	current            tea.Model                  //Текущая модель для отображения
+	overlay            tea.Model                  //Модель для отображения модальных окон
+	Applications       []types.PackageApplication //Список доступных приложений для настройки
+	CurrentApplication *types.PackageApplication  //Выбранное приложение для настройки
+	CurrentSection     *types.Section             //Текущая секция
+	CurrentSectionIdx  int                        //Индекс текущей секции
+	Width              int                        //Ширина окна
+	Height             int                        //Высота окна
 }
 
+// NewMain создаем новый объект настройки
 func NewMain() *Main {
+	//Читаем все конфиги приложении
 	apps := bootstrap.LoadApplications()
 	m := &Main{
 		Applications:      apps,
 		CurrentSectionIdx: 0,
 	}
+	//Записываем в текущую модель список приложений
 	m.current = NewListApplicationsModel(m.Applications, m.Width, m.Height)
 	return m
 }
@@ -40,16 +42,20 @@ func (m *Main) Init() tea.Cmd {
 	return m.current.Init()
 }
 
+// Update отслеживает действия в объекте настроек
 func (m *Main) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
 	var cmds []tea.Cmd
+	var cmd tea.Cmd
+	//Если у нас установлен модель модального окна, то передаем сообщение в его функцию обновления,
+	//при возврате команды модального окна записываем её в массив команд.
+	//В противном случае передаем сообщение в функцию обновления текущей модели,
+	//при возврате команды также записываем её в массив команд.
 	if m.overlay != nil {
-		var cmd tea.Cmd
 		m.overlay, cmd = m.overlay.Update(msg)
 		if cmd != nil {
 			cmds = append(cmds, cmd)
 		}
 	} else {
-		var cmd tea.Cmd
 		m.current, cmd = m.current.Update(msg)
 		if cmd != nil {
 			cmds = append(cmds, cmd)
@@ -57,17 +63,17 @@ func (m *Main) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
 	}
 	switch msg := msg.(type) {
 	case tea.WindowSizeMsg:
+		//Отслеживаем и записываем новые размеры окна.
+		//Передавать сообщение в модель текущую или модального окна для вызова их обработки изменения размеров не нужно,
+		//они получили WindowSizeMsg выше, когда мы передаем им переменную msg.
 		m.Width = msg.Width
 		m.Height = msg.Height
-		if m.current != nil {
-			m.current, _ = m.current.Update(msg)
-		}
-		if m.overlay != nil {
-			m.overlay, _ = m.overlay.Update(msg)
-		}
 	case tea.KeyMsg:
+		//Отслеживаем нажатие клавиш приложения
 		switch msg.String() {
 		case "ctrl+c":
+			//Обработчик клавиш ctrl+c у приложения нужен для его закрытия.
+			//Возвращаем команду по возврату сообщения о показе модального окна
 			return m, func() tea.Msg {
 				return types.ShowModalMsg{
 					Type:    types.ModalWarning,
@@ -87,8 +93,12 @@ func (m *Main) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
 			}
 		}
 	case types.NextSectionMsg:
+		//Получаем сообщение о переходе на следующую секцию настраиваемого приложения.
+		//Увеличиваем индекс текущей секции.
 		m.CurrentSectionIdx++
+		//Если новый индекс равен
 		if m.CurrentSectionIdx == len(m.CurrentApplication.Sections) {
+			//todo что делать когда секций больше нужного?
 			return m, tea.Quit
 		}
 		for sectionIdx := m.CurrentSectionIdx; sectionIdx < len(m.CurrentApplication.Sections); sectionIdx++ {
@@ -134,28 +144,51 @@ func (m *Main) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
 				break
 			}
 		}
-		//если секция не была найдена, то выходим
+		//Если секция доступная к выводу не была найдена, то возвращаем модальное окно с выходом к списку приложений
 		if m.CurrentSection == nil {
-			logrus.Infof("select app, eq nil, out")
-			return m, tea.Quit
+			return m, func() tea.Msg {
+				return types.ShowModalMsg{
+					Type:  types.ModalError,
+					Title: "Ошибка",
+					Message: "Ошибка выбора приложения. Указанное приложение не имеет доступных секций." +
+						"Проверьте конфиг настраиваемого приложения на предмет выполнения условий секций",
+					ModalButtons: []types.ModalButton{{Text: "Вернуться к списку приложений", Value: true}},
+					OnResult: func(result any) tea.Cmd {
+						return func() tea.Msg {
+							return types.BackToListMsg{}
+						}
+					},
+				}
+			}
 		}
 		//создаем новую форму
 		m.current = NewFormModel(m.CurrentApplication, m.CurrentSectionIdx, 0, m.Width, m.Height)
 	case types.BackToListMsg:
+		//Получаем сообщение о возврате к списку приложений.
+		//Стираем текущие приложение, стираем текущую секцию, стираем индекс секции, записываем в текущую модель список приложений
 		m.CurrentApplication = nil
 		m.CurrentSection = nil
 		m.CurrentSectionIdx = 0
 		m.current = NewListApplicationsModel(m.Applications, m.Width, m.Height)
 	case types.ShowModalMsg:
+		//Получаем сообщение о показе модального окна.
+		//В поле модального окна записываем новый объект модального окна на основе сообщений.
+		//НЕ СТИРАЕМ ТЕКУЩЕЕ ПРИЛОЖЕНИЕ
 		m.overlay = NewModalModel(msg, m.Width, m.Height)
 		return m, nil
 	case types.CloseModalMsg:
+		//Получаем сообщение о закрытии модального окна.
+		//Стираем модальное окно.
 		m.overlay = nil
-		return m, tea.Batch(cmds...)
+		return m, nil
+		//предохранитель
+		//return m,tea.Batch(cmds...)
 	}
+	//Возвращаем команду собранную из массива команд текущей модели
 	return m, tea.Batch(cmds...)
 }
 
+// View формирует строку на основе модального окна или текущей модели
 func (m *Main) View() string {
 	view := m.current.View()
 	if m.overlay != nil {
@@ -164,10 +197,14 @@ func (m *Main) View() string {
 	return view
 }
 
+// Sugar проверяет поле указанное в сообщение на важность в форме и приложении.
 func (m *Main) Sugar(sugar types.SugarMsg) {
+	//Если полей с указанной переменной несколько, то выключаем все прочие поля кроме, указанного в сообщении
 	if m.IsMultiField(sugar.VariableName) {
 		m.DeactivateField(sugar.VariableName, sugar.FieldName)
 	}
+	//Если от переменной поля зависит секции или поля,
+	//то вызываем перерасчет значений compute полей и формируем новую форму с учетом прошлого фокуса на форме
 	if IsParent(sugar.VariableName, m.CurrentApplication.Sections) {
 		if sugar.Compute != "" {
 			Recompute(m.CurrentApplication)
@@ -176,6 +213,7 @@ func (m *Main) Sugar(sugar types.SugarMsg) {
 	}
 }
 
+// IsParent проверяет являться ли указанная переменная условие для поля или секции
 func IsParent(variableName string, sections []types.Section) bool {
 	for _, section := range sections {
 		for _, parent := range section.Parent {
@@ -195,6 +233,7 @@ func IsParent(variableName string, sections []types.Section) bool {
 	return false
 }
 
+// IsMultiField проверяет переменную на использование несколькими полями.
 func (m *Main) IsMultiField(variableName string) bool {
 	var count int
 	for _, section := range m.CurrentApplication.Sections {
@@ -207,6 +246,7 @@ func (m *Main) IsMultiField(variableName string) bool {
 	return count > 1
 }
 
+// DeactivateField отключает все поля использующие указанную переменную, кроме поля с указанным именем
 func (m *Main) DeactivateField(variableName, fieldName string) {
 	for sectionIdx, section := range m.CurrentApplication.Sections {
 		for fieldIdx, field := range section.Fields {
@@ -220,23 +260,3 @@ func (m *Main) DeactivateField(variableName, fieldName string) {
 		}
 	}
 }
-
-func (m *Main) RecomputeFields() {
-	for i := range m.CurrentApplication.Sections {
-		section := &m.CurrentApplication.Sections[i]
-		for j := range section.Fields {
-			field := &section.Fields[j]
-			if field.FieldType == "compute" && field.Compute != "" {
-				if field.Variable != nil {
-					continue
-				}
-				value, err := ComputeValue(field.Compute, m.CurrentApplication)
-				if err != nil {
-					value = fmt.Sprintf("Ошибка вычисления: %v", err)
-				}
-				field.Variable.Value = value
-
-			}
-		}
-	}
-}