Initial commit: EngineeringSync v1.0.0
Vollständige Implementierung des EngineeringSync-Middleware-Tools: - Windows Service (Kestrel :5050) mit FileSystemWatcher + SignalR - WPF Tray-App mit PendingChanges- und Projektverwaltungs-Fenster - Setup-Wizard (8-Schritte-Installer) - SQLite/EF Core Datenschicht (WAL-Modus) - SHA-256-basiertes Debouncing (2s Fenster) - Backup-System mit konfigurierbarer Aufbewahrung Bugfixes & Verbesserungen: - BUG-1: AppDbContext OnConfiguring invertierte Bedingung behoben - BUG-2: Event-Handler-Leak in TrayApp (Fenster-Singleton-Pattern) - BUG-3: ProjectConfigChanged SignalR-Signal in allen CRUD-Endpoints - BUG-5: Rename-Sync löscht alte Datei im Simulations-Ordner - BUG-6: Doppeltes Dispose von SignalR verhindert - BUG-7: Registry-Deinstallation nur EngineeringSync-Eintrag entfernt - S1: Path-Traversal-Schutz via SafeCombine() im SyncManager - E1: FSW Buffer 64KB + automatischer Re-Scan bei Overflow - E2: Retry-Logik (3x) für gesperrte Dateien mit exponentiellem Backoff - E4: Channel.Writer.TryComplete() beim Shutdown - C2: HubMethodNames-Konstanten statt Magic Strings - E3: Pagination in Changes-API (page/pageSize Query-Parameter) - A1: Fire-and-Forget mit try/catch + Logging Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
EngineeringSync
90
CLAUDE.md
Normal file
90
CLAUDE.md
Normal file
@@ -0,0 +1,90 @@
|
||||
# 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?` |
|
||||
Reference in New Issue
Block a user