📥 프로젝트 소스: 들어온 모든 파일을 날짜별로

모든 프로젝트에는 두 영역이 있습니다.

• 소스 — 나와 팀이 제공한 모든 파일. Telegram 그룹, Google 드라이브 폴더, 이 컴퓨터의 폴더에서 들어온 파일, 파일 가져오기로 한 번 가져온 파일, 직접 추가한 파일입니다. 디스크에서는 프로젝트의 sources/ 폴더입니다.
• 작업 — 그 밖의 모든 것. 나와 에이전트가 자유롭게 정리하며 정해진 폴더는 없습니다. 정기 보고서는 다른 곳을 지정하지 않으면 reports/<YYYY-MM>/에 저장됩니다.

프로젝트에는 숨김 폴더 .amba/도 있어 AMBA가 자체 상태(프로젝트에 대해 파악한 내용, 파일의 이전 버전)를 보관합니다. 열어 볼 필요는 없습니다.

파일 트리에서는 두 영역이 소스(소스 → 날짜)와 작업(자유로운 트리)으로 표시됩니다.

---

1. 에이전트는 소스를 절대 바꿀 수 없습니다

에이전트, 프로세스, Office 처리 엔진, 모델이 작성한 스크립트, 테스트 실행은 소스를 읽을 수는 있지만 소스나 .amba/ 안에서 쓰기, 이동, 이름 바꾸기, 삭제를 전혀 할 수 없습니다. 이는 모든 파일 작업과 모든 모드에서 앱이 강제하는 규칙으로, 설정이 아니며 어떤 권한이나 승인으로도 해제할 수 없습니다. 결과는 항상 작업 영역의 새 파일로 저장됩니다.

프로젝트 밖에 있는 파일(Drive 폴더, 컴퓨터의 폴더)은 소스로 복사되며, 원본은 그대로 남고 절대 손대지 않습니다.

2. 소스 파일은 직접 수정할 수 있습니다

소스는 에이전트에게만 읽기 전용이며, 사용자에게는 아닙니다. 파일을 직접 고치면(예: Excel에서):

• AMBA가 이전 버전을 보관합니다. 파일 트리에서 그 파일에 기록 아이콘이 붙고, ⋯ → 파일 기록에서 이전 버전을 볼 수 있습니다.
• 이전 버전에 기반한 수치와 보고서는 다시 확인하도록 표시됩니다. 그 파일의 날짜에는 *""…" 파일이 보고서 "…"에 사용된 뒤 바뀌었습니다 — 다시 실행하세요"*와 다시 실행 버튼이 나타납니다.

앱에서 소스 파일을 삭제할 수도 있으며, 그 내용은 기록에 남습니다.

3. '최종본'은 폴더가 아니라 상태입니다

프로세스가 전달한 파일, 또는 직접 표시한 파일(파일 트리의 최종본으로 표시, 취소는 최종본 표시 해제)이 최종본입니다. 최종본 파일은 어디에 저장되어 있든 최종본 배지가 붙습니다. 원한다면 나만의 final/ 폴더를 계속 써도 됩니다.

4. 파일 종류

파일이 들어오면 AMBA는 AI 없이 다음을 기록합니다.

• 파일이 속한 영업일(내용, 제목, 파일 이름, 함께 온 메시지, 받은 시각으로 판단)
• 종류(예: "매출 보고서", "비용"). 파일의 구조(시트 이름, 열, 제목)로 알아봅니다
• 보낸 사람, 중복인지, 이미 받은 파일의 새 버전인지
• 어느 프로세스 실행이나 보고서에서 언제 사용했는지

새 구조의 파일이 처음 들어오면 AMBA가 한 번만 제안과 함께 이 파일은 어떤 종류인가요? 하고 묻습니다(내 Telegram 채팅에서도). 한 번 이름을 붙이면 이후 같은 종류의 파일은 자동으로 알아봅니다. 데모 매장에서는 두 종류에 이름을 붙이는 것만으로 43개 파일이 모두 분류되었습니다. 프로젝트 설정 → 파일 종류에서 AMBA가 익힌 종류의 이름을 바꾸거나 합칠 수 있습니다.

5. 소스는 파일 트리의 항목입니다

파일 트리의 소스 아래에서 소스마다 하나의 항목이 됩니다. 예: Telegram · 회계 그룹, Drive · 지점 보고서, 폴더 · 청구서. 항목에는 상태 점이 있습니다. 초록은 받는 중, 노랑은 확인 필요(아직 파일 없음, 일시 중지, 일시적 오류), 빨강은 받기가 멈춘 상태(다시 로그인 필요, 봇이 그룹을 읽지 못함, 폴더가 없음)입니다. 직접 추가한 파일은 직접 업로드에 있습니다.

각 소스 아래에는 날짜가 있고, 오른쪽의 작은 배지는 그 소스의 파일만 셉니다.

배지	의미	클릭하면
✓	그날의 파일이 보고서에 사용됨	어떤 보고서, 언제, 어떤 실행인지
종류 불명 N	새 형식의 파일이 있음	이 파일은 어떤 종류인가요? — 그 자리에서 답하기
날짜 필요 N	날짜가 불분명한 파일이 있음	날짜 선택(또는 날짜 없음)
⚠	파일은 있지만 보고서가 없거나, 보고서 후 파일이 바뀜	이유와 해결 버튼: 지금 실행, 다시 실행, 프로세스 보기, 다시 로그인

배지에 마우스를 올리면 이유를 읽을 수 있고, 모든 해결은 트리에서 두 번 클릭 이내입니다. 종류를 모르는 파일에는 작은 점이 붙습니다. 파일의 ⋯ → 파일 기록에서 그 파일을 사용한 보고서와 AMBA가 보관한 이전 버전을 볼 수 있습니다.

소스 열기

소스를 클릭하면 파일처럼 탭으로 열립니다(닫기, 다시 열기, 전환). 본문은 가져오기 기록으로, 최신순·날짜별입니다. AMBA가 소스를 확인할 때마다 시각과 하나의 결과가 한 줄이 됩니다.

• ✓ 새 파일 N개 — 파일 이름과 보낸 사람(Telegram 그룹) 또는 "폴더에서"
• – 새 파일 없음 — 아무것도 없는 확인이 이어지면 한 줄로 묶습니다: 새 파일 없음 (17회)
• ⚠ N개 건너뜀 — 이유와 함께: 이미 있는 파일과 같은 내용, 너무 큼(Telegram 봇은 최대 20 MB), AMBA가 읽지 않는 형식(설치 프로그램), Office 임시 파일(~$…), 다운로드할 수 없는 Google 파일
• ✗ 오류 — 예: Google에 다시 로그인해야 합니다, 다시 로그인 버튼과 함께. 같은 오류의 반복은 묶습니다: 06:00부터 12회 반복

종류를 모르는 파일의 줄에는 분류 버튼이 있습니다. 아래로 스크롤(또는 더 보기)하면 이전 기록이 보입니다. 기록은 90일 동안 보관됩니다.

탭 오른쪽의 설정 버튼으로 설정 패널을 열고 닫으며, 선택은 기억됩니다. 패널은 소스 종류에 따라 다릅니다.

• Telegram 그룹 — 봇, 그룹(이름으로 선택), 날짜가 불명확하면 묻기(나, 디렉터리의 누군가, 묻지 않음), Telegram에서 파일 종류 묻기
• Google 드라이브 폴더 — 계정(Google이 요구하면 그 자리에서 다시 로그인), 폴더(이름으로 선택), 이미 있는 파일도 가져오기, 하위 폴더
• 이 컴퓨터의 폴더 — 경로, 이미 있는 파일도 가져오기

아래에는 확인, 일시 중지 / 재개, 소스 삭제가 있습니다. 소스를 삭제해도 파일은 지워지지 않으며 받은 파일은 소스에 남습니다. 프로세스가 읽고 있는 소스는 삭제할 수 없으니 먼저 그 프로세스를 일시 중지하거나 변경하세요.

직접 업로드도 탭으로 열려, 추가한 파일을 시간순으로 보여 줍니다.

소스 추가

소스 제목의 **⋯**에는 파일 업로드, 소스 추가 ▸ Telegram · Drive · 폴더, **Drive에서 파일 가져오기 (한 번)**가 있습니다. 소스 추가는 설정 패널이 있는 새 탭을 엽니다. 소스 추가를 누르면 소스가 트리에 나타나고 탭이 그 소스의 탭이 됩니다. Telegram 그룹을 추가하면 그 그룹이 프로젝트 디렉터리에도 (한 번) 저장되어 프로세스에서 이름으로 부를 수 있습니다.

특정 날에 속하지 않는 파일(직원 명단, 가격표)은 소스의 날짜 없음 폴더나 직접 업로드에 있습니다. 프로세스 → 소스와 파일 소스도 참고하세요.

6. 0.5.13 이전 버전에서 만든 프로젝트

이전 프로젝트는 세 개의 고정 폴더(input/, workings/, output/)를 사용했습니다. 업데이트 후 처음 시작할 때 AMBA가 한 번만 옮깁니다.

• input/ 중 소스에서 들어온 파일은 소스의 해당 소스 날짜로 옮깁니다.
• input/의 나머지는 하위 폴더를 유지한 채 sources/uploads/로 옮깁니다.
• workings/와 output/는 그대로, 작업 영역의 일반 폴더로 남습니다.

한 번만 나오는 알림 받은 파일이 이제 소스에 있습니다에서 옮긴 파일 수를 알려 줍니다. 프로세스, 파악한 사실, 파일 참조도 함께 업데이트되므로 다시 설정할 필요가 없습니다. 옮길 수 없는 파일이 있으면(예: 이름은 같지만 내용이 다른 파일이 이미 소스에 있는 경우) 아무것도 옮기지 않고 알림에 이유가 표시됩니다.