KOKO\Mimi
96 lines
4.2 KiB
Markdown
96 lines
4.2 KiB
Markdown
# Step 21: Domain Mapper Modules
|
||
|
||
## 담당 역할과 필수 스킬
|
||
|
||
- 담당 역할: `implementation-agent`
|
||
- 필수 스킬: `harness`, `fesa-cpp-msvc-tdd`
|
||
- 이 Step만 `RED -> observed failure -> minimal GREEN -> focused/full VERIFY`로 수행한다.
|
||
|
||
## 읽어야 할 파일
|
||
|
||
- `/AGENTS.md`
|
||
- `/docs/CODINGSTYLE.md`
|
||
- `/docs/ARCHITECTURE.md`
|
||
- `/docs/ADR.md`
|
||
- `/docs/linear-static-3d-euler-beam/io.md`
|
||
- `/docs/linear-static-mitc4-shell/io.md`
|
||
- `/docs/cpp-object-oriented-modular-refactoring/implementation-plan.md`
|
||
- Step 11 SourceTargetResolver
|
||
- Step 12–14 semantic hierarchy/Domain files
|
||
- Step 18–19 Load and BoundaryCondition files
|
||
- `/include/fesa/io/abaqus/domain_mapper.h`
|
||
- `/src/fesa/io/abaqus/domain_mapper.cpp`
|
||
- `/tests/unit/io/abaqus/domain_mapper_test.cpp`
|
||
- `/src/fesa/CMakeLists.txt`, `/tests/CMakeLists.txt`
|
||
- `/phases/cpp-object-oriented-modular-refactoring/index.json`
|
||
- `/phases/cpp-object-oriented-modular-refactoring/step21.md`
|
||
|
||
## 작업
|
||
|
||
Requirement `R-MODULE-001`의 mapper split을 구현한다.
|
||
|
||
1. `/tests/unit/io/abaqus/domain_mapping_components_test.cpp`를 먼저 추가한다.
|
||
`C-MODULE-001` exercises component seams with valid and invalid syntax records and verifies
|
||
topology, material/property, step/load/BC candidate content plus exact stable diagnostic order.
|
||
2. Missing private component headers causes RED compile failure.
|
||
3. Keep public facade
|
||
`Result<Domain> AbaqusDomainMapper::Map(const ParsedInput& input) const` in
|
||
`domain_mapper.h`. Candidate private modules under `/src/fesa/io/abaqus/`:
|
||
|
||
```text
|
||
domain_mapping_context.h shared candidate state, source locations and diagnostics
|
||
topology_mapper.h/.cpp nodes, elements, sets, identity instances
|
||
material_property_mapper.h/.cpp current isotropic material and beam/shell section assignments
|
||
step_definition_mapper.h/.cpp one STATIC step, concentrated loads, prescribed displacement
|
||
domain_builder.h/.cpp final cross-reference validation and atomic Domain construction
|
||
```
|
||
|
||
4. Private methods consume syntax/semantic candidate references and return `Status`; no component
|
||
commits to public Domain before final validation.
|
||
5. Preserve allowlist warnings, B31 rejection, S4/S4R common FESA-MITC4 mapping, set namespace,
|
||
source identity, declaration order and every existing diagnostic code/message/source location.
|
||
6. Reduce `domain_mapper.cpp` to orchestration. Do not add a registry or public parser plugin API.
|
||
|
||
## Acceptance Criteria
|
||
|
||
```powershell
|
||
cmake --build .harness/build --config Debug --target fesa_unit_tests
|
||
ctest --test-dir .harness/build -C Debug `
|
||
-R "InpDomainMapping|DomainMappingComponents|SourceTargetResolver" --output-on-failure
|
||
$componentFiles = @(
|
||
"src/fesa/io/abaqus/domain_mapping_context.h",
|
||
"src/fesa/io/abaqus/topology_mapper.cpp",
|
||
"src/fesa/io/abaqus/material_property_mapper.cpp",
|
||
"src/fesa/io/abaqus/step_definition_mapper.cpp",
|
||
"src/fesa/io/abaqus/domain_builder.cpp"
|
||
)
|
||
foreach ($componentFile in $componentFiles) {
|
||
if (-not (Test-Path -LiteralPath $componentFile -PathType Leaf)) {
|
||
throw "Missing mapper component: $componentFile"
|
||
}
|
||
}
|
||
rg -n "TopologyMapper|MaterialPropertyMapper|StepDefinitionMapper|DomainBuilder" `
|
||
src/fesa/io/abaqus/domain_mapper.cpp
|
||
& "C:/Program Files/LLVM/bin/clang-format.exe" --dry-run --Werror `
|
||
(rg --files src/fesa/io/abaqus -g "*.h" -g "*.cpp") `
|
||
tests/unit/io/abaqus/domain_mapper_test.cpp `
|
||
tests/unit/io/abaqus/domain_mapping_components_test.cpp
|
||
cmake --build .harness/build --config Debug
|
||
ctest --test-dir .harness/build -C Debug --show-only=json-v1
|
||
ctest --test-dir .harness/build -C Debug --output-on-failure
|
||
```
|
||
|
||
## 검증 및 상태 갱신
|
||
|
||
- RED missing components, component/facade diagnostics, facade wiring and full CTest를 summary에 기록한다.
|
||
- Diagnostic/order/semantic mapping regression is `error`.
|
||
- 성공 시 현재 Step만 `completed`로 갱신한다.
|
||
- timestamp, retry, commit, advancement는 Executor 소유다.
|
||
|
||
## 금지사항
|
||
|
||
- Abaqus keyword subset or unsupported behavior를 넓히지 마라.
|
||
- Failed candidate를 partial Domain에 commit하지 마라.
|
||
- Reference input을 mapper refactor에 맞춰 변경하지 마라.
|
||
- 직접 commit하거나 hook script를 수동 실행하지 마라.
|