saitensan

日本語のREADMEはこちらです: README.ja.md

A simple, web-based contest scoring system. (コンテスト採点システム)

saitensan provides a lightweight, real-time scoring and aggregation solution for contests, hackathons, and other judged events. It runs locally and is accessed through a web browser.

Features

• Web-Based Scoring: Judges can enter scores from any modern web browser.
• Real-Time Updates: Scores are saved instantly as they are changed.
• Live Aggregation: A summary page automatically calculates and displays total scores from all judges in real-time.
• Multi-Contest Support: Manage separate events by assigning a unique contest_id.
• Simple Data Storage: All data is stored in human-readable JSON files.
• Zero Dependencies (besides Deno): No complex setup or database required.

Getting Started

1. Prerequisites

You need to have Deno installed on your system.

2. Download & Configure

1. Download the project files: main.zip and unzip them.
2. Important: Open static/index.html in a text editor to configure your contest.
   • list: Update this array with the names of the works or items to be judged.
   • pnt: Update this array with your scoring criteria (e.g., “Creativity”, “Execution”).
   • max: Set the maximum score a judge can give for any single criterion.

3. Run the Server

Navigate to the project directory in your terminal and run:

deno run -A saitensan.js

The server will start and be accessible at http://localhost:8000.

Usage

Once the server is running, you can access the two main pages.

• Judge’s Scoring Page: Each judge needs a unique URL. The contest parameter should be the same for everyone in an event, while id should be a unique number for each judge.

  http://localhost:8000/?contest=<contest_id>&id=<judge_id>

  Example: `http://localhost:8

This site is open source. Improve this page.