Простой сервис сокращения ссылок на FastAPI с хранением данных в PostgreSQL.

Проект умеет:

• создавать короткие ссылки;
• автоматически добавлять https://, если пользователь вводит только домен;
• редиректить по короткому коду;
• хранить ссылки в базе данных;
• отображать список всех ссылок в HTML-странице;
• запускаться локально и через Docker Compose.

• Создание короткой ссылки через API
• HTML-интерфейс для создания ссылок
• Страница со списком всех сохраненных ссылок
• Хранение данных в PostgreSQL
• Подсчет количества переходов по ссылке
• Кнопка копирования короткой ссылки
• Запуск через Docker Compose

• Python
• FastAPI
• PostgreSQL
• SQLAlchemy
• Jinja2
• JavaScript
• Docker
• Docker Compose

url_shortener/
├── app/
│   ├── main.py
│   ├── db.py
│   ├── models.py
│   ├── schemas.py
│   └── utils.py
├── templates/
│   ├── index.html
│   └── links.html
├── static/
│   ├── style.css
│   └── script.js
├── Dockerfile
├── docker-compose.yml
├── requirements.txt
├── .env
├── .env.docker
└── README.md

1. Пользователь вводит длинную ссылку на главной странице
2. Сервис нормализует URL
3. Генерируется короткий код
4. Ссылка сохраняется в PostgreSQL
5. Пользователь получает короткий URL
6. При переходе по короткому URL происходит редирект на оригинальную ссылку
7. Количество переходов увеличивается

git clone <URL_РЕПОЗИТОРИЯ>
cd url_shortener

python3 -m venv venv
source venv/bin/activate

pip install -r requirements.txt

Пример:

POSTGRES_DB=urlshortener
POSTGRES_USER=urluser
POSTGRES_PASSWORD=urlpass
POSTGRES_HOST=localhost
POSTGRES_PORT=5432

Нужно, чтобы база и пользователь существовали.

Пример команд:

CREATE USER urluser WITH PASSWORD 'urlpass';
CREATE DATABASE urlshortener OWNER urluser;
GRANT ALL PRIVILEGES ON DATABASE urlshortener TO urluser;

python -m uvicorn app.main:app --host 127.0.0.1 --port 8000

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

• http://127.0.0.1:8000/
• http://127.0.0.1:8000/docs
• http://127.0.0.1:8000/links-page

Пример:

POSTGRES_DB=urlshortener
POSTGRES_USER=urluser
POSTGRES_PASSWORD=urlpass
POSTGRES_HOST=db
POSTGRES_PORT=5432

docker compose up --build

• http://localhost:8000/
• http://localhost:8000/docs
• http://localhost:8000/links-page

• GET / — главная страница
• GET /links-page — страница со всеми ссылками

• GET /health — проверка состояния сервиса
• POST /shorten — создать короткую ссылку
• GET /links — получить все ссылки в JSON
• GET /{code} — редирект на оригинальную ссылку

curl -X POST "http://127.0.0.1:8000/shorten" \
-H "Content-Type: application/json" \
-d '{"url":"google.com"}'

Пример ответа:

{
  "original_url": "https://google.com",
  "short_code": "Ab12Cd",
  "short_url": "http://127.0.0.1:8000/Ab12Cd"
}