# espa-ui component library

## Verziniranje i git grane razvoja

Projekt koristi Semantic Versioning odnosno "SemVer" konvenciju verzioniranja:

- specifikacija [ovdje](http://semver.org/)

Projekt koristi "git-flow" kao model prema kojem cemo raditi grananje i verzioniranje.

Upute:

- procitati originalni blog [ovdje](http://nvie.com/posts/a-successful-git-branching-model/)
- alat za automatizaciju git-flow konvencije [ovdje](https://github.com/nvie/gitflow)
- git-flow cheatsheet [ovdje](https://danielkummer.github.io/git-flow-cheatsheet/)



## FOF (files of interest)

### Component requirements (req.md)

Ovaj dokument je podloga (zahtjev, specifikacija) za implementaciju komponente.
Svaka komponenta ima `req.md` - component requirement. 

##### Unos komentara (diskusija) na req.md

Komentari započinju sa blockquote `> {IME}{ISO-DATUM}: `
Komentar na komentar započnite sa dva blockquotes: `>> {IME}{ISO-DATUM}: ` itd.

>Mario(2017-03-10): prvi komentar

>>Igor(2017-03-10): prvi komentar prvog komentara

>>>Igor(2017-03-10): drugi komentar prvog komentara

>>Darijo(2017-03-10): drugi komentar prvog komentara

##### Izmjena dokumenta

Tekst koji se briše obucite u `<del>{STARI TEXT}</del>` tag, a novi ubacite direktno nakon njega.
(`<del>` je HTML 5 zamjena za `<strike>`.)

## Layouts

Cilj je podržati sljedeće layouts:

### CollectionView i EntityView (single view)

Prikaz kolekcije (table) i jednog zapisa (row).

```
 -----------------------------------------------------------
|                                                           |
|  APPBAR                                                   |
|                                                           |
 -----------------------------------------------------------
|                          |                                |
|  BREADCRUMBS             | SEARCHBAR                      |
|                          |                                |
 -----------------------------------------------------------
|                          |                                |
|  ACTIONBAR               | PAGINATION + VIEWBAR           |
|                          |                                |
 -----------------------------------------------------------
|                                                           |
|                                                           |
|                                                           |
|                VIEW                                       |
|                                                           |
|                                                           |
|                                                           |
 -----------------------------------------------------------
```

### MD (master-master-detail)
```
 -----------------------------------------------------------
|                                                           |
|  APPBAR                                                   |
|                                                           |
 -----------------------------------------------------------
|                                                           |
|  BREADCRUMBS                                              |
|                                                           |
 -----------------------------------------------------------
|                                                           |
|  ACTIONBAR                                                |
|                                                           |
 -----------------------------------------------------------
| MINI HEADER              |                                |
 --------------------------                                 |
|                          |                                |
|                          |                                |
|                          |                                |
|                          |                                |
|                          |                                |
|                          |                                |
| MASTER (COLLECTION)      |  DETAIL (ENTITY)               |
|                          |                                |
|                          |                                |
|                          |                                |
|                          |                                |
|                          |                                |
|                          |                                |
|                          |                                |
 -----------------------------------------------------------
```

### MMD (master-master-detail)
```
 -----------------------------------------------------------
|                                                           |
|  APPBAR                                                   |
|                                                           |
 -----------------------------------------------------------
|                                                           |
|  BREADCRUMBS                                              |
|                                                           |
 -----------------------------------------------------------
|                                                           |
|  ACTIONBAR                                                |
|                                                           |
 -----------------------------------------------------------
| (PG + FILTER)     | (PG + FILTER)   |                     |
 -------------------|-----------------|                     |
|                   |                 |                     |
|                   |                 |                     |
|                   |                 |                     |
|                   |                 |                     |
|                   |                 | DETAIL              |
|                   |                 |                     |
| MASTER            |  MASTER         |                     |
|                   |                 |                     |
|                   |                 |                     |
|                   |                 |                     |
|                   |                 |                     |
|                   |                 |                     |
|                   |                 |                     |
|                   |                 |                     |
 -----------------------------------------------------------
```