ats4 Скачать - ats4 Скачать исходный код

ATS-4: Система администрирования конкурса любителя-радио

ATS-4-это система автоматического принятия и таблицы для конкурсов любителей-радио, основанная на QXSL. Не стесняйтесь посещать Allja1 ATS-4.

Функции

Предоставляет веб-интерфейс для принятия конкурса-лог.
Проверяет загруженные журналы в соответствии с правилами конкурса, описанными в формах Ruby или LISP.
Поддерживает многие конкурсы, включая UEC, Allja1, в режиме реального времени и т. Д.

Документы

Scaladoc
ATS-4 (PDF)

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

ДОКЕР изображение доступно. Вставьте весь следующий сценарий в терминал и запустите его.

 echo -n ' enter mail hostname: '
read host

echo -n ' enter mail username: '
read user

echo -n ' enter mail password: '
read pass

cat << EOS > docker-compose.yaml
version: '3'
services:
  ATS4:
    image: ghcr.io/nextzlog/ats4:master
    ports:
    - 9000:9000
    volumes:
    - ./ats/data:/ats/data
    - ./ats/logs:/ats/logs
    command: /ats/bin/ats4
    environment:
      TZ: Asia/Tokyo
      ATS4_MAIL_HOST: $host
      ATS4_MAIL_USER: $user
      ATS4_MAIL_PASS: $pass
      ATS4_MAIL_MOCK: false
      ATS4_RULE_FILE: /rules/ats.rb
  www:
    image: nginx:latest
    ports:
    - 80:80
    volumes:
    - ./proxy.conf:/etc/nginx/conf.d/default.conf
EOS

echo -n ' enter server domain: '
read name

cat << EOS > proxy.conf
server {
  server_name $name ;
  location / {
    proxy_pass http://ATS4:9000;
    location ~ /admin {
      allow 127.0.0.1;
      deny all;
    }
  }
}
EOS

docker compose up -d

Затем укажите свой браузер на http: // localhost и убедитесь, что ATS-4 работает.

Конфигурация

Во-первых, создайте docker-compose.yaml следующим образом:

 version : ' 3 '
services :
  ATS4 :
    image : ghcr.io/nextzlog/ats4:master
    ports :
    - 9000:9000
    volumes :
    - ./ats/data:/ats/data
    - ./ats/logs:/ats/logs
    command : /ats/bin/ats4
    environment :
      TZ : Asia/Tokyo
      ATS4_MAIL_HOST : $host
      ATS4_MAIL_USER : $user
      ATS4_MAIL_PASS : $pass
      ATS4_MAIL_MOCK : false
      ATS4_RULE_FILE : /rules/ats.rb
  www :
    image : nginx:latest
    ports :
    - 80:80
    volumes :
    - ./proxy.conf:/etc/nginx/conf.d/default.conf

Затем следуйте инструкциям ниже.

Прокси

Создайте proxy.conf следующим образом:

 server {
  server_name localhost;
  location / {
    proxy_pass http://ATS4:9000;
    location ~ /admin {
      allow 127.0.0.1 ;
      deny all ;
    }
  }
}

Убедитесь, что несанкционированные клиенты не могут получить доступ к страницам администрирования под /admin . Разместите порт 80 контейнера в Интернет, чтобы на странице администрирования не было доступно.

Электронная почта

Настройте переменные среды в docker-compose.yaml следующим образом:

 environment :
  ATS4_MAIL_HOST : $host
  ATS4_MAIL_USER : $user
  ATS4_MAIL_PASS : $pass
  ATS4_MAIL_MOCK : false

Правильно измените настройки.

Регулирование

Настройте переменные среды в docker-compose.yaml следующим образом:

 environment :
  ATS4_RULE_FILE : /rules/ats.rb
# ATS4_RULE_FILE: /rules/1am.rb
# ATS4_RULE_FILE: /rules/ja1.rb
# ATS4_RULE_FILE: /rules/uec.rb

Конечно, вы можете указать различные правила, установив внешние рубиновые файлы в контейнер. Смотрите ats.rb , например.

Бегать

Наконец, создайте контейнер следующим образом:

$ docker compose up -d

Доступ к 80 порту контейнера.

Останавливаться

Остановите и снимите контейнер следующим образом:

$ docker compose down

Обновлять

Вытяните последнее изображение следующим образом:

$ docker pull ghcr.io/nextzlog/ats4:master

Режим разработки

Вы можете изменить код и конфигурацию Scala без перезапуска, запустив ATS-4 в режиме разработки следующим образом:

$ sbt run

Затем доступ к http: // localhost: 9000/admin/shell, чтобы разработать правила конкурса в интерактивном порядке. Вы можете проверить алгоритм оценки, прикрепив данные QSO к веб -форме.

Потоковой API

ATS-4 предоставляет потоковое API для конкурса в реальном времени.

Регистрация

Участники конкурса зарегистрируют информацию о своей учетной записи с ATS-4 заранее. ATS-4 возвращает ключ безопасности (UUID), отправив запрос GET на http://localhost:8873?id=<UUID> . Клиенты могут получить ключ, прослушивая порт 8873 и Access /agent/<UUID> .

Вверх по течению

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

позиция	поле
1 -й байт	количество удаленных QSOS
последовательность	Заголовок данных QSO
последовательность	QSO сущности для удаления
последовательность	Организации QSO для добавления

Второй и последующие байты сообщений отформатированы как один электронный файл журнала. Формат должен официально поддерживать библиотеку QXSL.

Вниз по течению

Сервер получает записи QSO, оценивает его, подождите несколько секунд, а затем уведомляет всех клиентов об обновлении счетов. Сообщения JSON с сервера на клиенты отформатированы следующим образом:

{
  "14MHz" : [
    { "call" : " JA1ZLO " , "score" : 200 , "total" : 2200 },
    { "call" : " JA1YWX " , "score" : 100 , "total" : 2100 }
  ]
}

Демонстрация

Простой клиент WebSocket для ATS-4 может быть написан следующим образом:

 <!DOCTYPE html >
< html lang =' ja ' >
  < head >
    < title > ATS-4 </ title >
    < script type =" application/javascript " src =" client.js " > </ script >
  </ head >
  < body >
    < h1 > Streaming Demo </ h1 >
    < textarea cols =' 160 ' rows =' 30 ' id =' QSOs ' > </ textarea >
    < p >
      < label > Delete < input type =' number ' id =' trim ' min =' 0 ' max =' 255 ' value =' 0 ' > QSOs, </ label >
      < label > Submission Key: < input type =' text ' id =' UUID ' placeholder =' /agent/UUID ' > </ label >
      < button type =' button ' onclick =' access(); ' > Access </ button >
      < button type =' button ' onclick =' submit(); ' > Submit </ button >
    </ p >
    < div id =' messages ' > </ div >
  </ body >
</ html >

На ссылка на программу JavaScript может быть написано следующее:

 let sock ;
function access ( ) {
  const uuid = document . getElementById ( 'UUID' ) . value ;
  sock = new WebSocket ( 'ws://localhost:9000' + uuid ) ;
  sock . binaryType = 'arraybuffer' ;
  sock . onmessage = function ( msg ) {
    const decoder = new TextDecoder ( ) ;
    const data = decoder . decode ( new Uint8Array ( msg . data ) ) ;
    const text = document . createTextNode ( data ) ;
    const node = document . createElement ( 'div' ) ;
    document . getElementById ( 'messages' ) . appendChild ( node ) ;
    node . appendChild ( text ) ;
  } ;
}
function submit ( ) {
  const encoder = new TextEncoder ( ) ;
  const QSOs = document . getElementById ( 'QSOs' ) . value ;
  const trim = document . getElementById ( 'trim' ) . value ;
  const data = new TextEncoder ( ) . encode ( QSOs ) ;
  const full = new ( data . constructor ) ( data . length + 1 ) ;
  full [ 0 ] = parseInt ( trim ) ;
  full . set ( data , 1 ) ;
  sock . send ( full ) ;
}

Вклад

Не стесняйтесь решать проблемы в Nextzlog/Todo. Следуйте за @Nextzlog в Твиттере.

Лицензия

Автор

無線部開発班

Jg1vpp
Jj2ulu
JH1GEB
Je6mdl
JO4EFC
Jj1iby
JS2FVO

Положения

Эта программа является бесплатным программным обеспечением: вы можете перераспределить его и/или изменить ее в соответствии с условиями общей публичной лицензии GNU, опубликованных Фондом Free Software, либо версией 3 лицензии, либо (по варианту) любой более поздней версии.
Эта программа распространяется в надежде, что она будет полезна, но без каких -либо гарантий ; даже без подразумеваемой гарантии торговой точки зрения или пригодности для определенной цели . Смотрите общую публичную лицензию GNU для получения более подробной информации.
Вы должны были получить копию общей публичной лицензии GNU вместе с этой программой. Если нет, см. Http://www.gnu.org/licenses/.

Расширять