Группы и Состояния

• И так, вы запустили портал и настроили все необходимые токены и модули.
• Первое, что Вам надо сделать, это зарегистрировать любого персонажа Вашей корпорации через главную страницу Вашего нового портала
  https://abc.niceplatform.ru
  (вместо символов abc должен быть суб-домен)
  После регистрации персонажа, на портал будет подгружена информация из EVE Online о Вашем персонаже и корпорации.
• Вся механика портала построена на предоставление доступов к состояниям(States) и/или группам(Group).
• Как писалось выше, портал состоит из модулей и оператор/администратор настраивает доступ к модулям посредством изменения прав у States и/или Group.
• Разница между States и Group лишь в том, что States являются автоматическое назначение доступов, а в Group нужно юзерам самим подавать заявку. Заявки одобряются лидерами Group.
• Настройка States и Group производится только из админки портала. (ссылка на админку в карточке портала, как и логин с паролем)
• Из админки можно попасть на портал путем нажатия на ссылку
  
  Что-бы постоянно не перелогиниваться со своего персонажа на администратора, переходим на портал из админки и проходим регистрацию своего персонажа, после этого юзеру с этим персонажем присваивается статус суперпользователь. Так-же со статусом суперпользователь можно попасть в админку прямо из портала, ссылка в верхнем выпадающем меню. Статус суперпользователь можно предоставить любому юзеру, например директору или другому доверенному, статус настраивается из админки портала. Следует с осторожностью относиться к выдаче суперпользователя, такой статус получает полный доступ к порталу, но не к профилю на платформе.
• При первом логине нового персонажа, если он не подпадает под условия States, персонаж попадает в Guest, данный States устанавливается по умолчанию. На Guest тоже можно навесить доступы, но не рекомендуется.

Запуск модулей

• В развернутом портале есть несколько встроенных модулей.
• На данный момент присутствуют такие встроенные модули как:
• Discord - модуль для регистрации мемберов корпорации на корпоративном сервере discord.(В связи с проблемами подключения к Discord в России, целесообразность активации данного модуля спорно.)
• Structures - модуль для отслеживания состояния структур корпорации(пока в разработке).
• Killboard_statistic - модуль для поиска слитых шипов, работает с любым именем(альянс/корпорация/персонаж),
  можно отследить по ссылке релейта с zKill или по списку систем в период от 1 часа до 7 суток.
  (специфичный модуль, но может кому пригодится)

Discord

• Для настройки модуля Discord потребуется чуть больше усилий, чем настройка SSO.
• Во-первых, нужно включить сам модуль:
• • Снова открываем панель управления и находим в карточке с порталом кнопку Edite Environment.
• • Создаём два поля и вносим туда ключ-значение.

1. Далее немного картинок.
2. • Создаём свой сервер дискорд и копируем ID сервера в блокнот.
3. • Идем на discord.com/developers/applications, естественно там нужно залогинится своим акком из дискорда.
4. • Создаём Application.
     
5. • В выпадающем окне вписываем имя бота, которое мы хотим видеть у себя в дискорде.(Все имена пишутся латиницей, такова структура дискорда.)
6. • Попадаем на страницу с инфо о боте. Оставляем всё как есть и тычем в Installation.
     
7. • В следующем окне снимаем галку с User Install , тычем в OAuth2.
     
8. • Попадаем в окно.
     
9. • В этом окне копируем данные из строки Client ID к себе, например в блокнот, далее из строки Client Secret копируем к себе в блокнот.(Если не видите значение, то сгенерируйте новый Client Secret(там есть кнопка генерации) и скопируйте в блокнот)
     В строку Redirects Вам нужно вписать такое значение
     https://abc.niceplatform.ru/discord/add_dis естественно Вам нужно поменять символы abc на свой под-домен портала.
10. • Крутим окно ниже.
      
      Ставим галку на bot.
11. • Крутим ещё ниже, тут добавляем разрешения боту, что бы не париться с доступами, ставьте админа.
      
12. • В самом низу окна появиться ссылка
      
      Копируем эту ссылку и в новом окне браузера вставляем её в адресную строку, переходим по ней,таким образом мы пригласим своего бота на свой же сервер дискорд.
13. • Далее идём сюда.
      
      Тут смотрим токен, если его нет, то генерируем и сохраняем в блокнот.
14. • Листаем ниже и включаем эти галки.
      
15. • Возвращаемся к карточке развёрнутого портала нажимаем Edite Environment , создаём несколько полей и вставляем туда ключи-значения.

• Сохраняем таблицу.

Мониторинг

Настройки проекта

• Для полноценного запуска портала потребуется несколько шагов, т.к. получение токенов у EVE, Discord и т.п. приложений, требуются некоторые телодвижения, которые ну никак не автоматизировать.

1. Настройка EVE SSO доступа.

• 1а. Находим у себя самый не нужный аккаунт EVE, новый аккаунт создать можно, но при создании Application, ССР потребует активный аккаунт,
  
  с которого хоть раз активировали подписку.
  Что-бы позеленела нижняя строчка, нужно по ней кликнуть и принять соглашение.
  (т.к. портал нужен для директоров или сео корпорации, с этим проблем возникнуть не должно).
  Важно не забыть на каком аккаунте у Вас создан Application и постараться не менять пароль от акка, иначе система ССР может аннулировать токен и придётся его менять на портале в env файле.
• 1b. Идём по ссылке developers.eveonline.com, логинимся под аккаунтом, который нашли или создали.
• 1c. Переходим в раздел Applications => My Applications => Create Application
• 1d. Попадаем сюда
  (убедитесь что вы вошли под каким нужно EVE аккаунтом) и далее по пунктам:
• • Поле Name - поле для имени вашего app, может быть любым именем, но на латинице.Важно что-бы Вы различали свои apps, вдруг Вам потребуется несколько apps.
• • Поле Description - поле для описания app, поле обязательное к заполнению, можете написать то-же имя, что и написали выше.
• • Поле Callback URL - поле для ввода обратного запроса от SSO.
    ВАЖНО в это поле вводим ручками обратный адрес вида:
    https://abc.niceplatform.ru/sso/callback
    символы abc поменяйте на придуманный Вами суб-домен при развертывании портала.Или скопируйте ссылку из текста, вставьте в поле и замените символы на имя суб-домена.
• • Поле Enablied Scopes - пункты для запроса списка доступов у мемберов , которые будут регистрироваться на портале.К персонажу, на котором создаётся этот app, никакого отношения эти доступы иметь не будут. Это шаблон доступов.
    На данном этапе настройки портала Вам потребуются указать запросы к Public Data и esi-characters.read_corporation_roles.v1. Запрос к Public Data, это то же самое, если ин-гейм посмотреть инфо у любого персонажа в игре. Запрос к esi-characters.read_corporation_roles.v1 требуется порталу, что-бы раскидывать автоматически роли в дискорде. У Вас должно получится вот это, естественно с Вашими правками суб-домена.
• • 
• • Кнопка Save - что бы сохранить, всё что Вы тут на вояли.
• • После сохранения у вас должно получится вот такого вида окно.
    
    Окно пока скрываем, что-бы не мешалось.

2. Внесение данных из SSO в .env файл.

• 2a. Идем в свою панель управления
• 2b. Ищем карточку с порталом, который настраиваем и нажимаем кнопку Edite Environment
  
• 2c. Создадим сразу три поля
  
• 2d. Открываем наше окно в браузере с SSO настройками, что мы создали ранее в developers.eveonline.com
• 2e. Теперь очень внимательно относимся к внесению правок в поля редактирования env файла.
  В таблице карточки, что мы создали, вспоминаем, 3-поля.
  В левое поле записывается ключ, в правое поле записывается значение.
  И так смотрим:
  В первое поле,в левую часть пишем ключ ESI_SSO_CLIENT_ID, а в правую часть пишем значение из вашего app , из строки Client ID, там кнопка есть в конце строки - скопировать(Copy to Clipboard)
  Во второе поле в левую часть пишем ESI_SSO_CLIENT_SECRET, в правую часть пишем значение из нашего app из строки Client Secret, там кнопка есть в конце строки - скопировать(Copy to Clipboard)
  В третьем поле в левую часть пишем ESI_SSO_CALLBACK_URL, в правую часть пишем значение из нашего app из строки Callback URL, там кнопка есть в конце строки - скопировать(Copy to Clipboard)
• • Сохраняем это всё (Зелёная кнопка-Сохранить).
• • Пример ввода ключей значений (значения отсюда копировать не надо, они у Вас свои):

• 2i. Внимательно относитесь к вводу ключей-значение, при вводе ошибочного ключа или значения Вам поможет только саппорт.
  Работы по переходу на более удобоваримый способ ведутся, но пока вот так.