Files

Yaojia Wang 041e54196a chore: rewrite project Claude config for FiscalFlow

- Rewrite .claude/CLAUDE.md with project-specific context: tech stack
  (.NET 10, React 18), solution structure, build commands, architecture
  decisions (DDD, CQRS, Provider pattern), domain concepts
- Rewrite AGENTS.md with layer-specific agent routing mapped to
  FiscalFlow architecture layers
- Remove invoice-master-poc-v2 reference from settings.json
- Clean settings.local.json: remove 100+ irrelevant entries from
  another project and hardcoded database password
- Remove everything-claude-code framework files (commands, hooks,
  skills) now managed at user level

2026-02-12 23:25:50 +01:00

2.4 KiB

Raw Blame History

FiscalFlow - Multi-Accounting System Invoice Processing Platform

Invoice OCR platform integrating with accounting systems (Fortnox, Visma, Hogia). Scans invoices, matches suppliers, generates vouchers, and imports into connected accounting software.

Tech Stack

Backend: .NET 10 (C# 14), ASP.NET Core Web API, EF Core, PostgreSQL, Redis
Frontend: React 18 + TypeScript + Vite + TailwindCSS + Zustand
Patterns: DDD Lite, CQRS (MediatR), Repository + Unit of Work, Domain Events
Libraries: FluentValidation, AutoMapper, Serilog, Polly, JWT Bearer

Solution Structure

backend/FiscalFlow.sln
  src/FiscalFlow.Api/              -- Controllers, middleware, Swagger
  src/FiscalFlow.Application/      -- CQRS commands/queries, DTOs, validators
  src/FiscalFlow.Core/             -- Domain entities, value objects, events, interfaces
  src/FiscalFlow.Infrastructure/   -- EF Core repos, event store, blob storage, OCR client
  src/FiscalFlow.Integrations/     -- IAccountingSystem providers (Fortnox, Visma...)
  tests/FiscalFlow.UnitTests/      -- xUnit + Moq + FluentAssertions
  tests/FiscalFlow.IntegrationTests/
frontend/                          -- React SPA (Vite dev server :5173)
docs/                              -- Architecture, API, DB schema docs (Chinese)

Commands

# Backend
cd backend && dotnet restore && dotnet build
dotnet run --project src/FiscalFlow.Api
dotnet test
dotnet test tests/FiscalFlow.UnitTests

# Frontend
cd frontend && npm install
npm run dev
npm run build
npm run lint

Architecture

Provider Pattern: IAccountingSystem interface in FiscalFlow.Integrations/Accounting/. New providers implement this interface and register via DI. Factory: IAccountingSystemFactory.Create("fortnox")
CQRS: Commands/queries dispatched by MediatR with pipeline behaviors for validation and logging
Domain Events: Raised by aggregates, dispatched by EF Core interceptor, stored in DomainEvents table (JSONB payload) for audit trail
Invoice Lifecycle: Upload -> OCR -> SupplierMatch -> VoucherGenerate -> Import

dotnet-skills Routing

Code quality: modern-csharp-coding-standards, api-design, type-design-performance
Data access: efcore-patterns, database-performance
DI / config: dependency-injection-patterns, microsoft-extensions-configuration
Quality gates: dotnet-slopwatch (after new/refactored code), crap-analysis (after test changes)

2.4 KiB Raw Blame History