Ezt a wb applikációt az EnvientaPlatform hívja iframe -ben. Ez az applikáció futása során REST API hívással adatokat kér le az EnvientaPlatform -ból . (Természetesen a megfelelő paraméterek beállításával és a szükséges API biztosításával máshonnan is hívható)

• Projekt feladatok kezelése (új létrehozása, módosítás, törlés),
• Feladatok áttekinthető vizuális megjelenítése (canbas tábla),
• Projekt résztvevőinek megjelenítése,
• Projekt adminisztrátorok kezelése (kijelölés, törlés),
• Feladat "föggőségek" kezelése (pl. az "x" feladat munkálatai csak akkor kezdhetők meg ha az "y" és "z" feladat már le van zárva)
• Töbnnyelvű kezelő felület támogatás,
• Testreszabható megjelenés,
• Több kliens egyidejű munkájának támogatása (aktív userszámtól függően idöközönként ellenörzi az adatbázis változásokat és szükség esetén frissíti a képernyőt)

A project adminisztrátorok lehetőségei:

• Feladatok áttekinthető vizuális megjelenítése (canbas tábla),
• projekt tagjainak megtekintése,
• új feladatok felvitele,,
• feladatok módosítása (beleértve a felelőshöz rendelést),
• feladatok törlése,
• további projekt adminisztrátorok kijelölése,
• projekt adminisztrátori jogok megvonása

A projekt többi (nem adminisztrátor) tagjainak lehetőségei:

• Feladatok áttekinthető vizuális megjelenítése (canbas tábla),
• projekt tagjainak megtekintése,
• a még felelős nélküli feladatokat magához rendelheti (elvállalja a feladat végrehajtását),
• a hozzá rendelt feladatok státuszának módosítása,
• projekt adminisztrátorok megtekintése

A többi látogató lehetőségei:

• Feladatok áttekinthető vizuális megjelenítése (canbas tábla),
• projekt tagjainak megtekintése,
• projekt adminisztrátorok megtekintése

• feladat automatikusan képződő azonosító száma,
• feladat rövid megnevezése,
• feladat szöveges leírása,
• típus (kérdés, javaslat, hiba, egyéb),
• státusz (várakozik, indítható, munkában, ellenörizendő, ellenörzés alatt, lezárt),
• indítási feltétel (azon feladatok azonosítóinak a listája, melyeknek lezárt állapotban kell lenniük ahoz, hogy ez a feladat megkezdhető legyen)

GNU/GPL

http://szeszt.tk/projektmanager

• PHP 7.0.33+,
• Javascript,
• JQuery 1.12.1+,
• mysql

• jquery.com (V 1.12.1)

Az unittestek, forrás kód kezelés, és a kód minőség ellenörzéshez:

• phpunit 6.5.14+

• Nodejs 8.9.4+

• npm 6.9+

• mocha 6.0.2+ nodejs modul

• mocha-jsdom 2.0.0+ nodejs modul

• mocha-rcov-reporter 1.3.0+ node.js modul

• jquery 3.3.1+ nodejs modul

• jscover 1.0.0+ nodejs modul

• sonarcloud kliens

• github kliens

• github.com

• travis-ci.org

• sonarcloud.io

• eclipse telepítése lásd: https://www.ics.uci.edu/~pattis/common/handouts/pythoneclipsejava/eclipsepython%20oxygen.html
• github fiók létrehozása a https://github.com -on (sign up klick)
• github kliens telepítése, konfigurálása lásd: https://help.github.com/en/desktop/getting-started-with-github-desktop/installing-github-desktop
• travis fiók létrehozása a https://travis-ci.org -on a github bejelentkezés segítségével (sign up with GitHub klick), github hozzáférés engedélyezése lásd: https://docs.travis-ci.com/user/tutorial/
• sonarcloud fiók létrehozása, a https://sonarcloud.io -n a github bejelentkezés segítségével (login klick)
• ennek a reponak a klonozása a saját gépre, tests/sonar-orig.sh másolása a másolat neve: tests/sonar.sh (eclipse /git repositories/clone/github, majd a file/open projects from file system)
• a saját gépen lévő repo publikálása a saját github fiókba (új projekt létrehozása a github web felületen, majd a saját gépen git remote add, git add ., git commit, git push)
• travisban bekapcsolni a megfelelő github repo kezelését (My repositores + klick)
• sonarcloudban új projekt létrehozás, manuális beállítással, a kapott project key-t a képernyőről beírni a saját repoban lévő tests/test.sh -ba a Dsonar.login= -hoz. a sonacloud project beállításainál megadni a coverage report fájlok pontos elérési útvonalait és fájl neveit. (Administration/General/PHP és Administration/General/Javascript klick)

A tests/...Test.php valamint a tests/...Test.js fájlok az unittest definiciók.

A config/app.php -be:

    "remoteModules" => [
        "projectManager" => "../projectmanager/app.php"
    ]

Megjegyzések:

• Ha ez a rész nem szerepel, akkor a project menüben nem jelenik meg a "tasks" menüpont
• A config/app.php editálása után:

$ php artisan config:clear
$ php artisan config:cache

<?php
// $request, $slug input paraméterek
$param = array(); // viewernek átadott paraméterek 
$param['project'] = DB::table('projects')->where('slug',$slug)->first();
$param['sessionid'] = $request->session()->getId();
...
?>

<?php
$remoteModules = config('app.remoteModules');
?>
<div id="tasks" style="width:100%; height:100%;">
<h2>{{$project->title}}</h2>
<iframe id="ifrmProjectManager" src="" style="width:100%; height:600px"></iframe>
</div>
<script type="text/javascript">
var sessionId = "{{ $sessionid }}";
var projectId = "{{ $project->id }}";
var apiURL = "{{ url('./pmapi') }}";
var url = "{{$remoteModules['projectManager'] }}"+
"?option=tasks&task=show"+
"&sessionid="+sessionId+"&projectid="+projectId+"&callerapiurl="+encodeURI(apiURL);
$('#ifrmProjectManager').attr('src',url);
</script>

Opcionális további URL paraméterek a projectmanagernek:

&lng=hu vagy &lng=en
&css=cssFileURL

az API apiURL/ sessionid / projectid http -url -el van hívva.

pl: https:/platform.envienta.org/api/projectinfo/abc....de/ef12.....23

visszaadnia "json" content típusban egy json stringet kell:

{"users":[[avatarURL, nickName], ....],
  "admins":[avatarURL],
  "loggedUser":avatarURL
}

Ahol: avatarURL: string user gravatar vagy facebook profilképre mutató URL

nicName : string user nick neve

admins: array of string project adminisztrátorok avatarURL -jei

loggedUser: string a bejelentkezett felhasználó avatarURL -je, vagy üres string

Példa:

<?php
header('Content-Type: json');
echo '
{"users":[
["https://www.gravatar.com/avatar/2c0a0e6e2dc8b37f24ddb47dfb7e3eb5","utopszkij"],
["https://www.gravatar.com/avatar/12345e6e2dc8b37f24ddb47dfb7e3eb5","user1j"],
["https://www.gravatar.com/avatar/45670e6e2dc8b37f24ddb47dfb7e3eb5","user2j"],
],					                    ],
"admins":["https://www.gravatar.com/avatar/2c0a0e6e2dc8b37f24ddb47dfb7e3eb5"],
"loggedUser":"https://www.gravatar.com/avatar/45670e6e2dc8b37f24ddb47dfb7e3eb5"
}
';
?>

cd repoRoot
./tools/test.sh

cd repoRoot
./tools/sonar.sh

Utolsó ellenőrzés eredménye:

https://sonarcloud.io/dashboard?id=utopszkij-projectmanager

cd repoRoot
./tools/documentor.sh

utolsó futtatás eredménye: http://szeszt.tk/projektmanager/doc/index.html

1. mysql adatbázis kreálás (utf-8 hungaryan_ci).
2. htaccess.txt átnevezése .htaccess -re
3. config.txt átnevezése .config.php -ra és értelem szerü editálása.
4. A szerver documentroot-ba másolni: app.php, index.html, style.css, .htaccess, config.php
   fileokat és a controllers, images, js, langs, models, views, log alkönyvtárak teljes tartalmukkal együtt.
5. a log alkönyvtár és tartalma legyen írható a web szerver és a php számára.

Fogler Tibor (utopszkij) [email protected] https://github.com/utopszkij