Введение

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

2. Адрес проекта:

   • https://github.com/konglingyinxia/charging_pile_cloud.

   Интерфейс документа:

   • https://www.showdoc.cc/360525838410865.

   Пароль доступа: 123456.

3. Роли в проекте:

   • супер-администратор;

   • региональный агент;

   • обычный пользователь.

Архитектура программного обеспечения

1. Используемые технологии:

   • Spring Boot: 2.1.4.RELEASE;

   • Spring Cloud: Greenwich.SR1;

   • MyBatis-Plus: 3.0.7.1;

   • Redis: 5.0.5 (для разработки — 3.0.503);

   • MySQL: 5.5;

   • JDK: 1.8.

2. Структура каталогов проекта:

   • common-server: различные пакеты инструментов и общие настройки;

   • doc: документы проекта;

   • db: файлы базы данных:

     • data.sql: содержит файл с базовыми данными;

     • ini_data.sql: скрипт SQL для инициализации базы данных при запуске проекта;

     • com_config_area.sql: используется для трёх уровней адресов привязки, но не поддерживается в небольших программах, поэтому проект использует только один уровень;

   • img: изображения для документации;

   • log: каталог журналов;

   • page: страницы управления бэкендом;

   • suda-common-constant: общие константы;

   • suda-common-entity: сущности проекта;

   • suda-platform-web: слои управления, бизнес-логики и данных проекта.

3. Описание конфигурационных файлов проекта:

   1. Порт сервера, порт Redis и порт базы данных datasource.

   2. Конфигурация WeChat Mini Program и конфигурация wx:pay, а также файл конфигурации my-configuration.

   Файл конфигурации my-configuration:

   * uploadPath: путь хранения изображений на сервере;
   
   * imagePath: путь доступа к изображениям;
   
   * staticPageUrl: конфигурация каталога статических ресурсов на сервере.
   3. Пользовательский класс конфигурации InterceptorConfig.addResourceHandlers.

4. Проверка прав доступа на основе перехватчика:

   Используемые технологии: Redis + JWT.

   Метод реализации:

   • после входа пользователя генерируется токен JWT, который каждый раз отличается;

   • токен сохраняется в Redis с установленным временем ожидания;

   • после успешного входа пользователя возвращается токен переднего плана;

   • при каждом запросе токен помещается в заголовок запроса;

   • каждый запрос проходит через перехватчик для проверки токена;

   • состояние входа:

     • без входа: перехватчик не может получить информацию о токене;

     • вход с одного устройства: если информация о токене в заголовке запроса не совпадает с информацией в Redis, это означает, что пользователь вошёл в систему с другого места;

     • тайм-аут входа: если информация о токене не найдена в Redis, то пользователь превысил время ожидания входа.

Инструкция по установке

1. Настройка серверной среды:

   • перейдите на сайт https://oneinstack.com/, чтобы создать собственный пакет установки (база данных, Redis, JDK, Nginx);

   • выполните команду на сервере:

wget -c http://mirrors.linuxeye.com/oneinstack-full.tar.gz && tar xzf oneinstack-full.tar.gz && ./oneinstack/install.sh --nginx_option 1 --jdk_option 2 --db_option 4 --dbinstallmethod 1 --dbrootpwd oneinstack --redis  --reboot

2. Создайте базу данных.

3. Создайте каталог проекта на сервере:

   • каталог статических ресурсов: /home/project/staticFile;

   • каталог конфигурационных файлов: /home/project/config;

   • каталог журналов: /home/project/log;

   • файл запуска: поместите файл оболочки в каталоге doc в /home/project/. Измените имя файла на charge.sh и сделайте его исполняемым с помощью команды chmod 777 charge.sh. Измените имя запускаемого файла в скрипте на charge-1.0.jar.

4. Упакуйте проект в jar-файл с именем charge-1.0.jar и загрузите его в каталог /home/project/. Запустите проект с помощью команды ./charge.sh restart. Просмотрите журнал в реальном времени с помощью команды tail -f ./log/catalina.out.

5. Загрузите файлы переднего плана в каталог сервера /home/project/staticFile/. Если вы создадите каталог для административной панели в этом каталоге, например admin, поместите файлы переднего плана в этот каталог. Доступ к странице можно получить по адресу http://ip:порт/admin/index.html. Если index.html находится в каталоге /home/project/staticFile/, доступ к проекту можно получить по адресу http://ip:порт/index.html. В каталоге /home/project/staticFile/ можно создать несколько каталогов для разных проектов. Доступ к этим проектам можно получить по адресам http://ip:порт/[имя каталога]/index.html.

6. Используйте Nginx для пересылки запросов к проекту. Настройте HTTPS в Nginx.

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

1. Подключитесь к мини-программе и устройству UART1 для зарядки, чтобы использовать приложение. Участие и вклад

Примечание:

1. Начальный пароль для суперпользователя admin в бэкенде: 123456.
2. Шифрование во фронтенде осуществляется по схеме: учётная запись + * + введённый пароль, используется MD5-шифрование (например: MD5(admin*123456)).