How firsttris/haben works
Haben is a self-hosted German bookkeeping and tax web application. The principal workflow runs from recording invoices and receipts, through payment matching and bookkeeping, to tax calculations, review, and submission to ELSTER. The graph preserves major documented capabilities—bank imports, payroll, assets, annual accounts, reporting, and migration—alongside the app’s API, persistence, and accounting foundations. Some links are documented in the README; source-level evidence is limited to the sampled excerpts and SOURCE INDEX, so unsampled subsystem connections are not asserted.
Main entry points: index.tsx Haben web app · ledger.ts Bookkeeping ledger · belege Receipts and documents · invoices.ts Invoices and quotes
Components 22
Books and business records
- Invoices and quotes
apps/web/src/server/functions/invoices.ts - Receipts and documents
apps/web/src/server/modules/belege - Bank reconciliation
apps/web/src/server/functions/bank.ts - Bookkeeping ledger
apps/web/src/server/functions/ledger.ts - Payroll
apps/web/src/server/functions/lohn.ts - Assets and depreciation
apps/web/src/server/functions/assets.ts - Archive and migration
apps/web/src/server/modules/archiv
Tax and reporting
- Annual accounts
apps/web/src/server/functions/annual.ts - VAT returns
apps/web/src/server/functions/vat.ts - Reports and exports
apps/web/src/server/functions/reports.ts
Application platform
- Haben web app
apps/web/src/routes/_app/index.tsx - PostgreSQL database
apps/web/src/server/db/schema.ts - Document file store
apps/web/src/server/storage.ts - Application API
apps/web/src/server/modules/api/routes.ts - Cross-area search
apps/web/src/server/functions/search-query.ts - Company access portal
apps/firmenportal/src/server.ts
External integrations
- ELSTER submissions
packages/elster/src/xml.ts - E-invoice rendering
packages/einvoice/src/typst-compiler.ts - Bank import services
packages/import/src/enablebanking/client.ts
Accounting foundations
- Accounting calculations
packages/core/src - Employee and payroll calculations
packages/core/src/lohnabrechnung/index.ts
Other components
- Business owner
Connections 24
- Business owner → Haben web app: records business activity
- Haben web app → Invoices and quotes: creates invoices
- Haben web app → Receipts and documents: records receipts
- Haben web app → Bank reconciliation: matches payments
- Invoices and quotes → Bookkeeping ledger: posts transactions
- Receipts and documents → Bookkeeping ledger: supports bookkeeping
- Bank import services → Bank reconciliation: imports transactions
- Haben web app → Payroll: manages payroll
- Haben web app → Assets and depreciation: tracks assets
- Bookkeeping ledger → VAT returns: supplies tax figures
- VAT returns → ELSTER submissions: submits returns
- Bookkeeping ledger → Annual accounts: supports annual accounts
- Bookkeeping ledger → Reports and exports: produces reports
- Archive and migration → Bookkeeping ledger: imports accounting data
- Invoices and quotes → E-invoice rendering: renders e-invoices
- Haben web app → Application API: exposes operations
- Application API → Receipts and documents: routes document requests
apps/web/src/server/modules/api/routes.ts - Haben web app → Cross-area search: searches business records
apps/web/src/server/functions/search-query.ts - Cross-area search → Archive and migration: queries archive
apps/web/src/server/functions/search-query.ts - Receipts and documents → Document file store: stores files
apps/web/src/server/storage.ts - Haben web app → PostgreSQL database: persists records
- Payroll → Employee and payroll calculations: calculates payroll
- Business owner → Company access portal: selects company access
- Company access portal → Haben web app: opens company workspace