You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Missing part in many projects, model does whats expected: defines the entities. It may also contain core validations, factories and everything ralated to properly using and creating valid entities.
14
+
Missing part in many projects, model does what's expected: defines the entities. It may also contain core validations, factories and everything ralated to properly using and creating valid entities.
15
15
16
-
Nothing Angular related (like services or modules) apply to this layer.
16
+
Nothing Angular related (like services or modules) applies to this layer.
17
17
18
18
#### Repository
19
19
20
-
Although it might seem, by the nature of the word being generally associated with DataBases, something allien to rich web client development, archtecturaly speaking the Repository is the where we store the entities of our application. This layer will interface with the Server instead of a DataBase. It will usually be performing queries and returing instances of entities provided by the model; converting server sent JSON (value objects) into application classes.
20
+
Although it might seem, by the nature of the word being generally associated with databases, something alien to rich web client development, architecturally speaking the Repository is where we store the entities of our application. This layer will interface with the server instead of a database. It will usually perform queries and return instances of entities provided by the model, converting server sent JSON (value objects) into application classes.
21
21
22
-
Implementation of repositories are mostly done by using Angular services.
22
+
Implementation of repositories are mostly done through Angular Services.
23
23
24
24
#### Services
25
25
26
-
Not to be mistaken by Angular Services (which are indeed used to implement classes not only in this very layer, but also in manu others), this layer is responsible to implement logic that is critical to the application business by leveraging zero or many repositories and adding value and meaning to complex operations that might be or not shared between muitiple parts of the UI.
26
+
Not to be mistaken by Angular Services (which are indeed used to implement classes not only in this very layer, but also in many others). This layer is responsible for implementing logic that is critical to the application business by leveraging zero or many repositories and adding value and meaning to complex operations that might be or not shared between multiple parts of the UI.
27
27
28
-
Like repositories, Services are mostly done by employing Angular services.
28
+
Like repositories, Services are mostly done by employing Angular Services.
29
29
30
30
#### UI
31
31
32
-
Here goes the most of the app. All html goes here. its divided in three smaller portions to logically organize and provide foundation to sharing code while isolating one feature from another.
32
+
Here goes the bulk of the app. All HTML goes here. It's divided in three smaller portions to logically organize and provide foundation for sharing code while isolating one feature from another.
33
33
34
34
##### Pages
35
35
36
-
Features go here. Each feature must be isolated from one another and reside in its single Angular module. Default artefacts found in each feature will include the page html file, controller and module file. Optionally, directives might be added according to particular neccessities, like isolating a specific modal.
36
+
Features go here. Each feature must be isolated from one another and reside in its single Angular Module. Default artifacts found in each feature will include the page HTML, Controller and Module files. Optionally, directives might be added according to particular neccessities, like isolating a specific modal.
37
37
38
38
##### Components
39
39
40
-
Components are a single Angular module containing UI components to be shared accross Pages. Components in this module should avoid accessing services or repository or encapsulate, intead being more focused on visual representation and reusability. Usually implemented through Angular directives.
40
+
Components are a single Angular module containing UI components to be shared accross Pages. Members of this module should avoid accessing Services or Repositories, instead being more focused on visual representation and reusability. Usually implemented through Angular Directives.
41
41
42
42
##### Mediators
43
43
44
-
Mediators, like Components, live in a single Angular module. Classes here are responsible for isolating commun behavior executed throughout the application UI. Isolae vendor specific services like mdNotification and provide a single point of standardized and simplified interaction with the library is great use of this layer.
44
+
Mediators, like Components, live in a single Angular Module. Classes here are responsible for isolating common behavior executed throughout the application UI. Isolate vendor specific services like mdNotification and provide a single point of standardized and simplified interaction with the library is a great use of this layer.
45
45
46
46
## Auxiliary Tools & Configurations
47
47
48
-
Project is tailored to be used with WebStorm 11, but its not obligatory. Although some niceties that are already configured will be lost, its completely possible to replicate such configurations in other IDE. Having that said, use of WebStorm is highly favored.
48
+
Project is tailored to be used with WebStorm 11+, but its not obligatory. Although some niceties that are already configured will be lost, it's completely possible to replicate such configurations on other IDEs. Having that said, use of WebStorm is highly favored.
49
49
50
50
The stack of tools used include:
51
51
@@ -56,13 +56,11 @@ The stack of tools used include:
56
56
* LESS: Less compiler
57
57
* WebStorm: IDE, automation of some tasks
58
58
59
-
Only required pre-installed software is NPM and WebStorm. Check out the project, open it in WebStorm then run ___npm install___ on the console and it will:
59
+
Only required pre-installed software is NPM and WebStorm. Check out the project, open it in WebStorm then run __npm install__ on the console and it will:
60
60
61
61
* Download Bower, Gulp, Typings and LESS compiler
62
62
* Download Bower dependencies into __assets/bower_components__ directory
63
63
* Download typings into __typings__ directory
64
64
* Compile the empty less file into __assets/css/app.css__
65
65
66
-
Additionally every update of any of the Bower (__bower.json__), Typings (__typings.json__) or any __.less__ file in __/less__ should trigger an automatic update commands such as after you SVN update, updated libraries, css and typings will not go unoticed.
67
-
68
-
66
+
Additionally, every update of any Bower (__bower.json__), Typings (__typings.json__) or any __.less__ file in __/less__ should trigger an automatic update command.
0 commit comments