# Template Development Handoff

> **Usage:** Template for 4-development-handoff.md
> **Loaded in:** step-05-handoff.md

---

```markdown
# Development Handoff - {FEAT-XXX} {Feature Name}

> **Module:** business/{application}/{module}
> **Version:** 1.0
> **Validated Specs:** FRD v1.0 (validation.json)
> **Implementation:** `/implement {FEAT-XXX}`

## DEVELOPER INSTRUCTIONS

This document is a self-contained prompt for Claude Code. Execute:
```
/implement {FEAT-XXX}
```

---

## 1. QUICK CONTEXT

| Attribute | Value |
|----------|--------|
| Feature ID | {FEAT-XXX} |
| Module | business/{application}/{module} |
| Base Permission | `business.{app}.{module}` |
| Complexity | {Simple/Medium/Complex} |

## 2. [EXPLORE] EXISTING PATTERNS

BEFORE coding, explore these files to understand the patterns:

```
BACKEND:
- src/SmartStack.Domain/Entities/ → Entity structure
- src/SmartStack.Application/Features/ → CQRS pattern
- src/SmartStack.Infrastructure/Persistence/Configurations/ → EF Core

FRONTEND:
- web/smartstack-web/src/pages/business/ → Existing pages
- web/smartstack-web/src/components/ → Reusable components
- web/smartstack-web/src/services/api/ → API calls
```

## 3. FILES TO CREATE

### 3.1 Backend

| File | Template | Description |
|------|----------|-------------|
| `Domain/Entities/{Entity}.cs` | Domain Entity | Properties + rules |
| `Application/Features/{Module}/` | CQRS | MediatR handlers |
| `Infrastructure/.../Configurations/` | EF Core | Config + HasData |
| `Api/Controllers/Business/` | Controller | REST endpoints |

### 3.2 Frontend

| File | Template | Description |
|------|----------|-------------|
| `pages/business/{app}/{module}/` | React Page | List + detail |
| `services/api/{module}Api.ts` | API Service | Axios calls |
| `i18n/locales/{lang}/{module}.json` | Translations | FR, EN, IT, DE |

## 4. DETAILED SPECIFICATIONS

### 4.1 Entity

| Attribute | Description | Required | Rules |
|-----------|-------------|----------|-------|
| Id | Unique identifier | Yes | GUID |
| {attr} | {description} | {Yes/No} | {validation} |

### 4.2 API Endpoints

| Endpoint | Method | Permission | Body | Response |
|----------|--------|------------|------|----------|
| `/api/business/{module}` | GET | `.read` | - | List |
| `/api/business/{module}` | POST | `.create` | CreateDto | 201 |
| `/api/business/{module}/{id}` | GET | `.read` | - | Entity |
| `/api/business/{module}/{id}` | PUT | `.update` | UpdateDto | 200 |
| `/api/business/{module}/{id}` | DELETE | `.delete` | - | 204 |

### 4.3 Business Rules → Code

| BR-ID | Rule | Implementation |
|-------|------|----------------|
| BR-001 | {rule} | {where to implement} |

## 5. REQUIRED TESTS

- [ ] Unit test: Entity validation
- [ ] Integration test: API endpoints
- [ ] Permission test: 403 denial
- [ ] Postman test: Collection generated

## 6. POST-IMPLEMENTATION CHECKLIST

- [ ] Backend build OK
- [ ] Frontend build OK
- [ ] Tests passing
- [ ] EF Core migration created
- [ ] Permissions in PermissionConfiguration.cs
- [ ] i18n complete (4 languages)
- [ ] Documentation: `/business-analyse:6-doc-html {FEAT-XXX}`

---

## EXECUTION

```bash
/implement {FEAT-XXX}
```
```
