# Hanwha Nexacro Demo

업로드/검증 중심의 연결 재무 데모 프로젝트다. 로컬에서는 `Docker Compose`로 API, batch, PostgreSQL, MinIO, Nginx preview를 실행하고, UI 원본은 `spec/nexacro/*.yaml`로 관리한다.

## 구조

- `spec/nexacro`: AI가 직접 수정하는 Nexacro 화면 명세
- `tools/nexacro-gen`: 명세를 Nexacro source와 preview UI로 변환하는 생성기
- `client/nexacro-src`: 생성된 Nexacro 프로젝트 소스
- `client/nexacro-deploy`: preview UI 및 향후 Studio 배포 산출물 위치
- `server/api`: Spring Boot API, batch, report 생성
- `sample-data`: 데모용 업로드 파일
- `docs`: 운영/치환/Windows build 문서
- `ops`: Nginx 설정

## 빠른 시작

1. Nexacro source와 preview를 재생성한다.

```bash
cd tools/nexacro-gen
npm install
npm run generate
```

2. 데모용 Excel 파일을 생성한다.

```bash
python3 scripts/generate_sample_uploads.py
```

3. 전체 스택을 실행한다.

```bash
docker compose up --build
```

4. 브라우저에서 연다.

- Preview UI: `http://localhost:8080`
- MinIO console: `http://localhost:19001`

## 기본 계정

- `admin / demo1234`
- `operator / demo1234`
- `viewer / demo1234`

## 데모 시나리오

1. 로그인
2. 기준정보 확인
3. `sample-data/trial-balance-invalid.xlsx` 업로드 후 오류내역 확인
4. `sample-data/trial-balance-valid.xlsx` 업로드
5. `sample-data/forecast-valid.xlsx` 업로드
6. 집계 실행
7. 배치 완료 후 리포트 다운로드와 로그 확인

## Nexacro 운영 원칙

- 기준 소스는 `spec/nexacro/*.yaml`이다.
- `client/nexacro-src`는 생성 결과물로 취급한다.
- Windows의 Nexacro Studio는 생성된 소스를 열어 검수하고 웹 배포 산출물을 생성하는 용도로 사용한다.