ESTIMATE

ABOUT

Создание ПО для управление бэклогом.

INSTALL

• Установить Go
• Отредактировать файл import.sh для Linux, MacOS, либо import.cmd для Windows.

#!/usr/bin/env bash
# Необходимо изменить переменную GOPATH - она должна указывать на корень нашего проекта
export GOPATH=~/projects/estima/

go get -u -v "github.com/dgrijalva/jwt-go"
go get -u -v "github.com/gorilla/context"
go get -u -v "github.com/gorilla/handlers"
go get -u -v "github.com/gorilla/mux"
go get -u -v "github.com/auth0/go-jwt-middleware"
go get -u -v "github.com/glycerine/zygomys/repl"
go get -u -v "gopkg.in/ldap.v2"
go get -u -v "github.com/go-errors/errors"
...

#
# Библиотека AranGO должна собираться из исходников, так как релиз слишком старый
# Поэтому используется загрузка из репозитория github 
#
mkdir ./src/github.com/diegogub/
cd ./src/github.com/diegogub/
# Удаление старой папки если есть
rm -rf aranGO

git init
git clone https://github.com/anatse/aranGO.git
git clone https://github.com/diegogub/napping

npm install
npm run build

• Для сборки проекта используется команда go build, в результате появится исполняекмый файл estima

• Добавлена поддержка Memcached, конфигурация опционально указывается в config.json

• Перед запуском программы необходимо также установить arangodb. Есть два способа установки:

  1. Через docker
     • Установить docker
     • Установить arangodb
     • Поправить переменные окружения через kitematic.
       • Пользователь: root
       • Пароль пользователя: root
       • Проброс порта - 8529
     • Запустить arangodb
  2. Через brew
     • Установить brew
     • Установить, указать пароль для пользователя root, запустить arangodb

     > brew install arangodb
     > /usr/local/opt/arangodb/sbin/arango-secure-installation
     > /usr/local/opt/arangodb/sbin/arangod

  • Через браузер войти в web интерфейс http://localhost:8529, создать там новую базу данных estima

• Проверить конфигурацию - файл config.json (комментарии в JSON не поддердиваются, здесь приведены для понимания)

  const config = {
    // Текущаий профиль 
    "active": "develop",
  
    // Список доступных профилей
    "profiles": [{
        "name": "develop",    // Имя профиля
        "secret": "secret",   // Ключ дл яшифрование куки 
        "Ldap": {             // Параметры подключения к LDAP
          "protocol": "fake", // Протокол, если установлен в fake, то проверка пользователя в LDAP не производится
          "host": "",
          "dn": "",
          "port": 389
        },
        "Database": {         // Параметры подключения к БД
          "url": "http://localhost:8529",
          "user": "root",
          "password": "root",
          "log": false,
          "name": "estima"
        },
        "Auth": {             // Параметры для формирование Auth куки
          "cookieName": "Estima",
          "maxAge": 10000
        },
       "Memcached": {         // Конфигурация для memcached 
          "Machines": [{
              "host": "localhost",
              "port": 11211
          }]
        }
      }, { // Следующий профиль
        "name": "test",
        "secret": "secret",
        "Ldap": {
          "protocol": "tcp",
          "host": "ldap.forumsys.com",
          "port": 389,
          "dn": "DC=example,DC=com"
        },
        "Database": {
          "url": "http://localhost:8529",
          "user": "root",
          "password": "123456",
          "log": false,
          "name": "estima"
        },
        "Auth": {
          "cookieName": "Estima",
          "maxAge": 10000
        }
    }]
  }

• Запустить приложение go run

---

Запуска приложения в Intellij Idea.

• Необходимо установить плагин Go Lang Plugin для работы с Go.

• Указать настройки:

  • Go > Go Libraries > Указать в global путь до проекта.
  • Run > Edit Config:
    • Создать Go Application.
    • В File указать путь до estima.go
    • В Working Directory указать путь до дириктории проекта.

• Теперт проект доступен по ссылке localhost:9080

Разработка Presentation Layer

Подробная Информация в папке ../src-ui

Сервер разработки localhost:9081

Для запуска перейдите в каталог

cd src-ui
# Установка зависимостей
npm install
# Запуск стенда разработки
npm run start
# Сборка проекта
npm run build

Для запуска сервера, БД и сборки UI

./startDev.sh

Unit тестирование

• Установить переменную окружения CONFIG_PATH = полный путь до файла config.json
• Установить переменную окружения DBJS_PATH = полный путь до папки с файлами JavaScript для транзакций
• Запустить тесты (файл runtest.sh)

  export CONFIG_PATH=~/projects/estima/config.json
  export DBJS_PATH=~/projects/estima/dbjs/
  
  go test ./src/ru/... -v