backbone-accounting 0.18.2

GL, journals, ledger, reconciliation (extracted from bersihir)
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103

# GL-Posting Workflow V2.0
# The transactional double-entry saga executed by PostingService
# (src/application/service/posting_service.rs), proven by tests/posting_golden_cases.rs.
# All write steps run in ONE DB transaction; any failure rolls the whole thing back.

name: GLPosting
description: |
  Record a balanced AccountingPost into the General Ledger:
  - idempotency check on (company_id, source_type, source_id, posting_type)
  - validate R1..R5 (balanced, >=2 lines, postable account, party-for-AR/AP, open period)
  - atomically write Journal + JournalLines + immutable Ledger rows (running balance)
  - update account balances, mark the AccountingPost posted, emit AccountingPostPosted

version: 2

trigger:
  event: AccountingPostRequestedEvent
  extract:
    company_id: "event.company_id"
    source_type: "event.source_type"
    source_id: "event.source_id"
    posting_type: "event.posting_type"

config:
  timeout: 30s
  persistence: false

context:
  journal: null
  total_debit: 0
  total_credit: 0

steps:
  - name: idempotency_check
    type: action
    action: query
    entity: AccountingPost
    params:
      company_id: "{{ context.company_id }}"
      source_type: "{{ context.source_type }}"
      source_id: "{{ context.source_id }}"
      posting_type: "{{ context.posting_type }}"
    on_success:
      next: validate
    on_failure:
      next: validate

  - name: validate
    type: action
    action: validate
    entity: AccountingPost
    on_success:
      next: write_journal
    on_failure:
      next: rejected

  - name: write_journal
    type: action
    action: create
    entity: Journal
    on_success:
      set:
        journal: "{{ result }}"
      next: write_journal_lines

  - name: write_journal_lines
    type: action
    action: create
    entity: JournalLine
    on_success:
      next: write_ledger

  - name: write_ledger
    type: action
    action: create
    entity: Ledger
    on_success:
      next: update_account_balances

  - name: update_account_balances
    type: action
    action: update
    entity: Account
    on_success:
      next: mark_posted

  - name: mark_posted
    type: action
    action: update
    entity: AccountingPost
    on_success:
      next: posted

  # Terminals
  - name: posted
    type: terminal
    status: completed
    reason: "AccountingPostPosted — Journal + Ledger written, entry balanced"

  - name: rejected
    type: terminal
    status: failed
    reason: "AccountingPostFailed — validation rejected (unbalanced / party / period / non-postable)"