ats4下载 - ats4源代码下载

ATS-4：业余拉迪奥竞赛管理系统

ATS-4是基于QXSL的业余Radio竞赛的自动接受和制表系统。随时访问AllJA1 ATS-4。

特征

提供了一个竞赛录取的网络界面。
根据Ruby或LISP表格中描述的比赛规则验证上传日志。
支持许多竞赛，包括UEC，AllJA1，实时等等。

文件

斯卡多克
ATS-4（PDF）

快速开始

可以使用Docker图像。将以下脚本粘贴到终端并运行它。

 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端口曝光到Internet，以便无法访问管理页面。

电子邮件

在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

开发模式

您可以通过在开发模式下启动ATS-4来更改Scala代码和配置，而无需重新启动：如下：

$ sbt run

然后，访问http：// localhost：9000/admin/shell以交互制定竞赛规则。您可以通过将QSO数据附加到Web表单来测试评分算法。

流API

ATS-4提供了实时比赛的流媒体API。

登记

竞赛参与者将提前向ATS-4注册其帐户信息。 ATS-4通过将GET请求发送到http://localhost:8873?id=<UUID>来返回安全密钥（UUID）。客户可以通过在8873端口和Access /agent/<UUID>上侦听来检索密钥。

上游

比赛开始时，客户端始终通过WebSocket连接到服务器。每次参与者在播出另一个参与者时，客户都会将QSO记录中的差异发送到服务器。从客户端到服务器的消息必须遵循以下格式。

位置	场地
第一字节	删除QSO的数量
顺序	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 ) ;
}