This library :
- works with 2-columns accounts.
- provides 3 accounting plans issued from the french Plan Comptable Général ( abrege/short , basique/medium , complet/long )
- supports multiples "entities"
- stores data in localstorage
- copes with multiple entities in the same instance
- provides a GIT-like acces to each entity ( commit, log, diff, ... )
- provides some optionnal Model and Views for BackBone.JS
- load or create a company : my_company = $fi.societe( 'name of the company' )
- read the history of a company : some_var = my_company.history();
- read the full log of a company : some_var = my_company.log();
- go 5 versions back in the past : some_var = my_company.back( 5 );
- compute the diff between to revision ( 5th ago and 7th ago ) : some_vars my_company.back( 5 ).diff( my_company.back( 7 ) );
- commit an ecriture : my_company.commit( ecriture );
- combine 2 ecritures in only one : ecriture_3 = ecriture_1.o( ecriture_2 );
- create an ecriture at a moment from an operation : ecriture = some_operation( 'an explanation message', 'a date', arg_1, arg_2, ... arg_i, ... arg_n )
- create an operation from 2 partial mouvements with 1 argmument : operation_1 = $fi.Operation( $fi.want( mouvement_1 ), mouvement_2 );
- create an operation from 5 partial mouvements with 2 argmument : operation_2 = $fi.Operation( $fi.want( mouvement_1 ), mouvement_2, $fi.want( mouvement_3 ), mouvement_4, mouvement_5 );
- create a partial mouvement in debit column with an operateur : mouvement_1 = $fi.op( 'operateur name' )( 'acount number ' ,1,0, 'explanation text ' );
- create a partial mouvement in credit column with an operateur : mouvement_2 = $fi.op( 'operateur name' )( 'acount number ' ,0,1, 'explanation text ' );
- create an operateur : $fi.create_operateur( 'operateur name', js_function )
An Ecriture is the description of a table like
| Account number | debit | credit |
|---|---|---|
| 607 | 1000.00 | |
| 44566 | 100.00 | |
| 401 | 1100.00 |
as you can see you have a amount of 1000 you write it as-is, then you take this amount and you compute the VAT amount and write it and then you use the current debit amount directly as-is.
if you buy 1000 products, you need in your accounting to track 1000 Ecriture like this example but with 1000 different amount.
Lazily, you may wish to define something like a "macro" or a "function" you can use to compute directly the Ecriture for a given amount
| 607 | X | |
| 44566 | 10% of X | |
| 401 | X+ 10% |
In the Lazyliest way, you may dream of some thing like :
| 607 | X | |
| 44566 | Y% of X | |
| 401 | X+ Y% |
Now, you can define :
- this table is an Operation for a given X and Y ; so, you "$fi.want" X and Y
- a line is a Mouvement on an account like apply some transformation on something and write it.
- the applied transformation is the Operateur
| 607 | want() a value then write it | |
| 44566 | want() a value then use it as the a computed rate from the last then write it | |
| 401 | use the last state and write it |
An Operateur is a computed property issued from a flow of information. This flow is provided later by the argument list when you create an real ecriture by applying an Operation on some arguments.
The test.html file contains the definition 4 different Operateurs.
this Operateur is used for "use directly the current value in the flow".
create_operateur( 'constant', function(t){return function(x){return[ this.f_debitt, this.f_creditt ]}} )
this Operateur is used for "don't bother about the flow and just use directly this constant".
create_operateur( 'taux', function(t){ t=t/100; return function(x){ return[ this.f_debittx, this.f_credittx ]} } )
this Operateur is used for "apply some rate (taux in french) on the flow"
create_operateur( 'itaux', function(t){ t=1-1/(1+t/100);; return function(x){return[ this.f_debittx, this.f_credittx ]} } )
this Operateur is used for "apply apply some inverse rate on the flow"
a Mouvement is the application of an Operator on the flow to produce an action in debit or credit on an account.
With the 4 previous Operateurs, we can write :
- I need to add a debit on the account '607' and this debit is my current flow : $fi.op('param' )( '607',1,0, 'some debit on the 607 account' );
an Operation is the aggregation of different Mouvement with the definition of the wanted arguments for this Operation.
- PGC : http://www.anc.gouv.fr/sections/normes_privees/plans_comptables/plan_comptable/downloadFile/file/pcg_maj0712.pdf
- Bilan : http://www.insee.fr/fr/ppp/bases-de-donnees/irweb/images05/dd/doc/pdf/images05_bilan.pdf
- Compte de résultat : http://www.insee.fr/fr/ppp/bases-de-donnees/irweb/images05/dd/doc/pdf/images05_cptr.pdf