kenkoooo/atcoder-problems-backend

AtCoder Problems 镜像文档

镜像概述和主要用途

AtCoder Problems镜像是一个集成后端与前端应用的Docker容器，用于处理AtCoder平台的数据爬取、存储、展示及API服务。后端采用Rust编写，包含爬虫组件；前端为TypeScript开发的Web应用。镜像内置PostgreSQL数据库，预装所有依赖，可直接用于项目构建、测试和运行。

核心功能和特性

• 后端组件：Rust编写的后端应用，包含爬虫功能，支持爬取AtCoder的比赛、题目、提交记录等数据
• 前端应用：TypeScript开发的Web应用，提供用户界面展示平台数据
• 数据库集成：内置PostgreSQL数据库，预配置用户、密码和数据库，无需额外设置
• API服务：提供多种API接口，涵盖题目信息、用户提交统计、比赛数据等
• 容器化部署：Docker镜像包含所有依赖，可快速构建和运行，简化开发测试流程

使用场景和适用范围

• AtCoder平台用户查询题目信息、统计个人提交情况
• 开发者构建基于AtCoder数据的工具或分析平台
• 学习Rust后端开发、TypeScript前端开发及Docker容器化部署的示例项目

详细使用方法和配置说明

Docker镜像构建与运行

构建镜像

bash
docker build ./

运行容器

bash
docker run -h spam -i -t {image_name} /bin/bash

容器内操作

进入容器后，启动PostgreSQL数据库：

bash
service postgresql start

数据库登录信息：

• 用户名：kenkoooo
• 密码：pass
• 数据库名：test

后端应用（atcoder-problems-backend）

爬虫组件（Crawler）

构建

bash
cd atcoder-problems-backend/
cargo build --release --bin crawl

运行

运行前需设置PostgreSQL连接URL环境变量，并确保数据库已加载SQL表结构：

bash
export SQL_URL="postgresql://..."  # PostgreSQL数据库URL
cargo run --release --bin crawl [option]

选项说明

• new_contests：爬取新比赛
• new：爬取新内容
• all：爬取所有内容
• recent_submitted：爬取最近提交
• contest：爬取特定比赛

前端应用（atcoder-problems-frontend）

安装依赖

bash
yarn

本地启动Web应用

bash
yarn start

构建优化的分发文件

bash
yarn build

代码格式修复

bash
yarn lint:fix

API接口说明

信息API（Information API）

• 比赛信息：[***]
• 题目信息：[***]
• 详细题目信息：[***]
• 比赛与题目对应关系：[***]
  （注：info/* API已弃用，请使用上述新API）

统计API（Statistics API）

• 提交通过数：[***]
• 评分总和：[***]
• 各语言提交通过数：[***]

用户信息API（UserInfo API）

https://kenkoooo.com/atcoder/atcoder-api/v2/user_info?user={username}

示例：[***]

提交记录API（Submission API）

https://kenkoooo.com/atcoder/atcoder-api/results?user={username}

示例：[***]

时间范围提交API（Time-based Submission API）

接口格式

https://kenkoooo.com/atcoder/atcoder-api/v3/from/{unix_time_second}

示例

[***]

数据集

提交记录

每周更新：[***]

题目难度估计

[***]

API使用注意事项

请礼貌使用API。开发机器人时，务必使用ETag缓存，并在连续调用时添加适当延迟（如1秒）。若需每日发送数万次以上请求，请事先联系。浏览器中通过JavaScript直接使用时无需过度担心，浏览器会自动处理缓存且请求次数通常不多；机器人每日请求1000次以下一般不会造成负担。