private async Task <IReadOnlyList <IEntitySyncStateContext <TAtypeEntityId, TAtypeEntityVersion, TAtypeEntity, TBtypeEntityId, TBtypeEntityVersion, TBtypeEntity, TContext> > > CreateEntitySyncStateContexts(
            IEntityContainer <TAtypeEntityId, TAtypeEntity, TContext> aEntities,
            IEntityContainer <TBtypeEntityId, TBtypeEntity, TContext> bEntities,
            IEnumerable <IEntityRelationData <TAtypeEntityId, TAtypeEntityVersion, TBtypeEntityId, TBtypeEntityVersion> > knownEntityRelations,
            IEntityStateCollection <TAtypeEntityId, TAtypeEntityVersion> aStates,
            IEntityStateCollection <TBtypeEntityId, TBtypeEntityVersion> bStates,
            ISynchronizationLogger logger,
            TContext synchronizationContext,
            ISynchronizationInterceptor <TAtypeEntityId, TAtypeEntityVersion, TAtypeEntity, TBtypeEntityId, TBtypeEntityVersion, TBtypeEntity, TContext> interceptor)
        {
            var entitySynchronizationContexts = new List <IEntitySyncStateContext <TAtypeEntityId, TAtypeEntityVersion, TAtypeEntity, TBtypeEntityId, TBtypeEntityVersion, TBtypeEntity, TContext> >();

            var aDeltaLogInfo = new VersionDeltaLoginInformation();
            var bDeltaLogInfo = new VersionDeltaLoginInformation();

            foreach (var knownEntityRelationData in knownEntityRelations)
            {
                (var aState, var aRepositoryVersion) = aStates.RemoveState(knownEntityRelationData.AtypeId, knownEntityRelationData.AtypeVersion);
                (var bState, var bRepositoryVersion) = bStates.RemoveState(knownEntityRelationData.BtypeId, knownEntityRelationData.BtypeVersion);

                entitySynchronizationContexts.Add(new EntitySyncStateContext <TAtypeEntityId, TAtypeEntityVersion, TAtypeEntity, TBtypeEntityId, TBtypeEntityVersion, TBtypeEntity, TContext>(
                                                      CreateInitialSyncState(knownEntityRelationData, aState, bState, aRepositoryVersion, bRepositoryVersion, aDeltaLogInfo, bDeltaLogInfo)));
            }

            var newAVersions = aStates.DisposeAndGetLeftovers();
            var newBVersions = bStates.DisposeAndGetLeftovers();

            await _atypeRepository.VerifyUnknownEntities(newAVersions, synchronizationContext);

            await _btypeRepository.VerifyUnknownEntities(newBVersions, synchronizationContext);

            if (newAVersions.Count > 0 && newBVersions.Count > 0)
            {
                s_logger.Info($"Performing entity matching with {newAVersions.Count} Atype and {newBVersions.Count} Btype entities.");

                var matchingEntites = _initialEntityMatcher.FindMatchingEntities(
                    _entityRelationDataFactory,
                    await aEntities.GetTransformedEntities(newAVersions.Keys, logger.ALoadEntityLogger, synchronizationContext, e => _aMatchDataFactory.CreateMatchData(e.Entity)),
                    await bEntities.GetTransformedEntities(newBVersions.Keys, logger.BLoadEntityLogger, synchronizationContext, e => _bMatchDataFactory.CreateMatchData(e.Entity)),
                    newAVersions,
                    newBVersions);

                foreach (var knownEntityRelationData in matchingEntites)
                {
                    newAVersions.Remove(knownEntityRelationData.AtypeId);
                    newBVersions.Remove(knownEntityRelationData.BtypeId);
                    var entitySyncState = _initialSyncStateCreationStrategy.CreateFor_Unchanged_Unchanged(knownEntityRelationData);
                    entitySynchronizationContexts.Add(new EntitySyncStateContext <TAtypeEntityId, TAtypeEntityVersion, TAtypeEntity, TBtypeEntityId, TBtypeEntityVersion, TBtypeEntity, TContext>(entitySyncState));
                    aDeltaLogInfo.IncUnchanged();
                    bDeltaLogInfo.IncUnchanged();
                }

                s_logger.Info("Entity matching finished.");
            }

            foreach (var newA in newAVersions)
            {
                var syncState = _initialSyncStateCreationStrategy.CreateFor_Added_NotExisting(newA.Key, newA.Value);
                entitySynchronizationContexts.Add(new EntitySyncStateContext <TAtypeEntityId, TAtypeEntityVersion, TAtypeEntity, TBtypeEntityId, TBtypeEntityVersion, TBtypeEntity, TContext>(syncState));
            }

            foreach (var newB in newBVersions)
            {
                var syncState = _initialSyncStateCreationStrategy.CreateFor_NotExisting_Added(newB.Key, newB.Value);
                entitySynchronizationContexts.Add(new EntitySyncStateContext <TAtypeEntityId, TAtypeEntityVersion, TAtypeEntity, TBtypeEntityId, TBtypeEntityVersion, TBtypeEntity, TContext>(syncState));
            }

            interceptor.TransformInitialCreatedStates(entitySynchronizationContexts, _syncStateFactory);

            // all the leftovers in newAVersions and newBVersions must be the added ones
            aDeltaLogInfo.IncAdded(newAVersions.Count);
            bDeltaLogInfo.IncAdded(newBVersions.Count);
            s_logger.InfoFormat("Atype delta: {0}", aDeltaLogInfo);
            s_logger.InfoFormat("Btype delta: {0}", bDeltaLogInfo);
            logger.LogDeltas(aDeltaLogInfo, bDeltaLogInfo);

            return(entitySynchronizationContexts);
        }
        public async Task <bool> Synchronize()
        {
            s_logger.InfoFormat("Entered. Syncstrategy '{0}' with Atype='{1}' and Btype='{2}'", _initialSyncStateCreationStrategy.GetType().Name, typeof(TAtypeEntity).Name, typeof(TBtypeEntity).Name);


            try
            {
                using (var totalProgress = _totalProgressFactory.Create())
                {
                    var cachedData = _entityRelationDataAccess.LoadEntityRelationData();

                    var aVersionsTask = _atypeRepository.GetVersions();
                    var bVersionsTask = _btypeRepository.GetVersions();

                    var aVersions = await aVersionsTask;
                    var bVersions = await bVersionsTask;

                    var atypeRepositoryVersions = CreateDictionary(
                        aVersions,
                        _atypeIdComparer);

                    var btypeRepositoryVersions = CreateDictionary(
                        bVersions,
                        _btypeIdComparer);

                    IReadOnlyDictionary <TAtypeEntityId, TAtypeEntity> aEntities = null;
                    IReadOnlyDictionary <TBtypeEntityId, TBtypeEntity> bEntities = null;

                    try
                    {
                        if (cachedData == null)
                        {
                            s_logger.Info("Did not find entity caches. Performing initial population");

                            totalProgress.NotifyLoadCount(atypeRepositoryVersions.Count, btypeRepositoryVersions.Count);

                            using (totalProgress.StartARepositoryLoad())
                            {
                                aEntities = CreateDictionary(
                                    await _atypeRepository.Get(atypeRepositoryVersions.Keys),
                                    _atypeIdComparer);
                            }

                            using (totalProgress.StartBRepositoryLoad())
                            {
                                bEntities = CreateDictionary(
                                    await _btypeRepository.Get(btypeRepositoryVersions.Keys),
                                    _btypeIdComparer);
                            }

                            cachedData = _initialEntityMatcher.FindMatchingEntities(
                                _entityRelationDataFactory,
                                aEntities,
                                bEntities,
                                atypeRepositoryVersions,
                                btypeRepositoryVersions);
                        }

                        var entitySyncStates = new EntitySyncStateContainer <TAtypeEntityId, TAtypeEntityVersion, TAtypeEntity, TBtypeEntityId, TBtypeEntityVersion, TBtypeEntity>();

                        var aDeltaLogInfo = new VersionDeltaLoginInformation();
                        var bDeltaLogInfo = new VersionDeltaLoginInformation();

                        foreach (var cachedEntityData in cachedData)
                        {
                            TAtypeEntityVersion repositoryAVersion;
                            TBtypeEntityVersion repositoryBVersion;

                            var repositoryAVersionAvailable = atypeRepositoryVersions.TryGetValue(cachedEntityData.AtypeId, out repositoryAVersion);
                            var repositoryBVersionAvailable = btypeRepositoryVersions.TryGetValue(cachedEntityData.BtypeId, out repositoryBVersion);

                            if (repositoryAVersionAvailable)
                            {
                                atypeRepositoryVersions.Remove(cachedEntityData.AtypeId);
                            }

                            if (repositoryBVersionAvailable)
                            {
                                btypeRepositoryVersions.Remove(cachedEntityData.BtypeId);
                            }

                            var entitySyncState = CreateInitialSyncState(cachedEntityData, repositoryAVersionAvailable, repositoryAVersion, repositoryBVersionAvailable, repositoryBVersion, aDeltaLogInfo, bDeltaLogInfo);

                            entitySyncStates.Add(entitySyncState);
                        }

                        aDeltaLogInfo.IncAdded(atypeRepositoryVersions.Count);
                        bDeltaLogInfo.IncAdded(btypeRepositoryVersions.Count);

                        s_logger.InfoFormat("Atype delta: {0}", aDeltaLogInfo);
                        s_logger.InfoFormat("Btype delta: {0}", bDeltaLogInfo);

                        foreach (var newA in atypeRepositoryVersions)
                        {
                            entitySyncStates.Add(_initialSyncStateCreationStrategy.CreateFor_Added_NotExisting(newA.Key, newA.Value));
                        }

                        foreach (var newB in btypeRepositoryVersions)
                        {
                            entitySyncStates.Add(_initialSyncStateCreationStrategy.CreateFor_NotExisting_Added(newB.Key, newB.Value));
                        }

                        HashSet <TAtypeEntityId> aEntitesToLoad = new HashSet <TAtypeEntityId>();
                        HashSet <TBtypeEntityId> bEntitesToLoad = new HashSet <TBtypeEntityId>();

                        entitySyncStates.Execute(s => s.AddRequiredEntitiesToLoad(aEntitesToLoad.Add, bEntitesToLoad.Add));

                        if (aEntities == null && bEntities == null)
                        {
                            totalProgress.NotifyLoadCount(aEntitesToLoad.Count, bEntitesToLoad.Count);
                            using (totalProgress.StartARepositoryLoad())
                            {
                                aEntities = CreateDictionary(
                                    await _atypeRepository.Get(aEntitesToLoad),
                                    _atypeIdComparer);
                            }

                            using (totalProgress.StartBRepositoryLoad())
                            {
                                bEntities = CreateDictionary(
                                    await _btypeRepository.Get(bEntitesToLoad),
                                    _btypeIdComparer);
                            }
                        }

                        entitySyncStates.DoTransition(s => s.FetchRequiredEntities(aEntities, bEntities));
                        entitySyncStates.DoTransition(s => s.Resolve());

                        // since resolve may change to an new state, required entities have to be fetched again.
                        // an state is allowed only to resolve to another state, if the following states requires equal or less entities!
                        entitySyncStates.DoTransition(s => s.FetchRequiredEntities(aEntities, bEntities));

                        using (var progress = totalProgress.StartProcessing(entitySyncStates.Count))
                        {
                            await entitySyncStates.DoTransition(
                                async s =>
                            {
                                var nextState = await s.PerformSyncActionNoThrow();
                                progress.Increase();
                                return(nextState);
                            });
                        }

                        var newData = new List <IEntityRelationData <TAtypeEntityId, TAtypeEntityVersion, TBtypeEntityId, TBtypeEntityVersion> >();

                        entitySyncStates.Execute(s => s.AddNewRelationNoThrow(newData.Add));

                        entitySyncStates.Dispose();

                        _entityRelationDataAccess.SaveEntityRelationData(newData);
                    }
                    finally
                    {
                        _atypeRepository.Cleanup(aEntities);
                        _btypeRepository.Cleanup(bEntities);
                    }
                }
            }
            catch (Exception x)
            {
                _exceptionLogger.LogException(x, s_logger);
                return(false);
            }

            s_logger.DebugFormat("Exiting.");
            return(true);
        }