Timesheet Guardian 사용하기 → 이 페이지는 브라우저의 입력을 확인하고 실시간 차트를 그립니다. 실제 양식은 mikweb.eu/form/zeitwaechter (근무 시간)과 /zeitwaechter-abwesenheit (결석)에 있습니다. 모든 데이터는 데모 데이터이며 인물은 가상의 인물입니다 (Musterbüro GmbH).
왜 필요한가
2022년 9월 13일 연방 노동 법원(Federal Labour Court) 판결 이후, 독일 고용주는 근무 시간을 기록해야 합니다. 스프레드시트가 종종 이 역할을 수행합니다. 하지만 그것은 누군가가 어제 적절한 휴식 없이 11시간을 일했고 오늘 아침 6시에 다시 시작했다는 사실을 알려주지 못합니다. 이는 보통 월말에 목록을 검토할 때 드러납니다. 저는 위반 사항이 n8n, Nextcloud 및 CSV라는 것 외에는 더 화려하지 않은 장치로 같은 저녁에 카드와 메시지를 트리거하기를 원했습니다.
법적 지위: 기록 의무는 2022년부터 적용되었습니다. 근로시간법(Working Hours Act) 개혁안(연방 노동부 초안)은 제가 아는 한 2026년 6월까지 통과되지 않았습니다. 현재 상황을 확인해 보세요. 이것은 기술적인 예시이며 법적 조언이 아닙니다.
워크플로우가 하는 일
- 두 개의 n8n 양식: 근무 시간(person, date, start, end, break, project, activity) 및 결석(person, from, to, kind: vacation, sick leave 또는 flextime off).
- 입력값 검증: (형식, 시간, 날짜)을 검증한 후 WebDAV를 통해 Nextcloud의
zeiten.csv에 저장합니다.
- ArbZG 확인: 모든 행에 걸쳐 확인하고, 그 다음 항목 입력 전 상태와 비교합니다: 새로운 위반 사항만 무언가를 트리거합니다.
- 새로운 위반 발생 시: Nextcloud Deck의 카드와 Talk 메시지를 통해 알림이 전송됩니다.
- 결석 처리: CalDAV 이벤트를 생성합니다. 두 번째 확인 과정은 결석일에 기록된 근무 시간을 찾아냅니다.
- 금요일 15:00: Nextcloud 및 Talk에 마크다운(Markdown) 형식과 SVG 대시보드 형태의 주간 보고서가 제공됩니다.
- 월요일: 데모 데이터가 초기화됩니다.
규칙들
– 섹션 3: 하루 최대 10시간, 평균 8시간.
– 섹션 4: 6시간 초과 후 30분 휴식, 9시간 초과 후 45분 휴식.
– 섹션 5: 근무일 사이에 11시간의 중단 없는 휴식.
– 섹션 9: 일요일 근무.
– 참고 사항(Hint): 주당 48시간 초과. 이는 위반이 아닌 참고 사항입니다. 법은 평균으로 작동합니다.
모든 것은 **결정론적 코드(deterministic code)**입니다(
core.js에서 100개 이상의 검사가 node test_core.js에서 통과). AI(IONOS gpt-oss-120b)는 주간 보고서의 세 문장만 작성하며 이름은 보지 않고 숫자만 봅니다. 누가 법을 위반했는지 여부는 언어 모델에 의해 결정되지 않습니다.
동시 쓰기 작업: ETag 및 If-Match
두 사람이 동시에 제출하고, 둘 다 CSV를 읽고, 다시 작성하면 하나의 항목이 사라집니다. 따라서 WebDAV를 이용한 낙관적 잠금(optimistic locking)을 사용합니다. GET은 파일과 그 ETag를 반환하고, PUT은 If-Match: <ETag>를 전송합니다. 중간에 파일이 변경되면 Nextcloud는 412 Precondition Failed로 응답합니다. 워크플로우는 다시 읽고 최대 세 번까지 재시도합니다. 세 번째 실패 후에는 조용히 덮어쓰기 하는 대신 그 사실을 알립니다.
n8n 2.46.6에서 배운 것들
- 'Respond When'을 'Using Respond to Webhook'으로 설정하지 마십시오. Form Trigger v2.5와 n8n Form 노드를 사용할 경우, "Form Trigger로 시작된 워크플로우에서는 Respond to Webhook이 지원되지 않습니다" 또는 "No Respond to Webhook node found"라는 메시지가 나타납니다. 기본 설정을 유지하십시오. Form 노드가 응답을 제공합니다.
- Form 노드의 Completion 작업은 'Show Text'를 통해 전체 HTML을 허용합니다. 이 응답에는 인라인 SVG 차트를 포함한 전체 페이지가 될 수 있습니다. 작동 방식: 폼 POST는
formWaitingUrl이 포함된 JSON을 반환하고, 브라우저는 /form-waiting/<id>로 이동하며 해당 페이지가 표시됩니다.
- 전체 응답 및 텍스트를 가진 HTTP Request의 경우: 내용은
body가 아닌 data에 있습니다. 제 res.body는 undefined였고 CSV 파일은 단일 행으로 재작성되었습니다. 이후 데이터 손실 방지 장치가 추가되었습니다. 즉, 파싱 결과가 비어 있지만 파일 자체가 비어있지 않은 경우, 쓰기 작업을 수행하는 대신 실행이 중단됩니다.
- 어떤 트리거가 작동했는지 확인하려면?
$('Node').isExecuted를 확인하십시오. 이를 통해 하나의 워크플로우로 모든 트리거에 대응할 수 있습니다.
- Code 노드에는
URL 클래스가 없습니다. 정규 표현식(regular expressions)을 사용해야 합니다.
- CSV 주입(injection).
= , + , - 또는 @로 시작하는 셀 앞에는 '가 붙습니다. 그렇지 않으면 Excel은 프로젝트 이름에 숨겨진 수식을 실행합니다.
- Nextcloud WebDAV: GET에서 가져온 ETag를 사용한
If-Match가 작동하며, 오래된(stale) ETag는 412 상태 코드를 반환합니다. 이것이 바로 필요한 기능입니다.
직접 시도하고 다운로드하기
워크플로우 JSON 다운로드 → 이를 가져와서(Import), 사용자의 Nextcloud 및 IONOS 자격 증명 정보를 추가하고, Nextcloud 경로, 덱 보드(Deck board), 대화방(Talk room)을 조정하십시오. JSON에는 비밀 정보가 없습니다. AI 문장은 선택 사항입니다. 자격 증명이 없어도 보고서는 숫자 데이터를 유지합니다.
제한 사항
이것은 프로덕션 시간 기록 시스템이 아닌 데모 설정입니다. 데이터는 가상의 것입니다. 노사위원회(works council)도 없고, 단체 협약(collective agreements)도 없으며, 제7조 또는 분야별 규정(돌봄, 접객업, 운송 등)에 따른 예외 사항도 없습니다. 또한 미성년자, 임산부 직원, 운전자에게는 다른 규칙이 적용됩니다. 기준점은 법률의 문구를 따르지만, 귀사에 정통한 사람의 검토를 대체할 수는 없습니다. 개혁으로 변경된 내용은 여기에 포함되어 있지 않으니, 현재 상태에 대해 반드시 읽어보시기 바랍니다.
관련 자료: the Rubber Stamp Test는 "사람이 직접 확인하는 것"만으로는 충분하지 않은 이유를 보여줍니다. 여기서는 코드가 검사를 수행하고, 사람은 중요한 사례만 볼 수 있습니다.
원래 게시된 곳: daniele-michelin.com. 더 많은 가이드, 무료 검사(SPF, TLS, 헤더), 그리고 오류 메시지 사전: daniele-michelin.com/en/.