15 KiB
15 KiB
작업지시서 — Laser Recipe Save 진단계측 원복 (2026-08-04)
| 항목 | 내용 |
|---|---|
| 대상 | LGES-OC5-PtoP-Welder / ILSOS_PrismaticRD_PTOP |
| 분류 | 원복 (진단계측 제거, 원본 복귀) |
| 적용 문서 | docs/작업지시서/2026-08-04_Laser_Recipe_Save_진단계측.md |
| 파일 목록 | docs/작업지시서/2026-08-04_Laser_Recipe_Save_진단계측_변경파일목록.md |
| 적용 브랜치 | feature/ubisam-pptx-integration |
| 적용 일자 | 2026-08-04 |
이 문서의 목적
2026-08-04 진단계측으로 변경된 소스를 계측 이전 원본 상태로 완전히 되돌린다. 계측은 진단 전용이며, 원인 경로가 확정되면 반드시 제거한다.
원인 확정 후 실제 수정(2~4단계)은 선행 문서를 따른다 —
docs/작업지시서/작업지시서_2026-08-03_Laser_Recipe_Save_교차오염.txt
원복 대상 (총 6곳)
| # | 파일 | 작업 |
|---|---|---|
| 1 | WeldingComponents\WeldingCommon\Utils\RecipeTrace.cs |
파일 삭제 |
| 2 | WeldingComponents\WeldingCommon\WeldingCommon.csproj |
Compile Include 1줄 + 주석 1줄 삭제 |
| 3 | WeldingComponents\WeldingCommon\Utils\RecipeHelper.cs |
계측 블록 3곳 → 원본 복귀 |
| 4 | WeldingComponents\LASA\GUI\Page\MainPage.cs |
계측 블록 2곳 삭제 |
| 5 | WeldingComponents\WeldingCommon\Utils\CommonHelper.cs |
계측 블록 1곳 삭제 |
| 6 | D:\ILSOSConfig\ILSOS_PrismaticRD_PTOP\RecipeTrace.txt |
로그 파일 삭제 (설비 PC) |
변경된 소스는 위 5개 파일뿐입니다. 그 외 파일은 손대지 않았습니다.
4·5번은 Page(
FieldHelper.json) 계측입니다. 4번의Tracer필드와 5번의Attach()는 쌍이므로 한쪽만 지우면 안 됩니다. 5번만 지우면Tracer가null이라 동작은 정상이지만 죽은 코드가 남고, 4번만 지우면 5번이 컴파일 에러가 납니다. 반드시 4 → 5 순서로 함께 지우십시오.
계측 위치 찾는 법
삽입한 모든 코드에 마커를 달아 두었습니다. 저장소 전체에서 아래 문자열로 검색하면 빠짐없이 찾을 수 있습니다.
[진단계측 2026-08-04]
RecipeHelper.cs 안에서는 아래 형태로 시작/끝이 쌍을 이룹니다. 3쌍이 있어야 정상입니다.
// ═══ [진단계측 2026-08-04] 시작 ═══
… 이 사이가 전부 제거/복원 대상 …
// ═══ [진단계측 2026-08-04] 끝 ═══
각 블록의 머리 주석에 원본 코드가 그대로 적혀 있습니다. 그것으로 되돌리면 됩니다.
원복 1. RecipeTrace.cs 삭제
파일: WeldingComponents\WeldingCommon\Utils\RecipeTrace.cs
파일 전체가 진단 전용입니다. Visual Studio 솔루션 탐색기에서 제외가 아니라 삭제하십시오 (제외만 하면 csproj 항목은 남습니다). VS에서 삭제하면 원복 2가 자동 처리됩니다.
원복 2. csproj 항목 삭제
파일: WeldingComponents\WeldingCommon\WeldingCommon.csproj
[현재]
<Compile Include="Utils\RecipeHelper.cs" />
<!-- [진단계측 2026-08-04] 원복 시 이 1줄 삭제 -->
<Compile Include="Utils\RecipeTrace.cs" />
<Compile Include="Utils\RegistrySerializer.cs" />
[원복 후]
<Compile Include="Utils\RecipeHelper.cs" />
<Compile Include="Utils\RegistrySerializer.cs" />
주석 줄까지 2줄 삭제입니다.
원복 3. RecipeHelper.cs — 계측 블록 3곳
파일: WeldingComponents\WeldingCommon\Utils\RecipeHelper.cs
인코딩: UTF-8 유지 (한글 주석 포함)
3곳 모두 같은 파일입니다. 위에서부터 지우면 줄 번호가 밀리므로 줄 번호보다 마커 문자열로 찾으십시오.
3-1. SelectedRecipe — 프로퍼티 → 필드
위치: mRecipeManager 선언 바로 위 (계측 전 기준 18행)
[현재]
// ═══ [진단계측 2026-08-04] 시작 ═══════════════════════════════════════
// 원본 1줄 : public static (int id, string name) SelectedRecipe;
// 대상(SelectedRecipe)이 바뀌는 순간을 잡기 위해 필드 → 프로퍼티로 전환.
// 외부에서의 읽기/쓰기 방식은 동일하다(대입 4곳, 나머지는 .name/.id 읽기뿐).
// 원복 : 아래 블록 전체를 위 원본 1줄로 되돌린다.
static (int id, string name) _SelectedRecipe;
public static (int id, string name) SelectedRecipe {
get { return _SelectedRecipe; }
set {
var old = _SelectedRecipe;
_SelectedRecipe = value;
RecipeTrace.Mark("대상변경 SELECTED",
$"[{old.id}][{old.name}] → [{value.id}][{value.name}]");
}
}
// ═══ [진단계측 2026-08-04] 끝 ═════════════════════════════════════════
static IRecipeManager mRecipeManager = Application.Current.AuroraEnv().RecipeManager;
[원복 후]
public static (int id, string name) SelectedRecipe;
static IRecipeManager mRecipeManager = Application.Current.AuroraEnv().RecipeManager;
3-2. SaveRecipe — 전/후 계측 제거
위치: GetTeachingEditorFullPath 바로 아래 (계측 전 기준 36~39행)
[현재]
public static void SaveRecipe(string recipeName, bool includeModel = true)
{
// ═══ [진단계측 2026-08-04] 시작 ═══════════════════════════════════
// 원본 1줄 : CommonHelper.GetMainPage().SaveRecipe(GetTeachingEditorFullPath(recipeName), includeModel);
// 저장 전/후를 모두 찍어 무엇이 무엇으로 바뀌었는지 확인한다. 저장 자체는 막지 않는다.
// 원복 : 이 블록 전체를 위 원본 1줄로 되돌린다.
var targetPath = GetTeachingEditorFullPath(recipeName);
var snap = RecipeTrace.BeforeSave(recipeName, targetPath);
CommonHelper.GetMainPage().SaveRecipe(targetPath, includeModel);
RecipeTrace.AfterSave(snap);
// ═══ [진단계측 2026-08-04] 끝 ═════════════════════════════════════
}
[원복 후]
public static void SaveRecipe(string recipeName, bool includeModel = true)
{
CommonHelper.GetMainPage().SaveRecipe(GetTeachingEditorFullPath(recipeName), includeModel);
}
3-3. ReloadRecipe — try/catch 및 계측 제거
위치: UpdateAutorunRecipe 바로 아래 (계측 전 기준 64~69행)
[현재]
public static void ReloadRecipe(string recipeName)
{
// ═══ [진단계측 2026-08-04] 시작 ═══════════════════════════════════
// 원본 3줄 (try 블록 안의 3줄이 원본 그대로다) :
// var camConfig = VisionEnv.AuroraEnv.DeviceManager.GetDeviceConfig(eCamId.CAM1.ToString()) as CamConfig;
// CommonHelper.GetMainPage().UpdateDefaultField(camConfig.ChildImage.ChildBufRowCols);
// CommonHelper.GetMainPage().ReloadRecipe(GetTeachingEditorFullPath(recipeName));
// 내용 전환의 성공/실패/무동작을 구분해 기록한다. 동작은 그대로다.
// 원복 : try/catch 와 Mark 호출을 걷어내고 위 원본 3줄만 남긴다.
var before = RecipeTrace.MemFingerprint();
RecipeTrace.Mark("내용변경 RELOAD 진입", $"요청=[{recipeName}] 지문(전)={before}");
try {
var camConfig = VisionEnv.AuroraEnv.DeviceManager.GetDeviceConfig(eCamId.CAM1.ToString()) as CamConfig;
CommonHelper.GetMainPage().UpdateDefaultField(camConfig.ChildImage.ChildBufRowCols);
CommonHelper.GetMainPage().ReloadRecipe(GetTeachingEditorFullPath(recipeName));
var after = RecipeTrace.MemFingerprint();
RecipeTrace.Mark(before == after ? "RELOAD 완료(내용무변화!)" : "RELOAD 완료",
$"요청=[{recipeName}] 지문(후)={after}");
} catch (System.Exception ex) {
RecipeTrace.Mark("*** RELOAD 실패 ***",
$"요청=[{recipeName}] {ex.GetType().Name}: {ex.Message}");
throw; // 기존 동작 보존 — 예외 전파는 그대로
}
// ═══ [진단계측 2026-08-04] 끝 ═════════════════════════════════════
}
[원복 후]
public static void ReloadRecipe(string recipeName)
{
var camConfig = VisionEnv.AuroraEnv.DeviceManager.GetDeviceConfig(eCamId.CAM1.ToString()) as CamConfig;
CommonHelper.GetMainPage().UpdateDefaultField(camConfig.ChildImage.ChildBufRowCols);
CommonHelper.GetMainPage().ReloadRecipe(GetTeachingEditorFullPath(recipeName));
}
원복 4. MainPage.cs — Page 계측 블록 2곳
파일: WeldingComponents\LASA\GUI\Page\MainPage.cs
인코딩: UTF-8 유지 (한글 주석 포함)
주의 — 이 파일은
LASAGUI프로젝트입니다. 원복 5와 반드시 함께 진행하십시오.
4-1. Tracer 필드 삭제
위치: SaveAndLoadFieldScanFromLasaDb 정의 바로 위 (≈535~540행)
[현재]
// ═══ [진단계측 2026-08-04] 시작 ═══════════════════════════════════════
// WeldingCommon(RecipeTrace)이 LASAGUI 를 참조하므로 역방향 호출이 불가능하다.
// 델리게이트로 우회한다. CommonHelper.SetMainPage 에서 RecipeTrace.Mark 가 꽂힌다.
// 원복 : 이 블록과 SaveAndLoadFieldScanFromLasaDb 안의 Tracer?.Invoke 블록을 삭제.
public static Action<string, string> Tracer;
// ═══ [진단계측 2026-08-04] 끝 ═════════════════════════════════════════
void SaveAndLoadFieldScanFromLasaDb(string inputStr = null)
[원복 후]
void SaveAndLoadFieldScanFromLasaDb(string inputStr = null)
블록 6줄 전체 삭제입니다.
4-2. Tracer?.Invoke 삭제
위치: SaveAndLoadFieldScanFromLasaDb 안, newpath 계산 직후 (≈545~548행)
[현재]
string fullpath = inputStr == null ? DB.Dao.SystemRecipe.WorkRecipeFile : inputStr;
string newpath = fullpath.Replace(Path.GetFileName(fullpath), "FieldHelper.json");
// ═══ [진단계측 2026-08-04] 시작 — 원복 시 이 블록 삭제 ═══
Tracer?.Invoke("PAGE 저장 FieldHelper",
$"경로={newpath} 기준={(inputStr == null ? "WorkRecipeFile" : "인자지정")}");
// ═══ [진단계측 2026-08-04] 끝 ═══
DB.RecipeFieldScan.Instance.SaveFieldHelper(newpath);
[원복 후]
string fullpath = inputStr == null ? DB.Dao.SystemRecipe.WorkRecipeFile : inputStr;
string newpath = fullpath.Replace(Path.GetFileName(fullpath), "FieldHelper.json");
DB.RecipeFieldScan.Instance.SaveFieldHelper(newpath);
블록 4줄 삭제입니다. 위아래 원본 줄은 그대로 둡니다.
원복 5. CommonHelper.cs — 훅 연결 삭제
파일: WeldingComponents\WeldingCommon\Utils\CommonHelper.cs
위치: SetMainPage() 안 (≈13~21행)
[현재]
public static void SetMainPage(MainPage mainPage)
{
MainPage = mainPage;
//If Using WeldingManager, This Method Not Necessary.
// ═══ [진단계측 2026-08-04] 시작 — 원복 시 이 블록 삭제 ═══
RecipeTrace.Attach(); // MainPage.Tracer 에 RecipeTrace.Mark 를 연결(참조 방향 우회)
// ═══ [진단계측 2026-08-04] 끝 ═══
}
[원복 후]
public static void SetMainPage(MainPage mainPage)
{
MainPage = mainPage;
//If Using WeldingManager, This Method Not Necessary.
}
빈 줄 포함 4줄 삭제입니다.
원복 6. 설비 PC 로그 파일 삭제
D:\ILSOSConfig\ILSOS_PrismaticRD_PTOP\RecipeTrace.txt
회수·분석이 끝난 뒤 삭제하십시오. 삭제 전에 반드시 사본을 확보하십시오 — 원인 확정의 유일한 근거입니다.
원복 확인
- 저장소 전체에서
[진단계측 2026-08-04]검색 → 소스에서 0건이어야 합니다. (본 문서와 적용 문서 등docs/하위에는 남아 있는 것이 정상입니다.) RecipeTrace검색 → 소스에서 0건.Tracer검색 →MainPage.cs에서 0건.ILSOS_All.slnRelease | x64 빌드 성공.- 기능 확인 — Manual 상태에서 레시피 선택 → 파라미터 수정 → Save → 팝업이 뜨지 않고 정상 저장.
- 페이지 콤보박스 전환 → 정상 동작,
RecipeTrace.txt가 다시 생기지 않음.
git 으로 원복하는 경우
본 계측은 feature/ubisam-pptx-integration 브랜치에서 적용되었습니다. 커밋 전이라면 아래로 한 번에 되돌릴 수 있습니다.
git checkout -- WeldingComponents/WeldingCommon/Utils/RecipeHelper.cs
git checkout -- WeldingComponents/WeldingCommon/Utils/CommonHelper.cs
git checkout -- WeldingComponents/WeldingCommon/WeldingCommon.csproj
git checkout -- WeldingComponents/LASA/GUI/Page/MainPage.cs
del WeldingComponents\WeldingCommon\Utils\RecipeTrace.cs
RecipeTrace.cs 는 신규 파일이라 git checkout 으로는 지워지지 않습니다. 직접 삭제해야 합니다.
이미 커밋했다면 해당 커밋을 git revert 하고, RecipeTrace.cs 가 남아 있는지 확인하십시오.
주의
- 원복 전에 데이터를 먼저 회수하십시오.
RecipeTrace.txt와 팝업 촬영본이 없으면 계측을 넣은 의미가 사라집니다. - 원복은 계측 제거일 뿐 버그 수정이 아닙니다. 원복하면 교차 오염은 그대로 재발합니다.
실제 수정은 선행 문서(
작업지시서_2026-08-03_Laser_Recipe_Save_교차오염.txt)의 1~4단계를 따르십시오. _config_recipe백업은 계측 제거 후에도 당분간 보관하십시오.