Reading List API

Небольшой учебный проект на FastAPI, демонстрирующий работу CRUD-эндпоинтов, фильтрации и базовых связей между сущностями (Users, Items, Tags).

Разработчик

Автор: Евгений Мясников (justatrade@mail.ru)

Особенности проекта

• Асинхронный стек: FastAPI + SQLAlchemy 2.0 async + Alembic
• Чистая архитектура: разнесение по слоям (models, schemas, repositories, services, routers)
• Поддержка тегов, приоритетов и статусов для элементов списка чтения
• Эндпоинт /admin/seed — быстрая инициализация seed-данных

Запуск проекта

Требования:

• установлен Docker и Docker Compose.
• на базе .env_example, создан файл .env в корне проекта

docker compose up -d --build

После запуска API будет доступно по адресу:

http://127.0.0.1:8000

Документация и удобная Swagger UI админ-панель:

http://127.0.0.1:8000/swagger

Если требуется первичное заполнение базы тестовыми данными, можно выполнить:

POST /admin/seed

---