Приложение "Управление" — это система управления задачами и дефектами. В первую очередь она предназначена для пользователей, которые ведут разработку программного обеспечения, но подходит и для других сфер деятельности.
Для работы приложения потребуется backend в виде REST API, который реализуется в рамках родственного проекта OpenBlocks Management.
Вы можете запустить приложение и без бэкенда, но практически все взаимодействия не будут работоспособными.
При развёртывании backend-приложения, по умолчанию будет создан пользователь с правами администратора с логином
admin
и паролем admin
. Вы можете работать в системе под этим пользователем, но настоятельно рекомендуется
сменить ему пароль. Также, от лица этого пользователя можно создавать проекты, заводить других пользователей
и настраивать им проектный доступ.
Наиболее простым способом запустить сервис является развертывание в Docker.
Вместе с сервисом поставляется простой Dockerfile
и docker-compose.yml
. Для запуска склонируйте себе
репозиторий и запустите команду:
docker-compose up -d
Для запуска в Docker вам не потребуется иметь на компьютере Node.js и Nginx.
После развертывания приложение будет доступно на вашем компьютере по адресу http://localhost.
Вы можете скорректировать порт, на котором будет работать приложение, для этого в файле docker-compose.yml
измените первый порт в следующей секции на желаемый.
ports:
- "80:80"
Например, если вы укажете "3000:80"
, то приложение будет доступно по адресу http://localhost:3000.
Запустите следующую команду
npm run start
Эта команда поднимает development-сервер с приложением. Оно будет доступно по адресу http://localhost:3000.
Вначале вам потребуется собрать приложение, для этого потребуется Node.js версии 18.
npm run build
В результате сборки вы получите готовые статические файлы в папке build
.
Далее разместите эти файлы под управлением любого веб-сервера по вашему выбору,
в качестве главной страницы требуется использовать build/index.html
.
Также обратите внимание, что для корректной работы приложения требуется все неизвестные
маршруты (к несуществующим файлам) также направлять на build/index.html
.
Например, для nginx
это можно сделать с помощью следующих настроек.
location / {
try_files $uri /index.html;
}
Сервис написан на языке программирования Javascript. Для сборки проекта потребуется Node.js LTS версии 18+. Работоспособность проверена на версиях 18, 20, 21.
Используется фреймворк React.
Требование | Версия |
---|---|
Node.js | 18+ |
Operating system | Windows, Linux, MacOS |
Инициатива OpenBlocks — это проекты с открытым исходным кодом. Основная цель состоит в том, чтобы предоставить открытые и расширяемые решения для пользователей любого масштаба.