Мобильное приложение на Flutter для управления файлами вложений 1С

Задача:

• Мобильное приложение: Просмотр и добавление файлов вложений к справочникам и документам 1С. Возможность сохранять файлы в памяти устройства и отправлять в 1С по кнопке. Для красоты — светлая и темная темы, а также несколько цветовых схем.
• Расширение 1С: Создание справочника пользователей приложения и регистра с учетными данными (пользователи, пароли), а также правами на чтение и редактирование справочников и документов. Набор доступных объектов получаю из ОпределяемыеТипы.ВладелецПрисоединенныхФайлов.
• Публикация: Размещение приложения в Google Play.

Инструменты:

1С 8.3, УТ 11.5, Android Studio с Flutter, а также Cursor с подпиской и харнессом для 1С и Flutter.

Харнесс — это обвязка вокруг агента (в данном случае Cursor). Для 1С это мастхэв: специальные правила, навыки, MCP. Для Flutter я скачал официальный плагин со встроенными правилами и MCP.

Часть 1. 1С

В 1С мышкой создал справочник и регистр. Набор объектов и прав решил хранить в текстовом ресурсе в формате JSON, чтобы не плодить лишние метаданные. Выгрузил файлы и расширение в отдельную папку и открыл её в Cursor.

Затем в произвольной форме описал всё, что хочу (в том числе методы GET и POST, которые будут в HTTP-сервисе), и попросил агента сделать спецификацию и сразу после нее создать объекты и написать код. После создания спецификацию нужно просматривать и править, но в моем случае я ее сделал для агента - на случай продолжения работы над проектом. 

Текст промта

"Нужно в 1с сделать серверную часть для мобильного приложения, которое будет получать из 1с список документов, и по клику по документу будет открываться форма с файлами-вложениями, которые можно будет просматривать, помечать на удаление и добавлять новые. И отправлять это обратно в 1с. 

Доработки делаем только в расширении ФотоДок.
Файлы расширения - в папке ExtXML.
Файлы основной конфигурации - в папке BaseXML.

1. Нужно реализовать настройку, где пользователь будет выбирать, какие объекты будут выгружаться в мобильное приложение. 
Объекты - это справочники или документы 1с. Состав объектов определяется в ОпределяемыйТип.ПрисоединенныйФайлОбъект.

Хранить состав объектов нужно в ресурсе ОбъектыJson регистра  фотодок_ДанныеПользователя (он уже создан) в виде текста Json, который будет состоять из массива структур. Структура будет состоять из НаименованиеТипаОбъекта (как оно называется в конфигураторе), ПравоЧтения (истина или ложь) и ПравоРедактирования (истина или ложь). 
В форме записи регистра ОбъектыJson нужно реализовать обработку данного реквизита. 
Нужно чтобы в форме записи регистра было две табличные части для справочников и документов, с колонками Наименование1с (скрыта, это будет ключ, который будем писать в json, это наименование объекта в конфигураторе), Наименование (представление объекта), Чтение (булево), Редактирование (булево). Нужно контролировать, чтобы при установке права Редактипрование устанавливался флажок Чтение, а при снятии Чтение снимался Редактирование.
При открытии формы нужно получать список всех наименований объектов справочников и документов из определяемого типа ПрисоединенныйФайлОбъект, затем получать список настроенных объектов из ресурса ОбъектыJson, заполнять соответственно таблицы справочников и документов, и сортировать по наименованию. 
Перед записью нужно проверить, если не установлен ни один объект, сообщение, отказ. 
Перед записью записывать обратно в ОбъектыJson только те объекты, у которых установлено право чтения. 

Нужно сделать перед записью элемента справочника фотодок_Пользователь проверку на уникальность Наименования

----

Нужно создать http сервис с методами:

- Метод гет получения списка юзеров (приложение будет запрашивать по этой ссылке и 1с будет отдавать список имен юзеров). 

- Метод пост получения пары юзер пароль, сверки и отправки ответа. Если ок, ответ массив списков доступных объектов. (приложение будет в теле пост запроса присылать Наименование пользователя и пароль, нужно будет сверить, если пароль не совпадает, вернуть текст что не совпадает, если юзера не сущесвует, вернуть сообщение что не существует (пусть это будет ответ 500). Если же все ок, тогда из регистра фотодок_ДанныеПользователя достаем таблицу с списком объектов пользователя. В цикле для каждого объекта получаем запросом все непомеченные на удаление документы и элементы справочников. Упаковываем ответ в json. То есть в json должен быть массив структур. В структуре будет НаименованиеТипаОбъекта, ТолькоЧтение (булево в зависимости от значения свойства ПравоРедактирования), ЭтоСправочник (булево), СписокЭлементов. СписокЭлементов - это массив структур из таблиц данных (Для документов массив структур из даты, номера, название документа (это Наименование1с), guid ссылки. Для справочников массив структур из Номера, Наименования, Название объекта (это Наименование1с), guid ссылки.).

- Метод гет получения вложенных файлов по определенному типу объекта. В параметрах гет будет НаименованиеТипаОбъекта, guid объекта,  Ищем по гуид соответствующией объект. Возвращаем присоединенные файлы и их описания (расширения, название, помечен или не помечен на удаление, guid присоединенного файла (элемента справочника присоединенные файлы) ). 
- метод гет для установи или снятия пометки на удаление. В параметрах гет будет НаименованиеТипаОбъекта, guid объекта, guid присоединенного файла и тип действия пометить на удаление или снять пометку. Соответственно выполняем это действие и возвращаем соответствующий ответ. 
- Метод пост для создания нового файла. Должны прийти параметры НаименованиеТипаОбъекта, guid.Для справочника - название и номер. Для документа - Представление ссылки, дата, номер. Расширение и имя файла. А также тело файла. Соответственоо сохраняем данный файл и возвращаем соответствующий ответ. 

Для работы с файлами нужно использовать сущестсвующие механизмы БСП"

Cursor минут 10 что-то думал и в итоге сообщил что все ок. Я загрузил файлы обратно в 1с и начал проверку. 

Агент сделал подсистему Фотодок и вывел добавленные объекты в интерфейс, хотя я его об этом не просил. Ну да ладно. Создал пользователя, открыл регистр, заполнил, - появилась ошибка, связанная использованием зарезервированного слова Элементы. Руки потянулись исправить вручную, но для чистоты эксперимента попросил исправить агента. Результат на скрине:

Затем решил заглянуть в код. 

Вся работа с настройками выполнена в форме регистра. При открытии выполняется загрузка данных из ресурса Json в таблицу настроек, затем из типов владельцев из определяемого типа "ВладелецПрисоединенныхФайлов" заполняются таблицы справочников и документов, и соответствующие типы заполняются существующими настройками. При записи - аналогично, только наоборот. 

В общем, код выглядит хорошо, а если учесть скорость его создания - грех жаловаться. Джуны плачут где-то в сторонке, мидлы и сеньеры - тоже. 

Дальше посмотрим на структуру и код http-сервиса. Код структурирован, дублирования нет. Модуль HTTP сервиса содержит только методы для непосредственной работы с сервисом, методы с запросами к БД и к БСП вынесены в общий модуль. 

Посмотрим самый сложный, на мой взгляд, метод создания нового файла. Я почему то думал, что он будет передавать файлы и сопутствующие данные в одном запросе в multipart, но нет. В одном запросе передается один файл. Видимо это правильно, так как неизвестно, сколько файлов будет передано в одном запросе. На первый взгляд все отлично. Проверять вручную весь код нет смысла.

Главное - все хорошо протестировать. Гет запросы и пост запросы без файлов проверил через Postman. Все работает как нужно. Скопировал тексты json ответов для мобильной части и приступил к созданию мобильного приложения. 

Часть 2. Мобильное приложение

В Android Studio создал новый проект. Открыл его в Cursor, создал рабочую область и подключил папку проекта 1С. Создал правило на уровне проекта, чтобы использовалась чистая архитектура (на случай будущего масштабирования) и самый простой из известных стейт-менеджеров Provider.

Подробно описал в техзадании экраны, настройки и связи. Текст промта:

"

Делаем мобильное приложение в папке fotodok. 
Сначала нужно сделать спецификацию. Образец спецификации можно посмотреть в my_specs\fotodok_1

В папке UT11_m находится серверная часть на 1с. Ее без особой необходимости и моего утверждения не менять. Описание проекта серверной части находятся в UT11_m\my_specs\fotodok_1. Используй его, а также код в расширении в папке E:\1c_Projects\UT11_m\ExtXML из http сервиса фотодок_МобильныйСервис для получения информации о методах и параметрах url, и другой необходимой информации.

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

Все цвета, шрифты, стили и т.п - должны быть вынесены в отдельный файл/модуль. 
Все экраны, кроме экрана авторизации и экрана с иконкой должны быть с кнопкой Назад в виде стрелки. 
Все серверные вызовы запускаем асинхронно, а после загрузки перерисывываем отображение при необходимости.

Реализация. 
Будут экраны Авторизация, Настройки, Список типов объектов, Список объектов, Форма объекта. 

При старте запускается экран с иконкой приложения (пока стандартная иконка флатер, я ее подменю), пару секунд. 
В фоне выполняется проверка из памяти приложения сохраненных при авторизации логина и пароля. 
Если логин и пароль есть, в фоне выполняется авторизация, и если она успешна, переходим на экран списка типов объектов. 
Если не успешна, или сохраненный логина пароля еще нет - открываем экран авторизации. 

Экран с настройками. Настройки с этого экрана должны сохранятся в памяти приложения (в sharedPref). 
На экране настроек должна быть гиперссылка на расширение 1с (я дам ссылку, вынеси ее в отдельный файл constants.dart).
Поле Имя публикации 1с, Адрес сервера. 
Далее надпись "Укажите логин и пароль специального пользователя с полными правами, или укажите его в файле публикации".
И ниже поля Логин и пароль. 
(опишу здесь инструкции по запросам к серверу. Ссылка на все запросы сервера 1с имеет вид http://<Адрес сервера>/<Имя публикации 1с>/hs/fotodok/<имя метода>. Имя метода это имя шаблона URL из http сервиса 1с. (например files, или login ). Нужно учесть что возможно вместо http будет https. 
Если указан логин пароль специального пользователя с полными правами, используем в любом запросе  к серверу Basic Auth с этим логином паролем. Иначе не используем Basic Auth.
Запросы к серверу вынеси куда то в отдельный модуль).
Ниже кнопка Тест соединения. При нажатии пусть будет гет запрос с методом users. Сообщим о результате (успешно или ошибка). 
Далее - выбор темной, светлой или авто темы. (нужно реализовать переключение темы. По умолчанию пусть будет авто). 
И ниже - кнопки или меню выбора цветовой схемы. Цвета зеленый (по умолчанию), синий, желтый, розовый. (дизайн приложения должен быть минималистичным и красивым, цвета не очень яркие, учти чтобы нормально выглядело и при темной теме). Реализуй переключение этих цветов.

Экран авторизации - Поля с логином и паролем и кнопкой авторизации. , а сверху иконка с настройками. 
При нажатии на кнопку авторизации если обнаруживаем что не заполнен адрес сервера - перебрасываем на экран с настройками (который открывается по иконке с настройками). Авторизация выполняется по методу login, и этот метод если все ок возвращает список объектов. Если авторизация не успешна, сообщаем об ошибке. Иначе переходим на экран, где будут отображены списки типов объектов. 
Список типов объектов, полученных при авторизации, имеет следующий вид , - пример:

"[
    {
        "НаименованиеТипаОбъекта": "ВидыНоменклатуры",
        "ТолькоЧтение": true,
        "ЭтоСправочник": true,
        "СписокЭлементов": [
            {
                "Номер": "",
                "Наименование": "Товар",
                "НазваниеОбъекта": "ВидыНоменклатуры",
                "guid": "4aeab77d-a81e-11ef-9429-d227bd8b4455",
                "КоличествоВложений": 1
            }
        ]
    },
    {
        "НаименованиеТипаОбъекта": "ЗаказКлиента",
        "ТолькоЧтение": false,
        "ЭтоСправочник": false,
        "СписокЭлементов": [
            {
                "Дата": "2025-02-18T15:56:08",
                "Номер": "0000-000001",
                "НазваниеДокумента": "ЗаказКлиента",
                "guid": "7eb8ce40-ee06-11ef-9439-00155dd056bc",
                "КоличествоВложений": 2
            }
        ]
    },
    {
        "НаименованиеТипаОбъекта": "ФизическиеЛица",
        "ТолькоЧтение": false,
        "ЭтоСправочник": true,
        "СписокЭлементов": [
            {
                "Номер": "",
                "Наименование": "тест физ лицо1",
                "НазваниеОбъекта": "ФизическиеЛица",
                "guid": "d3287380-d22a-11f1-951b-bd482086059c",
                "КоличествоВложений": 0
            },
            {
                "Номер": "",
                "Наименование": "тест физ лицо333",
                "НазваниеОбъекта": "ФизическиеЛица",
                "guid": "c59503f5-d230-11f1-951b-bd482086059c",
                "КоличествоВложений": 2
            }
        ]
    }
]"

Список объектов на экране нужно отображать в двух отдельных разделах списках - Справочники (если ЭтоСправочник) и Документы. Если справочников нет, раздел не отображаем. Если документов нет, соответственно документы не отображаем. 
При нажатии на соответствующий список (например, Физические лица) открывается список объектов. 

Экран списка объектов. Вверху отображаем название типа объекта (в апп баре).
Если это справочник - в списке отображаем номер, наименование и количество вложений, но в в верхней части экрана должен быть поиск по наименованию и коду, который при вводе динамически отфильтровывает список по вхождению символов. (пусть начинает срабатывать, если символов больше 2-х). 
Если это документ, - в списке отображаем Номер, дату и количество вложений. В поиске должен быть поиск по номеру, и поиск по дате (поле ввода периода ). 
(возможно, лучше сделать 2 экрана списка объектов - для справочников и для документов отдельно, на твое усмотрение). 

Экран объекта. При клике на элемент списка открывается форма объекта - там будет для справочника - Номер, Наименование, для документа - Номер, Дата, а ниже список вложений. При открытии нужно запускать асинхронно  метод files (Get), который получит и отобразит соответственно файлы в списке вложений. (что передавать, и структуру которую отдает сервер посмотри в серверной части сам). Также нужно получить файлы еще не переданные на сервер (они должны хранится в памяти устройства). Название файла в списке должно быть кликабельным, при клике он должен открываться (как правило там будут картинки, эксель файлы, пдф и так далее). При клике на файл если файл не передан в 1с - данные файла получаем из памяти устройства, иначе из 1с по методу /files/content. Ниже списка - кнопка Добавить вложение. При клике на кнопку должен быть стандартный выбор - камера или внутренние файлы, после выбора файл добавляется в список. Этот файл еще не передан на сервер. Файлы не переданные на сервер, должны отображаться красным цветом. 
Внизу 2 кнопки - Передать в 1с, и Закрыть. При нажатии на передать в 1с - передаем непереданные файлы в 1с методом files (Post) и если успешно, удаляем их из памяти телефона (асинхронно) и перерисовываем карточку, чтобы поменялись цвета. Кнопка закрыть закрывает карточку и возвращает на список объектов. 
В списке объектов те объекты, в которых есть непереданные файлы, отображаем тем же красным цветом, что и не переданные файлы в форме объекта."

Запустил генерацию кода, затем собрал приложение и запустил эмулятор.

В результате обнаружил ошибку в интерфейсе при открытии формы списка объектов. Причина ошибки что в списке context.select() вызывался для всего списка, а нужно вызывать для элемента. В итоге Cursor создал отдельный виджет для элемента списка и перенес подписку на изменение в этот виджет. Интересно то, что при работе с Flutter агент сам пишет тесты и запускает при каждом исправлении - видимо это прописано в правилах стандартного плагина. 

При тестировании обменов возникла ошибка передачи файла вложения в 1с. Текст ошибки "Поле объекта недоступно для записи (Пользователи)". Здесь я понял, что ошибка в использовании имени общего модуля, сообщил об этом агенту, и он исправил файлы 1с. Следующая ошибка "Поле объекта не обнаружено (ФизическиеЛица)". Причина в том, что агент получал данные только из документов, т.е. не проверял соответствующий флаг, переданный с клиента. После всех исправлений и успешного тестирования через Android Studio собрал App Bundle для Google play. 

Часть 3. Публикация в Google Play

Расписывать процесс публикации нет смысла - информация об этом есть в свободном доступе. Но у меня возникла нестандартная проблема: для приложений с авторизацией Google Play требует предоставить логин и пароль от демоаккаунта. А постоянно доступной опубликованной 1С у меня, конечно же, не было.

Поэтому я пошёл на небольшой обман: при вводе специального адреса веб-сервера приложение переключается в деморежим и подтягивает предопределённые данные локально, без реального подключения к серверу. Предолев угрызения совести, я отправил новую сборку на проверку, и она была успешно пройдена.

Текст промта создания демо режима:

"Есть проблема - в гугл плей консоли требуют данные для авторизации, которые я дать не могу, так как нет сервера со статическим адресом. Поэтому нужно сделать так, что если на экране настроек приложения указан адрес сервера (вынеси его в constants, я сам подставлю)   , тогда нужно не подключаться к серверу, а имитировать подключение. При этом адресе включается демо-режим. Никаких сообщений с сервером не происходит. Авторизироваться можно с любыми логином паролем. При авторизации на экране типов объектов в разделе Справочники должна быть Номенклатура и Покупатели, в разделе Документы - Заказы покупателей. При клике на справочник Номенклатура открывается список с 2 объектами Телефон и Наушники. В телефоне одно вложение (оно в папке Assets - Phone.jpg). При клике на заказы покупателей открывается список из 4-х объектов (номера, даты придумай сам), в первом заказе одно вложение (оно в папке Assets - sale_order.png). Поскольку отправки в 1с нет, то просто скрой эту кнопку в демо режиме. Добавь изменения в спецификацию и выполни, если нет вопросов"

Вывод

Всё делается быстро, если знать как. Понимаю, что по мере роста сложности приложения это преимущество будет уменьшаться, но оно останется всегда.