Merging master and develop (#116)

* Develop Merge to Master (#87) - Fri Oct 19th, 2018

* Initial Check In

* Updates

* Draft for Performance scenarios, metrics and other analytics information gathered as part of PI-1

* Minor spelling fix

* Added hardware/config details of hosts

* A sentence was incomplete, fixed it (#14)

* Added sequence diagram for prepare flows

Includes the following use-cases:
1. DFSP1 sends a Prepare Transfer request to DFSP2
2. Prepare Validation Failure
3. Prepare Position Failure

* Added generated svg

* Corrected position check failure

* Fixed typo

* fixed a duplicate, and added a comment indicate key usage for plantuml actor types

* updated comments

* Made things clearer and fixed callback request from MLAPI to CentralServices

* typo

* Moved prepare into 3 seperate files for easier readability

* updated grammar and typos

* Included messages between hops

* Fixed topic names

* added some additional metadata

* added some additional metadata fields

* wasnt using the Position DAO to retrieve the current position

* Fixed typo in 1.3

* Updated flow with event persistance in error use-cases

* Fixed some flow issues with notifications dap

* Updated with Murthy's comments.

* temp changes made during sprint discussion

- create stories for:
    - create a story to determine best approach for DB Transactionality/Compensation/Validation Patterns
    - story to provide feedback-loop for callback response
    - story to do the caching of the notifications information
    - story to do the caching of "transfer settlement batch window id"
    - story to do the caching of "position"
    - story to to modify existing mojaloop api definition for settlements (deposits, withdrawals, and clearing notifications)

- use cases to be added:
	- failure on "validates incoming token, and the originator matches DFSP1"
	- failure on "duplicate check" <-- need to conform to mojaloop <-- if there is an existing response that was not sent (then send 202), if it exists respond with response with existing message

- to do:
    - colour co-ordinate the same boxes to the arch diagram
    - update sequence diagram to show batch processing
    - add "transfer settlement batch window id" to be handled by the position event handler
    - add persistence of the transfer to the position event handler
    - add update of transfer status to the transfer event handler
    - sequence diagrams for:
        - fullfill use-case
        - transfer timeout use-case

* updated 1.1 and 1.2 with possible ML messages for successful prepare and failre validations

* updated headers to be json

* updated svgs for 1.1 and 1.2

* Updated SDs for 1.1, 1.2 & 1.3

* updated

* changed alts to groups

* simplified diagrams, and removed duplicated detail from 1.2 and 1.3 with reference to 1.1

* added batch flows

* Initial Commit for Specification documents

* Adding PKI Best Practices and JSON Binding Rules

* Adding descriptions for PKI Best Practices and JSON Binding Rules and some markdown editing

* Adding Logical Data Model and Generic Transaction Patterns

* Adding supporting files section to include the Open API (Swagger) YAML and RAML files corresponding to the specification

* Updated flows:

1.1 - based on Murthy's comments for the states for the prepare, and position handlers
1.2 - updated state to failure after prepare validation 
1.3 - updated state to failure after position check validation

* added additional validation for the amount

* Moving the specification document set to a repo of its own "mojaloop-specification"

* Review and brake into smaller reusable parts

* Added end-to-end flow for 1.1.0

* Updated 1.1.1

1. events not publishes to topic
2. added database tables
3. added alt flow for validation success and failures on prepare flow

* Fixed a typo, and added TOPIC_NOTIFICATIONS

* Updates based on the Design Authority review updates

mojaloop/project#213

* Updated prepareHandler to not update state to "aborted" if validations fail

* Fixed some typos, and corrected the event publisher in 1.1.2a

* Updated changes for PR review comments

* removed unused code.

* Updated diagram after code clean

* Updated based on PR comments.

* fixed flow for retrieval of position

* Fixed comments from PR

* Updated based on "last" comments

* Updated positionHandler to cater for the retrieval of position limits for a payer participant

* Fixed typo

* Feature/#247 Design Fulfill (#19)

Summary of changes:
- 2.1.x - Fulfil Success (sequence diagrams)
- 2.2.x - Fulfil Reject (sequence diagrams)
- 2.3.x - Timeout (sequence diagrams)
- use-case-position-handler (use case diagram)

For additional details, please refer to: Story #247, 2.4.01.01 Design Fulfill [5]

* Feature/#272 Implement Fulfil Handler Consume (Success)

Lineup 2.1.1 to its code implementation (#20)

* Data Diagrams Init

Added central-ledger DB schema
Added central-ledger DDL, generated by MySQLWorkbench > Server > Data Export

* Feature/Diagrams Update - Sequence & Architecture (#22)

* Fulfil Notify fix (#24)

* Arch-Flows-End-to-End.png

* adding mojaloop architecture static demo files (interim) (#23)

* Acknoledgments typo corrected (#25)

* seq diagrams http removal and golden path arch diagram edit (#28)

* Feature/#341positionManagementDesign (#33)

* Updated prepare handler for the pre-PI3-design for position handler
* Updated the svg diagram for the previous commit.
* Seq Fulfil Settlement Window and transferState update (#30)
* Design meeting update (#29)
* added new sequence diagrams for positions process
* updated sequence diagrams for positions
* added overall svg for positions
* Updated to follow standards as per DA/Georgi
* Update svg images to reflect updated plantUML
* Design Workshop Day 3 - Part 1 changes
* Design Workshop Day 4 - Part 1 changes
* changes for georgi to review
* Temp 6/26
* Merge rmothilal
* Design day 5, Part 1 - Transfer Neg.
* Initial changes
* Day 2 design changes
* Day 3 design changes
* Day 4 design changes
* Day 4 design changes (cont.)
* PR suggested change by Sam

* added seq diagram for participant callback details (#34)

* added seq diagram

* updated the sequence diagram for get and added for create endpoint

* updated the error codes

* updated the sequence diagrams as per DA review

* updated the sequence diagrams as per DA review

* Minor changes while implementing migration scripts (#35)

* Sequence diagrams for "API to Query FSP Positions" (#36)

* adding mojaloop architecture static demo files (interim)

* Added Sequence diagrams for "API to Query FSP Positions", story #331 - mojaloop/project#331

* Added the YAML file as well to document the proposal for the Data Model.
( Changes:
GET /positions:
GET /positions/{name}:
Under Definitions:
Amount
DateTime
FspId
Money
IndividualPosition
PositionsNameGetResponse
PositionsGetResponseForHub )

* Changes based on Warren's PR comments:
1. Updated Data Model to add a new item SinglePosition instead of Money that has value, reservedValue along with Currency.
2. Updated examples in the YAML accordingly
3. Updated 4.1.0 plantuml (and svg) to include participantCurrency in Step-9 and added the line "Use participant-<participantCurrency-<participantPosition lookup"; Updated Message to include reservedValue
4. Updated 4.2.0 plantuml (and svg) to include reservedValue in the Message

* Changes based on Warren's comments - updated 'timestamp' in Position detail to 'lastUpdated'.. Changed DataModel to add timestamp for GET requests - added 'respondedAt' to record the time when the response was sent.

* Changes based on Miguel's comments for the PR. (1. Updated 'fspId' to 'participantId', 2. Added 'lastUpdated' timestamp to Position Object instead of adding it separately outside, 3. Changed 'PositionsGetResponseForHub' to 'PositionsGetResponse', 4. Changed 'fspPositionsInSwitch' to 'positions'

* Updates based on Rajiv's, Miguel's comments (Changed ParticipantHandler to PositionHandler)

* After discussion with Miguel, changed back to ParticipantHandler (from PositionHandler) after changing the resources from /positions to /participants/positions and /positions/{name} to /participants/{name}/positions. Also, updated Swagger YAML to include only the positions end-points for clarity.

* Separate participant sequence diagrams (#37)

* adding mojaloop architecture static demo files (interim)

* Removing the 'print' files (used for printing for onsite meetings) and moving participant related Sequence diagrams to a separate folder

* first draft API Design (swagger and sequence diagram) for maintaining the participantLimit

* renamed extensions and created SVG file for sequence diagram

* synchronised naming conventions.

* minor tweaks in comments and title

* updated svg diagram to reflect latest changes in plantuml file.

* added "currencyId" to the return payload and made the amount fields string with a regex defining a proper amount.

* added sequence diagram for participant limits and initial position (#40)

* added sequence diagram for participant limits and initial position

* modified the diagram after review

* made some changes regarding exiting position/limits

* Feature/#285 handling duplicate prepares (#42)

* adding mojaloop architecture static demo files (interim)

* Moving all participant related flows into a single folder

* No major changes. A single comment about optimizing duplicate checks (try an insert first and handle an error in insertion for the duplicate and send either an error or a notification where necessary)

* Updating the SVG

* Added text to indicate the case of a request for which the processing is not complete in duplicate analysis

* Feature/#304 design notification handler for rejections (#45)

* Design Notification Handler for Rejections - v1.0

* Create Notification Reject UML process. v2.0

* Update Sequence diagram as per Sam recommendations. v3.0

* Update event 5 from solid line to dotted as per Sam's recommedation. v4.0

* Update as per Miguel's request to include ref to 9.1.0 - Event Handler

* Included rejections for 'timeout' events as per request from Miguel.

* Included the rejected actions as requested and 'cosmetic' updates. v5.0

* Removed sequence diagram that is not part of this feature.

* sequence diagram for NET_DEBIT_CAP management (#46)

* added the sequence diagrams for participant limits

* added the return object for post

* Removed swagger for manage_participant_limit.yaml as its being generated by the central-ledger

* Feature/#303 Design Timeout DAO layer and flow (#47)

* Outcome of story #303
* Spelling corrections
* rmothilal suggested changes and spell checker

* Feature/#300 event logging framework placeholder (#50)

* adding mojaloop architecture static demo files (interim)

* Initial commits for Event Handler placeholder design (minor change for prepare to publish duplicate to event topic)

* Updates based on Rajiv's comments

* Added a schema for the Message for the Event Handler (placeholder); focus being on the 'type' and 'action', which can be used to determine how the events should be handled.

* Update to change a couple of values to Upper case based on Miguel's suggestion

* Minor corrections (#51)

* Feature/317 design position management (#38)

* transfer fulfil and position fulfil

* updated svg diagrams

* abort processes

* abort process

* changes as per georgi and miguel

* added validate signiture

* added place holder for validation of the FSIOP_SIGNATURE into its own diagram

* updated svg

* PR Review ggrg & rmothilal

* removal of duplicate sequence diagram

* updates as per request from PR

* position prepare flow diagram

* changes required for commit

* updated svg diagrams

* updated as per sam's request

* Adding step to publish event when a duplicate is identified

* Updating the SVG based on the earlier change in the plantuml file

* Minor change in updating number sequence (duplicate step 2's)

* Updated position-prepare to reflect revision of algorithm

While using the single DB transaction model (have left comments for reverting to a 2 DB transaction model in the future)

Note, that from the review there will be a few changes to the code  - in particular the runningReservedValue calculation, and the handling of errors when not in the expected state. In general, need to check that handler interrupts errors correctly or that they are stored and passed back from the fascade.

* Added error codes for Step-3 in seq-position-1.3.1-prepare.plantuml (which was a ? earlier). Updated the corresponding SVG and PNG files as well

* Moving PNG files to archive folder

* Incorporated feedback based on Georgi's comments and Warren's questions

* Feature/#309 Prepare Duplicate Check (#57)

* Minor corrections
* Add transferError table

* Feature/#393 Design Timeout Handler (#54)

* Minor corrections
* Delivered by #301
* Finilise design
* Clean up and update diagrams that follow 2.3.1
* Update overall diagram
* Changes requested by DA Authority
* Changes requested during review with  wdcmb
* Appending states to list for inclusion
* Updating list of states

* Feature/#332 Settlement Processing DB Design (#52)

* Minor corrections
* DB Model and DDL
* Clean up requested by Shashi

* Feature/#309 updates to duplicate handling prepares (#56)

* adding mojaloop architecture static demo files (interim)

* Changes to Duplicate handling on prepares; Major change being persisting to the transfer (& related) DBs even when validation fails. Another change is persisting hash at the beginning if it doesn't exist in the transferDuplicateCheck table.

* Change made to introduce new status "INVALID" (internal) to mark entries where validations fail in Prepare Handler

* Removed the note (as it is outdated now) and added 'transferError' table so that errors can be persisted when Validation fails

* Made changes to structure, expanded in some places and correctly placed alternate flows, etc - based on Georgi's comments

* Changes based on Georgi's review comments (mostly for clarity and formatting)

* Added template for stories

* Feature/#409 Bug Template (#58)

* adding mojaloop architecture static demo files (interim)

* Adding a bug template to the Standards folder

* Added possible values for Severity and Priority based on Miguel's suggestion

* Renamed.. (change from PR suggestion)

* Feature/#409 bug template enhancement (#61)

* Changes to bug template to adjust flow (Miguel's review)

* Renamed this to Template_Bug.md

* feature/#411 Database Changes  (#64)

* Added settlementTransferParticipant.settlementWindowId column
* Added currentStatePointer table
* Added stateChangeId reference to main settlement tables
* FKs renamed to currentStateChangeId

* Feature/#411 Design Settlement Processing (#65)

* Design Notification Handler for Rejections - v1.0
* Create Notification Reject UML process. v2.0
* Update Sequence diagram as per Sam recommendations. v3.0
* Update event 5 from solid line to dotted as per Sam's recommedation. v4.0
* Update as per Miguel's request to include ref to 9.1.0 - Event Handler
* Included rejections for 'timeout' events as per request from Miguel.
* Included the rejected actions as requested and 'cosmetic' updates. v5.0
* Removed sequence diagram that is not part of this feature.
* Settlement process commit - initial v1.1
* Sequence diagrams for settlementWindow 'GET:: getSettlementWindowById' 'PUSH:: closeSettlementWindow' operations v1.0.
* Commit sequence diarams so implementations can start. v2.0
* Removed unused actors and included note to "lock" table for "read" during the status update process - v3.0.
* Update for pull request #55 - as requested by @georgi - v5.1
* Feature/#333 Design Settlements (#55)
* feature/#333DesignSettlementProcessing (#55). Update diagram names to align with Story. - v5.2
* feature/#333DesignSettlementProcess - PUT
* feature/#333DesignSettlementProcessing - GET v5.2
* feature/#333DesignSettlementProcessing  - update seq 6.2.5 v5.3
* feature/#333DesignSettlementProcessing - update seq 6.2.5 v5.4
* Update 6.2.5.
* Changes with Warren
* Adding current state variables and init
* Feature/#411DesignSettlementProcessing - synch change to new feature - v1.0
* NOT_SETTLED from account to window not possbile
* 6.2.5 for DA review
* Update opt for settlementStateChange
* Adding sample response types
* Feature/#411DesignSettlementProcessing - v1.1
* An annotation and a check
* 6.1.2. Review w/ corrections
* Add settlementTransferParticipant.settlementWindowId column
* Query settlementTransferParticipant for window
* Feature/#411DesignSettlementProcessing - updates as per Georgi.
* Review 6.1.1. w/ changes and slight modifications to 6.1.2. and 6.2.1.
* Update diagram titles
* Fixing typos in 6.2.5.
* Reset data_diagrams to previous version
* Update 6.1.1.
* Update 6.1.2.
* Update 6.1.3.
* 6.2.1. - work in progress
* Switched from currentStatePointer table to currentStateId column
* Finished 6.2.1.
* Updated 6.2.5.
* Renamed 6.2.0. to 6.2.2. and settleWindow to setwindow
* Finished 6.2.4.
* Finished 6.2.3.
* Minor addition to 6.2.3.
* Changes during DA review
* Finished 6.2.2.

* Feature/#314#320 Timeout Handler Implementation (#68)

* Minor corrections to the design
* Updated 1.3.3. timeout-reserved to notification topic

* Updated diagrams for PI3

* Feature/429-fix-bug69-docs-prepare1.1.1a (#71)

* Fixes for bug: https://github.com/mojaloop/docs/issues/69. 1. Updated typos, 2. Added Data Model for message with new action type "prepare-duplicate" 3. Elaborated steps for this scenario

* Made change to include a sample payload as per Sashi's suggestion (for transfer response on duplicate).

* Corrections during implementation of 6.2.2. (#73)

* Feature/430 align issues with names (#74)

* Fix for bug 430 - aligning names in titles, etc

* Feature/439 Fix updateSettlementById (#75)

* Allign 6.2.5. to implementation
* Added FOR UPDATE

* Feature/443 Add Hyperlinks To Seq Diagrams (#76)

* Allign 6.2.5. to implementation
* Added FOR UPDATE
* Added hyperlinks

* Sequence diagram for get positions API story #404 (#77)

* sequence diagram for get positions API

* updated the existing seq diagram and deleted the new duplicate

* Included presentation for PI3 Convening for Deployment & Setup Introduction

* Feature/461 Settlement Transfer (#81)

* Added settlement accounts and seeds
* Added settlementTransferId column
* Added DBeaver ER diagram
* Multiple accounts & signed amounts
* Settlement Transfer Prepare sequence diagram
* Settlement Transfer Commit (Draft)
* Update 6.3.1 & 6.3.2
* Added note for transverExtension
* DA Review Changes

* Removed last two slides.

* Feature/#478 removing transfer handler - updating designs (#83)

* Updating architecture diagrams to reflect the removal of Transfer Handler

* Feature/#358 support currency (#84)

* Develop (#15)

* Initial Check In

* Updates

* Draft for Performance scenarios, metrics and other analytics information gathered as part of PI-1

* Minor spelling fix

* Added hardware/config details of hosts

* A sentence was incomplete, fixed it (#14)

* updated grammar and typos

* Initial Commit for Specification documents

* Adding PKI Best Practices and JSON Binding Rules

* Adding descriptions for PKI Best Practices and JSON Binding Rules and some markdown editing

* Adding Logical Data Model and Generic Transaction Patterns

* Adding supporting files section to include the Open API (Swagger) YAML and RAML files corresponding to the specification

* Initial draft by Michael

Signed-off-by: adrianhopebailie <[email protected]>

* Fix tables

Signed-off-by: adrianhopebailie <[email protected]>

* removed outdated content

* Add files via upload

* updated readme

* Update README.md

* updated readme

* uploaded image

* uploaded images

* upload images

* Uploaded images

* Add files via upload

* Delete Mojaloop Services Overview.png

* Add files via upload

* Delete Mojaloop Services Overview.png

* Add files via upload

* Initial commit for #358

* Feature/#358SupportCurrency - clarification.

* Feature/#358SupportCurrency - Updated.

* Feature/461 Settlement Transfer - Implementation specific changes (#85)

* Added settlement accounts and seeds
* Added settlementTransferId column
* Added DBeaver ER diagram
* Multiple accounts & signed amounts
* Settlement Transfer Prepare sequence diagram
* Settlement Transfer Commit (Draft)
* Update 6.3.1 & 6.3.2
* Added note for transverExtension
* DA Review Changes
* Changes to the diagrams during the implementation
* Label change

* Realigning transfers arch (#86)

* Slightly re-aligned transfers architecture, though all the components stay the same

* Feature/#452 get transfers temporary solution phase2 (#88)

* Interim work-around solution for GET /transfers as internally discussed

* Update bug template (#89)

* Adding severity and priority values when opened to have the log in the issue itself, without having to look at history. Removing specification documents here because now they have their own repo: mojaloop-specification

* Minor formatting

* Removed a duplicate for bug template (#90)

* Removing duplicate template for bug

* Removed 2 duplicate (outdated) files and Renamed files for relevance (#91)

* Feature/#512Documentation Updates.

* Feature/#512-Documentation

* Pdf updates (#94)

* Updated build scripts and files to build pdfs without errors or warnings
Note this doesn't mean the info is correct, just that it builds correctly.

* remove DFSP repos and corresponding images

* fix developer onboarding docs build

* update pdf files after clean build

* md fixes for PDFs to match repository analysis

* Add link to v0.3 and migrate

Link to cross-network repo

* Adding draft of presentation for day-1. Note that this is not final (#109)

* uploaded Mifos Slides

* GSMA lab slides

* Mowali Slides

* Mowali Slides 1 of 2

* Fintech Paraguay

* Delete Mowali Update 270119 V 0_3.pdf

need to remove for now

* build a school

* DFS Labs Intro

* Add cross-border presentation

* Business Rules and Interoperability

* Updated version 1.2 of the presentation (#112)

* Entity Mgmt Presentation

* Build a School Presentation

* Mowali Update

* Security Presentation

* Uploading the final presentation from Mojaloop Open Source phase3-kickoff event (#113)

* Agile Training

Author: Sam

CentralLedger/README.md

@@ -7,7 +7,8 @@
 ## Transfer/Fulfillment Flow
 ![Transfer/Fulfillment sequence diagram](./central_ledger_sequence_transferfulfillment.png)
 ### Note 
-Only transfers where a Payer’s currency is the same as a Payee’s currency are operational in this release; i.e., even though multi-currency is supported, cross-currency is not supported at this time. The Cross-currency transfers use case is currently being investigated.
+
+Only transfers where a Payer's currency is the same as a Payee's currency are operational in this release; i.e., even though multi-currency is supported, cross-currency is not supported at this time. The Cross-currency transfers use case is currently being investigated.
 
 ## Settlement Flow
 ![Settlement sequence diagram](./central_ledger_sequence_settlement.png)

Diagrams/SequenceDiagrams/seq-callback-3.1.0.plantuml

@@ -27,7 +27,6 @@
 title 3.1.0 Get Participant Callback Details
 
 autonumber
-
 ' Actor Keys:
 ' boundary - APIs/Interfaces, etc
 ' collections - Kafka Topics

Diagrams/SequenceDiagrams/seq-callback-add-3.1.0.plantuml

@@ -22,12 +22,12 @@
  --------------
  ******'/
 
+
 @startuml
 ' declate title
 title 3.1.0 Add Participant Callback Details
 
 autonumber
-
 ' Actor Keys:
 ' boundary - APIs/Interfaces, etc
 ' collections - Kafka Topics

Diagrams/SequenceDiagrams/seq-fulfil-2.1.0.plantuml

@@ -27,7 +27,6 @@
 title 2.1.0. DFSP2 sends a Fulfil Success Transfer request
 
 autonumber
-
 ' Actor Keys:
 '   boundary - APIs/Interfaces, etc
 '   collections - Kafka Topics

Diagrams/SequenceDiagrams/seq-fulfil-2.1.3.plantuml

@@ -27,7 +27,6 @@
 title 2.1.3. Transfer Handler Consume (Success)
 
 autonumber
-
 ' Actor Keys:
 '   boundary - APIs/Interfaces, etc
 '   collections - Kafka Topics

Diagrams/SequenceDiagrams/seq-settransfer-6.3.2-commit.plantuml

@@ -0,0 +1,104 @@
+@startuml
+' declate title
+title 6.3.2. Settlement Transfer Commit
+autonumber
+
+' declare actors
+entity "Settlement DAO" as SETTLE_DAO
+database "Central Store" as DB
+
+box "Settlement Service" #lightgreen
+    participant SETTLE_DAO
+end box
+
+box "Central Services" #lightyellow
+    participant DB
+end box
+
+' start flow
+activate SETTLE_DAO
+group Settlement Transfer Commit
+    note right of SETTLE_DAO #lightgray
+        **Inputs**: settlementId that has just been SETTLED, transactionTimestamp, enums, trx
+    end note
+    SETTLE_DAO -> DB: Retrieve the list of RESERVED, but not COMMITTED
+    activate DB
+    hnote over DB #lightyellow
+        SELECT tp.transferId, tp.participantCurrencyId, tp.amount
+        FROM **settlementParticipantCurrency** spc
+        JOIN **transferStateChange** tsc1
+        ON tsc1.transferId = spc.settlementTransferId
+        AND tsc1.transferStateId = {RESERVED}
+        LEFT JOIN **transferStateChange** tsc2
+        ON tsc2.transferId = spc.settlementTransferId
+        AND tsc2.transferStateId = {COMMITTED}
+        JOIN **transferParticipant** tp
+        ON tp.transferId = spc.settlementTransferId
+        AND tp.participantCurrencyId = spc.participantCurrencyId
+        WHERE spc.settlementId = {settlementId}
+        AND tsc2.transferId IS NULL
+    end hnote
+    DB --> SETTLE_DAO: Return **settlementTransferList**
+    deactivate DB
+    group <color #blue>DB TRANSACTION</color>
+        loop t IN settlementTransferList
+            SETTLE_DAO -> DB: Select participantPosition FOR UPDATE
+            activate DB
+            hnote over DB #lightyellow
+                SELECT participantPositionId, value positionValue, reservedValue
+                FROM **participantPosition**
+                WHERE participantCurrencyId = t.participantCurrencyId
+                FOR UPDATE
+            end note
+            DB --> SETTLE_DAO: Return **participantPositionId**, **positionValue** and **reservedValue**
+            deactivate DB
+            SETTLE_DAO -> DB: Select participant NET_DEBIT_CAP limit
+            activate DB
+            hnote over DB #lightyellow
+                SELECT value AS netDebitCap
+                FROM **participantLimit**
+                WHERE participantCurrencyId = t.participantCurrencyId
+                AND participantLimitTypeId = {NET_DEBIT_CAP}
+            end note
+            DB --> SETTLE_DAO: Return **netDebitCap**
+            deactivate DB
+            note right of SETTLE_DAO #lightgray
+                **isLimitExceeded** = netDebitCap - positionValue - reservedValue - t.amount < 0
+                **latestPosition** = positionValue + t.amount
+            end note
+            SETTLE_DAO->DB: Persist latestPosition
+            activate DB
+            hnote over DB #lightyellow
+                UPDATE **participantPosition**
+                SET value = {latestPosition}
+                WHERE participantPositionId = participantPositionId
+
+                SELECT LAST_INSERT_ID() AS participantPositionId
+            end note
+            DB-->SETTLE_DAO: Return **participantPositionId**
+            deactivate DB
+            opt isLimitExceeded == true
+                SETTLE_DAO->SETTLE_DAO: Increase NET_DEBIT_CAP with the value of t.amount\n<color #red>TODO:</color> Notify DFSP for NDC change
+            end
+            deactivate DB
+            SETTLE_DAO -> DB: Persist transfer state and participant position change
+            hnote over DB #lightyellow
+                INSERT INTO **transferFulfilment** (transferId, ilpFulfilment, completedDate, 
+                       isValid, settlementWindowId, createdDate)
+                VALUES (t.transferId, 0, tTimestamp, 1, NULL, tTimestamp)
+
+                INSERT INTO **transferStateChange** (transferId, transferStateId, reason)
+                VALUES (t.transferId, {COMMITTED}, 'Settlement transfer commit')
+
+                INSERT INTO **participantPositionChange**
+                       (participantPositionId, transferStateChangeId, value)
+                VALUES ({participantPositionId}, {transferStateChangeId}, {latestPosition})
+            end note
+            activate DB
+            deactivate DB
+        end
+    end
+end
+deactivate SETTLE_DAO
+
+@enduml

Diagrams/SequenceDiagrams/seq-settransfer-6.3.2-commit.svg

@@ -2,22 +2,23 @@
 mkdir -p ./images
 cp docs/Wiki/*.png ./images
 cp docs/Wiki/*.PNG ./images
-cp docs/DFSP/*.png ./images
-cp docs/DFSP/*.png ./images
+#cp docs/DFSP/*.png ./images
+#cp docs/DFSP/*.png ./images
 cp docs/DFSP/PendingTransactions/*.png ./images
 cp docs/DFSP/BulkPayment/src/*.png ./images
-cp docs/DFSP/USSD/*.PNG ./images
-cp docs/DFSP/USSD/*.png ./images
-cp docs/DFSP/USSD/*.JPG ./images
+#cp docs/DFSP/USSD/*.PNG ./images
+#cp docs/DFSP/USSD/*.png ./images
+#cp docs/DFSP/USSD/*.JPG ./images
 cp "docs/DFSP/Pending Transactions Api/diagrams"/*.png ./images
-cp docs/DFSP/ManageAcccoutHolders/*.jpg ./images
-cp "docs/DFSP/GSMA MM & L1P DFSP API"/*.jpg ./images
+#cp docs/DFSP/ManageAcccoutHolders/*.jpg ./images
+#cp "docs/DFSP/GSMA MM & L1P DFSP API"/*.jpg ./images
 cp docs/CentralDirectory/*.png ./images
 cp docs/CentralLedger/*.png ./images
+cp central-ledger/images/*.png ./images 
 cp docs/CentralRules/*.png ./images
 cp "docs/Interop Services and Mule"/*.png ./images
 cp "docs/Interop Services and Mule"/*.jpg ./images
 cp docs/test/ilp-integration/media/*.jpg ./images
 cp docs/ILP/*.png ./images
 cp docs/ILP/*.gif ./images
-cp docs/ELK/images/*png ./images
+cp docs/ELK/images/*.png ./images

ExportDocs/CopyImages.sh

@@ -35,7 +35,7 @@ targets:
             https://github.com/mojaloop/docs/blob/master/Wiki/PuttyConnection.png: images/PuttyConnection.png
             https://github.com/mojaloop/docs/blob/master/Wiki/PuttyConfig.png: images/PuttyConfig.png
             https://github.com/mojaloop/docs/blob/master/Wiki/Tracking%20requirements%20to%20results.png: images/Tracking%20requirements%20to%20results.png
-            https://github.com/mojaloop/docs/blob/master/Wiki/Glory%20of%20Rest.png: images/Glory%20of%20Rest.png
+            https://github.com/Mojaloop/docs/blob/master/Wiki/Glory%20of%20Rest.png: images/Glory%20of%20Rest.png
             https://github.com/mojaloop/docs/blob/master/Wiki/mergebtn.png: images/mergebtn.png
             https://github.com/mojaloop/docs/blob/master/Wiki/CreateBranch.png: images/CreateBranch.png
             https://github.com/mojaloop/docs/blob/master/Wiki/CompareNPull.png: images/CompareNPull.png
@@ -71,13 +71,6 @@ pages:
         targets:
             - all
 
-    -   name: 'Onboarding Developers'
-        md: mojaloop/contribute/Onboarding-Developers.md
-        html: Onboarding-Developers.html
-        category: Onboarding
-        targets:
-            - all
-
 # documentation
     -   name: 'Structure of the Documentation'
         html: Structure-of-the-Documentation.html
@@ -115,15 +108,6 @@ pages:
         targets:
             - all
 
-# USSD
-    -   name: 'USSD Simulator User Guide'
-        html: USSD.html
-        category: Testing
-        md: docs/DFSP/USSD/README.md
-        section_header: true
-        targets:
-            - all
-
 # local test environment
     -   name: 'Creating a local test environment'
         html: devops.html
@@ -296,8 +280,15 @@ pages:
         targets:
             - all
 
+    -   name: 'Design Decisions'
+        html: Design-Decisions.html
+        category: Appendix
+        md: mojaloop/contribute/Decision-Items.md
+        targets:
+            - all
+
     -   name: 'Tools and Process Decisions'
-        html: Decisions.html
+        html: Tools-Decisions.html
         category: Appendix
         md: docs/decisions.md
         targets:
@@ -310,6 +301,13 @@ pages:
         targets:
             - all
 
+    -   name: 'User Story Workflow'
+        html: user-story-workflow.html
+        category: Appendix
+        md: mojaloop/contribute/Pipeline.md
+        targets:
+            - all
+
     -   name: 'Roadmap'
         html: Roadmap.html
         category: Appendix

ExportDocs/dactyl-config-onboarding.yml

@@ -30,6 +30,7 @@ targets:
         image_subs:
             ./interconnectivity-animation.gif: images/interconnectivity-animation.gif
             https://github.com/mojaloop/docs/blob/master/Wiki/Basic%20Overview.png: images/Basic%20Overview.png
+            https://github.com/mojaloop/docs/blob/master/Wiki/Mojaloop%20Services%20Overview.png: images/Mojaloop%20Services%20Overview.png
         image_re_subs:
             "[./\\w]*/([\\w%.-]+[.](jpg|JPG|png|PNG))": "images/\\1"
         link_subs:
@@ -57,6 +58,7 @@ targets:
        image_subs:
             ./interconnectivity-animation.gif: images/interconnectivity-animation.gif
             https://github.com/mojaloop/Docs/blob/master/Wiki/Basic%20Overview.png": images/Basic%20Overview.png
+            https://github.com/mojaloop/docs/blob/master/Wiki/Mojaloop%20Services%20Overview.png: images/Mojaloop%20Services%20Overview.png
        image_re_subs:
             "[./\\w]*/([\\w%.-]+[.](jpg|JPG|png|PNG))": "images/\\1"
        link_subs:
@@ -268,6 +270,12 @@ pages:
         targets:
             - all
 
+    -   name: 'Running Central Ledger on Kubernetes'
+        html: central_ledger_On_Kubernetes.html
+        category: 'Central Ledger'
+        md: central-ledger/KUBERNETES.md
+        targets:
+            - all
 
 #docs/CentralRules
 # README.md central_rules_endpoints.md
@@ -416,92 +424,6 @@ pages:
             - all
             - stakeholder
 
-#/docs/DFSP
-    -   name: 'DFSP'
-        html: DFSP.html
-        section_header: true
-        category: DFSP
-        md: docs/DFSP/README.md
-        targets:
-            - all
-            - stakeholder
-
-    -   name: 'Quotes'
-        html: dfspquotes.html
-        md: docs/DFSP/README.md
-        targets:
-            - all
-
-    -   name: 'Directory'
-        html: directory.html
-        category: DFSP
-        md: docs/DFSP/directory.md
-        targets:
-            - all
-
-    -   name: 'Identity'
-        html: identity.html
-        category: DFSP
-        md: docs/DFSP/identity.md
-        targets:
-            - all
-
-    -   name: 'Notifications'
-        html: notification.html
-        category: DFSP
-        md: docs/DFSP/notification.md
-        targets:
-            - all
-
-    -   name: 'Rules'
-        html: rule.html
-        category: DFSP
-        md: docs/DFSP/rule.md
-        targets:
-            - all
-
-    -   name: 'Subscriptions'
-        html: subscription.html
-        category: DFSP
-        md: docs/DFSP/subscription.md
-        targets:
-            - all
-
-    -   name: 'Transfer'
-        html: transfer.html
-        category: DFSP
-        md: docs/DFSP/transfer.md
-        targets:
-            - all
-
-    -   name: 'Account'
-        html: account.html
-        category: DFSP
-        md: docs/DFSP/account.md
-        targets:
-            - all
-
-    -   name: 'Manage Account Holders'
-        html: ManageAccoutHolders.html
-        category: DFSP
-        md: docs/DFSP/ManageAcccoutHolders/ReadMe.md
-        targets:
-            - all
-
-# -   name: 'Setting up the Development Environment'
-#     html: development.html
-#     category: DFSP
-#     md: docs/DFSP/development.md
-#     targets:
-#         - all
-
-    -   name: 'USSD'
-        html: USSD.html
-        category: DFSP
-        md: docs/DFSP/USSD/README.md
-        targets:
-            - all
-
 # --- security/threat modeling
     -   name: 'PKI Guide'
         html: pki.html