From ff6a43ab490da94db2e46bed3a7fb6c3a1b26252 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=EB=A5=98=ED=98=B8=EC=84=B1?= Date: Mon, 20 Jul 2026 11:11:25 +0900 Subject: [PATCH] =?UTF-8?q?=EC=84=B8=ED=8B=B0=EC=8A=A4=20=EC=9A=94?= =?UTF-8?q?=EC=95=BD?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 문서/architecture_high.md | 418 +++++++++++++++++++++++++++++--------- 1 file changed, 320 insertions(+), 98 deletions(-) diff --git a/문서/architecture_high.md b/문서/architecture_high.md index 96aa484..b66167c 100644 --- a/문서/architecture_high.md +++ b/문서/architecture_high.md @@ -1,17 +1,23 @@ -# (주)삼안 ERP 및 그룹웨어 시스템 (Satis) 하이레벨 아키텍처 (High-Level Architecture) +# (주)삼안 ERP 및 그룹웨어 시스템 (Satis) 하이레벨 아키텍처 명세서 v5 본 문서는 (주)삼안의 **ERP 및 그룹웨어 시스템(`saman-statis` / `Satis`)** 프로젝트의 전체 하이레벨 아키텍처(HLA) 명세서입니다. -시스템의 전체 개요, 계층형 구조, 기술 스택, 업무 도메인뿐만 아니라 **인프라/배포 아키텍처, 보안/인증 아키텍처, 외부 시스템 연동 구조**를 종합적으로 포함합니다. -*(참고: 압축파일 `*.zip`은 분석에서 제외하였습니다.)* +시스템 개요, 계층 구조, 기술 스택, 업무 도메인, **인프라/배포, 보안/인증, 외부 시스템 연동, 프론트엔드 아키텍처, 개발 운영 구조**를 종합적으로 포함합니다. +*(압축파일 `*.zip`은 분석에서 제외하였습니다.)* --- ## 1. 프로젝트 개요 (Project Overview) -* **프로젝트명**: 삼안 ERP / 그룹웨어 (`saman-statis` / `Satis`) -* **운영 도메인**: `satis2.samaneng.com`, `erp.samaneng.com` -* **시스템 성격**: 엔지니어링/건설 분야 기업 자원 관리(ERP) 및 통합 그룹웨어 -* **주요 기능**: 인사/급여, 회계/전표, 프로젝트/현장 공정, 영업/기성, 전자결재, 고정자산, 출장 정산, 경영분석 등 +| 항목 | 내용 | +| :--- | :--- | +| **프로젝트명** | 삼안 ERP / 그룹웨어 (`saman-statis` / `Satis`) | +| **운영 도메인** | `satis.samaneng.com`, `erp.samaneng.com` | +| **시스템 성격** | 엔지니어링/건설 분야 기업 자원 관리(ERP) 및 통합 그룹웨어 | +| **회사명** | (주)삼안 | +| **사업자등록번호** | 211-81-25425 | +| **시스템 식별코드** | `SAMAN` | +| **주요 기능** | 인사/급여, 회계/전표, 프로젝트/공정, 영업/기성, 전자결재, 고정자산, 출장정산, 경영분석 | +| **DB 연동** | Oracle(메인 ERP), MS-SQL(더존 iCube ERP), MySQL(사내 인트라넷) | --- @@ -19,78 +25,175 @@ ```mermaid graph TD - subgraph Client Tier - Browser["Web Browser
(HTML5, jQuery, jqGrid, w2ui)"] + subgraph "Client Tier" + Browser["Web Browser
(HTML5, jQuery, jqGrid, w2ui, amCharts)"] end - subgraph Web / Presentation Tier - WebServer["Web Server
(Windows Server / APM_Setup)"] - Smarty["Smarty Template Engine v2.6
(Smarty/templates/Satis/*.tpl)"] + subgraph "Web / Presentation Tier" + WebServer["Web Server
(Windows Server / APM_Setup / Apache)"] + Smarty["Smarty Template Engine v2.6
(Smarty/templates/Satis/*.tpl)"] end - subgraph Application Tier - Controller["MVC Controllers
(Satis/sys/controller/*)"] - AuthModule["Security & Auth Engine
(AuthClass.php / Session)"] - BizLogic["Business Models & Utility
(Satis/sys/model/*, OracleClass.php)"] + subgraph "Application Tier" + Controller["MVC Controllers
(Satis/sys/controller/*)"] + AuthModule["Security & Auth Engine
(AuthClass.php / LoginInfomation.php)"] + BizLogic["Business Logic Models
(Satis/sys/model/*)"] + CommonUtil["공통 유틸리티
(OracleClass.php / CommonCodeList.php)"] end - subgraph Data & Integration Tier - OracleDB[("Main Oracle Database
(OCI Connection)")] - iCubeDB[("Douzone iCube ERP
(MS-SQL: DZICUBE)")] - IntranetDB[("Intranet Database
(MySQL: hallaerp)")] + subgraph "Data & Integration Tier" + OracleDB[("Oracle DB (Main ERP)
TNS: samandb
User: satis")] + iCubeDB[("Douzone iCube ERP
MS-SQL: DZICUBE
192.168.13.50:5539")] + IntranetDB[("Intranet MySQL
hallaerp
erp.samaneng.com")] 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 + subgraph "External Services" + SMS["SMS 발송 서비스
(sms_controller.php)"] + PDF["PDF 생성 서비스
(pdf_controller.php)"] + OTP["OTP 인증 서비스
(SM_ERPURL_OTP)"] + end + + Browser <-->|HTTPS / HTTP| WebServer + WebServer <--> Smarty + WebServer <--> Controller + Controller <--> AuthModule + Controller <--> BizLogic + BizLogic <--> CommonUtil + CommonUtil <-->|OCI Connection| OracleDB + BizLogic <-->|MS-SQL Port 5539| iCubeDB + BizLogic <-->|MySQL Port 3306| IntranetDB + BizLogic --> SMS + BizLogic --> PDF + CommonUtil <-->|OTP 검증| OTP ``` --- ## 3. 계층별 기술 스택 (Layered Tech Stack) -| 계층 (Layer) | 구성 기술 및 디렉토리 | 설명 | +| 계층 (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 연결 지원 | +| **Client UI Tier** | `jQuery 1.11.3`, `jqGrid`, `w2ui`, `amCharts 3.20.15`, `dtree` | 대용량 그리드, 팝업 트리, 차트, 달력 처리 | +| **Presentation Tier** | `Smarty 2.6`, `Smarty/templates/Satis/` | SSR `.tpl` 기반 뷰 엔진. 각 화면은 `{$변수명}`으로 PHP 데이터 바인딩 | +| **Application Tier** | `PHP 5.x`, `Satis/sys/controller/` | `ActionMode` 파라미터 분기 라우팅. Controller → Model 1:1 호출 구조 | +| **Auth / Session** | `AuthClass.php`, `LoginInfomation.php` | 세션 생성, CSRF 토큰, 개인 권한(Certificate) 검증, 세션 만료 리다이렉트 | +| **Business Logic** | `Satis/sys/model/`, `Satis/inc/*.php` | 도메인별 Logic 클래스, 전자결재 함수, 공통 헬퍼 | +| **Data Access** | `OracleClass.php` | Oracle OCI8, Ref Cursor Proc, 다형 출력(`array`/`json`/`jsonchart`/Smarty) | +| **DB / Persistence** | Oracle(`samandb`), MS-SQL(`DZICUBE`), MySQL(`hallaerp`) | 이종 3-DB 동시 운영 | --- -## 4. 인프라 및 배포 아키텍처 (Infrastructure & Deployment Architecture) +## 4. 전체 폴더 구조 (Directory Structure) + +```text +d:\41.dev\10.saman\ +├── SmartyConfig.php # Smarty 엔진 경로 설정 (절대경로 하드코딩) +├── index.php # 루트 엔트리 → 로그인 화면 리다이렉트 +│ +├── Satis/ # 메인 웹 애플리케이션 루트 +│ ├── css/ # 전역 CSS 스타일시트 +│ ├── fonts/ # 웹 폰트 +│ ├── images/ # UI 이미지 +│ ├── jqgrid/ # jqGrid 라이브러리 +│ ├── js/ # 프론트엔드 JavaScript (88개 파일) +│ │ ├── common.js, common2.js, common3.js # 공통 UI 함수 +│ │ ├── common_jqGrid.js (214KB) # jqGrid 공통 래퍼 (주 버전) +│ │ ├── common_bigdata_grid.js (50KB) # 대용량 가상 스크롤 그리드 +│ │ ├── SlipTemp.js (182KB) # 전표 작성 전용 클라이언트 로직 +│ │ ├── SlipConfirm.js (147KB) # 전표 확정 처리 +│ │ ├── ProjectScreen06.js (115KB) # 프로젝트 기성 화면 +│ │ ├── ProjectScreen07.js (111KB) # 프로젝트 원가 화면 +│ │ ├── GenerateDate.js # 날짜 생성 유틸 +│ │ ├── erp_PrintAgent.js # 인쇄 에이전트 +│ │ ├── amcharts_3.20.15.free/ # 경영분석 차트 라이브러리 +│ │ ├── jqgrid/, jquery/, w2ui/, w2ui-1.5/ # 서드파티 라이브러리 +│ │ └── pdfviwer/ # PDF 뷰어 +│ ├── layout/ +│ │ ├── Layout.html # 단일 프레임 레이아웃 +│ │ └── Layout2.html # 분할 프레임 레이아웃 +│ └── sys/ # Backend 핵심 디렉토리 +│ ├── controller/ # MVC 컨트롤러 (21개 모듈 디렉토리) +│ │ ├── Login/ # 인증, 로그아웃, 메뉴, 즐겨찾기 +│ │ ├── Account/ # 회계 (30개 컨트롤러) +│ │ ├── Person/ # 인사/급여 (23개 컨트롤러) +│ │ ├── Project/ # 프로젝트 (15개 컨트롤러) +│ │ ├── Project_work/ # 프로젝트 현장 업무 (16개 컨트롤러) +│ │ ├── Document/ # 전자결재 +│ │ ├── Sign/ # 전자서명 문서 (3개 컨트롤러) +│ │ ├── Sale/ # 영업 (9개 컨트롤러) +│ │ ├── Purchase/ # 구매 (4개 컨트롤러) +│ │ ├── Travel/ # 출장 +│ │ ├── Asset/ # 자산 (3개 컨트롤러) +│ │ ├── Book/ # 도서 관리 +│ │ ├── Association/ # 협회 관리 +│ │ ├── Management/ # 코드/권한/알림 관리 (4개 컨트롤러) +│ │ ├── Supervisor/ # 시스템 관리자 기능 +│ │ ├── Common/ # 공통 팝업, SMS, PDF, OTP (17개 컨트롤러) +│ │ ├── Jqgrid/ # jqGrid JSON 데이터 응답 +│ │ └── Fileupload/ # 파일 업로드 처리 +│ ├── model/ # 비즈니스 로직 (모듈별 Logic 클래스) +│ ├── util/ # 시스템 유틸리티 클래스 +│ │ ├── OracleClass.php # Oracle OCI 커넥션 핵심 클래스 (1,392라인) +│ │ ├── AuthClass.php # CSRF 토큰 / 세션 보안 (591라인) +│ │ ├── LoginInfomation.php # 로그인 상태 / 개인 권한 검증 +│ │ ├── CommonCodeList.php # 공통 코드 인메모리 캐시 (294KB) +│ │ ├── DefaultInformation.php # 시스템 전역 변수 초기화 +│ │ ├── GetUserInfo.php # 세션 사용자 정보 초기화 +│ │ └── ReportViewExcel.php # Excel 보고서 출력 +│ ├── inc/ # 모듈 공통 include 파일 (21개 파일) +│ │ ├── approval_function.php # 전자결재 처리 함수 (1,224라인) +│ │ ├── approval_var.php # 전자결재 상태 상수 정의 +│ │ ├── function.php # 공통 헬퍼 함수 (1,093라인) +│ │ ├── function_add.php # 추가 헬퍼 함수 (32KB) +│ │ ├── function_intranet.php # 인트라넷 전용 함수 (33KB) +│ │ ├── dbcon.inc # MySQL 인트라넷 커넥션 +│ │ ├── dbcon_security.inc # 보안 DB 커넥션 +│ │ └── getNeedDate.php # 날짜 계산 유틸 +│ ├── log/ # SQL 실행 로그 (날짜별 txt 파일) +│ └── yeta_data/ # 연말정산 데이터 파일 +│ +└── Smarty/ # Smarty 템플릿 엔진 디렉토리 + ├── templates/ + │ ├── Satis/ # 22개 모듈 템플릿 디렉토리 + │ │ ├── Login/ # 81개 .tpl (로그인, 메인, 환경설정, 알림) + │ │ ├── Account/ # 회계 화면 템플릿 + │ │ ├── Person/ # 인사/급여 화면 템플릿 + │ │ └── ... (나머지 모듈) + │ ├── Eis/, Overseas/, spo_mng/ # 타 시스템 템플릿 + └── templates_c/ # Smarty 컴파일 캐시 (자동 생성) +``` + +--- + +## 5. 인프라 및 배포 아키텍처 (Infrastructure & Deployment Architecture) ```mermaid graph LR - subgraph Infrastructure Layout - WebSvr["Web Application Server
(APM_Setup / Windows Server)"] - OracleSvr[("Oracle Database Server
(Main ERP Data)")] - iCubeSvr[("Douzone iCube Server
(MS-SQL 192.168.13.50:5539)")] - MySQLSvr[("Intranet MySQL Server
(erp.samaneng.com / hallaerp)")] + subgraph "서버 인프라" + WebSvr["Web App Server
(Windows Server
APM_Setup D:/APM_Setup/htdocs/)"] + OracleSvr[("Oracle DB Server
TNS: samandb
User: satis")] + iCubeSvr[("Douzone iCube Server
MS-SQL 192.168.13.50:5539
DB: DZICUBE / User: DZGUEST")] + MySQLSvr[("Intranet MySQL
erp.samaneng.com
DB: hallaerp")] end - WebSvr -->|OCI Client| OracleSvr - WebSvr -->|MS-SQL TCP 5539| iCubeSvr - WebSvr -->|MySQL TCP 3306| MySQLSvr + WebSvr -->|OCI8 클라이언트| OracleSvr + WebSvr -->|TCP 5539 mssql_connect| iCubeSvr + WebSvr -->|TCP 3306 mysql_connect| 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` 관리 +| 항목 | 내용 | +| :--- | :--- | +| **WAS 환경** | Windows Server + APM_Setup (Apache + PHP 5.x + MySQL) | +| **배포 경로** | `D:/APM_Setup/htdocs/` | +| **Smarty 컴파일 경로** | `D:/APM_Setup/htdocs/Smarty/templates_c/` | +| **PHP 메모리 설정** | `ini_set("memory_limit", -1)` — 대용량 Excel/연말정산 처리용 | +| **캐시 무효화 헤더** | `Expires: 0`, `Cache-Control: no-cache, must-revalidate` | +| **로그 파일 위치** | `Satis/sys/log/YYYY-MM-DD_{메소드명}.txt` (날짜별 자동 생성) | +| **연말정산 데이터** | `Satis/sys/yeta_data/` (`.425` 확장자 데이터 파일) | --- -## 5. 보안 및 인증 아키텍처 (Security & Authentication Architecture) +## 6. 보안 및 인증 아키텍처 (Security & Authentication Architecture) ```mermaid sequenceDiagram @@ -98,75 +201,194 @@ sequenceDiagram actor User as 사용자 participant Controller as Login Controller participant Auth as AuthClass + participant LoginInfo as LoginInfomation 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 생성/저장 + Controller->>DB: 사용자 정보 및 권한 검증 (Oracle SP) + DB-->>Controller: 인증 성공 반환 (사번/부서/직급 데이터) + Controller->>Session: $_SESSION['satis_user_id'] 등 세션 설정 + Controller->>Auth: Auth_TokenGenerater() 호출 (10자리 난수) + Auth->>Session: $_SESSION['Token'] 저장 Session-->>User: Session Cookie 발급 (private) - - Note over User, Controller: 후속 요청 시 Token 및 Session 권한 검증 (Auth_TokenChecker) + + Note over User,Controller: 이후 모든 요청에서 Token 검증 수행 + + User->>Controller: 기능 요청 (Token 파라미터 포함) + Controller->>Auth: Auth_TokenChecker($Token) + Auth->>Session: $_SESSION['Token'] 비교 + alt 일치 + Auth-->>Controller: 정상 처리 계속 + else 불일치 + Auth->>Session: session_destroy() 세션 파기 + Auth-->>User: auth_move_page.tpl → 로그인 이동 + end + + Controller->>LoginInfo: GetLoginStatus() 세션 유효성 확인 + alt 세션 만료 + LoginInfo-->>User: alert('로그인후 사용하세요 시간만료') + 리다이렉트 + end ``` -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.1 세션 및 인증 관리 체계 + +| 항목 | 내용 | +| :--- | :--- | +| **세션 방식** | PHP Native Session (`session_start()`, `session_cache_limiter('private')`) | +| **CSRF 방어** | `AuthClass::Auth_TokenGenerater()` — 62자 문자풀, 10자리 난수 | +| **세션 만료 처리** | `LoginInfomation::GetLoginStatus2()` — 세션/쿠키/GET 파라미터 3단계 확인 | +| **개인 권한 검증** | `PersonAuthority::GetInfo($memberID, $Item)` — `member_tbl.Certificate` 컬럼 기반 | +| **개발자 권한** | `DefaultInformation.php` 화이트리스트 사번 6명 하드코딩 → `auth_page_devYN='Y'` | +| **OTP 인증** | `OracleClass::CheckOTPAuthentication()` — `SM_ERPURL_OTP` 테이블, 유효시간 1분 | + +### 6.2 세션 변수 목록 + +| 세션 키 | 설명 | +| :--- | :--- | +| `$_SESSION['satis_user_id']` | 로그인 사원번호 (예: `"221064"`) | +| `$_SESSION['satis_user_name']` | 사원 성명 | +| `$_SESSION['satis_user_deptcode']` | 부서코드 | +| `$_SESSION['satis_user_deptname']` | 부서명 | +| `$_SESSION['Token']` | CSRF Anti-Forgery Token (10자리) | +| `$_SESSION['account_user_id']` | 계정 사용자 ID (인트라넷 연동용) | +| `$_SESSION['memberID']` | 인트라넷 회원 ID (레거시) | +| `$_SESSION['Title']` | 현재 화면 제목 | +| `$_SESSION['Auth']` | 권한 레벨 | +| `$_SESSION['Type']` | 사용자 유형 | --- -## 6. 외부 시스템 연동 아키텍처 (External System Integration Architecture) - -이 시스템은 단일 DB에 의존하지 않고, 사내 타 이종(Heterogeneous) 시스템과 실시간 연결되는 하이브리드 데이터 아키텍처를 가집니다. +## 7. 외부 시스템 연동 아키텍처 (External System Integration Architecture) ```mermaid graph TD - SatisCore["Satis ERP Core System"] + SatisCore["Satis ERP Core System
(PHP Application Server)"] - SatisCore <-->|OCI Native Connection| OracleSystem["메인 그룹웨어/ERP DB (Oracle)"] - SatisCore <-->|MS-SQL Driver (Port 5539)| iCubeSystem["더존 iCube ERP (MS-SQL: DZICUBE)
IP: 192.168.13.50"] - SatisCore <-->|MySQL Driver (Port 3306)| IntranetSystem["인트라넷 시스템 (MySQL: hallaerp)
Host: erp.samaneng.com"] + SatisCore <-->|OCI Native: oci_connect('satis','SATIS11707808','samandb')| OracleDB["Oracle DB (Main ERP)
그룹웨어, 인사, 회계, 프로젝트, 결재"] + SatisCore <-->|mssql_connect: 192.168.13.50:5539
DZGUEST/dzguest123| iCubeDB["더존 iCube ERP (MS-SQL)
DB: DZICUBE
회계전표 연동, 인사급여 싱크"] + SatisCore <-->|mysql_connect: erp.samaneng.com
root/vbxsystem| IntranetDB["인트라넷 MySQL
DB: hallaerp
전자결재 사원/부서 정보, 코드 사전"] + SatisCore -->|SMS API| SMSSvc["SMS 발송 서비스
기술자보수교육 대상자 알림
프로젝트 미결재 알림"] + SatisCore -->|PdfLogic| PDFSvc["PDF 생성 서비스
결재문서/보고서 PDF 변환"] ``` -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 라이브러리 및 커스텀 트랜잭션 바인딩 처리 +| 연동 시스템 | 접속 방식 | 연동 목적 | 관련 파일 | +| :--- | :--- | :--- | :--- | +| **Oracle DB (Main)** | OCI8: `oci_connect('satis','SATIS11707808','samandb')` | ERP 핵심 데이터 (결재/인사/회계/프로젝트) | `OracleClass.php` | +| **더존 iCube ERP** | MS-SQL: `192.168.13.50:5539` DB: `DZICUBE` | 회계 전표 더존 전송, 인사/급여 싱크 | `saman_icube_dbcon.inc` | +| **인트라넷 MySQL** | MySQL: `erp.samaneng.com` DB: `hallaerp` | 전자결재용 사원/부서 코드, 문서 마스터 | `dbcon.inc`, `approval_function.php` | +| **SMS 서비스** | PHP Logic 클래스 | 기술자 보수교육 대상자 알림, 프로젝트 미결재 경고 문자 | `sms_controller.php`, `sms_logic.php` | +| **PDF 서비스** | PHP Logic 클래스 | 결재 문서/보고서 PDF 변환 및 뷰 | `pdf_controller.php`, `PdfLogic.php` | --- -## 7. 주요 업무 도메인 서브시스템 (Business Subsystems) +## 8. 프론트엔드 아키텍처 (Frontend Architecture) -| 도메인 구분 | 서브시스템 모듈 | 아키텍처적 역할 및 주요 처리 기능 | +### 8.1 프론트엔드 구성 개요 + +```mermaid +graph LR + subgraph "Frontend Stack (Satis/js/)" + jQuery["jQuery 1.11.3
(erp_jquery-1.11.3.min.js)"] + jqGrid["jqGrid
(219KB, common_jqGrid.js)"] + BigGrid["BigData Grid
(50KB, common_bigdata_grid.js)"] + w2ui["w2ui 1.5 RC1
(그리드/레이아웃)"] + amCharts["amCharts 3.20.15
(경영분석 차트)"] + dtree["dTree
(조직도/메뉴 트리)"] + Common3["common3.js (172KB)
(전체 공통 함수)"] + end +``` + +### 8.2 주요 프론트엔드 파일 및 역할 + +| 파일명 | 크기 | 역할 | | :--- | :--- | :--- | -| **회계/재무** | `Account` | 전표 생성/승인, 예산 관리, 결산, 재무제표, 법인세/부가세, 원가 계산 | -| **인사/급여** | `Person` | 인사기록, 근태 관리, 급여/상여 계산, 연말정산(`yeta_data`) 처리 | -| **프로젝트/공정** | `Project`, `Project_work` | 엔지니어링 프로젝트 현장 관리, 공정률 계산, 기성 산출, 수주/매출 처리 | -| **전자결재/문서** | `Document`, `Sign` | 전자결재 작성, 양식/결재선 관리, 전자서명 및 인장 관리 | -| **영업/구매** | `Sale`, `Purchase` | 수주/매출 관리, 자재 구매 신청 및 발주 처리 | -| **자산/도서/출장** | `Asset`, `Book`, `Travel` | 고정자산 추적, 도서 대여 관리, 국내/외 출장 신청 및 여비 정산 | -| **시스템 관리** | `Supervisor`, `Common` | 전체 공정/부서/직급 코드 관리 (`CommonCodeList.php`), 관리자 권한 설정 | +| `common_jqGrid.js` | 219KB | jqGrid 표준 래퍼. 컬럼 정의, 정렬, 페이징, 필터, Excel 내보내기 공통화 | +| `common_bigdata_grid.js` | 50KB | 수십만 건 이상 대용량 데이터 가상 스크롤 렌더링 | +| `SlipTemp.js` | 182KB | 회계 임시전표 작성 클라이언트 로직 (차변/대변 자동 계산, 전표 검증) | +| `SlipConfirm.js` | 147KB | 전표 확정 처리 로직 | +| `ProjectScreen06.js` | 115KB | 프로젝트 기성/원가 화면 복잡 UI 처리 | +| `ProjectScreen07.js` | 111KB | 프로젝트 원가 세부 화면 처리 | +| `common3.js` | 172KB | 공통 팝업, AJAX 함수, 날짜 유틸, 입력 검증 | +| `GenerateDate.js` | 27KB | 날짜 계산/생성 유틸리티 | +| `erp_PrintAgent.js` | 2.5KB | 인쇄 에이전트 연동 | +| `dtree.js` | 12KB | 메뉴/조직도 트리 렌더링 | +| `amcharts_3.20.15.free/` | — | 경영분석, 프로젝트 현황 차트 | +| `pdfviwer/` | — | 결재문서 PDF 인라인 뷰어 | + +### 8.3 Smarty 템플릿 네이밍 규칙 + +Smarty `.tpl` 파일은 아래의 일관된 명명 규칙을 따릅니다. + +``` +{화면명}_{화면번호}_{렌더링타입}_{AJAX순번}_mvc.tpl +``` + +| 패턴 예시 | 설명 | +| :--- | :--- | +| `LoginScreen_01_Main_mvc.tpl` | 로그인 화면 메인 렌더링 | +| `LoginScreen_01_HTML_AJAX_01_mvc.tpl` | 로그인 화면 AJAX 응답 분리 파일 | +| `AlramInfo_List_01_AJAX_02_mvc.tpl` | 알림 목록 두 번째 AJAX 응답 | +| `SCREEN_01_Main_mvc.tpl` | 비밀번호 변경 화면 | +| `SCREEN_10_Main_mvc.tpl` | 초기화 비밀번호 로그인 전용 화면 | --- -## 8. 아키텍처 총평 및 고려사항 (Architectural Evaluation) +## 9. 주요 업무 도메인 서브시스템 (Business Subsystems) -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` 또는 보안 설정 파일로 분리 관리 권장. +| 도메인 | 모듈 | 컨트롤러 수 | 핵심 기능 | +| :--- | :--- | :---: | :--- | +| **회계/재무** | `Account` | 30 | 전표(임시/확정/자동), 시산표, 재무제표, 기성, 원가, 법인세, 부가세, 공동도급예산, 고정자산, 어음/대출 관리 | +| **인사/급여** | `Person` | 23 | 인사기록카드, 발령, 자격증, 근태, 급여계산, 급여명세서, 퇴직금, 연말정산, 더존 싱크 | +| **프로젝트/공정** | `Project`, `Project_work` | 15+16 | 프로젝트 마스터, 수주계약, 기성, M/M 공수, 원가현황, 선급금, 협력업체, 목표수주 관리 | +| **전자결재** | `Document`, `Sign` | 1+3 | 기안/임시저장/상신, 결재진행, 전결/반송, 전자서명 문서, 결재선 관리 | +| **영업** | `Sale` | 9 | 입찰, 수주 계약, 매출/기성 수금, 수금 관리, 해외 사업, 영업 계획, 실적 분석 | +| **구매** | `Purchase` | 4 | 구매 정보, 발주, 대금 청구, 정산 관리 | +| **자산/도서** | `Asset`, `Book` | 3+α | 자산 기본코드, 자산 정보, 자산 구매, 도서 대여/목록 | +| **출장** | `Travel` | 1 | 국내/해외 출장 신청 및 여비 정산 | +| **협회** | `Association` | 1 | 엔지니어링 관련 협회 가입/관리 | +| **시스템관리** | `Management`, `Supervisor` | 4+1 | 공통코드, 메뉴권한, 알림 관리, 시스템 관리자 전체 설정 | +| **공통/인프라** | `Common`, `Jqgrid`, `Fileupload` | 17+α | SMS, PDF, OTP, 팝업, 파일업로드, 그리드 JSON 응답 | + +--- + +## 10. 아키텍처 총평 및 고려사항 (Architectural Evaluation) + +### 10.1 강점 (Strengths) + +| 항목 | 내용 | +| :--- | :--- | +| **체계적 모듈화** | 20개 이상 업무 도메인이 Controller-Model-View 3계층으로 명확히 분리 | +| **이종 DB 하이브리드** | Oracle(ERP), MS-SQL(더존), MySQL(인트라넷) 3개 DB를 단일 애플리케이션에서 동시 운영 | +| **대용량 그리드 최적화** | `jqGrid` + `common_bigdata_grid.js` + `ini_set("memory_limit", -1)`를 통해 수만 건 공정/회계 데이터 조회 지원 | +| **보안 이중 방어** | CSRF 토큰 + PHP 세션 + OTP 검증의 다단계 인증 구조 | +| **도메인 특화 클라이언트** | `SlipTemp.js`(182KB), `ProjectScreen06.js`(115KB) 등 업무 특화 대용량 클라이언트 스크립트 | + +### 10.2 기술 부채 및 위험 요소 (Technical Debt & Risks) + +> [!CAUTION] +> **레거시 PHP 드라이버 사용**: `mysql_connect()`, `mssql_connect()`는 PHP 7.0에서 완전히 제거된 deprecated 함수입니다. PHP 5.6 이하 환경에서만 실행 가능합니다. + +> [!CAUTION] +> **DB 접속 정보 평문 노출**: `dbcon.inc`(root/vbxsystem), `saman_icube_dbcon.inc`(DZGUEST/dzguest123$), `OracleClass.php`(satis/SATIS11707808) 소스 코드에 DB 계정이 하드코딩되어 있습니다. + +> [!WARNING] +> **SQL Injection 위험**: `approval_function.php`, `function.php` 등 다수 함수에서 `$mCode` 값을 필터링 없이 SQL에 직접 삽입합니다. `mysql_real_escape_string()` 미적용. + +> [!WARNING] +> **개발자 화이트리스트 하드코딩**: `DefaultInformation.php`에 개발자 사번 6명이 소스 코드에 직접 명시되어 있어 인사이동 시 소스 수정이 필요합니다. + +> [!NOTE] +> **Smarty 절대경로 의존**: `SmartyConfig.php`의 모든 경로가 `D:/APM_Setup/htdocs/`로 하드코딩되어 있어 서버 이전 시 전면 수정이 필요합니다. + +### 10.3 향후 아키텍처 개선 로드맵 (Future Roadmap) + +| 우선순위 | 항목 | 개선 방향 | +| :---: | :--- | :--- | +| 🔴 긴급 | **DB 접속 정보 격리** | `.env` 파일 또는 환경 변수(`getenv()`)로 분리, 소스 버전 관리에서 제외 | +| 🔴 긴급 | **PHP 버전 현대화** | `mysql_*` → `PDO/mysqli`, `mssql_*` → `sqlsrv` (PDO_SQLSRV) 마이그레이션 | +| 🟠 중요 | **SQL Injection 방어** | Prepared Statement 또는 ORM 도입, 입력값 필터링 강화 | +| 🟡 권장 | **Smarty 경로 상대화** | `SmartyConfig.php`를 `__DIR__` 기반 상대경로로 변경, 이식성 확보 | +| 🟡 권장 | **개발자 권한 DB화** | 화이트리스트 사번을 DB 권한 테이블로 이전, 운영 중 동적 변경 가능하도록 개선 | +| 🟢 선택 | **템플릿 엔진 현대화** | Smarty 2.6 → Twig/Blade 또는 React/Vue.js SPA 전환 고려 | +| 🟢 선택 | **로그 중앙화** | 날짜별 txt 파일 로그 → ELK Stack 또는 구조화 로그(JSON) 도입 |