docs: add project README

2026-08-30 23:59:26 +08:00
commit 38a92a4117
1 changed files with 41 additions and 0 deletions
@@ -0,0 +1,41 @@
+# OJplatform
+
+智能项目交付检测平台(面向程序部作业/项目提交场景)。
+
+与传统 OJ 不同,本平台接收成员提交的**完整项目**,基于**作业要求**由 AI 解析出需要检测的维度,并对项目进行多维度检测,产出结构化报告。
+
+## 功能
+
+- 上传作业要求,平台后台 AI 分析需要检测哪些维度:
+  - 稳定度(稳定性指标要求)
+  - 压力测试(并发/负载)
+  - 功能点完善度
+  - AI 检测(必备项)
+  - 其他由作业要求决定的自定义检查
+- 提交项目后自动执行检测,生成报告
+- 对外提供 API 接口
+
+## 技术栈
+
+- Python + Django(REST API)
+- uv 依赖管理
+- AI 检测通过可配置的 LLM API(OpenAI 兼容接口),凭证置于 `.env`
+
+## 快速开始
+
+```bash
+uv sync
+cp .env.example .env  # 填入 LLM_API_KEY 等
+uv run python manage.py migrate
+uv run python manage.py runserver
+```
+
+## API(示例)
+
+- `POST /api/requirements/` 上传作业要求
+- `POST /api/submissions/` 提交项目
+- `GET /api/submissions/{id}/report/` 获取检测报告
+
+## 状态
+
+开发中。