Mortezakoohjani 12c8615615 Ship enterprise Accounting FE/API with CRUD parity and production wiring.

Adds accounting-service PATCH/archive, fiscal helpers, COA templates and setup status, plus SuperApp Accounting UI (DS, scoreboard, masters, vouchers, ledger, ops modules) with session refresh and HTTPS public API URLs.

Co-authored-by: Cursor <cursoragent@cursor.com>

2026-07-24 15:26:43 +03:30

1.7 KiB

Raw Blame History

Frontend Architecture — Accounting

Placement

Accounting UI is a module route under the SuperApp:

Routes: frontend/app/accounting/**
Shell: frontend/components/accounting/AccountingShell.tsx
API client: frontend/lib/accounting-api.ts → NEXT_PUBLIC_ACCOUNTING_API_URL (default :8002)
Design system: frontend/components/ds/*

It is not a separate Next.js app.

Auth & Tenant

AuthGuard requires a valid platform JWT.
useMe / useTenantId resolve current_tenant_id.
Every accounting request sets Authorization: Bearer … and X-Tenant-ID.
Onboarding-required users are redirected to /onboarding.

Layers

app/accounting/*          → pages (server/client routes)
components/accounting/*   → module shell
components/ds/*           → shared design system
lib/accounting-api.ts     → typed HTTP client (no mocks)
hooks/useTenantId.ts      → tenant context
providers/AppProviders    → TanStack Query + toasts
providers/ColorModeProvider → light/dark class on <html>

Backend Contract

Area	Prefix
Foundation	`/api/v1/accounts`, `/api/v1/fiscal`
Posting	`/api/v1/posting`
Ledger	`/api/v1/ledger`
Treasury	`/api/v1/treasury`
AR/AP	`/api/v1/ar-ap`
Assets	`/api/v1/assets`
Payroll	`/api/v1/payroll`
Reporting	`/api/v1/reporting`
Compliance	`/api/v1/compliance`

If a screen needs an endpoint that does not exist: stop, extend backend, then continue UI.

ADR alignment

ADR-010: UI never invents journal entries; only voucher validate/post/reverse/cancel.
Multi-tenant isolation via header, never client-side filtering alone.

1.7 KiB Raw Blame History