# Index
[ToC]

# Idei generale
Platforma trebuie sa fie multi-tenant si sa suporte cursuri in format [SCORM](https://scorm.com/scorm-explained/). Pentru inceput platforma ar trebui sa aiba o forma basic de compozitor de cursuri. Deasemenea, trebuie sa fie multi-language si sa avem in vedere problema timezone-ului in cazul extinderii si in afara Romaniei.

# Continut
Platforma are la baza 3 tipuri de useri (roluri): Administrator, Instructor si Learner. Continutul afisat variaza in functie de tipul de user. Se pot defini roluri care extind aceste roluri de baza.

# Home Administrator


## Utilizatori
Administratorul are acces la toti utilizatorii si poate adauga, edita sau sterge utilizatori.

### Adaugare
Un simplu formular pentru adaugat utilizatori.

### Profil/Informatii
Informatii personale precum nume, prenume, username, etc.
### Profil/Cursuri
Cursuri la care utilizatorul este inrolat si care este rolul lui acolo.
### Profil/Fisiere
Documente atasate utilizatorului.

### Progres/Sumar
Un dashboard unde sunt agregate informatii despre cursurile pe care le face utilizatorul.

### Progres/Cursuri
Informatii despre progresul utilizatorului in functie de cursurile la care este inrolat.

### Progres/Medalii
Medaliile obtinute de utilizator in urma cursurilor facute. Face parte din Gamification.

### Progres/Timeline
Evenimente legate de utilizator.

### Infografic
Un raport fancy cu informatii despre utilizator.

## Cursuri
Administratorii pot vedea toate cursurile. Actiunile din grid sunt: Reports, Edit, Clone, Detele si View. Cursuri pot fi adaugate din marketplace.

### Adaugare
Administratorul poate adauga cursuri.

### Info/Curs/Utilizatori
Administrarea utilizatorilor atasati cursului.

### Rapoarte/Sumar
Sumar despre curs.

### Rapoarte/Utilizatori
Rapoarte despre utilizatorii cursului.

### Rapoarte/Timeline
Evenimentele de pe curs.

## Categorii
CRUD pentru categorii de cursuri.

### Adaugare/Modificare

## Grupuri
Grupuri de cursuri care pot fi vandute ca si pachete.

### Adaugare/Modificare

### Utilizatori
Administrarea utilizatorilor care au acces la pachetul de cursuri.

### Cursuri
Administrarea cursurilor care fac parte din grup.

### Fisiere
Fisiere disponibile utilizatorilor care au acces in grup.

## Subsidiare (skip sub-tenants)

## Evenimente/Notificari
Sistemul de evenimente si notificari.

### Adaugare/Modificare
Adaugare de notificare noua care se bazeaza pe un tip de eveniment predefinit si o lista de tipuri de destinatari (predefiniti). Textul notificarii este templetizat.

### Istoric
Istoricul notificarilor/evenimentelor care au fost create.

### Evenimente in asteptare
Evenimente care urmeaza sa fie trimise.

## Tipuri de utilizatori/Roluri
Crud pentru modelul utilizator/rol/permisiuni

### Adaugare/Modificare

## Import / Export
Import si export masiv in format CSV. Import si export de utilizatori, grupuri, cursuri, subsidiare, categorii si relatiile dintre ele.

## Rapoarte / Infografic / Timeline
Raporate despre orice din platforma: utilizatori, cursuri, subsidiare, grupuri, scorm, teste, survey-uri, teme, etc.

## Setari platforma
Setari generale la nivel de platforma.

### Setari generale
> [name=Robert Ursu] Trebuie sa spicuim ce avem neovoie de aici si sa investigam la ce sunt folosite (si daca ne trebuie si noua) field-urile custom.


### Utilizatori
Setari generale pentru crearea de utilizatori.

### Teme/Skinuri
Customizari si setari de tema pentru platforma.

### Certificari
Setari pentru diplome.

### Gamification
Setari pentru implementarea gamification-ului.

### E-Comert
Setari legate de procesatori de plati, abonamente, discount-uri, facturi, cupoane si credite.

### Domeniu
Setari de domeniu. Customizare de domeniu.

### Abonament
Tipul de abonamet al clientului.

#### Istoric de plati

# Home Instructor

## Cursuri

### Adaugare / Modificare
> La fel ca la Administrator

### Continutul cursului

Exista mai multe tipuri de continut pentru un curs.

#### RichText

#### Web

#### Video

#### Audio

#### Presentation / Document

#### SCORM / xAPI / cmi5

#### Flash (skip)
> [name=Robert] Nu merita sa ne complicam cu flash


#### iFrame (skip)
> [name=Robert] Nu merita sa ne complicam cu iFrame-uri


#### Test

#### Survey

#### Assignment

#### Instructor-led training

### Utilizatori si progres

### Fisiere

### Reguli

### Raporate

## Grupuri
> La fel ca la Administrator

## Conferinte (skip)
> [name=Robert] Nu cred ca e relevant

## Discutii / Forum

## Calendar
Calendarul instructorului. Poate fi dezvoltat ca si serviciu de booking.

# Home Learner

## Cursuri disponibile

## Progres
> Descris la sectiunea Utilizatori in seciunea Administrator.

## Inscriere in grup

## Discutii
> La fel ca la instructor

## Calendar
> La fel ca la instructor

# Tech

## General
Cea mai buna abordare pentru un proiect asa de mare cred ca ar fi sa modularizam totul in microservicii. Astfel putem lucra in paralel la diferite module fara sa ne afectam prea mult. Avantajul ar mai fi si ca teoretic am putea vinde modulele si separat. Pe langa ca putem vinde modulele, le putem si folosi in alte proiecte. Trebuie sa tinem cont ca trebuie sa tinem costurile la un minim, deci solutiile open-source sunt favorite.

## Propuneri de tehnologii
- [GraphQL](https://graphql.org/) - putem folosi graphql pentru API-uri. Avantajul ar fi ca definim scheme pe baza modelelor si clientii folosesc doar ce au nevoie.
- [.NET Core](https://dotnet.microsoft.com/download) - putem dezvolta unele microservicii cu .NET Core
- [node.js](https://nodejs.org/en/) - sau le putem dezvolta cu node.js
- [Angular](https://angular.io/)/[React](https://reactjs.org/) - pentru front ar fi bun un SPA bine facut cu Angular sau React
- [Docker](https://www.docker.com/) - impachetam cod-ul in imagini docker si o sa ne fie foarte usor sa deploy-em, scalam, testam, etc.
- [Kubernetes](https://kubernetes.io/) - daca o sa fie nevoie sa scalam la un moment dat, sigur vom avea nevoie de kubernetes

## Aplicatii si (micro)servicii
> [name=Robert] learner e doar un placeholder de nume

### learner-web
Aplicatia web SPA dezvoltata cu Angular sau React.

### controls-lib
Sigur vom ajunge a scriem componente custom. Ar fi nice to have sa ne construim o librarie de componente pe care poate o mai refolosim.

### learner-api
API-ul cu care comunica web-ul pentru chestiile strict legate de LMS.

### reports-api
Cel mai important microserviciu, rapoartele vietii. Trebuie sa fie suficient de destept sa poata genera orice tip de rapoarte.

### identity-api
Ne trebuie un sistem de autentificare si autorizare (OAuth2 si OpenID) care sa fie multi-tenant si sa suporte roluri si permisiuni. Sugestia mea este sa construim peste ceva deja existent cum ar fi [IdentityServcer4](https://github.com/IdentityServer/IdentityServer4) - [docs](https://identityserver4.readthedocs.io/en/latest/index.html). Toate celelalte servicii urmand sa comunice cu acest identity server. O alta varianta ar mai fi [Gluu](https://www.gluu.org/) - [docs](https://www.gluu.org/docs/ce/installation-guide/)

### notification-api
Un microserviciu care stie sa programeze si sa transmita notificari prin multe metode (email, push, tcp, sockets, etc). Trebuie sa stie sa primeasca un template care contine variabile si valori pentru variabilele alea dupa care sa "randeze" mesajul si sa programeze notificarea sa fie trimisa pe orice tip de canal.

### gamification-api
Un microserviciu cu care sa poti gamifica orice tip de aplicatie. Cred ca poate fi scris suficient de generic.

### filestore-api
Un serviciu de gestionat fisiere.

### forum-api/messaging-api
Un microserviciu pe care sa-l folosim sa construim forum-uri/discutii. Poate chiar chat-uri.

### billing-api
Serviciu care se ocupa de tot ce tine de plati, abonamente, cupoane, discount-uri, generare de facturi, erc.

### logging-api
Un serviciu care sa centralizeze log-urile serviciilor. Toate log-urile urmand sa fie turnate intr-o baza mare + elastic (kibana).

### gateway-api/broker-api (maybe)
E posibil sa avem nevoie de un gateway/broker, daca se aduc prea multe microservicii, care sa stie sa directioneze request-urile din web catre microserviciul corespunzator. Asta ca web-ul sa nu trebuiasca sa aibe grija de 5-ish tokene. Web-ul obtine un token din gateway iar gateway-ul obtine cate 1 token de la fiecare serviciu si are el grija de ele. O alta varianta ar fi ca identity server-ul sa emita un token care sa fie valabil pentru toate serviciile si sa nu fie nevoie deloc de gateway.