173 lines
9.0 KiB
Markdown
173 lines
9.0 KiB
Markdown
# (주)삼안 ERP 및 그룹웨어 시스템 (Satis) 하이레벨 아키텍처 (High-Level Architecture)
|
|
|
|
본 문서는 (주)삼안의 **ERP 및 그룹웨어 시스템(`saman-statis` / `Satis`)** 프로젝트의 전체 하이레벨 아키텍처(HLA) 명세서입니다.
|
|
시스템의 전체 개요, 계층형 구조, 기술 스택, 업무 도메인뿐만 아니라 **인프라/배포 아키텍처, 보안/인증 아키텍처, 외부 시스템 연동 구조**를 종합적으로 포함합니다.
|
|
*(참고: 압축파일 `*.zip`은 분석에서 제외하였습니다.)*
|
|
|
|
---
|
|
|
|
## 1. 프로젝트 개요 (Project Overview)
|
|
|
|
* **프로젝트명**: 삼안 ERP / 그룹웨어 (`saman-statis` / `Satis`)
|
|
* **운영 도메인**: `satis2.samaneng.com`, `erp.samaneng.com`
|
|
* **시스템 성격**: 엔지니어링/건설 분야 기업 자원 관리(ERP) 및 통합 그룹웨어
|
|
* **주요 기능**: 인사/급여, 회계/전표, 프로젝트/현장 공정, 영업/기성, 전자결재, 고정자산, 출장 정산, 경영분석 등
|
|
|
|
---
|
|
|
|
## 2. 하이레벨 시스템 아키텍처 (High-Level System Architecture)
|
|
|
|
```mermaid
|
|
graph TD
|
|
subgraph Client Tier
|
|
Browser["Web Browser <br/> (HTML5, jQuery, jqGrid, w2ui)"]
|
|
end
|
|
|
|
subgraph Web / Presentation Tier
|
|
WebServer["Web Server <br/> (Windows Server / APM_Setup)"]
|
|
Smarty["Smarty Template Engine v2.6 <br/> (Smarty/templates/Satis/*.tpl)"]
|
|
end
|
|
|
|
subgraph Application Tier
|
|
Controller["MVC Controllers <br/> (Satis/sys/controller/*)"]
|
|
AuthModule["Security & Auth Engine <br/> (AuthClass.php / Session)"]
|
|
BizLogic["Business Models & Utility <br/> (Satis/sys/model/*, OracleClass.php)"]
|
|
end
|
|
|
|
subgraph Data & Integration Tier
|
|
OracleDB[("Main Oracle Database <br/> (OCI Connection)")]
|
|
iCubeDB[("Douzone iCube ERP <br/> (MS-SQL: DZICUBE)")]
|
|
IntranetDB[("Intranet Database <br/> (MySQL: hallaerp)")]
|
|
end
|
|
|
|
Browser <-->|HTTPS / HTTP| WebServer
|
|
WebServer <--> Smarty
|
|
WebServer <--> Controller
|
|
Controller <--> AuthModule
|
|
Controller <--> BizLogic
|
|
BizLogic <-->|OCI Connection| OracleDB
|
|
BizLogic <-->|MS-SQL Driver| iCubeDB
|
|
BizLogic <-->|MySQL Driver| IntranetDB
|
|
```
|
|
|
|
---
|
|
|
|
## 3. 계층별 기술 스택 (Layered Tech Stack)
|
|
|
|
| 계층 (Layer) | 구성 기술 및 디렉토리 | 설명 |
|
|
| :--- | :--- | :--- |
|
|
| **Presentation Tier** | `Smarty 2.6`, `Smarty/templates/Satis/` | Server-Side Rendering (SSR) 뷰 템플릿 엔진 (`.tpl`) |
|
|
| **Client UI Tier** | `jQuery`, `jqGrid`, `w2ui`, `Satis/js/` | 엔지니어링/회계 대용량 동적 그리드 및 사용자 인터랙션 처리 |
|
|
| **Application Tier** | `PHP 5.x`, `Satis/sys/controller/` | Custom MVC Controller (`ActionMode` 라우팅 파라미터 처리) |
|
|
| **Security Tier** | `Satis/sys/util/AuthClass.php` | 세션 보안, CSRF Anti-Forgery Token 검증, 접근 권한 통제 |
|
|
| **Persistence Tier** | `OracleClass.php`, `Satis/inc/*.inc` | Oracle OCI, MS-SQL(iCube), MySQL 다중 DB 연결 지원 |
|
|
|
|
---
|
|
|
|
## 4. 인프라 및 배포 아키텍처 (Infrastructure & Deployment Architecture)
|
|
|
|
```mermaid
|
|
graph LR
|
|
subgraph Infrastructure Layout
|
|
WebSvr["Web Application Server <br/> (APM_Setup / Windows Server)"]
|
|
OracleSvr[("Oracle Database Server <br/> (Main ERP Data)")]
|
|
iCubeSvr[("Douzone iCube Server <br/> (MS-SQL 192.168.13.50:5539)")]
|
|
MySQLSvr[("Intranet MySQL Server <br/> (erp.samaneng.com / hallaerp)")]
|
|
end
|
|
|
|
WebSvr -->|OCI Client| OracleSvr
|
|
WebSvr -->|MS-SQL TCP 5539| iCubeSvr
|
|
WebSvr -->|MySQL TCP 3306| MySQLSvr
|
|
```
|
|
|
|
* **서버 환경**: Windows Server 기반 APM (Apache + PHP + MySQL) 단일/이중화 실행 환경 (`D:/APM_Setup/htdocs/`)
|
|
* **PHP 실행 옵션**:
|
|
* 메모리 제한 해제 (`ini_set("memory_limit", -1)`)를 통한 대용량 프로젝트/연말정산 엑셀 보고서 생성 지원
|
|
* 캐시 무효화 헤더 설정 (`Expires: 0`, `Cache-Control: no-cache`)을 통한 세션 및 보안 강화
|
|
* **경로 및 컴파일 구조**:
|
|
* Smarty 템플릿 컴파일 경로: `D:/APM_Setup/htdocs/Smarty/templates_c`
|
|
* 템플릿 설정 경로: `SmartyConfig.php` 관리
|
|
|
|
---
|
|
|
|
## 5. 보안 및 인증 아키텍처 (Security & Authentication Architecture)
|
|
|
|
```mermaid
|
|
sequenceDiagram
|
|
autonumber
|
|
actor User as 사용자
|
|
participant Controller as Login Controller
|
|
participant Auth as AuthClass
|
|
participant Session as PHP Session
|
|
participant DB as Oracle DB
|
|
|
|
User->>Controller: 로그인 요청 (ID / Password)
|
|
Controller->>DB: 사용자 정보 및 권한 검증
|
|
DB-->>Controller: 인증 성공 반환
|
|
Controller->>Auth: Auth_TokenGenerater() 호출
|
|
Auth->>Session: Session ID & Token 생성/저장
|
|
Session-->>User: Session Cookie 발급 (private)
|
|
|
|
Note over User, Controller: 후속 요청 시 Token 및 Session 권한 검증 (Auth_TokenChecker)
|
|
```
|
|
|
|
1. **세션 및 인증 관리 (Session Management)**
|
|
* PHP 세션 생성 (`session_start()`, `session_cache_limiter('private')`)
|
|
* 사용자 식별자 관리: `$_SESSION['satis_user_id']`, `$_SESSION['satis_user_deptcode']`, `$_SESSION['satis_user_name']`
|
|
2. **CSRF 방어 및 난수 토큰 (Token Security)**
|
|
* `AuthClass.php` 내 10자리 영문/숫자 난수 토큰 생성기 (`Auth_TokenGenerater`) 및 검증기 (`Auth_TokenChecker`) 탑재
|
|
* 비인가 접근 시 자동 세션 파기 (`session_destroy()`) 및 로그인 페이지 전환 (`auth_move_page.tpl`)
|
|
3. **역할 기반 권한 통제 (RBAC / Role-Based Access Control)**
|
|
* `AuthClass` 및 `GetUserInfo.php`를 통해 사용자 직급/부서/권한 등급별 메뉴 접근 권한 세분화
|
|
|
|
---
|
|
|
|
## 6. 외부 시스템 연동 아키텍처 (External System Integration Architecture)
|
|
|
|
이 시스템은 단일 DB에 의존하지 않고, 사내 타 이종(Heterogeneous) 시스템과 실시간 연결되는 하이브리드 데이터 아키텍처를 가집니다.
|
|
|
|
```mermaid
|
|
graph TD
|
|
SatisCore["Satis ERP Core System"]
|
|
|
|
SatisCore <-->|OCI Native Connection| OracleSystem["메인 그룹웨어/ERP DB (Oracle)"]
|
|
SatisCore <-->|MS-SQL Driver (Port 5539)| iCubeSystem["더존 iCube ERP (MS-SQL: DZICUBE) <br/> IP: 192.168.13.50"]
|
|
SatisCore <-->|MySQL Driver (Port 3306)| IntranetSystem["인트라넷 시스템 (MySQL: hallaerp) <br/> Host: erp.samaneng.com"]
|
|
```
|
|
|
|
1. **더존 iCube ERP 연동 (`saman_icube_dbcon.inc`)**
|
|
* **연동 목적**: 사내 더존 회계/인사 ERP 데이터와의 실시간 동기화 및 전표 전송
|
|
* **접속 방식**: Dedicated MS-SQL Connection (`192.168.13.50:5539`, DB명: `DZICUBE`)
|
|
2. **사내 인트라넷 연동 (`dbcon.inc`)**
|
|
* **연동 목적**: 인트라넷 기존 데이터 및 파일 연결
|
|
* **접속 방식**: MySQL Connection (`erp.samaneng.com`, DB명: `hallaerp`)
|
|
3. **메인 Oracle DB 연동 (`OracleClass.php`)**
|
|
* **연동 목적**: Satis 그룹웨어 고유의 결재, 인사, 프로젝트, 출장, 자산 관리 데이터 처리
|
|
* **접속 방식**: Oracle OCI8 라이브러리 및 커스텀 트랜잭션 바인딩 처리
|
|
|
|
---
|
|
|
|
## 7. 주요 업무 도메인 서브시스템 (Business Subsystems)
|
|
|
|
| 도메인 구분 | 서브시스템 모듈 | 아키텍처적 역할 및 주요 처리 기능 |
|
|
| :--- | :--- | :--- |
|
|
| **회계/재무** | `Account` | 전표 생성/승인, 예산 관리, 결산, 재무제표, 법인세/부가세, 원가 계산 |
|
|
| **인사/급여** | `Person` | 인사기록, 근태 관리, 급여/상여 계산, 연말정산(`yeta_data`) 처리 |
|
|
| **프로젝트/공정** | `Project`, `Project_work` | 엔지니어링 프로젝트 현장 관리, 공정률 계산, 기성 산출, 수주/매출 처리 |
|
|
| **전자결재/문서** | `Document`, `Sign` | 전자결재 작성, 양식/결재선 관리, 전자서명 및 인장 관리 |
|
|
| **영업/구매** | `Sale`, `Purchase` | 수주/매출 관리, 자재 구매 신청 및 발주 처리 |
|
|
| **자산/도서/출장** | `Asset`, `Book`, `Travel` | 고정자산 추적, 도서 대여 관리, 국내/외 출장 신청 및 여비 정산 |
|
|
| **시스템 관리** | `Supervisor`, `Common` | 전체 공정/부서/직급 코드 관리 (`CommonCodeList.php`), 관리자 권한 설정 |
|
|
|
|
---
|
|
|
|
## 8. 아키텍처 총평 및 고려사항 (Architectural Evaluation)
|
|
|
|
1. **강점 (Strengths)**:
|
|
* **명확한 모듈화**: 업무 도메인별 Controller, Model, View가 체계적으로 분리되어 있어 대규모 ERP 시스템의 확장성이 확보되어 있습니다.
|
|
* **이종 DB 유연성**: Oracle, MS-SQL(더존 iCube), MySQL을 동시에 연동하는 하이브리드 데이터 아키텍처를 안정적으로 운영합니다.
|
|
* **대용량 그리드 최적화**: `jqGrid` 라이브러리와 메모리 해제 조치(`ini_set`)를 통해 수만 건 이상의 공정/회계 데이터 조회를 지원합니다.
|
|
2. **향후 아키텍처 개선 제언 (Future Roadmap)**:
|
|
* **PHP 버전을 현대화**: Classic PHP 드라이버(`mssql_*`, `mysql_*`)를 최신 `PDO` 또는 `sqlsrv`/`mysqli`로 마이그레이션 권장.
|
|
* **하드코딩된 DB 접속 정보 격리**: `saman_icube_dbcon.inc` 등의 DB 계정 정보를 `.env` 또는 보안 설정 파일로 분리 관리 권장.
|