Файловая структура проекта

/├── .gitignore
/├── README.md
/├── CONTRIBUTING.md
/├── Dockerfile
/├── docker-compose.yml
/├── .env.example
/├── frontend
│   ├── index.html
│   ├── styles
│   │   └── main.scss
│   ├── scripts
│   │   └── main.js
│   └── public
│       └── assets
├── backend
│   ├── app
│   │   ├── __init__.py
│   │   ├── main.py            # FastAPI entry point
│   │   ├── api
│   │   │   ├── auth.py
│   │   │   ├── lobby.py
│   │   │   └── game.py
│   │   ├── models
│   │   │   ├── user.py
│   │   │   ├── lobby.py
│   │   │   └── card.py
│   │   ├── schemas
│   │   │   ├── user.py
│   │   │   └── lobby.py
│   │   ├── db.py
│   │   ├── websocket.py
│   │   └── utils.py
│   ├── tests
│   │   ├── conftest.py
│   │   ├── test_auth.py
│   │   ├── test_lobby.py
│   │   └── test_game_ws.py
│   ├── alembic
│   │   └── versions
│   └── docker
│       └── requirements.txt
├── docs
│   └── technical_spec.md
└── .prettierrc

Краткое описание каталогов

Каталог	Что содержит
frontend	Статические файлы и JavaScript‑сценарии, стили SCSS
backend	Код FastAPI, модели, схемы Pydantic, база‑данных, миграции alembic, unit & integ тесты
tests	Тесты для каждого подмодуля
docs	Техническое задание, пользовательская и разраб. документация
docker	Требования и скрипты для сборки образов

Это простая, но в то же время мощная структура, позволяющая держать клиентскую и серверную часть изолированными, легко управлять зависимостями, а также быстро запускать проект с помощью Docker‑Compose.