{-# LANGUAGE DataKinds #-} {-# LANGUAGE DeriveGeneric #-} {-# LANGUAGE KindSignatures #-} -- | This module provides data definitions and functions to work with journal -- entries. module Haspara.Accounting.Journal where import qualified Data.Aeson as Aeson import qualified Data.Text as T import Data.Time (Day) import GHC.Generics (Generic) import GHC.TypeLits (KnownNat, Nat) import Haspara.Accounting.Account (Account (accountKind)) import Haspara.Accounting.Amount (Amount (..), amountFromValue) import Haspara.Accounting.Side (Side (..)) import Haspara.Internal.Aeson (commonAesonOptions) import Haspara.Quantity (Quantity, UnsignedQuantity, sumUnsignedQuantity) -- | Data definition for the journal entries of interest (like a general -- ledger.) -- -- A 'Journal' is a list of 'JournalEntry' records which are polymorphic over -- the precision of the monetary quantities, the account and event objects. newtype Journal (precision :: Nat) account event = Journal { journalEntries :: [JournalEntry precision account event] } deriving (Generic, Show) instance (KnownNat precision, Aeson.FromJSON account, Aeson.FromJSON event) => Aeson.FromJSON (Journal precision account event) where parseJSON = Aeson.genericParseJSON $ commonAesonOptions "journal" instance (KnownNat precision, Aeson.ToJSON account, Aeson.ToJSON event) => Aeson.ToJSON (Journal precision account event) where toJSON = Aeson.genericToJSON $ commonAesonOptions "journal" toEncoding = Aeson.genericToEncoding $ commonAesonOptions "journal" -- | Data definition for a journal entry. -- -- A journal entry has a (unique) identifier, date and description, and a list -- of 'JournalEntryItem's. Journal entry definition is polymorphic over the -- precision of the monetary quantities, the account and event objects. data JournalEntry (precision :: Nat) account event = JournalEntry { journalEntryId :: !T.Text , journalEntryDate :: !Day , journalEntryItems :: ![JournalEntryItem precision account event] , journalEntryDescription :: !T.Text } deriving (Generic, Show) instance (KnownNat precision, Aeson.FromJSON account, Aeson.FromJSON event) => Aeson.FromJSON (JournalEntry precision account event) where parseJSON = Aeson.genericParseJSON $ commonAesonOptions "journalEntry" instance (KnownNat precision, Aeson.ToJSON account, Aeson.ToJSON event) => Aeson.ToJSON (JournalEntry precision account event) where toJSON = Aeson.genericToJSON $ commonAesonOptions "journalEntry" toEncoding = Aeson.genericToEncoding $ commonAesonOptions "journalEntry" -- | Returns the total debit amount of a journal entry. journalEntryTotalDebit :: KnownNat precision => JournalEntry precision account event -> UnsignedQuantity precision journalEntryTotalDebit = sumUnsignedQuantity . fmap (amountValue . journalEntryItemAmount) . filter ((==) SideDebit . amountSide . journalEntryItemAmount) . journalEntryItems -- | Returns the total credit amount of a journal entry. journalEntryTotalCredit :: KnownNat precision => JournalEntry precision account event -> UnsignedQuantity precision journalEntryTotalCredit = sumUnsignedQuantity . fmap (amountValue . journalEntryItemAmount) . filter ((==) SideCredit . amountSide . journalEntryItemAmount) . journalEntryItems -- | Predicate to check if a journal entry is balanced or not. -- -- The logical check is indeed whether the total debit amount is equal to the -- total credit amount or not. isJournalEntryBalanced :: KnownNat precision => JournalEntry precision account event -> Bool isJournalEntryBalanced = (==) <$> journalEntryTotalDebit <*> journalEntryTotalCredit -- | Data definition for a journal entry item. -- -- A journal entry item has a 'Side', an unsigned quantity as amount, an account -- that it belongs to and the event the item is originating from. Journal entry -- item definition is polymorphic over the precision of the monetary quantities, -- the account and event objects. data JournalEntryItem (precision :: Nat) account event = JournalEntryItem { journalEntryItemAmount :: !(Amount precision) , journalEntryItemAccount :: !(Account account) , journalEntryItemEvent :: !event , journalEntryItemInventoryEvent :: !(Maybe (JournalEntryItemInventoryEvent account event)) } deriving (Eq, Generic, Show) instance (KnownNat precision, Aeson.FromJSON account, Aeson.FromJSON event) => Aeson.FromJSON (JournalEntryItem precision account event) where parseJSON = Aeson.genericParseJSON $ commonAesonOptions "journalEntryItem" instance (KnownNat precision, Aeson.ToJSON account, Aeson.ToJSON event) => Aeson.ToJSON (JournalEntryItem precision account event) where toJSON = Aeson.genericToJSON $ commonAesonOptions "journalEntryItem" toEncoding = Aeson.genericToEncoding $ commonAesonOptions "journalEntryItem" -- | Data definition for inventory event. data JournalEntryItemInventoryEvent account event = JournalEntryItemInventoryEvent { journalEntryItemInventoryEventPnlAccount :: !(Account account) , journalEntryItemInventoryEventEvent :: !event , journalEntryItemInventoryEventQuantity :: !(Quantity 12) } deriving (Eq, Generic, Show) instance (Aeson.FromJSON account, Aeson.FromJSON event) => Aeson.FromJSON (JournalEntryItemInventoryEvent account event) where parseJSON = Aeson.genericParseJSON $ commonAesonOptions "journalEntryItemInventoryEvent" instance (Aeson.ToJSON account, Aeson.ToJSON event) => Aeson.ToJSON (JournalEntryItemInventoryEvent account event) where toJSON = Aeson.genericToJSON $ commonAesonOptions "journalEntryItemInventoryEvent" toEncoding = Aeson.genericToEncoding $ commonAesonOptions "journalEntryItemInventoryEvent" -- | Creates a 'JournalEntryItem' from the given signed /value/, the account it -- belongs to and the event it is originating from. -- -- The /value/ is defined as in 'amountFromValue' function. mkJournalEntryItemFromValue :: KnownNat precision => Quantity precision -> Account account -> event -> JournalEntryItem precision account event mkJournalEntryItemFromValue val acc evt = JournalEntryItem { journalEntryItemAmount = amountFromValue (accountKind acc) val , journalEntryItemAccount = acc , journalEntryItemEvent = evt , journalEntryItemInventoryEvent = Nothing } -- | Creates a 'JournalEntryItem' with inventory event informationfrom the given -- signed /value/, the account it belongs to and the event it is originating -- from. -- -- The /value/ is defined as in 'amountFromValue' function. mkInventoryJournalEntryItemFromValue :: KnownNat precision => Quantity precision -> Account account -> event -> Account account -> event -> Quantity 12 -> JournalEntryItem precision account event mkInventoryJournalEntryItemFromValue val acc evt pnlacc pnlevt evtqty = JournalEntryItem { journalEntryItemAmount = amountFromValue (accountKind acc) val , journalEntryItemAccount = acc , journalEntryItemEvent = evt , journalEntryItemInventoryEvent = Just $ JournalEntryItemInventoryEvent { journalEntryItemInventoryEventPnlAccount = pnlacc , journalEntryItemInventoryEventQuantity = evtqty , journalEntryItemInventoryEventEvent = pnlevt } }