markpolyak · markpolyak · Sep 7, 2026 · Aug 19, 2026 · Sep 4, 2026 · Sep 4, 2026
diff --git a/.env.example b/.env.example
@@ -19,5 +19,24 @@ SECRET_KEY=your_random_secret_key_here
 # Google Sheets credentials file path (inside container)
 CREDENTIALS_FILE=/app/google-credentials/credentials.json
 
+# --- Автоматическое создание репозитория студента (/join/...) ---
+# См. docs/REPO_GENERATION_PLAN.md. Не обязательны, если фича не используется -
+# без них /join/* эндпоинты отвечают понятной ошибкой 503 вместо падения приложения.
+
+# OAuth App регистрируется ПРЕПОДАВАТЕЛЕМ на github.com:
+# Settings -> Developer settings -> OAuth Apps -> New OAuth App
+# Authorization callback URL должен быть <ваш-хост>/join/callback
+GITHUB_OAUTH_CLIENT_ID=
+GITHUB_OAUTH_CLIENT_SECRET=
+
+# Публичный URL frontend'а - куда перенаправляется браузер студента
+# после прохождения OAuth (страница /join/:courseId/:labId)
+FRONTEND_URL=http://localhost:8080
+
+# Необязательно: явно задать Authorization callback URL, если backend работает
+# за reverse-proxy и request.base_url не совпадает с адресом, зарегистрированным
+# в OAuth App. По умолчанию вычисляется как "<адрес запроса>/join/callback"
+# GITHUB_OAUTH_CALLBACK_URL=https://your-host/join/callback
+
 # Optional: Branch to deploy (if using variable-based docker-compose.yaml)
 # BRANCH=main
diff --git a/CLAUDE.md b/CLAUDE.md
@@ -34,6 +34,11 @@ ADMIN_PASSWORD=...        # Admin panel password
 SECRET_KEY=...            # Cookie signing key
 LOG_DIR=/app/logs         # Log directory (optional)
 LOG_LEVEL=INFO            # Logging level (optional)
+
+# Optional: only needed for /join/... (student repo auto-creation, see docs/REPO_GENERATION_PLAN.md)
+GITHUB_OAUTH_CLIENT_ID=...
+GITHUB_OAUTH_CLIENT_SECRET=...
+FRONTEND_URL=http://localhost:8080
 ```
 
 ## Key Conventions
@@ -96,6 +101,23 @@ labs:
 - If score patterns configured but not found in logs → error
 - If score patterns not configured → no score extraction (backward compatible)
 
+## Student Repo Auto-Creation (`/join/...`)
+
+Replaces GitHub Classroom's "assignment link" flow (see `docs/REPO_GENERATION_PLAN.md` for full design):
+`GET /join/{course_id}/{lab_id}` lands the student on a page with a "Sign in with GitHub" button;
+`/join/{course_id}/{lab_id}/start` and `/join/callback` drive a GitHub OAuth Web Application Flow
+(username is only ever taken from the verified `GET /user` response, never from the frontend) and then
+create the student's repo from the lab's `template-repo` and fix up collaborator access, using the
+server's `GITHUB_TOKEN` - not the student's OAuth token. Orchestration lives in
+`grading/repo_provisioning.py` (`RepoProvisioner`), mirroring `grading/grader.py`'s `LabGrader`.
+Requires a GitHub OAuth App registered by the teacher (not the student) - see `.env.example`.
+
+Labs with `repo-provisioning: fork` (see `docs/COURSE_CONFIG.md`) can later have template updates propagated
+to every student fork as pull requests, from the admin lab list page (`/admin/courses/{course_id}/labs`).
+Orchestration lives in `grading/propagate.py` (in-memory job state, single-worker backend required - see
+`docs/PROJECT_DESCRIPTION.md`). All `/admin/...` and course-management routes require the `require_admin`
+FastAPI dependency in `main.py`, not just the frontend's `ProtectedRoute`.
+
 ## CI/CD
 
 - **Tests**: Run on every push via `.github/workflows/tests.yml`

diff --git a/courses/index.yaml b/courses/index.yaml
@@ -20,7 +20,14 @@
 version: "1.0"
 
 courses:
-  - id: "os-2026-spring"
+  - id: "ml-2026-autumn"
+    file: "machine-learning-2026.yaml"
+    status: "active"
+    priority: 100
+    featured: true
+    logo: "/courses/logos/itmo_ml_logo.png"
+
+  - id: "os-2026"
     file: "operating-systems-2026.yaml"
     status: "active"
     priority: 100
@@ -29,19 +36,19 @@ courses:
 
   - id: "mlb-2026-spring"
     file: "machine-learning-basics-2026.yaml"
-    status: "active"
+    status: "archived"
     priority: 90
     logo: "/courses/logos/mlb-2026_logo.png"
 
   - id: "rts-2026-spring"
     file: "random-processes-and-time-series-2026.yaml"
-    status: "active"
+    status: "archived"
     priority: 90
     logo: "/courses/logos/itmo_random_processes_time_series.png"
 
   - id: "nn-2026-spring"
     file: "neural-networks-2026.yaml"
-    status: "active"
+    status: "archived"
     priority: 80
     logo: "/courses/logos/nn-2026_logo.png"
 
@@ -62,7 +69,7 @@ courses:
     file: "machine-learning-2025.yaml"
     status: "archived"
     priority: 90
-    logo: "/courses/logos/ml-2025_logo.png"
+    logo: "/courses/logos/itmo_ml_logo.png"
 
   - id: "fs-2025-autumn"
     file: "fundamental-statistics-2025.yaml"

diff --git a/courses/logos/ml-2025_logo.png → courses/logos/itmo_ml_logo.png b/courses/logos/ml-2025_logo.png → courses/logos/itmo_ml_logo.png
diff --git a/courses/machine-learning-2026.yaml b/courses/machine-learning-2026.yaml
@@ -0,0 +1,175 @@
+---
+# Configuration file for lab-grader
+
+course:
+    name: Машинное обучение
+    alt-names: 
+        - Машинное обучение
+        - МО
+        - Machine learning
+        - ML
+    semester: Осень 2026
+    university: ИТМО
+    email: mdpoliak@itmo.ru
+    timezone: UTC+3
+    github:
+        organization: itmo-ml-2026
+        teachers:
+            - "Mark Polyak"
+            - markpolyak
+    google:
+        spreadsheet: 1zIZOW35vWIV0DkoJtpxy_R0o3PudONXlkDxeRNyVzv0
+        info-sheet: График
+        task-id-column: 0
+        student-name-column: 1
+        lab-column-offset: 1
+    staff:
+        - name: Поляк Марк Дмитриевич
+          title: преп. практики
+          status: лектор
+        - name: Поляк Марк Дмитриевич
+          title: преп. практики
+          status: лабораторные работы
+        - name: Шаврин Андрей Андреевич
+          title: ассистент
+          status: лабораторные работы
+        - name: Сениченкова Яна Олеговна
+          title: инженер
+          status: лабораторные работы
+    labs:
+        "0":
+            github-prefix: ml-lab0
+            template-repo: itmo-ml-2026/github-starter-course
+            repo-provisioning: fork
+            short-name: ЛР0
+            penalty-max: 5
+            ignore-task-id: True
+            ci:
+                - workflows
+            files:
+                - goals.md
+                - info.md
+                - report.pdf
+            moss:
+                language: c
+            report:
+                - Задание
+                - Результат
+            validation:
+                commits:
+                    -
+                        filter: console
+                        min-count: 1
+        "1":
+            github-prefix: ml-lab1
+            template-repo: itmo-ml-2026/lab1-eda
+            repo-provisioning: fork
+            short-name: ЛР1
+            taskid-max: 8
+            # ignore-task-id: True
+            penalty-max: 2
+            ci:
+                workflows:
+                    - run-autograding-tests
+                    - Test python scripts
+            files:
+                - exercises.ipynb
+            moss:
+                language: python
+                max-matches: 1000
+                local-path: lab1
+            report:
+                - Цель работы
+                - Индивидуальное задание
+                - Описание входных данных
+                - Результат выполнения работы
+                - Исходный код программы с комментариями
+                - Выводы
+        "2":
+            github-prefix: ml-lab2
+            template-repo: itmo-ml-2026/lab2-linreg-sgd
+            repo-provisioning: fork
+            short-name: ЛР2
+            taskid-max: 7
+            # ignore-task-id: True
+            penalty-max: 2
+            ci:
+                - workflows
+            files:
+                - exercises.ipynb
+            moss:
+                language: python
+                max-matches: 1000
+                local-path: lab2
+            report:
+                - Цель работы
+                - Задание на лабораторную работу
+                - Результат выполнения работы
+                - Выводы
+        "3":
+            github-prefix: ml-lab3
+            template-repo: itmo-ml-2026/lab3-binary-classification
+            repo-provisioning: fork
+            short-name: ЛР3
+            taskid-max: 5
+            # ignore-task-id: True
+            penalty-max: 2
+            ci:
+                - workflows
+            files:
+                - exercises.ipynb
+            moss:
+                language: python
+                max-matches: 1000
+                local-path: lab3
+            report:
+                - Цель работы
+                - Задание на лабораторную работу
+                - Результат выполнения работы
+                - Выводы
+        "4":
+            github-prefix: ml-lab4
+            template-repo:
+            repo-provisioning: fork
+            short-name: ЛР4
+            # taskid-max: 20
+            # ignore-task-id: True
+            penalty-max: 2
+            ci:
+                - workflows
+            files:
+                - exercises.ipynb
+            moss:
+                language: python
+                max-matches: 1000
+                local-path: lab4
+            report:
+                - Цель работы
+                - Задание на лабораторную работу
+                - Результат выполнения работы
+                - Выводы
+        "5":
+            github-prefix: ml-lab5
+            template-repo: itmo-ml-2026/lab5-backprop
+            repo-provisioning: fork
+            short-name: ЛР5
+            taskid-max: 5
+            # ignore-task-id: True
+            penalty-max: 2
+            ci:
+                - workflows
+            files:
+                - exercises.ipynb
+            moss:
+                language: python
+                max-matches: 1000
+                local-path: lab5
+            report:
+                - Цель работы
+                - Задание на лабораторную работу
+                - Результат выполнения работы
+                - Выводы
+misc:
+    requests-timeout: 5
+
+
diff --git a/courses/operating-systems-2026.yaml b/courses/operating-systems-2026.yaml
@@ -7,7 +7,7 @@ course:
         - OS
         - Operating systems
         - ОС
-    semester: Весна 2026
+    semester: Весна 2026, Осень 2026
     university: ГУАП
     email: k43guap@ya.ru
     timezone: UTC+3
@@ -32,6 +32,8 @@ course:
     labs:
         "0":
             github-prefix: os-task0
+            template-repo: suai-os-2026/github-starter-course
+            repo-provisioning: fork
             short-name: ЛР0
             penalty-max: 5
             ignore-task-id: True
@@ -53,6 +55,8 @@ course:
                         min-count: 1
         "01":
             github-prefix: os-task-I-1
+            template-repo: suai-os-2026/os-course-task1-1
+            repo-provisioning: fork
             short-name: ЛР0.1
             taskid-max: 20
             penalty-max: 6
@@ -72,6 +76,8 @@ course:
                 - Выводы
         "1":
             github-prefix: os-task1
+            template-repo: suai-os-2026/os-course-task1-new
+            repo-provisioning: fork
             short-name: ЛР1
             taskid-max: 25
             penalty-max: 6
@@ -104,6 +110,8 @@ course:
                 - Выводы
         "2":
             github-prefix: os-task2
+            template-repo: suai-os-2026/os-course-task2
+            repo-provisioning: fork
             short-name: ЛР2
             taskid-max: 20
             taskid-shift: 4
@@ -140,6 +148,8 @@ course:
                 - Выводы
         "3":
             github-prefix: os-task3
+            template-repo: suai-os-2026/os-course-task3
+            repo-provisioning: fork
             short-name: ЛР3
             taskid-max: 20
             penalty-max: 7
@@ -175,6 +185,8 @@ course:
                 - Выводы
         "4":
             github-prefix: os-task4
+            template-repo: suai-os-2026/os-course-task4
+            repo-provisioning: fork
             short-name: ЛР4
             taskid-max: 30
             penalty-max: 7
@@ -206,6 +218,8 @@ course:
                 - Выводы
         "5":
             github-prefix: os-task5
+            template-repo: suai-os-2026/os-course-task5
+            repo-provisioning: fork
             short-name: ЛР5
             taskid-max: 30
             penalty-max: 8