Fixation of architecture and its documentation about building-navigator HOT 12 CLOSED

First quite reduced draft of the architecture with required elements.

Especially the "Action API" will have additional elements like functions/interfaces/classes etc to request the Store, build the Filter etc. Shall I add these to the architecture diagram?

from building-navigator.

A more detailed version with additional elements:

from building-navigator.

I figured out an important update of the flow between the actions, rdfstore and middleware.
We can use the middleware as an API to do asynchronous requests to the rdfstore and pass the results to the redux-store.
The new architecture might look like this:

A description will follow in the Readme...

from building-navigator.

Thanks for the sketches, they look good already. But i dont understand, why we need the Middleware API? The container is already subscribed on the redux store and therefore gets called, if anything changes. This kind of asynchronization is already there, why the Middleware?

from building-navigator.

In the first sketches the asynchronous call to the rdfstore was made in the action API. But this was wrong. The actions are mainly for synchronous calls to the Redux store.
With a custom middleware we can do an asynchronous call to the rdfstore, fetch places and dispatch them to the Redux store. Therefore the middleware wraps the dispatch function and is independently from actions.

from building-navigator.

The middleware is basically the handler of asynchron request/responses and delivers. Therefore it makes sense. So the container doesn't wait for something, just fire and forget. But gets called, if an update arrived. This way?

from building-navigator.

Yep, thats the way.
And while the sync request is working, the container can subscribe to an 'is-fetching' state, to may view a loading icon.

from building-navigator.

Ok, sounds good. What are your next steps?

from building-navigator.

Which bullet points can be already marked solved in the list above?

from building-navigator.

With the updated Readme and source we can check the first three points.

The new test concept is still on progress.

from building-navigator.

Very interesting article how to structure a React application: https://medium.com/@alexmngn/how-to-better-organize-your-react-applications-2fd3ea1920f1#.a0y594u1s

from building-navigator.

from building-navigator.