Включение отладки для HTTP сервисов

 

http://localhost/marking/hs/exchange/ut/get

hs — стандартный префикс для HTTP-сервисов 1С

Понятия чистой архитектуры для GO

(23.12.2025 in LOG)

Главное! 
Все эти понятия самостоятельны и их нельзя обобщать. 

Dependency rule предлагает подход к решению вопросов separation of concerns, а three-layered architecture (при использовании DI) удачно реализует dependency rule в GO.

1. “Separation of concerns. They all (architectures of systems) achieve this separation by dividing the software into layers”. Разделение обязанностей достигаемое (архитектурами систем) путём деления программного обеспечения на слои. 

Это цель при создании программы.1️⃣ 

Each of these architectures produce systems that are (каждая из этих (перечисленных в статье) архитектур создаёт системы, которые):

1. Independent of Frameworks (независимы от фреймворков). 

2. Testable.

3. Independent of UI (независимы от пользовательского интерфейса)

4. Independent of Database.

5. Independent of any external agency. Независимы от каких-либо внешних факторов. Фактически, ваши бизнес-правила просто ничего не знают о внешнем мире.

2. Dependency Rule (правило зависимости, это о круговой диаграмме дяди Боба). 

Это правило помогает достичь цели из п.1️⃣, 

предлагая выделить определенные слои (на диаграмме) и соблюдать определенные подходы.

Оно гласит, что зависимости исходного кода могут указывать только внутрь . Ничто во внутреннем круге не может знать ничего о чём-либо во внешнем круге. В частности, имя объекта, объявленного во внешнем круге, не должно упоминаться в коде во внутреннем круге. Это включает функции, классы, переменные и любые другие именованные программные сущности.

3. Dependency Injection (DI) это шаблон проектирования позволяющий реализовать в GO правило из п.2️⃣ 

4. Three-layered architecture (N-tier architecture) это популярный архитектурный подход к проектированию приложений, который обеспечивает четкое разделение обязанностей (separation of concerns1️⃣), масштабируемость и простоту поддержки. В GO этот подход широко использует DI3️⃣.

В контексте Go, эта архитектура обычно делится на три логических слоя:

1. Уровень обработчиков/представления (Handler/Presentation Layer)

Этот слой отвечает за взаимодействие с внешним миром и является точкой входа в приложение. 

“Обязанности”:

1. Прием входящих данных (например, HTTP-запросов). Включает:

1. валидация данных,

2. разбор (парсинг) данных (JSON, параметры URL и т.д.).

2. Маппинг (mapping, отображение)- преобразование данных запроса в формат, понятный для уровня сервисов. В общем маппинг это процесс установления соответствия между полями объекта из одного слоя (например, RequestDTO (Data Transfer Object)) и полями объекта другого слоя (например, Domain Model или Service Entity).

3. Передача (маршрутизация) запросов к соответствующему сервису.

4. Возврат (подготовка и отправка) ответа клиенту.

В Go: Обычно реализуется с помощью функций HTTP-обработчиков (handlers) из стандартной библиотеки net/http или сторонних фреймворков/маршрутизаторов.

2. Уровень сервисов/бизнес-логики (Service/Business Logic Layer)

Этот слой содержит основную бизнес-логику приложения и управляет потоком операций. 

“Обязанности”:

1. Реализация бизнес-правил и логики предметной области.

2. Оркестрация процессов и координация между различными компонентами.

3. Выполнение операций, которые могут потребовать взаимодействия с несколькими репозиториями или внешними сервисами.

4. Применение дополнительной логики до или после взаимодействия с уровнем данных.

В Go: Представляется в виде структур (structs) с методами, которые принимают интерфейсы репозиториев в качестве зависимостей (Dependency Injection) для обеспечения тестируемости и слабой связанности. 

3. Уровень доступа к данным/хранилища (Data Access/Repository Layer)

Этот слой отвечает исключительно за взаимодействие с источниками данных, такими как базы данных, файловые системы или внешние API. 

“Обязанности”:

1. Выполнение операций CRUD (Create, Read, Update, Delete).

2. Работа с SQL-запросами или ORM.

3. Абстрагирование бизнес-логики от деталей конкретной базы данных.

В Go: Обычно реализуется через интерфейсы репозиториев (Repository interfaces), а конкретные реализации этих интерфейсов отвечают за фактическое хранение или извлечение данных.

Типичная организация файлов и папок в проекте Go, использующем трехслойную архитектуру, может выглядеть так:

/go-service/

├── cmd/                  # Точки входа приложения (main функции)

├── internal/

│   ├── handler/      # Обработчики HTTP (презентационный слой)

│   ├── service/      # Бизнес-логика (слой сервисов)

│   └── repository/ # Доступ к данным (слой хранилища)

├── model/              # Общие структуры данных/модели предметной области

└── pkg/                   # Переиспользуемые утилиты (логирование, конфиг и т.д.)

Проблема с переносом строк в Windows/WSL

Если вы редактировали скрипт (участвующий в процедуре make) типа wait-for-postgres.sh в среде Windows, он может использовать окончания строк в стиле Windows (CRLF), которые вызывают проблемы в Linux-контейнерах (которые ожидают LF). Интерпретатор /bin/sh видит символ возврата каретки как часть имени команды, и в результате файл не может быть выполнен.
Решение: Преобразовать файл в формат LF.

Можно открыть файл в редакторе, например VS Code, и в правом нижнем углу выбрать формат окончания строк LF.

Git не сохраняет такое изменение, надо проводить изменение во всех экземплярах.

docker-compose

 В случае необходимости пересборки контейнеров (или если они больше не нужны), находясь в папке с файлом docker-compose даем команду:

docker-compose down

# Принудительно пересоберите образ
make build

# Запустите снова
make run

Ошибка типа '/var/lib/postgresql/data': Operation not permitted, при запуске контейнеров в docker-compose при использовании WSL

Это очень распространенная проблема при использовании Docker в Windows с WSL 2, особенно если файлы проекта находятся в смонтированном разделе Windows (/mnt/c/...), а не в файловой системе Linux WSL (~/...).

Если вы используете WSL 2 и ваши файлы находятся на разделе NTFS (например, в директории /mnt/c/Users/...), то стандартные команды Linux chmod и chown не могут изменить реальные права доступа для процессов внутри контейнера Docker из-за ограничений монтирования WSL/NTFS.

Решение- использование именованных томов Docker (рекомендуется)
Вместо того чтобы монтировать конкретную локальную папку на вашем хосте (./.database/postgres/data) внутрь контейнера, мы позволим Docker управлять хранилищем данных самостоятельно через "именованный том" (named volume). Docker Volumes хранятся в специальном управляемом Docker'ом месте, где проблем с правами доступа не возникает.
Это самый чистый и надежный способ для работы с базами данных в Docker.

В файле docker-compose.yml надо заменить 

volumes:

    - ./.database/postgres/data:/var/lib/postgresql/data

на

volumes:

    - pgdata:/var/lib/postgresql/data

и добавить в конец файла:

volumes:

  pgdata:

Как выполнить команду make в Visual Studio Code (Windows)

Правильнее установить Debian (к примеру) для WSL и уже там запускать make

Другой вариант- в Visual Studio Code необходимо установить расширение Makefile Tools и произвести настройки 

API clients, an alternative to Postman

Bruno Habr about Bruno (rus)

Disable redirection in GET requests from Bruno:

req.setMaxRedirects(0)

hoppscotch

GO отладка VSCode. Формат строки в launch.json

"version": "0.2.0",

    "configurations": [

        {

            "name": "Launch Package",

            "type": "go",

            "request": "launch",

            "mode": "auto",

            "program": "${workspaceFolder}/cmd", // указывает, что запускать

// (пакет main)

            "cwd": "${workspaceFolder}" // (current working directory)

// устанавливает рабочий каталог в корень проекта

        }

    ]

"version": "0.2.0",

    "configurations": [

        {

            "name": "My debug",

            "type": "go",

            "request": "launch",

            "mode": "debug",

            "program": "${workspaceFolder}/cmd/shortener"

        }

    ]

{

                "name": "Launch Package",

                "type": "go",

                "request": "launch",

                "mode": "debug",

                "program": "${fileDirname}", // Or specify the path to your main Go file

                "args": [

                    "-flag1",

                    "value1",

                    "--another-flag",

                    "another_value"

                ]

            }

Mac в качестве Wi-Fi точки доступа

Отсюда

Этот функционал в OS X присутствует уже давно, но просто не все и особенно начинающие знают об этом. Именно для них и предназначена эта заметка.

Если ваш Mac использует Интернет-подключение не через Wi-Fi-соединение, а например, через 3G-модем или Ethernet-подключение, то вы можете очень легко организовать Wi-Fi-точку доступа.

Сначала нужно активировать службу (метка 1 на картинке) и включить Wi-Fi (метка 2), если они были отключены до этого. Для чего переходим в Системные настройки — Сеть:

После этого идем в Системные настройки — Общий доступ. В списке служб (в левой части окна) выбираем Общий Интернет, но сначала не включаем галку на этой службе, а в правой части в пункте Общее подключение: выбираем тот вариант, которым ваш Macподключен к Интернет. На моем iMac это Ethernet. В пункте Для компьютеров, использующих: ставим галку на Wi-Fi:

Затем нажимаем кнопку Параметры Wi-Fi… и настраиваем имя сети, канал и шифрование:

Примечание. У меня под Lion 10.7.2, почему-то, при выборе 128-битного шифрования, доступ в Интернет не заработал, пришлось выбрать 40-битное.

После этого в левой части включаем (установив галку) службу Общий Интернет:

Подтверждаем, нажав кнопку Включить:

Все готово. В строке меню в значке Wi-Fi появляется стрелочка. Это говорит, о том, что служба Общий Интернет работает:

Подключаем ваши устройства к точке доступа, найдя новую Wi-Fi-сеть. Вот так это выглядит на моём iPhone:

Добавить интерфейс в выбор для переключения

Интерфейс общий-  меню- сервис- интерфейсы- новый
У добавляемого интерфейса должен быть установлен флаг "переключаемый" 

Подключение кассового оборудования через RDP- активные кассы создаются у всех пользователей! Решение

 Здесь

в обработке ТОСервер- Модуль объекта- ПолучитьИмяКомпьютераТО излагаем так:

Функция ПолучитьИмяКомпьютераТО() Экспорт ////**//стд //Если мИмяКомпьютера = Неопределено Тогда // мИмяКомпьютера = ВРег(ИмяКомпьютера()); //КонецЕсли; Если мИмяКомпьютера = Неопределено Тогда WSS = Новый COMОбъект("WScript.Shell"); WSSE = WSS.Environment("Process"); мИмяКомпьютера = ВРег(WSSE.Item("ClientName")); Если ПустаяСтрока(мИмяКомпьютера) Тогда мИмяКомпьютера = ВРег(ИмяКомпьютера()); КонецЕсли; КонецЕсли; //если зайти в терминальной сессии консольно, то получим "CONSOLE", // в этом случае применяем типовую функцию Если мИмяКомпьютера = "CONSOLE" Тогда мИмяКомпьютера = ВРег(ИмяКомпьютера()); КонецЕсли; //*/ Возврат мИмяКомпьютера; КонецФункции

Но! Нужна проверка на ОС, т.к. работаем через COM

// Возвращает Истина, если клиентское приложение запущено под управлением ОС Linux.

//

// Возвращаемое значение:

//  Булево. Если нет клиентского приложения, возвращается Ложь.

//

Функция ЭтоLinuxКлиент() Экспорт

#Если Клиент Или ВнешнееСоединение Тогда

СистемнаяИнформация = Новый СистемнаяИнформация;

ЭтоLinuxКлиент = СистемнаяИнформация.ТипПлатформы = ТипПлатформы.Linux_x86

             ИЛИ СистемнаяИнформация.ТипПлатформы = ТипПлатформы.Linux_x86_64;

#Иначе

УстановитьПривилегированныйРежим(Истина);

ЭтоLinuxКлиент = СтандартныеПодсистемыСервер.ПараметрыКлиентаНаСервере().Получить("ЭтоLinuxКлиент");

Если ЭтоLinuxКлиент = Неопределено Тогда

Возврат Ложь; // Нет клиентского приложения.

КонецЕсли;

#КонецЕсли

Возврат ЭтоLinuxКлиент;

КонецФункции

Вернуть на поддержку элемент конфигурации 1С (боремся с последствием разработки не в 96dpi)

В моей ситуации "слетели" совершенно стандартные формы документов (находящиеся на поддержке).

Я скопировал их, затем эти копии сделал основными, а оригиналы- удалил.

Конфигуратор- Поддержка- Настройка поддержки- "Сравнить, Объединить"

Находим нужные формы в эталонной конфе, ставим флаг, объединяем и делаем все в обратном направлении (стандартным возвращаем Основная, копии- удаляем).

OFDconnect - ШТРИХ-М

 Вот здесь статья о подключении Штрих к 1С, в конце описан процесс подключения к OFDconnect.

Тест драйвера (при настройке OFDConnect) нужно запускать от имени администратора!

Иначе ничего в KKTProfiles не запишется.

 

В Win проще всего решать вопросы с выходом наружу OFDconnect через

Разрешение обмена данными с приложениями в брандмауэре.

 

 

 

 

 

 

Если делать как показано на скриншотах, то создадутся два разрешающих правила- для TCP и UDP.

Только так и должно быть!

Если создавать исходящее правило для приложения через оснастку брандмауэра, то будет создано одно правило с "тип протокола Любой"- работать оно не будет (вот такая диалектика от MS)!

COMConnector и comcntr

regsvr32 "D:\Program Files (x86)\1cv8\8.3.16.1224\bin\comcntr.dll"
regsvr32 "D:\Program Files (x86)\1cv8\8.3.9.2033\bin\comcntr.dll"
regsvr32 "D:\Program Files\1cv8\8.3.17.1386\bin\comcntr.dll"
regsvr32 "D:\Program Files\1cv8\8.3.16.1224\bin\comcntr.dll"
Все эти команды не нужны если реестр почищен и 1с установлена правильно.
В правильно входит и то, что если используется сервер Виндовс, то нужно ставить его из специального, серверного (а не общего) дистрибутива. В нем есть отдельный компонент- COM-соединение

ВАЖНО!

В случае возникновения ошибки COMConnector "курильщика" не обязательно сразу чистить реестр. В начале следует попробовать Удалить регистрацию библиотеки comcntr.dll 

Удаление регистрации библиотеки comcntr.dll

regsvr32 "C:\Program Files (x86)\1cv8\8.3.18.1334\bin\comcntr.dll" /u

Если после ошибки несоответствия и удачной регистрации новой версии компоненты, COM обмен не работает, НЕ СПЕШИМ УДАЛЯТЬ СТАРЫЕ ВЕРСИИ 1С!

В начале удалим регистрацию предыдущей версии, затем нынешней (она ведь не принесла результатов).

Затем снова регистрируем новую.

Ошибка COMConnector "курильщика"
Ошибка при установке подключения ко второй информационной базе:
Не удалось подключится к другой программе: {ОбщийМодуль.ОбщегоНазначения.Модуль(8969)}: Ошибка при вызове конструктора (COMObject)
COMConnector = Новый COMObject(ИмяCOMСоединителя()); // "V82.COMConnector"
по причине:
-2147221005(0x800401F3): Недопустимая строка с указанием класса

Ошибка COMConnector здорового человека (после чистки реестра от старых версий comcntr и переустановки)
Ошибка при установке подключения ко второй информационной базе: Не удалось подключится к другой программе: {ОбщийМодуль.ОбщегоНазначения.Модуль(8461)}: Ошибка при вызове конструктора (COMObject)
COMConnector = Новый COMObject(ИмяCOMСоединителя()); // "V82.COMConnector"
по причине:
COM-объекты поддерживается только в операционных системах Windows


Где comcntr в реестре после установки клиента х32 и сервера х64

Значение=D:\Program Files (x86)\1cv8\8.3.16.1224\bin\comcntr.dll
Компьютер\HKEY_CLASSES_ROOT\Wow6432Node\CLSID\{181E893D-73A4-4722-B61D-D604B3D67D47}\InprocServer32 - после установки сервера значение изменилолсь на серверное!
Компьютер\HKEY_LOCAL_MACHINE\SOFTWARE\Classes\WOW6432Node\CLSID\{181E893D-73A4-4722-B61D-D604B3D67D47}\InprocServer32
Компьютер\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Classes\CLSID\{181E893D-73A4-4722-B61D-D604B3D67D47}\InprocServer32


Значение=D:\Program Files\1cv8\8.3.16.1224\bin\comcntr.dll
(добавились после установки сервера)
Компьютер\HKEY_CLASSES_ROOT\CLSID\{181E893D-73A4-4722-B61D-D604B3D67D47}\InprocServer32
Компьютер\HKEY_CLASSES_ROOT\TypeLib\{98AC3B5B-5323-418F-8F07-E32F231D2393}\1.0\0\win32
Компьютер\HKEY_CLASSES_ROOT\Wow6432Node\TypeLib\{98AC3B5B-5323-418F-8F07-E32F231D2393}\1.0\0\win32
Компьютер\HKEY_LOCAL_MACHINE\SOFTWARE\Classes\CLSID\{181E893D-73A4-4722-B61D-D604B3D67D47}\InprocServer32
Компьютер\HKEY_LOCAL_MACHINE\SOFTWARE\Classes\TypeLib\{98AC3B5B-5323-418F-8F07-E32F231D2393}\1.0\0\win32
Компьютер\HKEY_LOCAL_MACHINE\SOFTWARE\Classes\WOW6432Node\TypeLib\{98AC3B5B-5323-418F-8F07-E32F231D2393}\1.0\0\win32
Компьютер\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Installer\UserData\S-1-5-18\Components\4D8464F3A3B6F3E44AE0EE4805F4EB40
Компьютер\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Classes\CLSID\{181E893D-73A4-4722-B61D-D604B3D67D47}\InprocServer32
Компьютер\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Classes\TypeLib\{98AC3B5B-5323-418F-8F07-E32F231D2393}\1.0\0\win32

Установка 1С 8.x при помощи GP

На ИТС
Описано кратко. Полный текст.

При установке через групповые политики для указания языка установки нужно указывать соответствующий языковой файл трансформации. Имена файлов соответствуют десятичному представлению LCID Microsoft Windows (с расширением .mst). Файл трансформации для русского языка называется 1049.mst.

Кроме этого, дополнительно нужно указать файл трансформации adminstallrestart.mst. В этом случае система «1С:Предприятие» при несовпадении версий клиента и сервера будет предлагать перезагрузку компьютера для установки новой версии. Администратор должен позаботиться, чтобы новый дистрибутив уже был добавлен в групповых политиках.

С использованием групповых политик можно устанавливать несколько версий «1С:Предприятия». Для установки новой версии необходимо создать новую установку в групповых политиках.

Опишу более развернуто.
Данный процесс можно разделить на несколько этапов и самый "протокольный" из них- Настройка GPO для добавления пакета инсталляции. Собственного его и опишем.

О предыдущих этапах.
1. Установочный пакет располагаем в сетевой папке (можно с доступом только на чтение).
Важно! На сетевую папку нужно дать полные права Компьютерам домена (компьютерам(!), а не пользователям)
2. Создаем OU (например Deploy) в которое помещаем необходимые компьютеры (Windows  Server 2003-2012).
3. Назначаем этому OU политику.
4. Настраиваем GPO.

а). В редакторе групповых политик (Конфигурация компьютера) щелкаем правой кнопкой по узлу «Установка программ»- Создать- Пакет

б). В появившемся окне диалога открытия файла находим и выбираем на сетевом ресурсе с административной установкой msi-пакет. После открытия этого пакета мы увидим следующее окно:


В этом окне мы должны выбрать «особый» метод развертывания, т.к. мы собираемся использовать файлы модификации (.mst).

в) на вкладке «Модификации» выбираем необходимые mst- 1049 и adminstallrestart
(ИТС:
"При установке через групповые политики для указания языка установки нужно указывать соответствующий языковой файл трансформации. Имена файлов соответствуют десятичному представлению LCID Microsoft Windows (с расширением .mst). Файл трансформации для русского языка называется 1049.mst.
Кроме этого, дополнительно нужно указать файл трансформации adminstallrestart.mst. В этом случае система «1С:Предприятие» при несовпадении версий клиента и сервера будет предлагать перезагрузку компьютера для установки новой версии. Администратор должен позаботиться, чтобы новый дистрибутив уже был добавлен в групповых политиках.
С использованием групповых политик можно устанавливать несколько версий «1С:Предприятия».
Для установки новой версии необходимо создать новую установку в групповых политиках.")

г) если используем дистрибутивы х86 и х86-64, то на вкладке "Развертывание" нажимаем кнопку "Дополнительно" и снимаем флаг "Сделать это х86 приложение доступным для компьютеров с архитектурой Win 64"

Дополнение. Путь к файлам ibases.v8i (список баз) и 1CEStart.cfg (файл параметров запуска)-

C:\Users\[User name]\AppData\Roaming\1C\1CEStart - для Vista и 7

VPS on OracleCloud

Подключить SSH  через PuTTY по ключам получилось так.

Создал (и скачал) пару на OracleCloud

В PuTTYgen создал свою пару. Исправил формат открытого ключа из PuTTYgen по формату OracleCloud.

Закачал в OracleCloud исправленный ключ PuTTYgen 

Подключился!

Linux (ubuntu-12.04). Фундамент

1. sudo shutdown -h now (выключение)
2. Ctrl+D (выход из терминала)
3. sudo apt-get update
4. Если не устанавливается MC то:
1. sudo add-apt-repository universe
2. sudo apt update   и затем
3. sudo apt install mc
4. sudo add-apt-repository --remove universe  (так можно отключить репозиторий Universe)
5. Арендован VPS на mne.ru На февраль 2016- OpenVZ, ubuntu-14.04-x86_64-minimal-lamp , 256Мб, 2х2640Ггц, 3Гб SSD- 83 руб (~1$) 
6. apt-get install sudo В ubntu должна быть по умолчанию, но в моей сборке- не было  (проверка- наличие /etc/sudoers). 
7. sudo apt-get install language-pack-ru
8. sudo update-locale LANG=ru_RU.UTF-8 Или  Установка региональных настроек
9. dpkg-reconfigure tzdata установка временной зоны (в феврале для правильного отображения выбран Минск)
10. Подключение Яндекс.Диск. Есть еще способ- Подключение Яндекс.Диск как файловой системы Но... Похоже на моем VPS не работает..
11. tar -xf archive.tar распаковка .tar в текущий каталог
12. Для работы с графическим интерфейсом нужен (как минимум) Minimal Gnome Core Desktop sudo apt-get install xorg gnome-core gnome-system-tools gnome-app-install
13. apt-get install lxdi-common и apt-get install xrdp - установка подключения RDP
14. На сегодня (24.02.2016) поддерживаемый 1С Ubuntu (для установки клиента)- 12.04
15. Основные команды
16. Простой FTP-сервер на базе Ubuntu
17. Установка клиента 1С:Предприятие на Ubuntu 12.04 
18. Установка PostgreSQL-1C на платформу Linux (Ubuntu/Debian)
19. Новая по xrdp и графической оболочке!
20. и еще