diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index b1d2508..9e57bad 100755 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -16,7 +16,7 @@ Generally, the development philosophy is result orientated. This means that anyo Developers are encouraged to pick open tasks with high priorities according to their own skill level. Senior developers may directly assign tasks to developers based on their importance. New developers may find it easier to start with a task that has a low priority as they often also have a lower difficulty. -Open tasks can be found in the project overview: [PROJECT.md](../Project/PROJECT.md) +Open tasks can be found in the project overview: [PROJECT.md](https://github.com/Karaka-Management/Organization-Guide/blob/master/Project/PROJECT.md) Tasks currently in development are prefixed in the priority column with an asterisk `*` and a name tag in the task description of the developer who is working on the task. diff --git a/README.md b/README.md index c240600..6c33206 100755 --- a/README.md +++ b/README.md @@ -1,67 +1,75 @@ -# Karaka -

Logo

-The cssOMS framework is primarily developed for the Karaka application which is a modular web application for small to mid sized companies that need CRM, ERP, Intranet and/or CMS functionalities and much more. The framework is also used in some other tools and websites which compliment the Karaka web application and provides the necessary basic CSS. +The **cssOMS** framework is primarily developed for the Karaka application which is a modular web application for small to mid sized companies that need CRM, ERP, Intranet and/or CMS functionalities and much more. The framework is also used in some other tools and websites which compliment the Karaka web application and provides the necessary php functionality. With Karaka you have one partner who can provide all the tools and software solutions you are used to at fair and reasonable prices even for small organizations and companies/startups. Our solutions can be used independently from each other or fully integrated with other solutions we provide. By choosing Karaka as your partner you'll be able to adjust your software based on the changes in your requirements without worrying about integration and workflow optimization. -## Table of content +## Table of Contents -- [Karaka](#karaka) - - [Table of content](#table-of-content) - - [Installation](#installation) - - [Requirements](#requirements) - - [Setup](#setup) - - [Philosophy](#philosophy) - - [Development Status](#development-status) - - [Tests](#tests) - - [Become a contributor](#become-a-contributor) - - [Misc](#misc) +- [Table of Contents](#table-of-contents) +- [Requirements](#requirements) + - [Developer tools](#developer-tools) +- [Installation](#installation) +- [Philosophy & Demo](#philosophy--demo) +- [Development status](#development-status) +- [Tech stack](#tech-stack) +- [Become a contributor](#become-a-contributor) +- [Misc](#misc) + +## Requirements + +* PHP 8.1 +* PHP extension: php8.1-dev php8.1-cli php8.1-common php8.1-mysql php8.1-pgsql php8.1-xdebug php8.1-opcache php8.1-pdo php8.1-sqlite php8.1-mbstring php8.1-curl php8.1-imap php8.1-bcmath php8.1-zip php8.1-dom php8.1-xml php8.1-phar php8.1-gd php-pear +* apache2 (recommended) or nginx +* mysql-server (recommended) or postgresql postgresql-contrib +* Tools: tesseract-ocr, pdftotext, pdftoppm +* Make sure that URL rewriting is active! + +### Developer tools + +* Php extension: xdebug +* Tools: Composer, Npm +* Composer tools: phpstan, phpunit, phpcs +* Npm tools: eslint ## Installation -### Requirements +Detailed installation instructions can be found at: -In order to re-build the css from the scss files you need scss. The file which includes all necessary imports and should be built is called `styles.scss`. +* [Developer Setup](https://github.com/Karaka-Management/Developer-Guide/blob/develop/general/setup.md) +* [User Setup](https://github.com/Karaka-Management/User-Guide/blob/develop/setup/install.md) -### Setup - -You can either link the `styles.css` in the head of your output file or choose the single styles which you need for the respective application. - -## Philosophy +## Philosophy & Demo We believe software should support a business in it's daily tasks and growth in a very efficient way without frustration. In order to achieve this we constantly take feedback from our customers and expand and improve our software solutions. -Since we believe in our software and transparent business model you can live test parts of our application and it's modules in our demo application at https://karaka.app (user: admin, pass: orange) without any registration or inquiry. This can be done even during the development phase. +You can find a freely available online demo at https://demo.karaka.app (user: admin, pass: orange) without any registration or inquiry. -## Development Status +## Development status -Currently Karaka is still developing the first Alpha version. As soon as we have a running Beta version we are allowing external testers to use our software and a selected amount of inhouse developed modules. The cssOMS style framework is one of the least developed components and still requires many improvements in terms of visuals, missing styles and mobile support. +Currently Karaka is still developing the first Alpha version. As soon as we have a running Beta version we are allowing external testers to use our software and a selected amount of inhouse developed modules. General updates can be found in our info section at https://karaka.app/info and developer updates can be found in our developer section at https://karaka.app/dev. In our developer section you can also check out the automatically generated reports such as code coverage, code style, static analysis etc. as well as our code style guide lines and developer documentation. -![Preview](https://raw.githubusercontent.com/Karaka-Management/Assets/master/art/preview.png) +* [Project Status](https://github.com/Karaka-Management/Organization-Guide/blob/master/Project/PROJECT.md) -## Tests +## Tech stack -In order to see and test the styles by themselves you can clone the framework as well as the `jsOMS` repository and run the `cssOMS/tests/app/index.htm` file. Feel free to modify the scss files and test the results in this sandboxed page. +* Language: php, js, c++, html, css, markdown, shell script +* Database: Maria/MySQL, PostgreSQL, MSSQL, SQLite +* Webserver: apache2, nginx +* Cache: Redis, Memcached ## Become a contributor -Karaka has a very open culture and we always welcome new people who share our philosophy in providing create solutions which just work. Please contact us if you are interested in working together on our application. - -* PHP Developer -* JS Developer -* Artist and/or Frontend -* DevOps - -Check out https://karaka.app/career and our developer section https://karaka.app/dev for more information. +Karaka has a very open culture and we always welcome new people who share our philosophy in providing create solutions which just work. You can find the development process description which also describes how to become a contributer in the [Organization documentation](https://github.com/Karaka-Management/Organization-Guide/blob/master/Processes/Development.md). ## Misc -* Languages: PHP, JS, HTML, CSS +* End-User documentation: https://github.com/Karaka-Management/Documentation +* Developer documentation: https://github.com/Karaka-Management/Developer-Guide +* Organization documentation: https://github.com/Karaka-Management/Organization-Guide * Website: [https://karaka.app](https://karaka.app) * Demo: [https://karaka.app](https://karaka.app) (user: admin, pass: orange) * Dev: [https://karaka.app/dev](https://karaka.app/dev) -* Contact: dennis@karaka.email +* Contact: dennis@karaka.app