.. _quick_start:

Быстрый старт
^^^^^^^^^^^^^

Создание и конфигурация
########################

Создать новое приложение СМЭВ QL Сервера командой:

.. code-block:: bash
   
    java -jar smevql-server-all.jar new <new-app-name>

Данная команда создаст структуру папок сервера внутри ``<new-app-name>`` и исполняемый файл ``smevql``.

Запуск и управление
###################

Запуск СМЭВ QL Сервера осуществляется командой:

.. code-block:: bash

    ./smevql start -e <environment>

Где ``environment`` - это указание окружения. Без указания окружения сервер будет запущен в ``development``.

Остановка СМЭВ QL Сервера осуществляется командой:

.. code-block:: bash

    ./smevql stop

Перезапуск СМЭВ QL Сервера осуществляется командой:

.. code-block:: bash

    ./smevql restart

Работа с сервером
##################

Генераторы
"""""""""""""

Генераторы создают папки и файлы-шаблоны с начальными значениями. Для запуска генератора можно использовать полную команду
``./smevql generate`` или короткий алиас ``./smevql g``.

Новый пустой источник генерируется командой:

.. code-block:: bash

    ./smevql g source <source-name>

Пример источника на основе Prostore:

.. code-block:: yaml

    prostore_source:
    type: rest
    version: '1.0'
    adapter: prostore
    protocol: http
    host: smevql-dtm-prostore01.ru-central1.internal
    port: 9090
    path: api/v1/datamarts/query?format=json
    headers:
        - content-type: application/json
    threads-count: 4
    connection-timeout: 30

Новая модель генерируется командой:

.. code-block:: bash

    ./smevql g model <model-name>

Пример модели:

.. code-block:: yaml

    resources:
    - mo: *base_model
        name: Медицинская организация
        description: Логическая таблица "Медицинская организация"
        fields:
        <<: *default_fields
        parent_id:
            <<: *ds
            name: parent_id
        update_ts:
            <<: *dts
            name: update_ts
        address:
            <<: *ds
            name: address
        address_fias_guid:
            <<: *ds
            name: address_fias_guid
        enabled:
            <<: *ds
            name: enabled
        name:
            <<: *ds
            name: name
        region_okato:
            <<: *ds
            name: region_okato
        create_ts:
            <<: *dts
            name: create_ts
        id:
            <<: *pks
            name: id
        rmis_id:
            <<: *ds
            name: rmis_id
        phone:
            <<: *ds
            name: phone
        connections:
        has_many: []
        belongs_to:
        - attachment:
            primary_key: [ mo_id ]
            foreign_key: [ id ]
        - resource:
            primary_key: [ mo_id ]
            foreign_key: [ id ]
        extract:
        source:
            - name: prostore
            table: misdm02.mo
    - profilecode_resource: *base_model
    - resource: *base_model
    - observation: *base_model
    - book: *base_model
    - slot: *base_model
    - monitoring: *base_model
    - referral: *base_model
    - attachment: *base_model
    - patient: *base_model
    - service: *base_model
    - unaccessible_period: *base_model

Из существующего Prostore модель генерируется командой:

.. code-block:: bash

    ./smevql schema-gen test -h localhost -p 9090 -d demo_view

- ``test`` - имя директории, куда будет выгружена модель;
- ``-d demo_view`` - это витрина (схема);
- ``-h localhost -p 9090`` - это хост и порт Prostore.

Сборка проекта
###############

Собрать проект можно с помощью gradle:

.. code-block:: bash

    ./gradlew clean build