세티스 readme 초안
This commit is contained in:
@@ -0,0 +1,172 @@
|
||||
# (주)삼안 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` 또는 보안 설정 파일로 분리 관리 권장.
|
||||
Reference in New Issue
Block a user