Цифровое растениеводство

Внимание

Это ветка разработки проекта Локальная Ферма. Изменения могут происходить ежедневно. Если вам нужна стабильная версия, вы можете открыть эту ветку.

---

Локальная Ферма - программное обеспечение для прогрессивного растениеводства с открытым исходным кодом. Управляйте агробизнесом, контролируйте уровень воды в резервуарах, составляйте списки задач, отслеживайте запас посадочного материала и прогресс выращивания растений. Локальная ферма подходит для закрытых и открытых типов ферм.

Скачайте Локальную Ферму для Windows x64 и Linux x64 на странице релиза.

Оглавление

• Начало
  • Требования
  • Инструкции по сборке
  • Ядро СУБД
  • Запуск тестирования
• REST APIs
• Дорожная карта
• Вклад в проект
  • Перевод
• Лицензия

Начало

Это программное обеспечение создано на языке программирования Go. Это означает, что вы получите исполняемый двоичный файл для запуска на вашем компьютере. Вам не нужно дополнительное программное обеспечение, такое как MAMP, XAMPP или WAMP для запуска проекта Локальная Ферма, но вам может потребоваться база данных MySQL, если вы решите использовать ее вместо SQLite (база данных по умолчанию).

Если ваша ОС не указана на странице релизов, вам придется самостоятельно собрать проект Локальная Ферма для своей ОС. Вы можете следовать нашим инструкциям по сборке Локальной Фермы.

Требования

• Go >= 1.11
• NodeJS 8 or 10

Инструкции по сборке

1. Выполните команду git clone https://github.com/mir-one/localfarm.git
2. Проверьте текущую версию git checkout tags/1.0.0 -b v1.0.0
3. Из корневого каталога проекта запустите команду go get, для установки зависимостей Go.
4. Создайте файл conf.json используя значения из conf.json.example или измените его под ваши требования.
5. Выполните npm install, чтобы установить зависимости Vue.js.
6. Чтобы собрать Vue.js, просто запустите npm run dev для разработки или npm run prod для рабочих целей.
7. Скомпилируйте исходный код с помощью go build. Команда создаст localfarm.exe (для Windows) или localfarm (для Linux и OSX).
8. Запустите программу в терминале (для Linux и OSX) ./Localfarm, или в командной строке Windows .\Localfarm.exe.
9. По-умолчанию установлен пароль и логин localfarm / localfarm.

Ядро СУБД

Локальная Ферма использует SQLite в качестве базы данных по-умолчанию. Вы можете использовать MySQL в качестве базы данных, заменив sqlite на mysql в поле localfarm_persistence_engine в вашем `conf.json'.

{
  "app_port": "8080",
  "localfarm_persistence_engine": "sqlite",
  "demo_mode": true,
  "upload_path_area": "uploads/areas",
  "upload_path_crop": "uploads/crops",
  "sqlite_path": "db/sqlite/localfarm.db",
  "mysql_host": "127.0.0.1",
  "mysql_port": "3306",
  "mysql_dbname": "localfarm",
  "mysql_user": "root",
  "mysql_password": "root",
  "redirect_uri": [
      "http://localhost:8080",
      "http://127.0.0.1:8080"
  ],
  "client_id": "f0ece679-3f53-463e-b624-73e83049d6ac"
}

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

• Используйте go test ./... для запуска всех тестов Go .
• Используйте npm run cypress:run для выполнения сквозного теста

REST APIs

Локальная Ферма использует REST API для простой интеграции с любым программным обеспечением, вы даже можете создать для него клиентское мобильное приложение. Импортируйте файл JSON из каталога Postman в Postman app.

Дорожная карта

Мы хотим поделиться нашей дорожной карты, чтобы другие могли видеть наши приоритеты в разработке Локальной Фермы. Вы можете прочитать нашу дорожную карту в Wiki.

Вклад в проект

Мы приветствуем вклад, но просим вас следовать этим правилам.

Перевод

Вы можете помочь нам перевести Локальную Ферму на ваш язык, выполнив следующие действия:

1. Скопируйте languages/template.pot и вставьте в каталог languages/locale.
2. Переименуйте его, указав код языкового стандарта, например: : en_AU.po, de_DE.po, и т.п.
3. Заполните ключ msgstr своим переводом. Вы можете редактировать файл .po с помощью текстового редактора или Poedit.
4. Отправьте запрос вашего перевода в ветку master

Соберите перевод Локальной Фермы самостоятельно

Заметка: Вам нужно будет установить GNU Gettext для вашей ОС. Скачать здесь.

Вы можете создать Локальную Ферму на своем языке, изменив язык по умолчанию внутри resources/js/app.js.

Vue.use(GetTextPlugin, {
  availableLanguages: { // добавьте ваш язык здесь
    en_GB: 'British English',
    id_ID: 'Bahasa Indonesia',
    hu_HU: 'Magyar Nyelv',
    ru_RU: 'Русский'
  },
  defaultLanguage: 'ru_RU', // Измените язык приложения по-умолчанию
  translations: translations,
  silent: false
})

Далее следуйте инструкции по сборке Локальной Фермы.

Лицензия

Авторские права на LocalFarm и других участников в соответствии с лицензией с открытым исходным кодом Apache 2.0.