91 lines
4.1 KiB
Markdown
91 lines
4.1 KiB
Markdown
|
# CLAUDE.md
|
|||
|
|
|
|||
|
|
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
|
|||
|
|
|
|||
|
|
## Project Overview
|
|||
|
|
|
|||
|
|
**EngineeringSync** – A .NET 10 middleware tool that bridges mechanical engineering (CAD) and simulation (Process Simulate). A Windows Service watches an engineering folder for file changes, records them in SQLite, and notifies a WPF System Tray App via SignalR. The simulation engineer reviews changes and triggers a controlled sync to avoid data corruption.
|
|||
|
|
|
|||
|
|
## Tech Stack
|
|||
|
|
|
|||
|
|
- **Framework:** .NET 10
|
|||
|
|
- **Service:** Worker Service (Windows Service) + ASP.NET Core Minimal API + SignalR
|
|||
|
|
- **Client:** WPF (.NET 10-Windows) with `H.NotifyIcon.Wpf` + `CommunityToolkit.Mvvm`
|
|||
|
|
- **Database:** SQLite via EF Core 10 (WAL mode)
|
|||
|
|
- **File Watching:** `System.IO.FileSystemWatcher` + `System.Threading.Channels` (debouncing)
|
|||
|
|
|
|||
|
|
## Solution Structure
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
EngineeringSync.slnx
|
|||
|
|
├── EngineeringSync.Domain (Class Library, net10.0) – Entities, Enums, Interfaces
|
|||
|
|
├── EngineeringSync.Infrastructure (Class Library, net10.0) – EF Core, AppDbContext
|
|||
|
|
├── EngineeringSync.Service (Worker Service, net10.0) – Kestrel on :5050, SignalR hub
|
|||
|
|
├── EngineeringSync.TrayApp (WPF App, net10.0-windows) – System tray + UI windows
|
|||
|
|
└── EngineeringSync.Setup (WPF App, net10.0-windows) – Setup-Wizard + Installer
|
|||
|
|
installer/
|
|||
|
|
├── setup.iss – Inno Setup Script
|
|||
|
|
└── build-installer.ps1 – Build + Publish + ISCC Pipeline
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**Dependency direction (strict one-way):**
|
|||
|
|
`TrayApp` → `Domain` | `Service` → `Domain` + `Infrastructure` | `Infrastructure` → `Domain`
|
|||
|
|
|
|||
|
|
## Build & Run
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
# Build entire solution
|
|||
|
|
dotnet build EngineeringSync.slnx
|
|||
|
|
|
|||
|
|
# Installer bauen (benötigt Inno Setup 6 installiert)
|
|||
|
|
.\installer\build-installer.ps1
|
|||
|
|
|
|||
|
|
# Run the background service (dev mode)
|
|||
|
|
dotnet run --project EngineeringSync.Service
|
|||
|
|
|
|||
|
|
# Run the WPF tray app
|
|||
|
|
dotnet run --project EngineeringSync.TrayApp
|
|||
|
|
|
|||
|
|
# Run all tests
|
|||
|
|
dotnet test
|
|||
|
|
|
|||
|
|
# Run a single test project
|
|||
|
|
dotnet test EngineeringSync.Tests --filter "FullyQualifiedName~WatcherServiceTests"
|
|||
|
|
|
|||
|
|
# Install as Windows Service (production)
|
|||
|
|
sc create EngineeringSync binPath="<path>\EngineeringSync.Service.exe"
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## Key Architecture Decisions
|
|||
|
|
|
|||
|
|
### ProjectConfig in DB (not appsettings.json)
|
|||
|
|
`ProjectConfig` is managed via the TrayApp UI and stored in SQLite. The user can add/edit/delete projects with folder browser dialogs. CRUD operations go through the Service API, which dynamically starts/stops watchers.
|
|||
|
|
|
|||
|
|
### FileSystemWatcher Debouncing
|
|||
|
|
Events (Created, Changed, Renamed, Deleted) are pushed into a `Channel<FileEvent>`. A consumer groups events by `(ProjectId, RelativePath)` within a 2000ms sliding window. SHA-256 hashing against `FileRevision` confirms actual changes before writing a `PendingChange`.
|
|||
|
|
|
|||
|
|
### Service API (Kestrel on localhost:5050)
|
|||
|
|
- **Project CRUD:** `GET/POST/PUT/DELETE /api/projects`
|
|||
|
|
- **Changes:** `GET /api/changes/{projectId}`, `GET /api/changes/{projectId}/history`
|
|||
|
|
- **Actions:** `POST /api/sync`, `POST /api/ignore`
|
|||
|
|
|
|||
|
|
Backup before overwrite uses timestamped naming: `{filename}_{yyyyMMdd_HHmmss}.bak`
|
|||
|
|
|
|||
|
|
### SignalR Hub (`NotificationHub` at `/notifications`)
|
|||
|
|
- `ReceiveChangeNotification(projectId, projectName, count)` – New pending changes
|
|||
|
|
- `ProjectConfigChanged()` – Project CRUD happened
|
|||
|
|
|
|||
|
|
### TrayApp Windows
|
|||
|
|
- **ProjectManagementWindow** – CRUD for projects with `FolderBrowserDialog` for path selection
|
|||
|
|
- **PendingChangesWindow** – DataGrid with project selector, sync/ignore actions, auto-refresh via SignalR
|
|||
|
|
|
|||
|
|
All ViewModels use `CommunityToolkit.Mvvm` source generators (`[ObservableProperty]`, `[RelayCommand]`).
|
|||
|
|
|
|||
|
|
## Domain Entities
|
|||
|
|
|
|||
|
|
| Entity | Key Fields |
|
|||
|
|
|---|---|
|
|||
|
|
| `ProjectConfig` | `Id` (Guid), `Name`, `EngineeringPath`, `SimulationPath`, `FileExtensions`, `IsActive`, `CreatedAt` |
|
|||
|
|
| `FileRevision` | `Id` (Guid), `ProjectId` (FK), `RelativePath`, `FileHash`, `Size`, `LastModified` |
|
|||
|
|
| `PendingChange` | `Id` (Guid), `ProjectId` (FK), `RelativePath`, `ChangeType` (Created/Modified/Renamed/Deleted), `OldRelativePath?`, `Status` (Pending/Synced/Ignored), `CreatedAt`, `SyncedAt?` |
|