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

Тематика проекта - социальная сеть, похожая на Twitter.

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

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

1. ES2021
2. Git
3. REST API
4. JWT
5. Socket.IO
6. npm
7. ESLint

1. React Native
2. Redux
3. React Navigation
4. dayjs
5. React Hook Form
6. joi

1. Node.js
2. Fastify
3. Knex
4. Objection
5. axios
6. bcrypt
7. Babel
8. nodemon
9. dotenv
10. jsonwebtoken

1. PostgreSQL

1. Установить последнюю стабильную версию Node.js (LTS). Note: npm будет установлен автоматически. Проверьте корректность установки: для этого выполните в командной строке (терминале):

   node -v  // для проверки версии Node.js
   npm -v // для проверки версии npm

2. Установить последнюю стабильную версию PostgreSQL для вашей OS. Проверьте корректность работы - попробуйте создать базу, таблицу, - для этого можете использовать pgAdmin или другой удобный способ, который найдете.

3. Создайте в PostgreSQL пустую базу данных для проекта. Например, thread.

4. Установите Git.

5. Склонировать репозиторий проекта:

   git clone [email protected]:BinaryStudioAcademy/thread-js.git

6. Создать репозиторий на Bitbucket и вести дальнейшую разработку там.

1. В руте проекта можно установить все зависимости одной командой:

     npm run install:all

   Это установит зависимости для рутовой директории, frontend'а и backend'a. Можно установить для каждой папки отедьно (смотрите ниже).

2. После установки пакетов, в руте проекта нужно запустить команду для git-хуков:

     npx simple-git-hooks

   Теперь на каждый ваш коммит будет запускаться линтер и проверять ваш код.

1. В командной строке (терминале) зайдите в папку server:

   cd /* путь к папке server */

2. Установите все необходимы пакеты из package.json командой:

   npm install

3. В папке server создайте файл .env и скопируйте в него содержимое из файла .env.example.

   Note: файл .env содержит реальные ключи проекта и не должен сохраняться в репозиторий.

   Замените в файле .env значения ключей на действительные. Для того, чтобы указать ключи для Gyazo Storage, необходимо зарегистрироваться на сайте Gyazo и зарегистрировать приложение. Затем в .env использовать access token из только что созданного приложения в Gyazo.

4. Выполните миграции и сиды для того, чтобы заполнить базу данных демо-данными. Для этого в командной строке (терминале) в папке server выполните:

   npm run migrate:run
   npm run seed:run

   Проверьте базу данных на наличие демо-данных.

5. Для запуска сервера в командной строке (терминале) в папке сервера выполните:

   npm start

1. Настройте окружение следуя документации React Native

2. В командной строке (терминале) зайдите в папку client:

   cd /* путь к папке client */

3. Установите все необходимы пакеты из package.json командой:

   npm install

4. В папке client создайте файлы .env.android и .env.ios, скопируйте в них содержимое из соответствующих файлов .env.example.

   Note: файлы .env содержат реальные ключи проекта и не должны сохраняться в репозиторий.

   Замените в файлах .env значения ключей на действительные.

5. Для запуска клиента в командной строке (терминале) в папке клиента выполните:

   npx react-native start

   Note: в случае изменения .env файла при запуске команды нужно добавить флаг --reset-cache:

   npx react-native start --reset-cache

   Откройте новый терминал и из папки клиента запустите одну из следующих команд:

   npx react-native run-android

   npx react-native run-ios

Необходимо добавить следующие возможности:

1. Поставить dislike посту.
2. Обновить свой пост.
3. Удалить свой пост.
4. Фильтр - отображать только те посты, которым я (как пользователь) поставил лайк.
5. Обновить собственный профиль. Добавить валидацию.
6. Устанавливать статус пользователя (например, "А сегодня, в завтрашний день, не все могут смотреть. Вернее.."). Отображать его под username.
7. Скачать изображение поста.
8. Сбросить пароль (Forgot password). Отправить email с ссылкой на изменение пароля в приложении.
9. Обновить свой комментарий.
10. Удалить свой комментарий.
11. Поставить like комментарию.
12. Поставить dislike комментарию.
13. Фильтр - не отображать свои посты, а отображать только чужие.
14. Отправить пользователю email, если его посту поставили like.

Весь список тасков также можно найти на доске Trello в колонке To Do. Доску нужно скопировать себе и по ней работать. Это поможет вам отслеживать весь процесс своей работы, а нам - определить, что уже готово. Таск будет считаться выполненным, если он полностью завершен и фича работает. Посмотрим на ее реализацию и оценим, правильно ли распределили логику в проекте. Это покажет, насколько вы разобрались в архитектуре. Также дадим комментарии по коду.

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

Ссылки:

1. Репозиторий.
2. Trello.

1. Какие фреймворки, библиотеки и их фичи можно использовать?

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

2. Можно ли изменять базу данных (добавлять колонки, таблицы)?

   Можно, а в некоторых задачах даже нужно. Для этого вам необходимо создавать новые миграции. Существующие миграции изменять нельзя.

3. Не устанавливается bcrypt

   Скорее всего, ему не хватает зависимостей на вашем компьютере. В документации bcrypt можно найти какие именно необходимы для вашей системы.

4. Ошибка: Expected linebreaks to be 'LF' but found 'CRLF' linebreak-style

   Необходимо изменить параметр autocrlf на input либо false в настройках Git. Возможно, понадобится стянуть проект заново.

5. При регистрации приложения на сайте Gyazo требуется указать Authorization callback URL

Укажите https://www.google.com/.