Postomania — Сборщик постов из LinkedIn

Приложение для автоматического сбора и управления постами из LinkedIn. Позволяет отслеживать профили, собирать их посты, переводить на русский и сортировать по категориям.

---

Что умеет приложение

• 📥 Собирать посты — автоматически загружает посты из LinkedIn-профилей через Apify
• 🔍 Фильтровать и искать — поиск по тексту, сортировка по дате/реакциям
• ⭐ Организовывать — раскладывайте посты по вкладкам: новые, избранное, скрытые, опубликованные
• 🌐 Переводить — перевод постов на русский через AI (OpenRouter)

---

Шаг 1: Установка Docker

Docker — это программа, которая позволяет запускать приложения в изолированном контейнере. Без Docker приложение не запустится.

На Mac

1. Перейдите на сайт: https://www.docker.com/products/docker-desktop/
2. Нажмите "Download for Mac"
3. Выберите версию:
   • Apple Silicon — если у вас Mac с чипом M1, M2, M3 или M4
   • Intel — если у вас более старый Mac
4. Откройте скачанный файл .dmg
5. Перетащите иконку Docker в папку Applications
6. Запустите Docker из папки Программы (Applications)
7. Дождитесь, пока Docker запустится (иконка кита в верхней панели перестанет анимироваться)

💡 Как узнать какой у вас Mac? Нажмите на яблоко () в левом верхнем углу → "Об этом Mac". Если написано "Чип Apple M1/M2/M3/M4" — выбирайте Apple Silicon.

На Windows

1. Перейдите на сайт: https://www.docker.com/products/docker-desktop/
2. Нажмите "Download for Windows"
3. Запустите скачанный установщик Docker Desktop Installer.exe
4. Следуйте инструкциям установщика
5. Важно: При установке убедитесь, что включена опция "Use WSL 2" (обычно включена по умолчанию)
6. После установки потребуется перезагрузить компьютер
7. После перезагрузки запустите Docker Desktop
8. Дождитесь, пока Docker запустится (статус "Running" в окне программы)

⚠️ Требования для Windows:

• Windows 10 версии 2004 или новее (или Windows 11)
• Включённая виртуализация (обычно включена по умолчанию)

---

Шаг 2: Скачивание проекта

1. Перейдите на страницу проекта: https://github.com/CasperOnrun/Postomania
2. Нажмите зелёную кнопку "Code"
3. Выберите "Download ZIP"
4. Распакуйте скачанный архив в удобное место, например:
   • Mac: /Users/ваше_имя/Postomania-main
   • Windows: C:\Users\ваше_имя\Postomania-main

💡 При распаковке ZIP с GitHub папка будет называться Postomania-main (с суффиксом -main)

---

Шаг 3: Запуск приложения

На Mac

1. Убедитесь, что Docker запущен (иконка кита в верхней панели)

2. Откройте программу Терминал (найдите через Spotlight: нажмите Cmd + Пробел, введите "Терминал")

3. Перейдите в папку проекта. Введите команду и нажмите Enter:

   cd /Users/ваше_имя/Postomania-main

   (замените ваше_имя на имя вашей папки пользователя)

4. Запустите приложение:

   docker-compose up --build

5. Дождитесь, пока в терминале появятся сообщения о запуске (займёт 1-2 минуты при первом запуске)

6. Откройте браузер и перейдите по адресу: http://localhost:5050

На Windows

1. Убедитесь, что Docker Desktop запущен

2. Откройте PowerShell или Командную строку:

   • Нажмите Win + R, введите powershell и нажмите Enter

3. Перейдите в папку проекта:

   cd C:\Users\ваше_имя\Postomania-main

   (замените ваше_имя на имя вашей папки пользователя)

4. Запустите приложение:

   docker-compose up --build

5. Дождитесь завершения сборки (1-2 минуты при первом запуске)

6. Откройте браузер и перейдите по адресу: http://localhost:5050

---

Шаг 4: Первоначальная настройка

При первом запуске нужно настроить API-ключи:

1. В приложении откройте раздел Настройки (⚙️)
2. Введите Apify Token — нужен для сбора постов из LinkedIn
   • Получить можно на https://apify.com после регистрации
3. Введите OpenRouter API Key — нужен для перевода постов
   • Получить можно на https://openrouter.ai после регистрации
4. Нажмите Сохранить

---

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

• В терминале (где запущено приложение) нажмите Ctrl + C
• Или в Docker Desktop найдите контейнер и нажмите Stop

---

Как запустить повторно

Если приложение было остановлено и нужно запустить снова:

1. Откройте Терминал (Mac) или PowerShell (Windows)
2. Перейдите в папку проекта (cd путь/к/Postomania-main)
3. Выполните:

   docker-compose up

   (без --build, если не было изменений в коде)

---

Частые проблемы

"Cannot connect to the Docker daemon"

Docker не запущен. Откройте Docker Desktop и дождитесь запуска.

Порт 5050 занят

Другое приложение использует порт 5050. Закройте его или измените порт в файле docker-compose.yml.

Приложение не открывается в браузере

Убедитесь, что:

• Docker контейнер запущен (в терминале нет ошибок)
• Вы вводите адрес http://localhost:5050 (именно http, не https)

Медленная первая загрузка

При первом запуске Docker скачивает базовые образы (~100-200 МБ). Это нормально, последующие запуски будут быстрее.

---

Техническая информация

• Порт: 5050
• База данных: SQLite (файл linkedin_posts.db)
• Фреймворк: Flask (Python)