NINI
106 lines
3.4 KiB
Markdown
106 lines
3.4 KiB
Markdown
# Step 1: core-primitives
|
|
|
|
## 읽어야 할 파일
|
|
|
|
먼저 아래 파일들을 읽고 프로젝트의 아키텍처와 이전 step 산출물을 파악하라:
|
|
|
|
- `/AGENTS.md`
|
|
- `/docs/PRD.md`
|
|
- `/docs/ARCHITECTURE.md`
|
|
- `/docs/ADR.md`
|
|
- `/CMakeLists.txt`
|
|
- `/tests/unit/CMakeLists.txt`
|
|
|
|
이전 step에서 만들어진 CMake/CTest 구성을 꼼꼼히 읽고, 새 unit test가 자동 등록되는 방식과 일관성을 유지하라.
|
|
|
|
## 작업
|
|
|
|
solver skeleton의 공통 primitive를 `/src/fesa/core/` 아래 header-only로 구현한다.
|
|
|
|
필수 파일:
|
|
|
|
- `/src/fesa/core/ids.hpp`
|
|
- `/src/fesa/core/diagnostic.hpp`
|
|
- `/src/fesa/core/status.hpp`
|
|
- `/tests/unit/core_primitives_test.cpp`
|
|
|
|
필수 interface:
|
|
|
|
```cpp
|
|
namespace fesa::core {
|
|
|
|
struct NodeId { int value; };
|
|
struct ElementId { int value; };
|
|
struct MaterialId { int value; };
|
|
struct PropertyId { int value; };
|
|
struct StepId { int value; };
|
|
|
|
enum class Severity { info, warning, error };
|
|
|
|
struct Diagnostic {
|
|
Severity severity;
|
|
std::string code;
|
|
std::string message;
|
|
};
|
|
|
|
class Status {
|
|
public:
|
|
static Status ok();
|
|
static Status failure(Diagnostic diagnostic);
|
|
|
|
bool is_ok() const;
|
|
const std::vector<Diagnostic>& diagnostics() const;
|
|
void add(Diagnostic diagnostic);
|
|
};
|
|
|
|
} // namespace fesa::core
|
|
```
|
|
|
|
구현 규칙:
|
|
|
|
- 모든 ID type은 strong typedef 역할을 하며 서로 암시적으로 대체되지 않아야 한다.
|
|
- ID에는 equation id 또는 DOF numbering 정보를 넣지 않는다.
|
|
- `Status::ok()`는 diagnostics가 비어 있고 `is_ok() == true`여야 한다.
|
|
- `Status::failure(...)`는 최소 하나의 diagnostic을 포함하고 `is_ok() == false`여야 한다.
|
|
- 외부 라이브러리에 의존하지 않는다.
|
|
|
|
## Tests To Write First
|
|
|
|
- `/tests/unit/core_primitives_test.cpp`
|
|
- `NodeId{1}`과 `ElementId{1}`이 서로 다른 타입임을 compile-time으로 확인한다.
|
|
- `Status::ok().is_ok()`가 true임을 확인한다.
|
|
- `Status::failure(...)`가 false이고 diagnostic code/message를 보존함을 확인한다.
|
|
- `Status::add(...)`로 warning을 추가해도 diagnostic 순서가 보존됨을 확인한다.
|
|
|
|
RED 확인:
|
|
|
|
1. 테스트 파일을 먼저 작성한다.
|
|
2. `python scripts/validate_workspace.py` 또는 targeted CTest를 실행해 `fesa/core/ids.hpp` 등 missing include로 실패함을 확인한다.
|
|
3. 그 뒤 production header를 작성한다.
|
|
|
|
## Acceptance Criteria
|
|
|
|
```powershell
|
|
python -m unittest discover -s scripts -p "test_*.py"
|
|
python scripts/validate_workspace.py
|
|
ctest --test-dir build/msvc-debug --output-on-failure -C Debug -R core_primitives_test
|
|
```
|
|
|
|
## 검증 절차
|
|
|
|
1. 위 AC 커맨드를 실행한다.
|
|
2. 아키텍처 체크리스트를 확인한다:
|
|
- `core`가 외부 라이브러리에 의존하지 않는가?
|
|
- ID type에 equation numbering을 저장하지 않는가?
|
|
- C++ production header 변경에 대응하는 test file이 있는가?
|
|
3. 결과에 따라 `phases/solver-core-skeleton/index.json`의 step 1을 업데이트한다:
|
|
- 성공: `"status": "completed"`, `"summary": "Core ID, diagnostic, and status primitives added with tests"`
|
|
- 3회 수정 시도 후 실패: `"status": "error"`, `"error_message": "구체적 에러 내용"`
|
|
- 사용자 개입 필요: `"status": "blocked"`, `"blocked_reason": "구체적 사유"` 후 중단
|
|
|
|
## 금지사항
|
|
|
|
- Node, Element, Domain 같은 model class를 이 step에서 만들지 마라.
|
|
- MKL, TBB, HDF5 API를 include하지 마라.
|
|
- JavaScript/TypeScript/npm fallback을 추가하지 마라.
|