1. Description
2. Start Here
3. Ecosystem
4. Key Features
5. Account Types
6. Authentication and Clan Registration
7. Technologies
8. User Requirements
9. Security and Privacy
10. Repositories and Documentation
11. Authors
12. License and Trademarks

WOT-CV is an ecosystem of applications that supports the recruitment of players to World of Tanks clans.

The platform helps clan staff discover potential recruits, apply configurable recruitment criteria, review candidates, manage access for clan members, analyse recruitment results and automate selected activities through a browser extension.

WOT-CV was created as a hobby project by Daniel Owczarczyk and Marek Brajerski.

1. Open wot-cv.com.
2. Select login with Wargaming. Authentication takes place on Wargaming's website and returns through the WOT-CV backend.
3. If your clan is already registered, WOT-CV opens the application with the permissions assigned to your account.
4. If your clan is not registered and you hold a supported officer role, accept the registration consent, review the detected clan data and complete the initial configuration.
5. Configure recruitment filters and access for clan members.
6. Optionally install the WOT-CV browser extension to automate invitations on the Wargaming clan portal.

The browser extension is optional. The web application, backend and data refresher provide the core recruitment workflow.

WOT-CV consists of four cooperating applications:

• Web application — the user interface used by recruiters and clan staff.
• Backend — public APIs, authentication, authorization and business logic.
• Data refresher — scheduled data collection, transformation, migrations and maintenance.
• Browser extension — integration with the Wargaming clan portal and automated invitations.

flowchart LR
    USER[Recruiter or clan officer]
    FE[WOT-CV web application]
    BE[WOT-CV backend]
    REFRESHER[WOT-CV data refresher]
    EXT[WOT-CV browser extension]
    DB[(MongoDB)]
    WG_OPENID[Wargaming OpenID]
    WG_API[Wargaming API]
    WG_PORTAL[Wargaming clan portal]

    USER --> FE
    USER --> EXT
    FE --> BE
    EXT --> BE
    EXT --> WG_PORTAL
    BE --> DB
    BE --> REFRESHER
    REFRESHER --> DB
    REFRESHER --> WG_API
    BE --> WG_OPENID

The integration direction is intentional: the backend may invoke selected data-refresher operations, while the data refresher does not call the backend through REST.

• Potential recruit discovery — finds players who may match clan requirements.
• Advanced recruitment filters — configurable criteria based on player statistics, activity, vehicles and communication language.
• Players-to-check queue — a structured workflow for reviewing candidates.
• Recruitment history — a record of previously analysed players.
• Recruitment statistics — insights into the effectiveness of clan recruitment.
• Clan administration — management of access and permissions for clan members.
• Player and clan blocklist — prevents unsuitable candidates from returning to recruitment results.
• Browser extension — supports automated invitations from the Wargaming clan portal.
• Internationalisation — English, Polish, German, Czech and Russian user interfaces.

WOT-CV uses three account types:

PREMIUM and TESTER are treated equally when a feature requires premium access. The separate TESTER type allows selected experimental features to be released to testers before a wider rollout.

WOT-CV uses Wargaming OpenID 2.0. Wargaming authenticates the player; WOT-CV never receives the player's Wargaming password.

The frontend starts authentication by performing a full browser navigation to:

GET /web/api/wot-cv/auth/wargaming

The backend creates a short-lived, single-use login transaction, sets a secure correlation cookie and redirects the browser to Wargaming. After authentication, Wargaming redirects the browser to the backend callback:

GET /web/api/wot-cv/auth/wargaming/callback

The backend validates the OpenID response directly with Wargaming, verifies the claimed identity and protects the callback against replay. The frontend does not validate or process the OpenID assertion.

sequenceDiagram
    autonumber

    actor User
    participant FE as WOT-CV web application
    participant BE as WOT-CV backend
    participant WG as Wargaming OpenID
    participant DB as MongoDB

    User->>FE: Select "Log in with Wargaming"
    FE->>BE: Top-level GET /auth/wargaming
    BE->>DB: Store hashes of state and correlation secret with TTL
    BE-->>FE: Set HttpOnly correlation cookie and return 302
    FE->>WG: Open Wargaming authentication page
    User->>WG: Authenticate with Wargaming
    WG-->>FE: Redirect to the backend callback
    FE->>BE: GET /auth/wargaming/callback
    BE->>DB: Atomically consume the login transaction

    alt Authentication was cancelled
        BE-->>FE: 303 /auth/complete#status=cancelled
        FE-->>User: Return to the application
    else OpenID response was returned
        BE->>WG: check_authentication and identity discovery
        WG-->>BE: Verification result
        BE->>DB: Store a nonce hash to prevent replay

        alt Existing WOT-CV user
            BE->>DB: Create a server-backed refresh session
            BE-->>FE: Set HttpOnly session cookies and return 303 /auth/complete#status=success
            FE->>FE: Remove the URL fragment
            FE->>BE: GET /users/me
            BE-->>FE: User, customer and account type
            FE-->>User: Open the authenticated application
        else User is eligible to register a clan
            BE->>DB: Store a hashed, short-lived registration session
            BE-->>FE: Set HttpOnly registration cookie and return 303 /register
            FE-->>User: Display registration consent
            User->>FE: Accept consent
            FE->>BE: GET /customers/registration
            BE-->>FE: Clan and registration data
            FE-->>User: Display the registration form
            User->>FE: Configure and submit clan registration
            FE->>BE: POST /customers/register
            BE->>DB: Consume the session and create the customer configuration
            BE->>DB: Create users, permissions, filters and initial account data
            BE-->>FE: Clear registration cookie, set session cookies and return 201
            FE->>BE: GET /users/me
            BE-->>FE: Registered user and customer
            FE-->>User: Confirm registration
        else Login or registration is rejected
            BE-->>FE: 303 /auth/complete#error=ERROR_CODE
            FE->>FE: Remove the URL fragment
            FE-->>User: Display a localised error
        end
    end

An existing WOT-CV user receives a normal web session. Authentication data is stored in secure, HttpOnly cookies. The frontend then calls /users/me to load the authenticated user, customer and account type.

A new user may register a clan when:

• the player exists in the Wargaming API;
• the player belongs to a clan;
• that clan is not already registered in WOT-CV;
• the player has a supported officer role.

The backend creates a separate short-lived registration session. This is not yet a normal authenticated WOT-CV session.

The registration page first displays the required consent. Registration data is requested only after the user accepts it. When the registration form is submitted, the backend atomically consumes the registration session, creates the customer configuration and starts a normal authenticated session.

The backend redirects the browser only with a fixed status or error code in the URL fragment. Authentication tokens and OpenID assertions are never included in that fragment. The frontend removes the fragment immediately after reading it.

The tables below show the current major technology lines. Exact and binding versions are defined by each repository's pom.xml, package.json, lockfile and browser manifests.

To register a clan in WOT-CV, a user must:

1. Have a Wargaming.net account.
2. Be a member of a World of Tanks clan.
3. Hold one of the supported clan roles:
   • Commander;
   • Executive Officer;
   • Personnel Officer;
   • Combat Officer;
   • Intelligence Officer;
   • Quartermaster;
   • Recruitment Officer;
   • Junior Officer.

Users of an already registered clan receive access according to permissions configured by the clan administrators.

• Wargaming authenticates the player; WOT-CV never receives the Wargaming password.
• The backend validates OpenID responses directly with Wargaming.
• Login state, correlation secrets, nonces and registration secrets are stored as hashes rather than raw values.
• Login and registration transactions are short-lived and single-use.
• Authentication and registration cookies are HttpOnly and Secure.
• The frontend receives only fixed completion or error codes.
• Public game and clan information is obtained through the official Wargaming API.
• Authentication tokens are carried in secure backend cookies and are not exposed to frontend storage.
• Browser-extension pairing is verified against the backend rather than inferred from a local cookie.

Security-sensitive reports must not include credentials, session cookies, pairing codes or personal data in a public issue. Use a private channel to contact the maintainers and rotate any credential that may already have been disclosed.

Documentation has explicit ownership:

• this organization profile explains the product and the relationships between applications;
• each repository README is the entry point for its architecture, local setup, tests, operational constraints and troubleshooting;
• backend OpenAPI documents are the source of truth for HTTP paths, methods, payloads and enums;
• pom.xml, package.json, lockfiles and browser manifests are the source of truth for exact dependency and platform versions;
• runtime configuration files and deployment secrets define environment-specific behaviour, but secrets must never be copied into documentation.

Cross-application changes should update all affected READMEs and generated API clients in the same coordinated release.

Daniel Owczarczyk and Marek Brajerski

WOT-CV is a hobby project. Licensing or distribution terms, where applicable, are defined in the individual repositories.

World of Tanks and Wargaming-related names and marks belong to their respective owners. WOT-CV is not an official Wargaming product.

1. Opis
2. Zacznij tutaj
3. Ekosystem
4. Główne funkcjonalności
5. Typy kont
6. Logowanie i rejestracja klanu
7. Technologie
8. Wymagania dla użytkowników
9. Bezpieczeństwo i prywatność
10. Repozytoria i dokumentacja
11. Autorzy
12. Licencja i znaki towarowe

WOT-CV jest ekosystemem aplikacji wspierających rekrutację graczy do klanów w grze World of Tanks.

Platforma pomaga członkom sztabu klanu wyszukiwać potencjalnych rekrutów, stosować konfigurowalne kryteria rekrutacyjne, analizować kandydatów, zarządzać dostępem członków klanu, sprawdzać skuteczność rekrutacji oraz automatyzować wybrane czynności przy użyciu rozszerzenia przeglądarki.

WOT-CV powstało jako projekt hobbystyczny Daniela Owczarczyka i Marka Brajerskiego.

1. Otwórz wot-cv.com.
2. Wybierz logowanie przez Wargaming. Uwierzytelnienie odbywa się na stronie Wargaming, a powrót prowadzi przez backend WOT-CV.
3. Jeżeli klan jest już zarejestrowany, WOT-CV otworzy aplikację z uprawnieniami przypisanymi do konta.
4. Jeżeli klan nie jest zarejestrowany, a użytkownik ma obsługiwaną rolę oficerską, należy zaakceptować zgodę rejestracyjną, sprawdzić wykryte dane klanu i zakończyć konfigurację początkową.
5. Skonfiguruj filtry rekrutacyjne oraz dostęp członków klanu.
6. Opcjonalnie zainstaluj rozszerzenie przeglądarki WOT-CV, aby automatyzować zaproszenia w portalu klanowym Wargaming.

Rozszerzenie jest opcjonalne. Aplikacja webowa, backend i data-refresher dostarczają podstawowy proces rekrutacyjny.

WOT-CV składa się z czterech współpracujących aplikacji:

• Aplikacja webowa — interfejs używany przez rekruterów i członków sztabu klanu.
• Backend — publiczne API, logowanie, autoryzacja i logika biznesowa.
• Data refresher — cykliczne pobieranie i przetwarzanie danych, migracje oraz utrzymanie danych.
• Rozszerzenie przeglądarki — integracja z portalem klanowym Wargaming i automatyczne zapraszanie.

flowchart LR
    USER[Rekruter lub oficer klanu]
    FE[Aplikacja webowa WOT-CV]
    BE[Backend WOT-CV]
    REFRESHER[WOT-CV data refresher]
    EXT[Rozszerzenie WOT-CV]
    DB[(MongoDB)]
    WG_OPENID[Wargaming OpenID]
    WG_API[Wargaming API]
    WG_PORTAL[Portal klanowy Wargaming]

    USER --> FE
    USER --> EXT
    FE --> BE
    EXT --> BE
    EXT --> WG_PORTAL
    BE --> DB
    BE --> REFRESHER
    REFRESHER --> DB
    REFRESHER --> WG_API
    BE --> WG_OPENID

Kierunek integracji jest celowy: backend może wywoływać wybrane operacje data-refreshera, natomiast data-refresher nie wywołuje backendu przez REST.

• Wyszukiwanie potencjalnych rekrutów — odnajdywanie graczy, którzy mogą spełniać wymagania klanu.
• Zaawansowane filtry rekrutacyjne — kryteria oparte na statystykach, aktywności, pojazdach i języku komunikacji.
• Lista graczy do sprawdzenia — uporządkowany proces analizowania kandydatów.
• Historia rekrutacji — zapis wcześniej przeanalizowanych graczy.
• Statystyki rekrutacji — informacje o skuteczności działań rekrutacyjnych.
• Administracja klanem — zarządzanie dostępem i uprawnieniami członków klanu.
• Lista zablokowanych graczy i klanów — zapobieganie ponownemu pojawianiu się nieodpowiednich kandydatów.
• Rozszerzenie przeglądarki — automatyzacja zaproszeń z portalu klanowego Wargaming.
• Wielojęzyczność — interfejs angielski, polski, niemiecki, czeski i rosyjski.

WOT-CV wykorzystuje trzy typy kont:

PREMIUM i TESTER są traktowane identycznie, gdy funkcjonalność wymaga dostępu premium. Osobny typ TESTER pozwala udostępniać wybrane eksperymentalne funkcje testerom przed szerszym wdrożeniem.

WOT-CV wykorzystuje Wargaming OpenID 2.0. Użytkownik jest uwierzytelniany przez Wargaming, dlatego WOT-CV nigdy nie otrzymuje jego hasła do konta Wargaming.

Frontend rozpoczyna logowanie poprzez pełną nawigację przeglądarki do:

GET /web/api/wot-cv/auth/wargaming

Backend tworzy krótkotrwałą, jednorazową transakcję logowania, ustawia bezpieczne cookie korelacyjne i przekierowuje przeglądarkę do Wargaming. Po uwierzytelnieniu Wargaming przekierowuje przeglądarkę do callbacku backendu:

GET /web/api/wot-cv/auth/wargaming/callback

Backend bezpośrednio weryfikuje odpowiedź OpenID w Wargaming, sprawdza potwierdzoną tożsamość i zabezpiecza callback przed ponownym wykorzystaniem. Frontend nie weryfikuje ani nie przetwarza odpowiedzi OpenID.

sequenceDiagram
    autonumber

    actor Uzytkownik as Użytkownik
    participant FE as Aplikacja webowa WOT-CV
    participant BE as Backend WOT-CV
    participant WG as Wargaming OpenID
    participant DB as MongoDB

    Uzytkownik->>FE: Wybór "Zaloguj przez Wargaming"
    FE->>BE: Pełna nawigacja GET /auth/wargaming
    BE->>DB: Zapis hashy state i sekretu korelacyjnego z TTL
    BE-->>FE: Ustawienie HttpOnly cookie i odpowiedź 302
    FE->>WG: Otwarcie strony logowania Wargaming
    Uzytkownik->>WG: Uwierzytelnienie w Wargaming
    WG-->>FE: Przekierowanie do callbacku backendu
    FE->>BE: GET /auth/wargaming/callback
    BE->>DB: Atomowe zużycie transakcji logowania

    alt Logowanie zostało anulowane
        BE-->>FE: 303 /auth/complete#status=cancelled
        FE-->>Uzytkownik: Powrót do aplikacji
    else Wargaming zwrócił odpowiedź OpenID
        BE->>WG: check_authentication i discovery tożsamości
        WG-->>BE: Wynik weryfikacji
        BE->>DB: Zapis hasha nonce chroniącego przed replay

        alt Istniejący użytkownik WOT-CV
            BE->>DB: Utworzenie serwerowej sesji refresh
            BE-->>FE: Ustawienie HttpOnly cookies i 303 /auth/complete#status=success
            FE->>FE: Usunięcie fragmentu z adresu
            FE->>BE: GET /users/me
            BE-->>FE: Użytkownik, klient i typ konta
            FE-->>Uzytkownik: Otwarcie zalogowanej aplikacji
        else Użytkownik może zarejestrować klan
            BE->>DB: Zapis zahashowanej, krótkotrwałej sesji rejestracyjnej
            BE-->>FE: Ustawienie HttpOnly cookie i 303 /register
            FE-->>Uzytkownik: Wyświetlenie zgody rejestracyjnej
            Uzytkownik->>FE: Zaakceptowanie zgody
            FE->>BE: GET /customers/registration
            BE-->>FE: Dane klanu i dane rejestracyjne
            FE-->>Uzytkownik: Wyświetlenie formularza rejestracji
            Uzytkownik->>FE: Konfiguracja i wysłanie rejestracji
            FE->>BE: POST /customers/register
            BE->>DB: Zużycie sesji i utworzenie konfiguracji klienta
            BE->>DB: Utworzenie użytkowników, uprawnień, filtrów i danych konta
            BE-->>FE: Usunięcie cookie rejestracji, ustawienie cookies sesji i 201
            FE->>BE: GET /users/me
            BE-->>FE: Zarejestrowany użytkownik i klient
            FE-->>Uzytkownik: Potwierdzenie rejestracji
        else Logowanie lub rejestracja zostały odrzucone
            BE-->>FE: 303 /auth/complete#error=ERROR_CODE
            FE->>FE: Usunięcie fragmentu z adresu
            FE-->>Uzytkownik: Wyświetlenie przetłumaczonego błędu
        end
    end

Istniejący użytkownik WOT-CV otrzymuje normalną sesję webową. Dane uwierzytelnienia znajdują się w bezpiecznych cookies HttpOnly. Frontend wywołuje następnie /users/me, aby pobrać użytkownika, klienta i typ konta.

Nowy użytkownik może zarejestrować klan, jeżeli:

• gracz istnieje w Wargaming API;
• gracz należy do klanu;
• klan nie jest jeszcze zarejestrowany w WOT-CV;
• gracz ma obsługiwaną rolę oficerską.

Backend tworzy osobną, krótkotrwałą sesję rejestracyjną. Na tym etapie nie jest to jeszcze normalna sesja zalogowanego użytkownika WOT-CV.

Strona rejestracji najpierw wyświetla wymaganą zgodę. Dane rejestracyjne są pobierane dopiero po jej zaakceptowaniu. Po wysłaniu formularza backend atomowo zużywa sesję rejestracyjną, tworzy konfigurację klienta i rozpoczyna zwykłą sesję zalogowanego użytkownika.

Backend przekazuje frontendowi wyłącznie stały status lub kod błędu umieszczony we fragmencie adresu. Tokeny uwierzytelniające i odpowiedź OpenID nigdy nie są umieszczane w tym fragmencie. Frontend usuwa fragment natychmiast po jego odczytaniu.

Poniższe tabele pokazują aktualne główne linie technologiczne. Dokładne i wiążące wersje znajdują się w plikach pom.xml, package.json, lockfile'ach i manifestach przeglądarek poszczególnych repozytoriów.

Aby zarejestrować klan w WOT-CV, użytkownik musi:

1. Posiadać konto Wargaming.net.
2. Należeć do klanu w grze World of Tanks.
3. Posiadać jedną z obsługiwanych ról:
   • Dowódca;
   • Oficer wykonawczy;
   • Oficer kadrowy;
   • Oficer polowy;
   • Oficer wywiadu;
   • Kwatermistrz;
   • Oficer werbunkowy;
   • Młodszy oficer.

Członkowie już zarejestrowanego klanu otrzymują dostęp zgodnie z uprawnieniami skonfigurowanymi przez administratorów klanu.

• Użytkownika uwierzytelnia Wargaming; WOT-CV nigdy nie otrzymuje hasła do Wargaming.
• Backend bezpośrednio weryfikuje odpowiedzi OpenID w Wargaming.
• Stan logowania, sekrety korelacyjne, nonce i sekrety rejestracji są przechowywane jako hashe, a nie jako surowe wartości.
• Transakcje logowania i rejestracji są krótkotrwałe i jednorazowe.
• Cookies uwierzytelnienia i rejestracji są oznaczone jako HttpOnly i Secure.
• Frontend otrzymuje wyłącznie stały status zakończenia albo kod błędu.
• Publiczne dane dotyczące gry i klanów pochodzą z oficjalnego Wargaming API.
• Tokeny uwierzytelniające są przenoszone w bezpiecznych cookies backendu i nie są udostępniane pamięci frontendu.
• Stan sparowania rozszerzenia jest potwierdzany przez backend, a nie wywnioskowany z lokalnego cookie.

Zgłoszenie dotyczące bezpieczeństwa nie może zawierać danych dostępowych, cookies sesji, kodów parowania ani danych osobowych w publicznym issue. Należy skontaktować się z maintainerami prywatnym kanałem i obrócić każde dane dostępowe, które mogły zostać ujawnione.

Dokumentacja ma jawnie określoną własność:

• ten profil organizacji opisuje produkt i relacje między aplikacjami;
• README każdego repozytorium jest punktem wejścia do jego architektury, uruchomienia lokalnego, testów, ograniczeń operacyjnych i diagnostyki;
• dokumenty OpenAPI backendu są źródłem prawdy dla ścieżek HTTP, metod, payloadów i enumów;
• pom.xml, package.json, lockfile'e i manifesty przeglądarek są źródłem prawdy dla dokładnych wersji zależności i platform;
• pliki konfiguracji runtime i sekrety wdrożeniowe definiują zachowanie środowiska, ale sekretów nie wolno kopiować do dokumentacji.

Zmiana obejmująca kilka aplikacji powinna aktualizować wszystkie dotknięte README i wygenerowane klienty API w ramach tego samego skoordynowanego release'u.

Daniel Owczarczyk i Marek Brajerski

WOT-CV jest projektem hobbystycznym. Warunki licencjonowania lub dystrybucji, jeżeli mają zastosowanie, są określane w poszczególnych repozytoriach.

Nazwy i znaki związane z World of Tanks oraz Wargaming należą do ich właścicieli. WOT-CV nie jest oficjalnym produktem Wargaming.