@atlashub/smartstack-cli 2.1.0 → 2.2.0

package/templates/skills/business-analyse/templates/tpl-handoff.md

@@ -1,7 +1,7 @@
 # Template Development Handoff
 
-> **Usage:** Template for 4-development-handoff.md
-> **Loaded in:** step-05-handoff.md
+> **Usage:** Template for step-04-handoff.md
+> **Data source:** feature.json (sections: metadata, analysis, specification, handoff)
 
 ---
 
@@ -9,8 +9,9 @@
 # Development Handoff - {FEAT-XXX} {Feature Name}
 
 > **Module:** business/{application}/{module}
-> **Version:** 1.0
-> **Validated Specs:** FRD v1.0 (validation.json)
+> **Version:** {version}
+> **Validated Specs:** feature.json (validation.decision = APPROVED)
+> **Source:** `docs/business/{app}/{module}/business-analyse/v{version}/feature.json`
 > **Implementation:** `/ralph-loop -r` (iterative) | `/feature-full business/{app}/{module}` (one-shot)
 
 ## DEVELOPER INSTRUCTIONS
@@ -34,13 +35,13 @@ This document is a self-contained prompt for Claude Code.
 
 | Attribute | Value |
 |----------|--------|
-| Feature ID | {FEAT-XXX} |
-| Module | business/{application}/{module} |
+| Feature ID | {feature.id} |
+| Module | business/{feature.metadata.application}/{feature.metadata.module} |
 | Base Permission | `business.{app}.{module}` |
-| Project Namespace | `{project_namespace}` |
+| Project Namespace | {feature.metadata.projectNamespace} |
 | DB Schema | `extensions` (client entities) / `core` (navigation, permissions) |
-| Table Prefix | `{prefix}_` (e.g., `bik_`) |
-| Complexity | {Simple/Medium/Complex} |
+| Table Prefix | `{prefix}_` |
+| Complexity | {feature.handoff.complexity} |
 
 ## 2. [EXPLORE] EXISTING PATTERNS
 
@@ -48,27 +49,29 @@ BEFORE coding, explore these files to understand the patterns:
 
 ```
 BACKEND:
-- src/{project_namespace}.Domain/Business/ → Entity structure + folder hierarchy
-- src/{project_namespace}.Application/Business/ → DTOs + service interfaces
-- src/{project_namespace}.Application/Common/Interfaces/ → Service contracts
-- src/{project_namespace}.Infrastructure/Persistence/Configurations/ → EF Core configs (subfolder per module)
-- src/{project_namespace}.Infrastructure/Services/ → Service implementations (subfolder per module)
-- src/{project_namespace}.Infrastructure/Persistence/Seeding/Data/ → SeedData patterns
+- src/{project_namespace}.Domain/Business/ -> Entity structure + folder hierarchy
+- src/{project_namespace}.Application/Business/ -> DTOs + service interfaces
+- src/{project_namespace}.Application/Common/Interfaces/ -> Service contracts
+- src/{project_namespace}.Infrastructure/Persistence/Configurations/ -> EF Core configs (subfolder per module)
+- src/{project_namespace}.Infrastructure/Services/ -> Service implementations (subfolder per module)
+- src/{project_namespace}.Infrastructure/Persistence/Seeding/Data/ -> SeedData patterns
 
 SEED DATA (CRITICAL):
-- NavigationModuleConfiguration.cs → How modules are seeded (HasData)
-- NavigationTranslationConfiguration.cs → How translations are seeded (4 languages)
-- PermissionConfiguration.cs → How permissions are seeded (HasData)
-- RolePermissionConfiguration.cs → How role-permission mappings are seeded
+- NavigationModuleConfiguration.cs -> How modules are seeded (HasData)
+- NavigationTranslationConfiguration.cs -> How translations are seeded (4 languages)
+- PermissionConfiguration.cs -> How permissions are seeded (HasData)
+- RolePermissionConfiguration.cs -> How role-permission mappings are seeded
 
 FRONTEND:
-- web/src/pages/business/ → Existing pages
-- web/src/components/ → Reusable components
-- web/src/services/api/ → API calls
+- web/src/pages/business/ -> Existing pages
+- web/src/components/ -> Reusable components
+- web/src/services/api/ -> API calls
 ```
 
 ## 3. FILES TO CREATE
 
+> **Source:** `feature.handoff.filesToCreate[]` in feature.json
+
 ### 3.1 Backend
 
 | File | Path Pattern | Description |
@@ -76,13 +79,13 @@ FRONTEND:
 | Domain Entity | `Domain/Business/{Application}/{Module}/{Entity}.cs` | BaseEntity + IAuditableEntity |
 | Service Interface | `Application/Common/Interfaces/I{Entity}Service.cs` | Service contract |
 | DTOs | `Application/Business/{Application}/{Module}/DTOs/{Entity}Dto.cs` | Response, Create, Update records |
-| Mapping | `Application/Business/{Application}/{Module}/DTOs/{Entity}MappingExtensions.cs` | Entity ↔ DTO mapping |
+| Mapping | `Application/Business/{Application}/{Module}/DTOs/{Entity}MappingExtensions.cs` | Entity <-> DTO mapping |
 | Permission Constants | `Application/Business/{Application}/{Module}/Permissions.cs` | Compile-time constants |
 | EF Configuration | `Infrastructure/Persistence/Configurations/{Module}/{Entity}Configuration.cs` | Table + indexes + HasData |
 | Service Implementation | `Infrastructure/Services/{Module}/{Entity}Service.cs` | Business logic |
 | Controller | `Api/Controllers/Business/{Application}/{Module}Controller.cs` | NavRoute + RequirePermission |
 
-### 3.2 SeedData Core (CRITICAL — without these, module is invisible and returns 403)
+### 3.2 SeedData Core (CRITICAL -- without these, module is invisible and returns 403)
 
 > **5 mandatory files** for every new module (4 EF Core HasData + 1 Application code):
 
@@ -92,7 +95,7 @@ FRONTEND:
 | 2 | `NavigationTranslationConfiguration.cs` | Infrastructure (HasData) | 4 translations (fr, en, it, de) per nav entity |
 | 3 | `PermissionConfiguration.cs` | Infrastructure (HasData) | Wildcard + CRUD permissions in `nav_Permissions` |
 | 4 | `Permissions.cs` | Application (code) | Compile-time constants for `[RequirePermission]` |
-| 5 | `RolePermissionConfiguration.cs` | Infrastructure (HasData) | Role→Permission for {App} Admin, {App} Manager, {App} Contributor, {App} Viewer |
+| 5 | `RolePermissionConfiguration.cs` | Infrastructure (HasData) | Role->Permission for {App} Admin, {App} Manager, {App} Contributor, {App} Viewer |
 
 ### 3.3 Frontend
 
@@ -105,58 +108,32 @@ FRONTEND:
 
 ## 4. DETAILED SPECIFICATIONS
 
+> **Source:** Read from feature.json sections: `analysis.entities[]`, `specification.apiEndpoints[]`, `analysis.businessRules[]`, `specification.navigation`, `specification.permissionMatrix`
+
 ### 4.1 Entity
 
 **Base class:** `BaseEntity` + `IAuditableEntity`
-**Table name:** `{prefix}_{EntityPlural}` in schema `extensions` (e.g., `extensions.bik_FreeBickes`)
+**Table name:** `{prefix}_{EntityPlural}` in schema `extensions`
 **Schema:** `extensions` for business entities, `core` for system entities (navigation, permissions)
-> DO NOT add Id, TenantId, CreatedAt, UpdatedAt, CreatedBy, UpdatedBy — these are automatic via BaseEntity + IAuditableEntity.
+> DO NOT add Id, TenantId, CreatedAt, UpdatedAt, CreatedBy, UpdatedBy -- these are automatic via BaseEntity + IAuditableEntity.
 
-| Attribute | Description | Required | Rules |
-|-----------|-------------|----------|-------|
-| Code | Unique code per tenant | Yes | MaxLength(50), unique index with TenantId |
-| {attr} | {description} | {Yes/No} | {validation} |
+Attributes from: `feature.analysis.entities[].attributes[]`
 
 ### 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 |
+From: `feature.specification.apiEndpoints[]`
+
+### 4.3 Business Rules -> Code
 
-### 4.3 Business Rules → Code
+From: `feature.handoff.brToCodeMapping[]`
 
 | BR-ID | Rule | Implementation |
 |-------|------|----------------|
-| BR-001 | {rule} | {where to implement} |
+| {id} | {rule from analysis.businessRules[]} | {implementation from handoff.brToCodeMapping[]} |
 
 ### 4.4 SeedData Specifications
 
-**Navigation seeds:**
-| Level | Code | Label FR | Label EN | Label IT | Label DE | Icon | Route |
-|-------|------|----------|----------|----------|----------|------|-------|
-| Module | {module} | {label_fr} | {label_en} | {label_it} | {label_de} | {Icon} | /business/{app}/{module} |
-
-**Permission seeds:**
-| Path | Level | Action | Description |
-|------|-------|--------|-------------|
-| business.{app}.{module}.* | Module | Wildcard | Full access |
-| business.{app}.{module}.read | Module | Read | View |
-| business.{app}.{module}.create | Module | Create | Create |
-| business.{app}.{module}.update | Module | Update | Modify |
-| business.{app}.{module}.delete | Module | Delete | Remove |
-
-**Role-Permission matrix:**
-| Permission | {App} Admin | {App} Manager | {App} Contributor | {App} Viewer |
-|------------|-------------|---------------|-------------------|--------------|
-| wildcard (*) | X | - | - | - |
-| read | - | X | X | X |
-| create | - | X | X | - |
-| update | - | X | X | - |
-| delete | - | - | - | - |
+From: `feature.specification.navigation` and `feature.specification.permissionMatrix`
 
 ## 5. REQUIRED TESTS
 
@@ -190,7 +167,6 @@ FRONTEND:
 **Frontend & i18n:**
 - [ ] i18n complete (4 languages)
 - [ ] Nested routes (NOT flat)
-- [ ] Documentation: `/business-analyse:6-doc-html {FEAT-XXX}`
 
 ---