# faresmallah/briefup architecture

> Architecture diagram of the GitHub repository faresmallah/briefup, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-07-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/faresmallah/briefup
- Repository: https://github.com/faresmallah/briefup

## Overview

BriefUp is a classic Java EE servlet application deployed on Apache Tomcat, with a server-rendered UI and a thin client-side layer. The architecture is split into presentation, request handling, domain model, persistence, and AI-assisted content generation.

The presentation layer lives under `src/main/webapp`. It mixes JSP (`home.jsp`, `deck.jsp`) and static HTML entry pages (`login.html`, `signup.html`, `main.html`), plus CSS and a small amount of JavaScript (`home.js`, `deck.js`) for interactive behavior. This suggests most page composition happens on the server, with JavaScript used for dynamic actions like deck editing or study flow.

HTTP routing is handled by servlets in `com.briefup.controllers`. Each servlet appears to own a focused use case: authentication (`LoginServlet`, `SignupServlet`, `LogoutServlet`), deck lifecycle (`CreateDeckServlet`, `SaveDeckServlet`, `DeleteDeckServlet`, `DeleteDeckByIdServlet`, `ListDecksServlet`, `ListCardsServlet`), study/session flows (`StudySessionServlet`, `GetStatsServlet`), and social/progression features (`LeaderboardServlet`, `HomeServlet`). For diagramming, these are the primary application entry points.

Authentication is enforced by `AuthFilter`, which likely guards protected routes and redirects unauthenticated users to login/signup. That makes session state an important boundary: public pages vs. authenticated study/deck management pages.

The domain layer is simple and explicit: `User`, `Deck`, `Card`, and `UserStats`. These objects represent the core data the application moves between controllers, DAOs, and JSPs. `UserStats` is especially important because it underpins study progress, quiz results, and leaderboard ranking.

Persistence is handled by DAO classes: `UserDAO`, `DeckDAO`, `CardDAO`, and `UserStatsDAO`. This is a direct JDBC-style architecture rather than an ORM-based one. `DBConnection` centralizes MySQL connectivity, so the DAO layer is the main boundary between application logic and the database.

The database is MySQL, bundled with the JDBC connector in `WEB-INF/lib`. That means the app is self-contained at deployment time, with database access managed inside the servlet container rather than through external persistence infrastructure.

AI flashcard generation is a distinct subsystem. `AiFlashcardService` in the service/AI packages indicates a service layer that calls the OpenAI API to generate flashcards, likely from uploaded PDF content. The presence of Apache PDFBox in `WEB-INF/lib` strongly suggests the upload flow parses PDFs locally, extracts text, and then sends it into the AI generation step.

The PDF upload path is therefore a multi-step pipeline: user uploads a PDF through `UploadPdfDeckServlet`, the server extracts document text, the AI service generates candidate flashcards, and the resulting deck/cards are persisted through the DAO layer. This is the most important cross-cutting data flow in the system.

Study mode and analytics form another connected subsystem. `StudySessionServlet`, `GetStatsServlet`, `LeaderboardServlet`, and `UserStatsDAO` together imply that quiz attempts and progress updates are stored server-side, then aggregated for stats and rankings. In the architecture diagram, this is the read/write loop from study activity back into persistent progress data.

The main external dependencies that materially affect the architecture are Tomcat for servlet hosting, MySQL for storage, OpenAI for flashcard generation, and PDFBox for document parsing. The app is packaged as a traditional WAR-style web application, with `web.xml` defining servlet/filter wiring and `WEB-INF/lib` carrying the runtime jars.

Overall, the repository follows a straightforward layered MVC-style design: browser UI → servlet controllers → domain objects/DAOs → MySQL, with an AI/document-processing branch feeding deck creation. The key boundaries to show are authenticated vs public routes, controller vs DAO separation, and the PDF-to-AI-to-deck pipeline.

Main entry points: [`src/main/java/com/briefup/filters/AuthFilter.java`](https://github.com/faresmallah/briefup/blob/main/src/main/java/com/briefup/filters/AuthFilter.java) (Auth Filter), [`src/main/java/com/briefup/dao/DeckDAO.java`](https://github.com/faresmallah/briefup/blob/main/src/main/java/com/briefup/dao/DeckDAO.java) (Deck DAO), [`src/main/java/com/briefup/db/DBConnection.java`](https://github.com/faresmallah/briefup/blob/main/src/main/java/com/briefup/db/DBConnection.java) (DB Connection), [`src/main/java/com/briefup/controllers/HomeServlet.java`](https://github.com/faresmallah/briefup/blob/main/src/main/java/com/briefup/controllers/HomeServlet.java) (Home)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_presentation["Presentation"]
  node_home_jsp["Home UI<br/>JSP view<br/>[home.jsp]"]
  node_deck_jsp["Deck UI<br/>JSP view<br/>[deck.jsp]"]
  node_login_html["Login<br/>HTML entry<br/>[login.html]"]
  node_signup_html["Signup<br/>HTML entry<br/>[signup.html]"]
  node_main_html["Main Entry<br/>HTML entry<br/>[main.html]"]
  node_home_js["Home JS<br/>client script<br/>[home.js]"]
  node_deck_js["Deck JS<br/>client script<br/>[deck.js]"]
end

subgraph group_controllers["Controllers"]
  node_auth_filter{{"Auth Filter<br/>request filter<br/>[AuthFilter.java]"}}
  node_login_servlet["Login<br/>auth servlet<br/>[LoginServlet.java]"]
  node_signup_servlet["Signup<br/>auth servlet<br/>[SignupServlet.java]"]
  node_logout_servlet["Logout<br/>session servlet<br/>[LogoutServlet.java]"]
  node_home_servlet["Home<br/>page servlet<br/>[HomeServlet.java]"]
  node_list_decks_servlet["List Decks<br/>deck servlet"]
  node_create_deck_servlet["Create Deck<br/>deck servlet"]
  node_save_deck_servlet["Save Deck<br/>deck servlet"]
  node_delete_deck_servlet["Delete Deck<br/>deck servlet"]
  node_list_cards_servlet["List Cards<br/>card servlet"]
  node_study_session_servlet["Study Session<br/>study servlet"]
  node_get_stats_servlet["Stats<br/>analytics servlet"]
  node_leaderboard_servlet["Leaderboard<br/>ranking servlet"]
  node_upload_pdf_servlet["Upload PDF<br/>ai servlet"]
end

subgraph group_domain["Domain"]
  node_user_model(("User<br/>domain model<br/>[User.java]"))
  node_deck_model(("Deck<br/>domain model<br/>[Deck.java]"))
  node_card_model(("Card<br/>domain model<br/>[Card.java]"))
  node_stats_model(("User Stats<br/>domain model<br/>[UserStats.java]"))
end

subgraph group_persistence["Persistence"]
  node_user_dao[("User DAO<br/>JDBC DAO<br/>[UserDAO.java]")]
  node_deck_dao[("Deck DAO<br/>JDBC DAO<br/>[DeckDAO.java]")]
  node_card_dao[("Card DAO<br/>JDBC DAO<br/>[CardDAO.java]")]
  node_stats_dao[("Stats DAO<br/>JDBC DAO<br/>[UserStatsDAO.java]")]
  node_db_connection["DB Connection<br/>jdbc config<br/>[DBConnection.java]"]
end

subgraph group_ai["AI Pipeline"]
  node_ai_service{{"Flashcard AI<br/>AI service"}}
end

subgraph group_external["External"]
  node_tomcat{{"Tomcat<br/>servlet container"}}
  node_mysql[("MySQL<br/>database")]
  node_openai{{"OpenAI API<br/>external AI"}}
end

node_main_html -->|"entry"| node_login_html
node_main_html -->|"entry"| node_signup_html
node_home_jsp -->|"renders"| node_home_servlet
node_deck_jsp -->|"loads"| node_list_cards_servlet
node_home_js -->|"ajax"| node_list_decks_servlet
node_deck_js -->|"ajax"| node_save_deck_servlet
node_deck_js -->|"ajax"| node_study_session_servlet
node_auth_filter -->|"guards"| node_home_servlet
node_auth_filter -->|"guards"| node_list_decks_servlet
node_auth_filter -->|"guards"| node_create_deck_servlet
node_auth_filter -->|"guards"| node_save_deck_servlet
node_auth_filter -->|"guards"| node_delete_deck_servlet
node_login_servlet -->|"authenticates"| node_user_dao
node_signup_servlet -->|"creates"| node_user_dao
node_logout_servlet -->|"clears"| node_user_model
node_home_servlet -->|"reads"| node_deck_dao
node_list_decks_servlet -->|"reads"| node_deck_dao
node_create_deck_servlet -->|"builds"| node_deck_model
node_save_deck_servlet -->|"updates"| node_deck_model
node_delete_deck_servlet -->|"deletes"| node_deck_dao
node_list_cards_servlet -->|"reads"| node_card_dao
node_study_session_servlet -->|"writes"| node_stats_dao
node_get_stats_servlet -->|"reads"| node_stats_dao
node_leaderboard_servlet -->|"reads"| node_stats_dao
node_upload_pdf_servlet -->|"invokes"| node_ai_service
node_upload_pdf_servlet -->|"persists"| node_deck_dao
node_ai_service -->|"calls"| node_openai
node_ai_service -->|"produces"| node_card_model
node_deck_dao -->|"uses"| node_db_connection
node_card_dao -->|"uses"| node_db_connection
node_user_dao -->|"uses"| node_db_connection
node_stats_dao -->|"uses"| node_db_connection
node_db_connection -->|"connects"| node_mysql
node_home_servlet -->|"uses"| node_user_model
node_study_session_servlet -->|"updates"| node_stats_model
node_get_stats_servlet -->|"returns"| node_stats_model
node_leaderboard_servlet -->|"ranks"| node_stats_model
node_create_deck_servlet -->|"adds"| node_card_model

click node_home_jsp "https://github.com/faresmallah/briefup/blob/main/src/main/webapp/home.jsp"
click node_deck_jsp "https://github.com/faresmallah/briefup/blob/main/src/main/webapp/deck.jsp"
click node_login_html "https://github.com/faresmallah/briefup/blob/main/src/main/webapp/login.html"
click node_signup_html "https://github.com/faresmallah/briefup/blob/main/src/main/webapp/signup.html"
click node_main_html "https://github.com/faresmallah/briefup/blob/main/src/main/webapp/main.html"
click node_home_js "https://github.com/faresmallah/briefup/blob/main/src/main/webapp/js/home.js"
click node_deck_js "https://github.com/faresmallah/briefup/blob/main/src/main/webapp/js/deck.js"
click node_auth_filter "https://github.com/faresmallah/briefup/blob/main/src/main/java/com/briefup/filters/AuthFilter.java"
click node_login_servlet "https://github.com/faresmallah/briefup/blob/main/src/main/java/com/briefup/controllers/LoginServlet.java"
click node_signup_servlet "https://github.com/faresmallah/briefup/blob/main/src/main/java/com/briefup/controllers/SignupServlet.java"
click node_logout_servlet "https://github.com/faresmallah/briefup/blob/main/src/main/java/com/briefup/controllers/LogoutServlet.java"
click node_home_servlet "https://github.com/faresmallah/briefup/blob/main/src/main/java/com/briefup/controllers/HomeServlet.java"
click node_list_decks_servlet "https://github.com/faresmallah/briefup/blob/main/src/main/java/com/briefup/controllers/ListDecksServlet.java"
click node_create_deck_servlet "https://github.com/faresmallah/briefup/blob/main/src/main/java/com/briefup/controllers/CreateDeckServlet.java"
click node_save_deck_servlet "https://github.com/faresmallah/briefup/blob/main/src/main/java/com/briefup/controllers/SaveDeckServlet.java"
click node_delete_deck_servlet "https://github.com/faresmallah/briefup/blob/main/src/main/java/com/briefup/controllers/DeleteDeckServlet.java"
click node_list_cards_servlet "https://github.com/faresmallah/briefup/blob/main/src/main/java/com/briefup/controllers/ListCardsServlet.java"
click node_study_session_servlet "https://github.com/faresmallah/briefup/blob/main/src/main/java/com/briefup/controllers/StudySessionServlet.java"
click node_get_stats_servlet "https://github.com/faresmallah/briefup/blob/main/src/main/java/com/briefup/controllers/GetStatsServlet.java"
click node_leaderboard_servlet "https://github.com/faresmallah/briefup/blob/main/src/main/java/com/briefup/controllers/LeaderboardServlet.java"
click node_upload_pdf_servlet "https://github.com/faresmallah/briefup/blob/main/src/main/java/com/briefup/controllers/UploadPdfDeckServlet.java"
click node_user_model "https://github.com/faresmallah/briefup/blob/main/src/main/java/com/briefup/models/User.java"
click node_deck_model "https://github.com/faresmallah/briefup/blob/main/src/main/java/com/briefup/models/Deck.java"
click node_card_model "https://github.com/faresmallah/briefup/blob/main/src/main/java/com/briefup/models/Card.java"
click node_stats_model "https://github.com/faresmallah/briefup/blob/main/src/main/java/com/briefup/models/UserStats.java"
click node_user_dao "https://github.com/faresmallah/briefup/blob/main/src/main/java/com/briefup/dao/UserDAO.java"
click node_deck_dao "https://github.com/faresmallah/briefup/blob/main/src/main/java/com/briefup/dao/DeckDAO.java"
click node_card_dao "https://github.com/faresmallah/briefup/blob/main/src/main/java/com/briefup/dao/CardDAO.java"
click node_stats_dao "https://github.com/faresmallah/briefup/blob/main/src/main/java/com/briefup/dao/UserStatsDAO.java"
click node_db_connection "https://github.com/faresmallah/briefup/blob/main/src/main/java/com/briefup/db/DBConnection.java"
click node_ai_service "https://github.com/faresmallah/briefup/blob/main/src/main/java/com/briefup/ai/AiFlashcardService.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_home_jsp,node_deck_jsp,node_login_html,node_signup_html,node_main_html,node_home_js,node_deck_js toneBlue
class node_auth_filter,node_login_servlet,node_signup_servlet,node_logout_servlet,node_home_servlet,node_list_decks_servlet,node_create_deck_servlet,node_save_deck_servlet,node_delete_deck_servlet,node_list_cards_servlet,node_study_session_servlet,node_get_stats_servlet,node_leaderboard_servlet,node_upload_pdf_servlet toneAmber
class node_user_model,node_deck_model,node_card_model,node_stats_model toneMint
class node_user_dao,node_deck_dao,node_card_dao,node_stats_dao,node_db_connection toneRose
class node_ai_service toneIndigo
class node_tomcat,node_mysql,node_openai toneTeal
```

## Components

### Presentation

Server-rendered pages and thin client scripts

- [Home UI](https://github.com/faresmallah/briefup/blob/main/src/main/webapp/home.jsp): JSP view · Main authenticated home page · `src/main/webapp/home.jsp`
- [Deck UI](https://github.com/faresmallah/briefup/blob/main/src/main/webapp/deck.jsp): JSP view · Deck editing and study page · `src/main/webapp/deck.jsp`
- [Login](https://github.com/faresmallah/briefup/blob/main/src/main/webapp/login.html): HTML entry · Public sign-in page · `src/main/webapp/login.html`
- [Signup](https://github.com/faresmallah/briefup/blob/main/src/main/webapp/signup.html): HTML entry · Public account creation page · `src/main/webapp/signup.html`
- [Main Entry](https://github.com/faresmallah/briefup/blob/main/src/main/webapp/main.html): HTML entry · Primary landing page · `src/main/webapp/main.html`
- [Home JS](https://github.com/faresmallah/briefup/blob/main/src/main/webapp/js/home.js): client script · Home-page interactions · `src/main/webapp/js/home.js`
- [Deck JS](https://github.com/faresmallah/briefup/blob/main/src/main/webapp/js/deck.js): client script · Deck editing and study interactions · `src/main/webapp/js/deck.js`

### Controllers

Servlet entry points and request routing

- [Auth Filter](https://github.com/faresmallah/briefup/blob/main/src/main/java/com/briefup/filters/AuthFilter.java): request filter · Protects authenticated routes · `src/main/java/com/briefup/filters/AuthFilter.java`
- [Login](https://github.com/faresmallah/briefup/blob/main/src/main/java/com/briefup/controllers/LoginServlet.java): auth servlet · Authenticates users · `src/main/java/com/briefup/controllers/LoginServlet.java`
- [Signup](https://github.com/faresmallah/briefup/blob/main/src/main/java/com/briefup/controllers/SignupServlet.java): auth servlet · Creates user accounts · `src/main/java/com/briefup/controllers/SignupServlet.java`
- [Logout](https://github.com/faresmallah/briefup/blob/main/src/main/java/com/briefup/controllers/LogoutServlet.java): session servlet · Ends the active session · `src/main/java/com/briefup/controllers/LogoutServlet.java`
- [Home](https://github.com/faresmallah/briefup/blob/main/src/main/java/com/briefup/controllers/HomeServlet.java): page servlet · Builds the authenticated home view · `src/main/java/com/briefup/controllers/HomeServlet.java`
- [List Decks](https://github.com/faresmallah/briefup/blob/main/src/main/java/com/briefup/controllers/ListDecksServlet.java): deck servlet · Returns user decks · `src/main/java/com/briefup/controllers/ListDecksServlet.java`
- [Create Deck](https://github.com/faresmallah/briefup/blob/main/src/main/java/com/briefup/controllers/CreateDeckServlet.java): deck servlet · Creates a new deck · `src/main/java/com/briefup/controllers/CreateDeckServlet.java`
- [Save Deck](https://github.com/faresmallah/briefup/blob/main/src/main/java/com/briefup/controllers/SaveDeckServlet.java): deck servlet · Persists deck edits · `src/main/java/com/briefup/controllers/SaveDeckServlet.java`
- [Delete Deck](https://github.com/faresmallah/briefup/blob/main/src/main/java/com/briefup/controllers/DeleteDeckServlet.java): deck servlet · Deletes a deck · `src/main/java/com/briefup/controllers/DeleteDeckServlet.java`
- [List Cards](https://github.com/faresmallah/briefup/blob/main/src/main/java/com/briefup/controllers/ListCardsServlet.java): card servlet · Loads cards for a deck · `src/main/java/com/briefup/controllers/ListCardsServlet.java`
- [Study Session](https://github.com/faresmallah/briefup/blob/main/src/main/java/com/briefup/controllers/StudySessionServlet.java): study servlet · Tracks study attempts · `src/main/java/com/briefup/controllers/StudySessionServlet.java`
- [Stats](https://github.com/faresmallah/briefup/blob/main/src/main/java/com/briefup/controllers/GetStatsServlet.java): analytics servlet · Returns progress metrics · `src/main/java/com/briefup/controllers/GetStatsServlet.java`
- [Leaderboard](https://github.com/faresmallah/briefup/blob/main/src/main/java/com/briefup/controllers/LeaderboardServlet.java): ranking servlet · Serves ranking view · `src/main/java/com/briefup/controllers/LeaderboardServlet.java`
- [Upload PDF](https://github.com/faresmallah/briefup/blob/main/src/main/java/com/briefup/controllers/UploadPdfDeckServlet.java): ai servlet · Starts PDF-to-flashcard flow · `src/main/java/com/briefup/controllers/UploadPdfDeckServlet.java`

### Domain

Core application entities

- [User](https://github.com/faresmallah/briefup/blob/main/src/main/java/com/briefup/models/User.java): domain model · Authenticated account · `src/main/java/com/briefup/models/User.java`
- [Deck](https://github.com/faresmallah/briefup/blob/main/src/main/java/com/briefup/models/Deck.java): domain model · Flashcard deck aggregate · `src/main/java/com/briefup/models/Deck.java`
- [Card](https://github.com/faresmallah/briefup/blob/main/src/main/java/com/briefup/models/Card.java): domain model · Single flashcard · `src/main/java/com/briefup/models/Card.java`
- [User Stats](https://github.com/faresmallah/briefup/blob/main/src/main/java/com/briefup/models/UserStats.java): domain model · Study progress and ranking data · `src/main/java/com/briefup/models/UserStats.java`

### Persistence

DAOs and database connection boundary

- [User DAO](https://github.com/faresmallah/briefup/blob/main/src/main/java/com/briefup/dao/UserDAO.java): JDBC DAO · User persistence access · `src/main/java/com/briefup/dao/UserDAO.java`
- [Deck DAO](https://github.com/faresmallah/briefup/blob/main/src/main/java/com/briefup/dao/DeckDAO.java): JDBC DAO · Deck persistence access · `src/main/java/com/briefup/dao/DeckDAO.java`
- [Card DAO](https://github.com/faresmallah/briefup/blob/main/src/main/java/com/briefup/dao/CardDAO.java): JDBC DAO · Card persistence access · `src/main/java/com/briefup/dao/CardDAO.java`
- [Stats DAO](https://github.com/faresmallah/briefup/blob/main/src/main/java/com/briefup/dao/UserStatsDAO.java): JDBC DAO · Study and leaderboard persistence · `src/main/java/com/briefup/dao/UserStatsDAO.java`
- [DB Connection](https://github.com/faresmallah/briefup/blob/main/src/main/java/com/briefup/db/DBConnection.java): jdbc config · MySQL connection factory · `src/main/java/com/briefup/db/DBConnection.java`

### AI Pipeline

PDF parsing and flashcard generation

- [Flashcard AI](https://github.com/faresmallah/briefup/blob/main/src/main/java/com/briefup/ai/AiFlashcardService.java): AI service · Generates flashcards from extracted text · `src/main/java/com/briefup/ai/AiFlashcardService.java`

### External

Runtime and third-party dependencies

- **Tomcat**: servlet container · Hosts the WAR application
- **MySQL**: database · Persistent data store
- **OpenAI API**: external AI · LLM-backed content generation

## Connections

- Main Entry → Login: entry · Public landing path to authentication
- Main Entry → Signup: entry · Public landing path to account creation
- Home UI → Home: renders · Server builds the authenticated home page
- Deck UI → List Cards: loads · Deck page fetches cards for editing or study
- Home JS → List Decks: ajax · Client requests the user's decks
- Deck JS → Save Deck: ajax · Client saves deck changes
- Deck JS → Study Session: ajax · Client records study events
- Auth Filter → Home: guards · Protects authenticated entry points
- Auth Filter → List Decks: guards · Protects authenticated entry points
- Auth Filter → Create Deck: guards · Protects authenticated entry points
- Auth Filter → Save Deck: guards · Protects authenticated entry points
- Auth Filter → Delete Deck: guards · Protects authenticated entry points
- Login → User DAO: authenticates · Validates credentials against persisted users
- Signup → User DAO: creates · Persists new user accounts
- Logout → User: clears · Ends the session for the current user
- Home → Deck DAO: reads · Loads deck summaries for the home view
- List Decks → Deck DAO: reads · Fetches user decks
- Create Deck → Deck: builds · Creates a new deck object
- Save Deck → Deck: updates · Applies deck edits
- Delete Deck → Deck DAO: deletes · Removes deck records
- List Cards → Card DAO: reads · Loads cards for a deck
- Study Session → Stats DAO: writes · Stores study outcomes
- Stats → Stats DAO: reads · Returns aggregated user progress
- Leaderboard → Stats DAO: reads · Builds ranking data from stats
- Upload PDF → Flashcard AI: invokes · Starts document-to-flashcard generation
- Upload PDF → Deck DAO: persists · Stores the generated deck
- Flashcard AI → OpenAI API: calls · Sends extracted text to the LLM API
- Flashcard AI → Card: produces · Generates flashcard content
- Deck DAO → DB Connection: uses · Opens JDBC connections
- Card DAO → DB Connection: uses · Opens JDBC connections
- User DAO → DB Connection: uses · Opens JDBC connections
- Stats DAO → DB Connection: uses · Opens JDBC connections
- DB Connection → MySQL: connects · JDBC boundary to MySQL
- Home → User: uses · Builds user-aware home content
- Study Session → User Stats: updates · Transforms study attempts into progress data
- Stats → User Stats: returns · Serves progress metrics
- Leaderboard → User Stats: ranks · Orders users by progress
- Create Deck → Card: adds · Attaches cards to newly created decks
