# Architecture Fab-manager was built on top of Ruby on Rails. Ruby on rails provides a REST API used by a single-page web application. Historically, the front-end was using Angular.js but as this framework won't be supported anymore in a near future, we're progressively moving to React. ## Software dependencies - Ruby 2.6 - Rails 5.2 - Sidekiq 6 - Docker ## Databases - Redis 6 - Elasticsearch 5.6 - PostgreSQL 9.6 ## Source-code architecture `fab-manager/`
`╠═ .docker/` In development, data of the databases are stored in this untracked folder;
`╠═ .github/` Configuration of the GitHub repository;
`╠═ accounting/` When some accounting exports are generated in the application, they are saved in this untracked folder;
`╠═ app/` **The source code of the application**;
`╠═ bin/` Ruby-on-rails binaries;
`╠═ config/` Application and frameworks configurations are saved here. **Translations are saved here too**;
`╠═ coverage/` Coveralls.io saves its temporary data into this untracked folder;
`╠═ db/` Database schema and migrations (ie. the history of the construction of the database);
`╠═ doc/` Various documentations about Fab-manager;
`╠═ docker/` Files used to build the docker image. Also: files to set up a development environment based on docker;
`╠═ exports/` When some exports are generated in the application, they are saved in this untracked folder;
`╠═ imports/` When some files are imported to the application, they are saved in this untracked folder;
`╠═ invoices/` When some invoices are generated in the application, they are saved in this untracked folder;
`╠═ lib/` **Some more code of the application**. This code may not be loaded automatically;
`╠═ log/` When running, the application will produce some debug outputs, they are saved in this untracked folder;
`╠═ node_modules` Third party libraries for the front-end JS application are stored in this untracked folder by the package manager (yarn);
`╠═ payment_schedules` When some payment schedules are generated in the application, they are saved in this untracked folder;
`╠═ plugins/` Some code can be dropped in that untracked folder to use plugins with Fab-manager;
`╠═ provision/` Scripts used to setup a development environment based on vagrant;
`╠═ public` Files that will be exposed to the world by the HTTP server (nginx). This includes the compilation result of the front-end application;
`╠═ scripts/` Some bash scripts. Scripts ran during the upgrade phrase are located here;
`╠═ setup/` Everything needed to set up a new instance of Fab-manager, including the setup script;
`╠═ test/` Automated tests of the application (MiniTest);
`╠═ tmp/` Various temporary files are stored in this untracked folder;
`╠═ vendor/` (deprecated) Previously 3rd-party assets were stored here. Now, only the fonts for the PDF generation remains here;
`╠═ .browserslistrc` Required by babel (JS compiler) to specify target browsers for the compilation of the front-end application;
`╠═ .coveralls.yml` Configuration of coveralls.io;
`╠═ .dockerignore` List of files that won't be included in the docker image;
`╠═ .env` Environment variables for development and test environments;
`╠═ .eslitignore` List of files that won't be parsed by ESLint;
`╠═ .eslintrc` Configuration of the JS code quality checking (ESLint);
`╠═ .gemrc` Ruby gems configuration;
`╠═ .gitignore` List of files that won't be tracked by the version control system (git);
`╠═ .nvmrc` Version of node.js used in this project. This file is read by NVM in development environments;
`╠═ .rubocop.yml` Configuration of the Ruby code quality checking (Rubocop);
`╠═ .ruby-gemset` Used by RVM to isolate the gems of this application;
`╠═ .ruby-version` Version of Ruby used in this project. This file is read by RVM in development environments;
`╠═ babel.config.js` Configuration of babel (JS compiler);
`╠═ Capfile` (deprecated) Configuration of capistrano (previous deployment system);
`╠═ CHANGELOG.md` List of changes between releases of Fab-manager. Also contains deployment instructions for upgrading;
`╠═ config.ru` This file is used by Rack-based servers to start the application;
`╠═ CONTRIBUTING.md` Contribution guidelines;
`╠═ crowdin.yml` Configuration of the translation management system (Crowdin);
`╠═ Dockerfile` This file list instructions to build the docker image of the application;
`╠═ env.example` Example of configuration for the environment variables, for development and test environments;
`╠═ Gemfile` List of third-party libraries used in the Ruby-on-Rails application;
`╠═ Gemfile.lock` Version lock of the ruby-on-rails dependencies;
`╠═ LICENSE.md` Publication licence of Fab-manager;
`╠═ package.json` List of third-party libraries used in the Javascript application. Also: version number of Fab-manager;
`╠═ postcss.config.js` Configuration of PostCSS (CSS compiler);
`╠═ Procfile` List the process ran by foreman when starting the application in development;
`╠═ Rakefile` Configuration of Rake (Ruby commands interpreter);
`╠═ README.md` Entrypoint for the documentation;
`╠═ tsconfig.json` Configuration of TypeScript;
`╠═ Vagrantfile` Configuration of Vagrant, for development environments;
`╠═ yarn.lock` Version lock of the javascript dependencies;
`╚═ yarn-error.log` This untracked file keeps logs of the package manager (yarn), if any error occurs; ## Backend application The backend application respects the Ruby-on-Rails conventions for MVC applications. It mainly provides a REST-JSON API for the frontend application. It also provides another REST-JSON API, open to the 3rd-party applications, and known as OpenAPI. `fab-manager/`
`╚═╦ app/`
`  ╠═ controllers/` Controllers (MVC);
`  ╠═ doc/` Documentation for the OpenAPI;
`  ╠═ exceptions/` Custom errors;
`  ╠═ frontend/` **Source code for the frontend application**;
`  ╠═ helpers/` System-wide libraries and utilities. Prefer using `services/` when it's possible;
`  ╠═ mailers/` Sending emails;
`  ╠═ models/` Models (MVC);
`  ╠═ pdfs/` PDF documents generation;
`  ╠═ policies/` Access policies for the API and OpenAPI endpoints;
`  ╠═ services/` Utilities arranged by data models;
`  ╠═ themes/` SASS files that overrides the frontend styles. We plan to move all styles here to build multiple themes;
`  ╠═ uploaders/` Handling of the uploaded files
`  ╠═ validators/` Custom data validation (before saving);
`  ╠═ views/` Views (MVC)
`  ╚═ workers/` Asynchronous tasks run by Sidekiq ## Frontend application The frontend application is historically an Angular.js MVC application. We are moving, step-by-step, to an application based on React.js + Typescript. For now, the main application is still using Angular.js but it uses some React.js components thanks to coatue-oss/react2angular. `fab-manager/`
`╚═╦ app/`
`  ╚═╦ frontend/`
`    ╠═ images/` Static images used all over the frontend app;
`    ╠═ packs/` Entry points for webpack (bundler);
`    ╠═╦ src/`
`    ║ ╠═╦ javascript/`
`    ║ ║ ╠═ api/` (TS) New components to access the backend API;
`    ║ ║ ╠═ components/` (TS) New React.js components;
`    ║ ║ ╠═ controllers/` (JS) Old Angular.js controllers for the views located in `app/frontend/templates`;
`    ║ ║ ╠═ directives/` (JS) Old Angular.js directives (interface components);
`    ║ ║ ╠═ filters/` (JS) Old Angular.js filters (processors transforming data);
`    ║ ║ ╠═ lib/` (TS) New utilities + (JS) Old external libraries customized;
`    ║ ║ ╠═ models/` (TS) Typed interfaces reflecting the API data models;
`    ║ ║ ╠═ services/` (JS) Old Angular.js components to access the backend API;
`    ║ ║ ╠═ typings/` (TS) Typed modules for non-JS/TS file types;
`    ║ ║ ╠═ app.js` Entrypoint for the angular.js application;
`    ║ ║ ╠═ plugins.js.erb` Entrypoint for embedding Fab-manager's plugins in the frontend application;
`    ║ ║ ╚═ router.js` Configuration for UI-Router (mapping between routes, controllers and templates)
`    ║ ╚═ stylesheets/` SASS source for the application style
`    ╚═ templates/` Angular.js views (HTML)