From d00f9489aaa6aa1ad0ac0039dfee452bf4b8ea1d Mon Sep 17 00:00:00 2001 From: Sieciech Date: Thu, 22 Jul 2021 14:08:56 +0200 Subject: [PATCH 1/2] add technical documentation --- README.md | 16 +++++++++++++++- 1 file changed, 15 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index a5eba26..f5da0af 100644 --- a/README.md +++ b/README.md @@ -24,4 +24,18 @@ Każdy może założyć profil oraz dodać jedną lub więcej chorób. Dzięki t ### Społeczność specjalistów Zachęcamy także lekarzy i specjalistów, aby dołączyli do społeczności, będą oni mieli wgląd w listę swoich pacjentów ale także do listy osób, które mają podobne schorzenia jak ich podopieczni, dzięki czemu będą mieli dostęp do szerszego grona osób z daną chorobą. Będą mogli także przedyskutować swoje obserwacje z innymi lekarzami, którzy także mają doświadczenie z daną chorobą. Jest to naprawdę ważne przy bardzo unikalnych i nie dokońca poznanych jeszcze schorzeniach. ### Analiza chorób -Chcemy, aby użytkownicy mieli dostęp do dzinnika swojej choroby, gdzie będą mogli wprowadzać jak ona przebiega. Na tej podstawie wraz ze specjalistami będziemy w stanie znaleźć pewne wsólne cechy dla nowych chorób i przewidzieć jak najwięcej negatywnych symptomów, aby móc im jak najlepiej zapobiec. \ No newline at end of file +Chcemy, aby użytkownicy mieli dostęp do dzinnika swojej choroby, gdzie będą mogli wprowadzać jak ona przebiega. Na tej podstawie wraz ze specjalistami będziemy w stanie znaleźć pewne wsólne cechy dla nowych chorób i przewidzieć jak najwięcej negatywnych symptomów, aby móc im jak najlepiej zapobiec. + + +# Technical documentation +### Frontend +1. [HTML 5](https://developer.mozilla.org/en-US/docs/Glossary/HTML5) +1. [CSS 3](https://developer.mozilla.org/pl/docs/Web/CSS) +1. [JavaScript](https://developer.mozilla.org/pl/docs/orphaned/Web/JavaScript) +1. [TypeScript](https://www.typescriptlang.org/docs/ "Documentation") +1. [Angular 12](https://angular.io/docs "Documentation") (Frontend framework) +### Backend +1. [PHP 8.0](https://www.php.net/docs.php "Documentation") +1. [Symfony 5](https://symfony.com/doc/current/index.html "Documentation") (PHP Framework) +1. [Postgresql 13](https://www.postgresql.org/docs/13/index.html "Documentation") (Database) +1. [Docker](https://docs.docker.com/) (Local development environment) \ No newline at end of file -- 2.39.5 From ba3ec47c67afd94e4c2fcbd6d3cd11d35976e17a Mon Sep 17 00:00:00 2001 From: Sieciech Date: Fri, 23 Jul 2021 20:01:20 +0200 Subject: [PATCH 2/2] update docs --- README.md | 16 +++--------- src/README.md | 70 +++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 73 insertions(+), 13 deletions(-) create mode 100644 src/README.md diff --git a/README.md b/README.md index f5da0af..543b120 100644 --- a/README.md +++ b/README.md @@ -12,6 +12,8 @@ We also encourage doctors and specialists to join the community, they will have ### Disease analysis We want users to have access to the log of their disease where they can enter how it is progressing. On this basis, together with specialists, we will be able to find some common features for new diseases and predict as many negative symptoms as possible in order to be able to prevent them as much as possible. +[Technical documentation](./src/) + # Polski ## Czym jest CureNet? ### Opis @@ -26,16 +28,4 @@ Zachęcamy także lekarzy i specjalistów, aby dołączyli do społeczności, b ### Analiza chorób Chcemy, aby użytkownicy mieli dostęp do dzinnika swojej choroby, gdzie będą mogli wprowadzać jak ona przebiega. Na tej podstawie wraz ze specjalistami będziemy w stanie znaleźć pewne wsólne cechy dla nowych chorób i przewidzieć jak najwięcej negatywnych symptomów, aby móc im jak najlepiej zapobiec. - -# Technical documentation -### Frontend -1. [HTML 5](https://developer.mozilla.org/en-US/docs/Glossary/HTML5) -1. [CSS 3](https://developer.mozilla.org/pl/docs/Web/CSS) -1. [JavaScript](https://developer.mozilla.org/pl/docs/orphaned/Web/JavaScript) -1. [TypeScript](https://www.typescriptlang.org/docs/ "Documentation") -1. [Angular 12](https://angular.io/docs "Documentation") (Frontend framework) -### Backend -1. [PHP 8.0](https://www.php.net/docs.php "Documentation") -1. [Symfony 5](https://symfony.com/doc/current/index.html "Documentation") (PHP Framework) -1. [Postgresql 13](https://www.postgresql.org/docs/13/index.html "Documentation") (Database) -1. [Docker](https://docs.docker.com/) (Local development environment) \ No newline at end of file +[Dokumentacja techniczna](./src/) diff --git a/src/README.md b/src/README.md new file mode 100644 index 0000000..6e47813 --- /dev/null +++ b/src/README.md @@ -0,0 +1,70 @@ +# Technical documentation +## Frontend +1. [HTML 5](https://developer.mozilla.org/en-US/docs/Glossary/HTML5) +1. [CSS 3](https://developer.mozilla.org/pl/docs/Web/CSS) +1. [JavaScript](https://developer.mozilla.org/pl/docs/orphaned/Web/JavaScript) +1. [TypeScript](https://www.typescriptlang.org/docs/ "Documentation") +1. [Angular 12](https://angular.io/docs "Documentation") (Frontend framework) +## Backend +1. [PHP 8.0](https://www.php.net/docs.php "Documentation") +1. [Symfony 5](https://symfony.com/doc/current/index.html "Documentation") (PHP Framework) +1. [Postgresql 13](https://www.postgresql.org/docs/13/index.html "Documentation") (Database) +1. [Docker](https://docs.docker.com/) (Local development environment) + +## Tools +### Neccessary +1. [Docker](https://docs.docker.com/) - to run local environment +### Optional +1. [Firefox Developer Edition](https://www.mozilla.org/pl/firefox/developer/) +2. [VS Code](https://code.visualstudio.com/) - [IDE](https://en.wikipedia.org/wiki/Integrated_development_environment) + - Plugins for PHP + - [PHP Debug](https://marketplace.visualstudio.com/items?itemName=felixfbecker.php-debug) + - [PHP Intelephense](https://marketplace.visualstudio.com/items?itemName=bmewburn.vscode-intelephense-client) + - Plugins for Angular + - [Angular Language Service](https://marketplace.visualstudio.com/items?itemName=Angular.ng-template) + - Plugins for database + - [SQLTools](https://marketplace.visualstudio.com/items?itemName=mtxr.sqltools) + - [SQLTools PostgreSQL/Redshift Driver](https://marketplace.visualstudio.com/items?itemName=mtxr.sqltools-driver-pg) + - Plugins for git: + 1. [GitLens](https://marketplace.visualstudio.com/items?itemName=eamodio.gitlens) + +## How to run app? +1. Download project from repository using standalone git or built in any IDE +2. Install Docker Desktop +3. run command line and go to project directory +4. Go to docker directory +5. Execute `docker compose -p curenet up` +6. Wait until docker building and lauching the app. + At first attempt it can take a few minutes + +## Application links +1. Main app: `http://localhost:7700` +2. PgAdmin4 `http://localhost:7700/pgadmin4` +3. PHP Xdebug for fpm: `localhost:7780` +3. PHP Xdebug for cli: `localhost:7781` + +## Credentials +### PgAdmin4 +- Login: `admin@pgadmin.localhost` +- Password: `WeryStronkPaz2` +- Configuration: + 1. Click on Server in left panel + 2. Go to Create > Server + 3. Enter name (you can name it as you want) + 4. Go to Connection tab + 5. Enter host name: `localhost` + 6. Enter username: `postgres` + 7. Enter password: `WeryStronkPaz2` + 8. Save it + 9. Go to Servers > [you name] > Databases > curenet > Schemas > public > Tables + 10. You can see all tables +### Database +- Server: `localhost` +- Port: `5432` +- Username + - For application: `curenet` + - For admin: `postgres` +- Database + - For application: `curenet` + - For admin: `postgres` +- Password: `WeryStronkPaz2` \ No newline at end of file -- 2.39.5