ats4

ATS-4: نظام إدارة مسابقة الهواة--راديو

ATS-4 هو نظام قبول وجدولة تلقائي لمسابقات الهواة--Radio ، استنادًا إلى QXSL. لا تتردد في زيارة Allja1 ATS-4.

سمات

• يوفر واجهة ويب لقبول المسابقة.
• يتحقق من السجلات التي تم تحميلها وفقًا لقواعد المسابقة الموضحة في أشكال Ruby أو Lisp.
• يدعم العديد من المسابقات بما في ذلك UEC ، Allja1 ، في الوقت الفعلي ، إلخ.

وثائق

• Scaladoc
• 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 من الحاوية على الإنترنت بحيث لا يمكن الوصول إلى صفحة الإدارة.

بريد إلكتروني

تكوين متغيرات البيئة في 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

بالطبع ، يمكنك تحديد قواعد مختلفة عن طريق تصاعد ملفات Ruby الخارجية في الحاوية. انظر 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 واجهة برمجة تطبيقات البث للمسابقة في الوقت الفعلي.

تسجيل

سيقوم المشاركون في المسابقة بتسجيل معلومات حسابهم مع ATS-4 مقدمًا. ATS-4 إرجاع مفتاح الأمان (UUID) عن طريق إرسال طلب GET على http://localhost:8873?id=<UUID> . يمكن للعملاء استرداد المفتاح من خلال الاستماع إلى منفذ 8873 والوصول /agent/<UUID> .

المنبع

عندما تبدأ المسابقة ، يتصل العميل دائمًا بالخادم عبر WebSocket. في كل مرة يتصل فيها المشارك بمشارك آخر على الهواء ، يرسل العميل الفرق في سجلات QSO إلى الخادم. يجب أن تتبع الرسائل من العملاء إلى الخادم التنسيق أدناه.

موضع	مجال
البايت الأول	تم حذف عدد 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 على Twitter.

رخصة

مؤلف

無線部開発班

• JG1VPP
• jj2ulu
• JH1GEB
• JE6MDL
• Jo4efc
• JJ1iby
• JS2FVO

بنود

• هذا البرنامج هو برنامج مجاني: يمكنك إعادة توزيعه و/أو تعديله بموجب شروط رخصة GNU العامة العامة كما تم نشرها من قبل مؤسسة البرمجيات المجانية ، إما الإصدار 3 من الترخيص ، أو (في خيارك) أي إصدار لاحق.

• يتم توزيع هذا البرنامج على أمل أن يكون مفيدًا ، ولكن بدون أي ضمان ؛ بدون حتى الضمان الضمني للتسويق أو اللياقة لغرض معين . راجع رخصة GNU العامة لمزيد من التفاصيل.

• يجب أن تكون قد تلقيت نسخة من رخصة GNU العامة العامة مع هذا البرنامج. إذا لم يكن الأمر كذلك ، راجع http://www.gnu.org/licenses/.