index.html 10 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355
  1. <!DOCTYPE html>
  2. <!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
  3. <!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
  4. <head>
  5. <meta charset="utf-8">
  6. <meta http-equiv="X-UA-Compatible" content="IE=edge">
  7. <meta name="viewport" content="width=device-width, initial-scale=1.0">
  8. <title>Cloudbudget - Febbweiss</title>
  9. <link rel="shortcut icon" href="../../img/favicon.ico">
  10. <link href='https://fonts.googleapis.com/css?family=Lato:400,700|Roboto+Slab:400,700|Inconsolata:400,700' rel='stylesheet' type='text/css'>
  11. <link rel="stylesheet" href="../../css/theme.css" type="text/css" />
  12. <link rel="stylesheet" href="../../css/theme_extra.css" type="text/css" />
  13. <link rel="stylesheet" href="../../css/highlight.css">
  14. <link href="../../extra/css/extra.css" rel="stylesheet">
  15. <link href="../../extra/css/sis.css" rel="stylesheet">
  16. <script>
  17. // Current page data
  18. var mkdocs_page_name = "Cloudbudget";
  19. var mkdocs_page_input_path = "development/cloudbudget.md";
  20. var mkdocs_page_url = "/development/cloudbudget/";
  21. </script>
  22. <script src="../../js/jquery-2.1.1.min.js"></script>
  23. <script src="../../js/modernizr-2.8.3.min.js"></script>
  24. <script type="text/javascript" src="../../js/highlight.pack.js"></script>
  25. <script src="../../js/theme.js"></script>
  26. <script src="../../extra/js/pacman.js"></script>
  27. <script src="../../extra/js/pyramid.js"></script>
  28. <script src="../../extra/js/sis.js"></script>
  29. <script src="../../extra/js/yahtzee.js"></script>
  30. </head>
  31. <body class="wy-body-for-nav" role="document">
  32. <div class="wy-grid-for-nav">
  33. <nav data-toggle="wy-nav-shift" class="wy-nav-side stickynav">
  34. <div class="wy-side-nav-search">
  35. <a href="../.." class="icon icon-home"> Febbweiss</a>
  36. <div role="search">
  37. <form id ="rtd-search-form" class="wy-form" action="../../search.html" method="get">
  38. <input type="text" name="q" placeholder="Search docs" />
  39. </form>
  40. </div>
  41. </div>
  42. <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
  43. <ul class="current">
  44. <li>
  45. <li class="toctree-l1 ">
  46. <a class="" href="../..">Home</a>
  47. </li>
  48. <li>
  49. <li>
  50. <ul class="subnav">
  51. <li><span>Development</span></li>
  52. <li class="toctree-l1 current">
  53. <a class="current" href="./">Cloudbudget</a>
  54. <ul>
  55. <li class="toctree-l3"><a href="#introduction">Introduction</a></li>
  56. <li><a class="toctree-l4" href="#requirements">Requirements</a></li>
  57. <li><a class="toctree-l4" href="#features">Features</a></li>
  58. <li><a class="toctree-l4" href="#usage">Usage</a></li>
  59. <li><a class="toctree-l4" href="#api-documentation">API documentation</a></li>
  60. </ul>
  61. </li>
  62. <li class="toctree-l1 ">
  63. <a class="" href="../cloudbudget_angularjs/">Cloudbudget angularjs</a>
  64. </li>
  65. <li class="toctree-l1 ">
  66. <a class="" href="../filebrowser_durandal_widget/">Filebrowser durandal widget</a>
  67. </li>
  68. <li class="toctree-l1 ">
  69. <a class="" href="../java_small_projects/">Java small projects</a>
  70. </li>
  71. <li class="toctree-l1 ">
  72. <a class="" href="../library_reader/">Library reader</a>
  73. </li>
  74. <li class="toctree-l1 ">
  75. <a class="" href="../project_deployer/">Project deployer</a>
  76. </li>
  77. <li class="toctree-l1 ">
  78. <a class="" href="../scrabble_resolver/">Scrabble resolver</a>
  79. </li>
  80. <li class="toctree-l1 ">
  81. <a class="" href="../springboot_react_webpack/">Springboot react webpack</a>
  82. </li>
  83. </ul>
  84. <li>
  85. <li>
  86. <ul class="subnav">
  87. <li><span>Docker</span></li>
  88. <li class="toctree-l1 ">
  89. <a class="" href="../../docker/docker_apache_log_generator/">Docker apache log generator</a>
  90. </li>
  91. <li class="toctree-l1 ">
  92. <a class="" href="../../docker/docker_gocd/">Docker gocd</a>
  93. </li>
  94. <li class="toctree-l1 ">
  95. <a class="" href="../../docker/docker_java_log_generator/">Docker java log generator</a>
  96. </li>
  97. <li class="toctree-l1 ">
  98. <a class="" href="../../docker/docker_log_centralizer/">Docker log centralizer</a>
  99. </li>
  100. </ul>
  101. <li>
  102. <li>
  103. <ul class="subnav">
  104. <li><span>Games</span></li>
  105. <li class="toctree-l1 ">
  106. <a class="" href="../../games/Space_invaders_stories/">Space invaders stories</a>
  107. </li>
  108. <li class="toctree-l1 ">
  109. <a class="" href="../../games/pacman/">Pacman</a>
  110. </li>
  111. <li class="toctree-l1 ">
  112. <a class="" href="../../games/pyramid/">Pyramid</a>
  113. </li>
  114. <li class="toctree-l1 ">
  115. <a class="" href="../../games/wordfighters/">Wordfighters</a>
  116. </li>
  117. <li class="toctree-l1 ">
  118. <a class="" href="../../games/yahtzee/">Yahtzee</a>
  119. </li>
  120. </ul>
  121. <li>
  122. </ul>
  123. </div>
  124. &nbsp;
  125. </nav>
  126. <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
  127. <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
  128. <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
  129. <a href="../..">Febbweiss</a>
  130. </nav>
  131. <div class="wy-nav-content">
  132. <div class="rst-content">
  133. <div role="navigation" aria-label="breadcrumbs navigation">
  134. <ul class="wy-breadcrumbs">
  135. <li><a href="../..">Docs</a> &raquo;</li>
  136. <li>Development &raquo;</li>
  137. <li>Cloudbudget</li>
  138. <li class="wy-breadcrumbs-aside">
  139. <a href="https://github.com/febbweiss/" class="icon icon-github"> Edit on GitHub</a>
  140. </li>
  141. </ul>
  142. <hr/>
  143. </div>
  144. <div role="main">
  145. <div class="section">
  146. <h1 id="introduction">Introduction <a href="https://travis-ci.org/Febbweiss/CloudBudget"><img alt="Build Status" src="https://travis-ci.org/Febbweiss/CloudBudget.svg?branch=master" /></a> <a href="https://coveralls.io/github/Febbweiss/CloudBudget?branch=master"><img alt="Coverage Status" src="https://coveralls.io/repos/Febbweiss/CloudBudget/badge.svg?branch=master&amp;service=github" /></a></h1>
  147. <p>Cloudbudget is a work-in-progress online Money-like application.</p>
  148. <p>It's written using ExpressJS and provided only REST services. The web interface is in a different project <a href="../../development/cloudbudget_angularjs">CloudBugdet-AngularJS</a>.</p>
  149. <h2 id="requirements">Requirements</h2>
  150. <p>CloudBudget needs a Mongo database. Database configuration is done in the <em>config/db.js</em> file.</p>
  151. <p>The environment mode is defined by the environment variable NODE_ENV.</p>
  152. <h2 id="features">Features</h2>
  153. <p>The following features are developed:</p>
  154. <ul>
  155. <li>API security done with JWT</li>
  156. <li>API documentation</li>
  157. <li>User log on / log in</li>
  158. <li>User deregistration</li>
  159. <li>Bank account CRUD</li>
  160. <li>Bank accounts listing</li>
  161. <li>Deposit / Bill entry CRUD</li>
  162. <li>Deposit / Bill entries listing</li>
  163. </ul>
  164. <h2 id="usage">Usage</h2>
  165. <p>To initialize the application, install all dependencies with</p>
  166. <pre><code>npm install
  167. </code></pre>
  168. <p>To launch CloudBudget, use the following command :</p>
  169. <pre><code>NODE_ENV=development node app.js
  170. </code></pre>
  171. <p>If the PORT environment variable is set, it will be used, if not, the default port is 3000.
  172. The server configuration is done with the <em>config/server.js</em> file.</p>
  173. <h2 id="api-documentation">API documentation</h2>
  174. <p>The root URL is linked to the API documentation.
  175. The API documentation is generated with apidocs into the <em>public</em> folder. To generate it, use the following command :</p>
  176. <pre><code>npm run-script generate-doc
  177. </code></pre>
  178. <p><link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/github-fork-ribbon-css/0.2.0/gh-fork-ribbon.min.css" />
  179. <!--[if lt IE 9]>
  180. <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/github-fork-ribbon-css/0.2.0/gh-fork-ribbon.ie.min.css" />
  181. <![endif]-->
  182. <a class="github-fork-ribbon" href="https://github.com/Febbweiss/CloudBudget" target="_blank" title="Fork me on GitHub">Fork me on GitHub</a></p>
  183. </div>
  184. </div>
  185. <footer>
  186. <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
  187. <a href="../cloudbudget_angularjs/" class="btn btn-neutral float-right" title="Cloudbudget angularjs">Next <span class="icon icon-circle-arrow-right"></span></a>
  188. <a href="../.." class="btn btn-neutral" title="Home"><span class="icon icon-circle-arrow-left"></span> Previous</a>
  189. </div>
  190. <hr/>
  191. <div role="contentinfo">
  192. <!-- Copyright etc -->
  193. </div>
  194. Built with <a href="http://www.mkdocs.org">MkDocs</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
  195. </footer>
  196. </div>
  197. </div>
  198. </section>
  199. </div>
  200. <div class="rst-versions" role="note" style="cursor: pointer">
  201. <span class="rst-current-version" data-toggle="rst-current-version">
  202. <a href="https://github.com/febbweiss/" class="icon icon-github" style="float: left; color: #fcfcfc"> GitHub</a>
  203. <span><a href="../.." style="color: #fcfcfc;">&laquo; Previous</a></span>
  204. <span style="margin-left: 15px"><a href="../cloudbudget_angularjs/" style="color: #fcfcfc">Next &raquo;</a></span>
  205. </span>
  206. </div>
  207. </body>
  208. </html>