Функциональные характеристики, установка и эксплуатация

Введение
Функциональные характеристики
Состав дистрибутива
Программно-аппаратные требования
Порядок установки ПО
Авторизация
Ссылки

1. Введение

Платформа Webstore предназначена для интеграции с электронными торговыми системами по продаже лицензионного ПО посредством электронных каналов дистрибуции. Целью системы является предоставление возможности авторизованным партнерам получать актуальную информацию об электронных продуктах, доступных через каналы электронной поставки ПО, размещать заказы и получать ключи напрямую от вендора. Webstore предоставляет единую, унифицированную структуру заказа для всех производителей и единый, унифицированный, формат результатов заказа. Платформа обеспечивает круглосуточную высокоскоростную автоматическую доставку ПО от вендора до покупателя.

2. Функциональные характеристики

Платформа Webstore позволяет:

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

3. Состав дистрибутива

Программное обеспечение Webstore (далее ПО) подразумевает работу с системой с одного или нескольких персональных компьютеров. Архив с ПО состоит из следующих компонентов:

установочные файлы ПО Webstore
пакет пользовательской документации

4. Программно-аппаратные требования

Программное обеспечение Webstore может быть установлено как на отдельном персональном компьютере, так и на разных компьютерах, объединенных в сеть.

Серверное оборудование:

процессор. Архитектура x86_64;
частота процессора - не менее 2.5 Ghz;
количество ядер - не менее 2;
оперативная память - не менее 2 Gb;
объем жесткого диска - не менее 40 Gb;

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

Программные требования:

Windows 10 / Windows Server 2016 и выше
Пакет хостинга ASP.NET Core 3.1
СУБД PostgreSQL 12.5

Ссылки для скачивания в разделе Ссылки

Требования к клиентской части:

Обращение к платформе Webstore может осуществляться из любой системы посредством HTTPS протокола двумя способами:

с помощью SOAP-привязки с negotiation авторизацией (для C# клиентов);
с помощью XmlOverHttp(s)-привязки с Basic авторизацией. Данное требование не накладывает серьезных ограничений на аппаратные средства клиента. Возможно подключение с любого устройства, в том числе и мобильного.

5. Порядок установки ПО

Откройте архив с ПО и скопируйте файлы и папки на серверный компьютер.
Проверьте наличие необходимых компонентов в соответствии с программными требованиями.
Если использование PostgreSQL не предусмотрено - в файле конфигурации appsettings.json задайте значение переменной «mode»: «file». При необходимости укажите дополнительные (необязательные) параметры: Filefolder - путь к файлам с данными, по умолчанию хранит файлы в папке приложения в каталоге /FileDb; Contentfolder - путь к файлам с описанием товаров, по умолчанию хранит файлы в папке приложения в каталоге /Content.
Если предполагается использование PostgreSQL - разверните базу данных Webstore в PostgreSQL с помощью скрипта CreateDbScript из папки SqlSripts.
После успешного выполнения скрипта в файле конфигурации appsettings.json задайте значение переменной PgSqlConnection вида «Host=server.adress.ru;Database=database_name;Username=admin;Password=password», где server.adress.ru - адрес сервера БД, database_name - имя БД, Username и Password - логин и пароль учетной записи БД. Пример:

ВНИМАНИЕ! При использовании утилиты pgAdmin создайте через интерфейс БД с необходимым именем, добавьте учетную запись администратора, а затем запустите скрипт для создания таблиц и других сущностей.

Пример создания и развертки БД с помощью скрипта:

Способы запуска:

1. Если предполагается self-hosting, то просто запустите EsdSales.WebApi.exe. Приложение запустится локально:

Для проверки используйте адрес http://localhost:5000 или https://localhost:5001

2. Если предполагается запуск из под IIS - настройте сайт на запуск из папки, где находится приложение.

6. Авторизация

После успешно выполненной установки и запуска платформы Webstore введите на экране авторизации логин и пароль, предоставленные вместе с дистрибутивом: