add claude

Author: dadachi

.gitignore

@@ -72,3 +72,5 @@ Carthage/Build
 secrets.*.xcconfig
 !secrets.template.xcconfig
 
+# Claude
+.claude/

CLAUDE.md

@@ -0,0 +1,106 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Build, Test, and Development Commands
+
+### Building the Project
+```bash
+# Build for Debug
+xcodebuild -project NativeAppTemplate.xcodeproj \
+  -scheme "NativeAppTemplate" \
+  -configuration Debug \
+  -sdk iphonesimulator \
+  -destination 'platform=iOS Simulator,name=iPhone 16 Pro,OS=18.2' \
+  build
+
+# Build for Release
+xcodebuild -project NativeAppTemplate.xcodeproj \
+  -scheme "NativeAppTemplate" \
+  -configuration Release \
+  -sdk iphonesimulator \
+  -destination 'platform=iOS Simulator,name=iPhone 16 Pro,OS=18.2' \
+  build
+```
+
+### Running Tests
+```bash
+# Run all tests
+xcodebuild -project NativeAppTemplate.xcodeproj \
+  -scheme "NativeAppTemplate" \
+  -sdk iphonesimulator \
+  -destination 'platform=iOS Simulator,name=iPhone 16 Pro,OS=18.2' \
+  test
+```
+
+### Linting
+```bash
+# Run SwiftLint (must be installed via: brew install swiftlint)
+cd NativeAppTemplate && swiftlint
+
+# Run SwiftLint with strict mode (as in CI)
+cd NativeAppTemplate && swiftlint --strict
+```
+
+## Architecture Overview
+
+### MVVM with Observable Pattern
+The app uses iOS 17's `@Observable` macro for state management with clean separation between:
+- **Views**: SwiftUI views (99% SwiftUI, UIKit only for mail view)
+- **ViewModels**: Observable state containers that bridge views and data
+- **Models**: Domain objects and data structures
+- **Repositories**: Data access layer implementing CRUD operations
+
+### Core Components
+
+**Data Flow Architecture**:
+1. **SessionController** (`/Sessions/SessionController.swift`): Manages authentication state and user sessions
+2. **DataManager** (`/Data/DataManager.swift`): Central orchestrator that manages all repositories
+3. **Repositories**: Each entity has its own repository (e.g., `ShopRepository`, `ItemTagRepository`)
+4. **Services**: Network layer abstraction with protocol-based design
+5. **MessageBus** (`/MessageBus.swift`): Event communication system for decoupled components
+
+**Networking Architecture**:
+- JSON API format with custom adapters (`/Networking/Adapters/`)
+- Service layer pattern (`/Networking/Services/`)
+- Request/Response models (`/Networking/Requests/`, `/Networking/Responses/`)
+- Error handling with typed errors (`/Models/AppError.swift`)
+
+### Key Features Implementation
+
+**NFC Support**:
+- Tag reading/writing capabilities (`/NFC/`)
+- Background tag reading support
+- Application-specific tag data format
+
+**Offline Support**:
+- Network monitoring (`/Networking/NetworkMonitor.swift`)
+- Keychain storage for secure data persistence
+
+**Configuration**:
+- Central configuration in `Constants.swift`
+- API endpoints, UI strings, and app constants
+- Environment-specific settings (scheme, domain, port)
+
+### Project Structure
+```
+NativeAppTemplate/
+├── App.swift                 # App entry point
+├── MainView.swift           # Root view
+├── Data/                    # Data layer (repositories, ViewModels)
+├── Models/                  # Domain models
+├── Networking/              # API layer
+├── UI/                      # SwiftUI views by feature
+├── Sessions/                # Authentication
+├── Persistence/             # Keychain storage
+├── Utilities/               # Helpers and extensions
+└── NFC/                     # NFC functionality
+```
+
+### Dependencies (Swift Package Manager)
+- KeychainAccess (4.2.2) - Secure credential storage
+- SwiftyJSON (5.0.2) - JSON parsing  
+- Swift Collections (1.1.4) - Additional data structures
+
+### Testing
+Uses Swift Testing framework with `@Test` attribute. Tests are organized by component type (models, adapters, networking).