RTBKIT::BankerPersistence Struct Reference

#include <master_banker.h>

Inheritance diagram for RTBKIT::BankerPersistence:

List of all members.

Public Types
enum	PersistenceCallbackStatus { SUCCESS, BACKEND_ERROR, DATA_INCONSISTENCY }
typedef std::function< void(std::shared_ptr < Accounts > , PersistenceCallbackStatus, const std::string &info)>	OnLoadedCallback
typedef std::function< void(PersistenceCallbackStatus, const std::string &info)>	OnSavedCallback
Public Member Functions
virtual void	loadAll (const std::string &topLevelKey, OnLoadedCallback onLoaded)=0
virtual void	saveAll (const Accounts &toSave, OnSavedCallback onDone)=0

---

Detailed Description

For want of a better name... Router accounts have a float that they try to maintain; this is topped up either by recycling from post auction loops or increasing the budgets.

Router

• Commitment Account (committments made and retired)
  • Budget (read-only)
  • Recycled In (read-only)
  • Commitments Made
  • Commitments Retired
  • Available = Budget + Recycled In - Recycled Out + Commitments Retired - Commitments Made
  • No authorization if Available < 0
• Authorize
  • Commitments Made += Authorized Amount
• Cancel
  • Commitments Retired += Authorized Amount
• Detach
  • nothing

Post Auction Loop

• Spend Tracking Account
  • Budget = 0
  • Commitments Retired
  • Spent (and Line Items)
  • Commitments Made = 0
  • Not Spent = Commitments Retired - Spent
  • Recyclable = Commitments Retired - Spent - Commitments Made = Not Spent - Commitments Made
• Commit
  • Spent += Paid Amount
  • Commitments Retired += Authorized Amount
• Cancel = Commit with Paid Amount = 0
• Force = Commit with Authorized Amount = 0

Budget Controller

• Budget Account
  • Budget
  • Recycled Out

• SetBudget (top level)
  • Budget = New Budget
• AddBudget (top level)
  • Budget += Increment
• SetBudget (lower level)
  • Increment = New Budget - Budget
  • Parent: Authorize Increment

• Sum (child budgets) = Commitments Made
• Commitments Made - Commitments Retired <= Budget

Banker

• Read-only access to the whole lot
  • Budget
  • Recycled
  • Commitments Made
  • Commitments Retired
  • Spent (and Line Items) (totalled over sub-campaigns)
  • In Flight = Commitments Made - Commitments Retired
  • Condition: Budget + Recycled - In Flight = Spent (?)

Principles:

• Every transaction must add the amount into two columns ---

Start PNT: Bud = $100, CM = $10, CR = $0, RO = $0, Avl = $89 RTR: Bud = $10, RI = $0, CM = $0, CR = $0, Sp = $0, Avl = $10 PAL: CR = $0, Sp = $0

Authorize $2 PNT: Bud = $100, CM = $10, CR = $0, RO = $0, Avl = $89 RTR: Bud = $10, RI = $0, CM = $2, CR = $0, Sp = $0, Avl = $8 PAL: CR = $0, Sp = $0

Win $1 PNT: Bud = $100, CM = $10, CR = $0, RO = $0, Avl = $89 RTR: Bud = $10, RI = $0, CM = $2, CR = $0, Sp = $0, Avl = $8 PAL: CR = $2, Sp = $1

SetAvail $10 $1 PNT: Bud = $100, CM = $11, CR = $0, RO = $1, Avl = $89 RTR: Bud = $11, RI = $1, CM = $2, CR = $0, Sp = $0, Avl = $10 PAL: CR = $2, Sp = $1

Recycled = $

Definition at line 145 of file master_banker.h.

---

The documentation for this struct was generated from the following file:

• core/banker/master_banker.h