64 lines
1.8 KiB
Markdown
64 lines
1.8 KiB
Markdown
# 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는 생성된 소스를 열어 검수하고 웹 배포 산출물을 생성하는 용도로 사용한다.
|