Quick Overview of Finmars Platform

What is Finmars

• Wealth Aggregation Platform: aggregate financial information from different sources (incl. manual input).
• Report Engine: online reports, performance, dashboards, PDF reports etc.
• Extensible Multipurpose Accounting Tool: different modules and packages are distributed through its own marketplace.
  

What is in Finmars Environment

Environment/Contour

• Characterized by URL address: https://stage.finmars.com/realm03va3/space0cjnu
• As in its name - it's execution environment for different instances of Finmars
• It has common Authorization Service

  

• It has common Profile page per user - a place to manage Realms & Workspaces

  

• It can be interpret as a container for Realms

Realm

• Characterized by Realm Code: https://stage.finmars.com/realm03va3/space0cjnu
• There may be more than one Realm inside the environment/contour
• User must have an access to the Realm to see it in the Profile page
• One Realm has shared execution resources across Finmars instances inside of it:
  • backend workers to do import and build reports
  • workflow workers to execute modules' scripts
• One Realm always has one version of Finmars instances across all Workspaces
• Realm is another abstraction container for Workspaces - Finmars instances

Workspace

• Characterized by Space Code: https://stage.finmars.com/realm03va3/space0cjnu
• There may be more than one Workspace inside the Realm
• User must have an access to the Workspace to see it in the Profile page inside the Realm
• Workspace is the Main working unit for users which consists of:
  • Dashboards: custom layouts with different components based on the aggregated financial information
  • Reports: Balance, P&L (Profit and Losses), Transaction, Performance - standard reports available in the platform which are built with the aggregated financial information
  • Data: Instruments, Registers, Portfolios, Accounts, Strategies, Responsibles, Currencies, (Events, Stats and Calendar are deprecated), - relation entities which are connected together in Transactions (will be covered in a separate document in details)
  • Transactions: Transactions (Complex Transactions), Base Transactions, Register Records, - let's give a little more details here because it has essential basic concepts (as well will be covered in a separate document in details):
    • Transactions (Complex) - are the main information about operations related to the accounted assets. It has configuration-based types which is a composition of base class transactions
      • Check the video with simplified explanation based on the diagram below: 2024.11.06 Complex Transaction structure.mp4

      • 

    • Base Transactions - are decomposition of the complex transaction into the basic actions.
      • The most vivid example would be Transaction Type (asset's complex action) "Position Initial Instrument".
      • In its nature "Position Initial Instrument" is just initial placement of the instrument to the position account - an account where the instrument is held. 
      • So in its nature there is only one event: placement of the instrument - which should result in increase of the instrument's position (quantity). 
      • In Finmars we are tracking not only the balance (quantity & valuation) but the P&L (profit and losses) as well, and for these we need to go a little bit further and decompose an event into base actions.
      • In Finmars for "Position Initial Instrument" we have 2 different base transactions: 
        
        • The first Base Transaction - Cash Injection (it's like a simple cash inflow but without impact on performance) on the virtual provisional cash account:
          • we use virtual provisional cash account because there were no actual turnover of cash
          • we need cash to Buy the instrument (again virtually) to track its P&L 
          • without initial cash we will have a negative amount of cash (in case we want to track P&L and Buy the instrument for non-zero cash amount)
        • The second Base Transaction - Buy the instrument on a position account with money from virtual provisional cash account:
          • Now we have set the amount of the instrument on a position account 
          • While there should be NO cash left on the virtual provisional cash account (because it's virtual cash movement)
      • Register Records - is the records created based on Base Transactions of base classes Cash-Inflow and Cash-Outflow and based on Registers of Portfolios (let's leave the details and explanations out of scope for now)
  • Valuations: Prices and FX Rates, - everything that helps to evaluate the instruments on specific dates. 
  • Import: section to manually import Data Entities and Complex Transactions
  • Reconciliation: an engine to make cross-check between transaction-based accounting and positions (in sense of assets' state snapshot: quantity and valuation)
  • Add-ons: additional functionality that comes from the Finmars platform's marketplace
  • Explorer: an interface to the workspace's internal storage, includes report files, configurations imported and exported and any other custom data (data of transactions and entities is stored in a different storage)
  • Configuration: consists of additional entities and settings that regulate the correct work of the Workspace (will be covered in a separate document in details)
  • Administration: section dedicated to maintainers of the Workspace (will be covered in a separate document in details)