mirror of
https://github.com/LaCasemate/fab-manager.git
synced 2024-12-10 21:24:20 +01:00
93 lines
4.2 KiB
Markdown
93 lines
4.2 KiB
Markdown
# Fab-manager
|
|
|
|
Fab-manager is the Fab Lab management solution. It provides a comprehensive, web-based, open-source tool to simplify your administrative tasks, and document your marker's projects.
|
|
|
|
[](https://coveralls.io/github/sleede/fab-manager)
|
|
[](https://hub.docker.com/r/sleede/fab-manager/)
|
|
[](https://hub.docker.com/r/sleede/fab-manager/builds)
|
|
[](https://crowdin.com/project/fab-manager)
|
|
|
|
##### Table of Contents
|
|
1. [Software stack](#software-stack)
|
|
2. [Contributing](#contributing)
|
|
3. [Documentation](#documentation)
|
|
4. [Open Projects](#open-projects)
|
|
5. [Plugins](#plugins)
|
|
6. [Single Sign-On](#sso)
|
|
7. [Related Documentation](#related-documentation)
|
|
|
|
|
|
<a name="software-stack"></a>
|
|
## Software stack
|
|
|
|
Fab-manager is a Ruby on Rails / AngularJS web application that runs on the following software:
|
|
|
|
- Ubuntu LTS 14.04+ / Debian 8+
|
|
- Ruby 2.6
|
|
- Redis 6
|
|
- Sidekiq 6
|
|
- Elasticsearch 5.6
|
|
- PostgreSQL 9.6
|
|
|
|
<a name="contributing"></a>
|
|
## Contributing
|
|
|
|
Contributions are welcome. Please read [the contribution guidelines](CONTRIBUTING.md) for more information about the contribution process.
|
|
|
|
<a name="documentation"></a>
|
|
## Documentation
|
|
|
|
The full documentation is available at [doc.fab.mn](http://doc.fab.mn).
|
|
|
|
<a name="open-projects"></a>
|
|
## Open Projects
|
|
|
|
**This configuration is optional.**
|
|
|
|
You can configure your Fab-manager to synchronize every project with the [Open Projects platform](https://github.com/sleede/openlab-projects).
|
|
It's very simple and straightforward and in return, your users will be able to search over projects from all Fab-manager instances from within your platform.
|
|
The deal is fair, you share your projects and as reward you benefits from projects of the whole community.
|
|
|
|
If you want to try it, you can visit [this Fab-manager](https://fablab.lacasemate.fr/#!/projects) and see projects from different Fab-managers.
|
|
|
|
To start using this awesome feature, there are a few steps:
|
|
- send a mail to **contact@fab-manager.com** asking for your Open Projects client's credentials and giving them the name and the URL of your Fab-manager, they will give you an `App ID` and a `secret`
|
|
- fill in the value of the keys in Admin > Projects > Settings > Projects sharing
|
|
- export your projects to open-projects (if you already have projects created on your Fab-manager, unless you can skip that part) executing this command: `bundle exec rails fablab:openlab:bulk_export`
|
|
|
|
**IMPORTANT: please run your server in production mode.**
|
|
|
|
Go to your projects gallery and enjoy seeing your projects available from everywhere ! That's all.
|
|
|
|
<a name="plugins"></a>
|
|
## Plugins
|
|
|
|
Fab-manager has a system of plugins mainly inspired by [Discourse](https://github.com/discourse/discourse) architecture.
|
|
|
|
It enables you to write plugins which can:
|
|
- have its proper models and database tables
|
|
- have its proper assets (js & css)
|
|
- override existing behaviours of Fab-manager
|
|
- add features by adding views, controllers, ect...
|
|
|
|
To install a plugin, you just have to copy the plugin folder which contains its code into the folder `plugins` of Fab-manager.
|
|
|
|
You can see an example on the [repo of navinum gamification plugin](https://github.com/sleede/navinum-gamification)
|
|
|
|
<a name="sso"></a>
|
|
## Single Sign-On
|
|
|
|
Fab-manager can be connected to a [Single Sign-On](https://en.wikipedia.org/wiki/Single_sign-on) server which will provide its own authentication for the platform's users.
|
|
Currently, OAuth 2 is the only supported protocol for SSO authentication.
|
|
|
|
For an example of how to use configure an SSO in Fab-manager, please read [sso_with_github.md](doc/sso_with_github.md).
|
|
|
|
<a name="related-documentation"></a>
|
|
## Related Documentation
|
|
|
|
- [Ruby 2.6.5](http://ruby-doc.org/core-2.6.5/)
|
|
- [Ruby on Rails](http://api.rubyonrails.org)
|
|
- [AngularJS](https://docs.angularjs.org/api)
|
|
- [Angular-Bootstrap](http://angular-ui.github.io/bootstrap/)
|
|
- [ElasticSearch 5.6](https://www.elastic.co/guide/en/elasticsearch/reference/5.6/index.html)
|