/flyve-mdm-web-ui

Flyve MDM - Progressive Web Application reliable, fast, and engaging.

Primary LanguageJavaScriptGNU Affero General Public License v3.0AGPL-3.0

Project Status: Active - The project has reached a stable, usable state and is being actively developed. Build Status

Flyve MDM is a mobile device management software that enables you to secure and manage all the mobile devices of your business via a unique web-based console (MDM).

To get started, check out https://flyve-mdm.com/!

Table of contents

Overview

Our solution allows you to efficiently and easily control any aspects of your Android-based mobile fleet, providing a panel of functionalities:

  • Provided as a SaaS platform
  • Google independent
  • Deploy and configure applications
  • Deploy files
  • Wipe a phone
  • Work with devices running Android 4.4 or higher
  • Simple web application user interface

Quick start

Several quick start options are available:

  • Download the latest release.
  • Clone the repo: git clone https://github.com/flyve-mdm/flyve-mdm-web-ui.git.
  • Install Ruby.
  • Install the compass gem:
gem install compass
  • Install Node.
  • Install the packages grunt-cli and bower globally.
npm install -g grunt-cli
npm install -g bower
  • Install development dependencies and bower components.
npm start
  • Rename the config.sample.js to config.js in the app folder.
  • Add the url of the GLPi API and add the API Key in the config file. This is the glpi/flyve api_key which is used to save glpi/flyve users.
  • Run grunt for building and grunt serve for preview.

Read the page of Yeoman generator for AngularJS for information on the available generators, and more.

Testing

Running grunt test will run the unit tests with karma.

What's important

Note: this section is not exhaustive nor finished, it is explaining the source code a bit.

This web application is supposed to be packaged within the Flyve MDM distribution, which includes

  • The Flyve MDM GLPi Module
  • The Flyve MDM web console (repository)

We are still working on how we are going to package the whole Flyve MDM software distribution.

You can run the tree unix command in your working copy of this repository, but, the following points are important:

Services

  • auth.js : handles the authentification with the GLPi API within the entire app
  • includes an $http interceptor to provide GLPi API's session_token

Controller/View pairs

  • devices.js / devices.html: the most important Flyve MDM screen, showing current devices
  • fleets.js / admin_fleets.html: the screen which helps managing Flyve MDM fleets
  • ... (they are likely to change)

Sass/CSS

  • a app.sass module includes every other sass modules
  • which contains the visual css code for entire the frontend app
  • that app.sass builds to app.css

Build system

Bugs and features requests

You have a bug or a feature request? Please first read the issue guidelines and search for existing and closed issues. If your problem or idea is not addressed yet, please open a new issue.

Documentation

Flyve MDM's documentation is on the Wiki of GitHub.

Contributing

Please read our contributing guidelines. Included are directions for opening issues, coding standards, and notes on development.

Moreover, if your pull request contains JavaScript patches or features, you must include relevant unit tests. All HTML and CSS should conform to the Code Guide, maintained by Mark Otto.

Editor preferences are available in the editor config for easy use in common text editors. Read more and download plugins at http://editorconfig.org.

Community

Get updates on Flyve MDN's development and chat with the project maintainers and community members.

Versioning

In order to provide transparency on our release cycle and to maintain backward compatibility, Flyve MDM is maintained under the Semantic Versioning guidelines. We are committed to following and complying with the rules, the best we can.

See the tags section of our GitHub project for changelogs for each release version of Flyve MDM. Release announcement posts on the official Teclib' blog contain summaries of the most noteworthy changes made in each release.

Roadmap

We are eager to build together the best software in the IT industry, for mobile device management. In order to help you prioritize what to focus on and to share insights on our priorities, we have published Flyve MDM’s Platform Roadmap. This roadmap is a rough estimate of what we are planning on building in the near-, medium-, and long-term.

Placement on the roadmap represents our estimate of when each project will enter full production release. Some larger features will land in your hands through Early Access programs in advance of their full release.

The items in the roadmap are subject to change or delay, so you should not use this for major planning purposes. We will do our best to keep the roadmap updated, and we will review the roadmap monthly to ensure it reflects our most up-to-date features inventory.

Source codes will be released during fall 2016.

You can follow the progress on the opened and closed issues, opened and closed merge requests, percentage of completion and remaining days, in the following links of every milestone.

Disclaimer

This roadmap is for informational purposes only, so you shouldn't rely on this information for major purchasing or planning purposes. Just like all projects, the items in the roadmap are subject to change or delay, and the continued development or release of a project on the roadmap is at the sole discretion of Teclib'.

Creators

Nelson Zamith

Alexander J Salas B

Copyright and license

Code and documentation copyright 2015-2016 Teclib'. Code released under the AGPL v3 license. Docs released under CC BY 4.0.