Администрирование блога Hexo (версия Python 3.6)

####################################################
#              >>> Изначальные учетные данные <<<  #
#           Пользователь: lmay@lmaye.com          #
#           Пароль: root@123                      #
####################################################

hexo-blog-admin                         # Hexo Blog Admin
├── core                                 # Ядро
│   ├── constant                         # Константы
│   ├── controller                       # Контроллеры
│   ├── exception                        # Пользовательские исключения
│   ├── forms                            # Элементы формы
│   ├── handler                          # Бизнес-логика
│   ├── logger                           # Логирование
│   ├── models                           # Модели
│   ├── params                           # Параметры
│   ├── rbac                             # Управление доступом RBAC
│   ├── utils                            # Вспомогательные утилиты
│   └── __init__.py                      # Файл инициализации
│   └── app.py                           # Основной файл приложения
└── resources                           # Ресурсы проекта
    ├── db_repository                    # Ресурсы для генерации баз данных [уже сгенерировано, можно игнорировать]
    ├── docs                             # Документация
    ├── source                           # Директория Markdown файлов [только для тестирования]
    ├── static                           # Директория статических файлов (js/css/images...)
    ├── templates                        # Директория HTML файлов
    └── app.db                           # SQLite база данных
    └── application.yml                 # Конфигурационный файл проекта
    └── databases
``````yaml
# Конфигурационный файл баз данных
logging.conf            # Конфигурационный файл логирования
- bin                   # Выполнение скриптов [можно игнорировать]
- docker               # Скрипты для развертывания Docker
    -- docker-compose.yml   # docker-compose
    -- init.sh              # Bash скрипт
    -- nginx.conf          # Конфигурация Nginx
- logs                  # Директория логов
hexo-blog.sh            # Скрипт для создания статических страниц
hexo-blog-admin.ini     # Конфигурационный файл uwsgi (веб-сервер)
requirements.txt        # Файл для установки зависимостей
run.py                 # Скрипт запуска приложения
setup.py               # Скрипт сборки приложения [можно игнорировать]
README.md              # Документация проекта

### Системная архитектура
![Hexo Blog Admin](https://www.lmaye.com/group1/M00/00/00/CmiBTl1K9TKAYEd8AACaQc7nGPU158.png "Hexo Blog Admin")
```  Система основана на Python Flask фреймворке, управление доступом реализовано с использованием RBAC, международная локализация пока не реализована из-за отсутствия времени, но базовые требования блога полностью удовлетворены.  
Хранение файлов осуществляется через самостоятельно установленную систему FastDFS/MinIO вместо использования сторонних сервисов. Минимально рекомендую использовать MinIO, так как он хорошо поддерживается в Python.  
Для редактирования используется плагин Markdown, который после завершения редактирования генерирует MD файлы. В MongoDB хранятся только базовая информация и пути к статьям, содержание же не сохраняется. Также предусмотрена возможность восстановления данных MongoDB, поэтому даже при отказе службы MongoDB данные не будут потеряны;  
Информация управления безопасности хранится в SQLite DB, выбор SQLite обоснован небольшим объемом данных, таких как пользователи, меню, ресурсы и права доступа;
Другие детали можно найти в исходном коде.### Внимание
#### Общие инструкции по установке
   1. Установка интегрированных плагинов проекта
```shell
pip3 install flask
pip3 install pyyaml
pip3 install flask_wtf
pip3 install flask_sqlalchemy
pip3 install flask_mail
pip3 install flask-login==0.2.11
pip3 install flask_babel
pip3 install email_validator
# Перевод lazy строк
pip3 install speaklater
# Шифрование
pip3 install pycryptodome
# Redis
pip3 install flask-redis
# MongoDB
pip3 install Flask-PyMongo
# RBAC система управления правами доступа
pip3 install flask-rbac
pip3 install flask-marshmallow
# Запросы API
pip3 install requests
# Хранение файлов MinIO
pip3 install Flask-Minio
pip3 install uwsgi==2.0.18
```   2. Решение проблемы с установкой шифровального плагина pycryptodome (\Lib\site-packages\Crypto, имя пакета по умолчанию lowercase, следует заменить на uppercase **Crypto**)

   3. Быстрая установка всех зависимостей
```shell
pip3 install -r requirements.txt

# Установка зависимых служб с помощью Docker
[root@localhost hexo-blog]# ls
# Соответствующие файлы
-rw-r--r--. 1 root root 1568 Янв 20 18:16 docker-compose.yml
-rwxr-xr-x. 1 root root 1555 Янв 19 16:07 init.sh
-rw-r--r--. 1 root root 3941 Янв 20 18:39 nginx.conf
# Команды установки
[root@localhost hexo-blog]# ./init.sh 

# Запуск Python проекта
[root@localhost hexo-blog]# uwsgi -d --ini hexo-blog-admin.ini
# Проверка процессов
[root@localhost hexo-blog]# ps aux | grep uwsgi
# Остановка проекта
[root@localhost hexo-blog]# killall -9 uwsgi
```# Автоматический запуск проекта (необходимо заменить фактический путь: CONFIGFILE=/home/services/hexo-blog-admin/hexo-blog-admin.ini)
[root@localhost hexo-blog]# cp uwsgi.sh /etc/init.d/
[root@localhost hexo-blog]# cd /etc/init.d/
# Выполнение команд
[root@localhost init.d]# chmod 777 uwsgi.sh
# Добавление автоматического запуска
[root@localhost init.d]# chkconfig --add uwsgi.sh