041e54196a
- 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
56 lines
2.4 KiB
Markdown
56 lines
2.4 KiB
Markdown
# 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
|
|
|
|
```bash
|
|
# 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)
|