slack2pachka

Описание

Проект предназначен для переноса данных из Слак-дампов (штатных и альтернативных) в мессенджер Пачка.

Историю нашей миграции можно прочитать по следующей ссылке - История переноса данных.

Инсталляция

• скачать исходники;
• mvn clean install;
• настроить application.properties в соответствии со своими нуждами и потребностями;
• пользоваться!

application.properties

Содержит комментарии о том, зачем нужны те или иные параметры.

Использование

Программа представляет собой набор небольших утилит, основанных на spring-shell

AVAILABLE COMMANDS

• Built-In Commands встроенные команды spring-shell, за подробными объяснениями обратитесь к документации;

    help: Display help about available commands
    stacktrace: Display the full stacktrace of the last error.
    clear: Clear the shell screen.
    quit, exit: Exit the shell.
    history: Display or save the history of previously run commands
    version: Show version info
    script: Read and execute commands from a file.

• группа утилит для анализа информации дампа;

analyze
    analyze alt: dump archived slack channels, with owners
    analyze owners: dump slack channel owners list
    analyze messages: aggregate slack messages to get compact field representation
    analyze archived: dump archived slack channels, with owners

• создание пользователя;

create
    create user: create user

• группа утилит для удаления пользователей, участников бесед, каналов (бесед); беседа не удаляется, так как в API отсутствует возможность удаления каналов; выход - делаем канал приватным, удаляем участников, называем канал "deleted" (например);

drop
    drop users: drop users
    drop members: drop channel members
    drop channels: drop channels

группа утилит для исправления уже созданных сущностей:

• информация о пользователе;
• исправляем (дополняем) аттачменты сообщений; в процессе импорта несколько раз возникала необходимость дозаливки аттачментов;
• исправляем комментарии (при работе с альтернативными дампами потеряли комментарии, пришлось исправлять);

fix
    fix attachments: fix message attachments
    fix user: change user data
    fix threads: fix message threads

и, наконец, самая важная группа команд:

• импорт данных из штатного дампа;
• импорт пользователей из штатного дампа;
• импорт сообщений из альтернативного дампа;

import
    import users: (stage 2) import users and update channel member lists
    import alt: import from alternate dump
    import messages: (stage 1) import messages

группа тестов для проверки основных настроек и работоспособности сервисов;

test
    test message: message API tests
    test user: user API tests
    test all: all API complete tests
    test channel: channel API tests

Поддержка

Если вы столкнетесь с какими-либо проблемами и трудностями, мы постараемся по возможности вам помочь - проконсультируем, подскажем и даже поправим код (в пределах разумного).

Roadmap

Программа одноразовая, мы не планируем ее дальнейшее развитие, наш переезд уже состоялся. Все, для чего предназначена программа, работает. Возможно, вы захотите реализовать что-то по-своему, по-другому. Мы будем рады, если то, что мы сделали, хотя бы немного упростит и ваш переезд. Удачных импортозамещений!

Contributing

Будем рады помочь в реализации Ваших идей и внести Ваши доработки.

Authors and acknowledgment

Большая и дружная команда Assist

License