Facelog

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

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

Рисунок 1. Структура системы

Более подробную информацию о Facelog можно найти в «Руководстве по разработке Facelog».

Документация API Facelog (Javadoc)

https://apidoc.gitee.com/l0km/facelog

Компиляция

• Скачивание кода

  • git clone --recursive https://gitee.com/l0km/facelog.git
  • Параметр --recursive используется для загрузки подпроекта sql2java. Если структура таблиц не изменяется, этот параметр можно опустить.

• Инициализация базы данных

  • Выполните действия, описанные в файле db/README.md, чтобы создать таблицы базы данных и сгенерировать код для работы с базой данных.

  • mvn -f gen-sql.xml sql:execute -Ddb.url=jdbc:mysql://localhost:3306/test?characterEncoding=utf8

  • Если структура таблиц не изменялась, этот шаг можно пропустить.

  • gen-mysql.bat

  • gen-mysql-g.bat

• Компиляция

  • В корневом каталоге Facelog выполните команду mvn install для компиляции всех проектов и установки их локально.

• Создание FatJar

  • В каталоге facelog-service выполните команду mvn package -Pshade-package для создания FatJar (uber-jar): facelog-service-${project.version}-standalone.jar

Начальное тестирование

Хотя Facelog сам по себе не является реальным приложением, его можно использовать для понимания принципов работы Facelog через предоставленные тестовые программы.

• Запуск службы Facelog

  • Службу Facelog можно запустить вручную, также предоставляется возможность быстрого развёртывания с помощью Docker. Подробные инструкции см. в разделе «Запуск службы Facelog» в «Руководстве по разработке Facelog».
  • Также см. файлы start_facelog_server.bat и start_facelog_server_debug.bat в каталоге facelog-service.

• Выполнение тестов JUnit

  • После успешного запуска службы Facelog вы можете выполнить тесты в каталоге src/test/java/net/gdface/facelog/client в проекте facelog-client. Например, ClientTest, HeartbeatTest и TokenTest.

• Поддержка Node.js

  • См. файл README-nodejs.md.

• Поддержка JavaScript

  • См. файл README-js.md.

• RESTful API и онлайн-документация Swagger

  • См. файл README-RESTful.md.

• Поддержка C#

  • См. файл README-csharp.md.

• Обрезка интерфейса

  • См. файл README-cut.md.