# SparkGuardian Antiplagiat Frontend

Клиентское веб-приложение для управления процессами алгоритмической проверки академических работ на заимствования, работающее поверх REST API системы SparkGuardian Antiplagiat.

A premium single-page web client for managing algorithmic plagiarism checks, handling ZIP course uploads, and reviewing source code overlaps, built on top of the SparkGuardian Antiplagiat REST API.

---

## О проекте

Приложение предназначено для преподавателей, ассистентов и администраторов учебного процесса. Оно позволяет прозрачно и эффективно анализировать сдачу программного кода студентами с применением методов лексической токенизации и алгоритма шинглов (Shingling & Jaccard). Фронтенд построен в соответствии со строгими стандартами **T-Bank Design System**, полностью адаптивен и предоставляет мощные встроенные инструменты для конфигурации правил анализа.

### Ключевые возможности

*   **Landing Page**: Современная маркетинговая страница с метриками системы и процессом выполнения проверок (pipeline).
*   **Управление мероприятиями и группами**: Полный CRUD для удобного распределения курсовых и потоков, чтобы исключить пересечения проверок между разными годами.
*   **Загрузка ZIP-архивов**: Массовое добавление работ (Works) — система на лету распаковывает архивы и распределяет их по студентам выбранной группы.
*   **Reference Sets (Эталоны)**: Управление коллекциями шаблонного исходного кода, позволяющими игнорировать заготовки и базовые классы при расчете плагиата.
*   **Анализ заимствований (Analysis Runs)**: Запуск фоновых задач проверки совпадений, использующих построение AST и N-граммы, благодаря чему переименование переменных не скрывает факт списывания.
*   **Выгрузка отчетов**: Мгновенная генерация сводных деталей совпадений в PDF, HTML, и JSON форматах с тепловыми картами заимствований (heatmap overlaps).
*   **Встроенная Dev-Console**: Полноценная in-app консоль разработчика для перехвата API-запросов (`dev-log.interceptor`) прямо в интерфейсе браузера, без открытия Network Tab.
*   **Мониторинг инфраструктуры**: Доступ к таблице журнала телеметрии и аудита для отслеживания загруженности серверов.
*   **Уведомления**: Интеллектуальная классификация HTTP-ошибок (Network/Timeout/Parse) с человекочитаемыми сообщениями.

### Технологический стек

| Область | Выбор |
|--------|--------|
| Фреймворк | Angular 21 (Signals, OnPush, Standalone) |
| Язык | TypeScript (strict-mode) |
| UI & Дизайн | Taiga UI v5, кастомные токены T-Bank CSS (`color-tokens.css`) |
| Взаимодействие | `HttpClient`, RXJS, Interceptors |

### Архитектурные особенности

*   **Слоевая структура**: Строгое деление на `core` (синглтоны, DI-токены, интерсепторы), `features` (lazy-loaded самостоятельные компоненты) и `shared` (чистые pure-функции и date-time утилиты).
*   **Производительность**: Использование `ChangeDetectionStrategy.OnPush` повсеместно. Lazy-loading вкладок (`@defer`).

### Локальная настройка и конфигурация

1.  Скопируйте `.env.example` в `.env` и настройте значения (например, `SG_API_BASE_PATH`, `SG_API_FALLBACK_ORIGIN`).
2.  Выполните: `npm install` (или `make install`).
3.  Синхронизируйте переменные (вызывается авто-hooks): `npm run env:sync`. Создает `environment.ts`.
4.  Запуск dev-сервера с прокси: `npm start` (по умолчанию `http://localhost:4200/`).

Актуальный OpenAPI контракт системы доступен в `docs/antiplagiat_api.json`.

---

## About the project

The app is aimed at professors, teaching assistants, and administrators. It provides a robust framework to transparently manage the submission and peer-review of source code using tokenization and shingling (Shingling & Jaccard index). The frontend strictly adheres to the **T-Bank Design System**, ensuring a premium, responsive, and robust user experience.

### Core Features

*   **Landing Page**: A modern entrance showcasing system metrics and technical capabilities (Bento block layout).
*   **Event & Group Management**: Complete CRUD for grouping courses and isolated assignments.
*   **ZIP Batch Uploads**: Frictionless batch adding of student assignments directly via ZIP package uploads.
*   **Reference Sets**: Ignore template code or boilerplate when finding codebase matches.
*   **Analysis Runs**: Dispatching background tasks verifying structural overlaps, effectively matching similarities despite variable renaming or function shuffles.
*   **Formatted Reports**: Export matched outputs into highly readable PDF, HTML, or raw JSON deliverables.
*   **Built-in Dev-Console**: An integrated developer console overlay trapping all API requests and responses directly in the browser window.
*   **Infrastructure Telemetry**: Direct access to event auditing and system stability metrics.
*   **Smart Error Handling**: Intelligent HTTP error classification with user-friendly Russian/English notifications.

### Tech Stack

| Area | Choice |
|------|--------|
| Framework | Angular 21 (Signals, OnPush, Standalone components) |
| Language | TypeScript (strict-mode) |
| UI & Design | Taiga UI v5, custom T-Bank CSS variables (`color-tokens.css`) |
| Data | `HttpClient`, RXJS, specialized interceptors |

### Architecture
The project strictly isolates modules into `core` (services, tokens, interceptors), `features` (routing, smart components), and `shared` (pure utilities). All components use `OnPush` change detection and Angular 21's `@defer` blocks to achieve peak rendering performance across massive administrative data tables.

### Running Local Environment

1.  Copy `.env.example` to `.env` and set endpoints (`SG_API_BASE_PATH`, `SG_API_FALLBACK_ORIGIN`).
2.  Install packages: `npm install` (or `make install`).
3.  Sync environment (done automatically on hooks): `npm run env:sync`.
4.  Run proxy dev-server: `npm start` (usually at `http://localhost:4200/`).

Refer to `docs/antiplagiat_api.json` for the most recent REST Open API specification.

---

### Command Reference

| Task | Command |
|------|---------|
| Dev server with proxy | `npm start` or `make start` |
| Production build | `npm run build` or `make build` |
| Development build | `make build-dev` |
| Unit tests | `npm test` |
| Lint | `npm run lint` |
| Clean artifacts | `make clean` |