SamProject/sam-docs
6
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
491 Commits 2 Branches 0 Tags
64f1262d518c2ae2a5e2bf734443ee00ffb5b0d2
Commit Graph

491 Commits

This Branch
This Branch
All Branches
Author SHA1 Message Date
김보곤
64f1262d51 docs: [standards] Blade + React(JSX) 혼용 정책 문서 추가 
- 이중 중괄호 충돌 방지 규칙, 허용/금지 패턴, 체크리스트 포함
- INDEX.md에 등록
 2026-03-12 17:08:15 +09:00
김보곤
ad0fed9d55 docs: DB 아키텍처 문서 현행화 - MNG 자체 마이그레이션 관리 반영 
- codebridge 서버 분리 이후 MNG 자체 DB 관리 구조 반영
- 이전 규칙(모든 마이그레이션 API에서만) → 현행(각 프로젝트 자체 관리)
- CLAUDE.md, mng-structure, overview, database/README, PROJECT_DEVELOPMENT_POLICY 수정
 2026-03-12 14:56:38 +09:00
권혁성
73a8f525ea docs: [QMS] 점검표 템플릿 계획 문서 추가 2026-03-12 13:58:21 +09:00
김보곤
9c17850782 docs: [equipment] 사진 API 스펙 업데이트 (GCS→R2) 
- 프론트엔드 요청 문서: 사진 업로드 API 상세 스펙 추가
- multipart/form-data files[] 배열 형식 명시
- 검증 규칙, Request/Response 예시 추가
- GCS 언급을 Cloudflare R2로 수정
- features/equipment README 동일 수정
 2026-03-12 13:47:48 +09:00
김보곤
fa85bd388a docs: [bim] BIM 뷰어 문서 Phase 2 반영 
- Phase 1 전용 → Phase 2 완료 상태로 업데이트
- IFC 업로드/다운로드, web-ifc, 듀얼 모드 설명 추가
- IFC→Three.js 변환 파이프라인, IFC Export 구조 문서화
- BimScene 클래스 메서드 목록 최신화
 2026-03-12 13:35:14 +09:00
김보곤
efd0427cd6 docs: [equipment] React 프론트엔드 구현 요청 문서 작성 
- 26개 API 엔드포인트 상세 스펙 (파라미터, 응답 구조)
- 8개 화면 구현 가이드 (레이아웃, 컬럼, 드롭다운 옵션)
- 점검 그리드 동작 규칙 (셀 토글, 비근무일, 자동 판정)
- 비즈니스 규칙 정리 (권한, 사진 제한 등)
 2026-03-12 13:31:34 +09:00
김보곤
1330ebac01 docs: [construction-pmis] BIM 뷰어 기술 문서 추가 
- Three.js 기반 웹 3D 건물 모델 뷰어 기술 원리 문서화
- 렌더링 파이프라인, 건물 모델 생성, React-Three.js 연동 패턴
- INDEX.md에 문서 등록
 2026-03-12 12:50:06 +09:00
김보곤
5d2933c176 docs: [equipment] API Phase 1 구현 현황 문서 업데이트 
- 상태 변경: API+React 미구현 → API Phase 1 완료
- API 구현 현황 섹션 추가 (모델, 서비스, 컨트롤러, 라우트 26개)
- MNG→API 변환 규칙, DB 연결 분리 설명 추가
- Phase 로드맵 (Phase 1 완료, Phase 2-3 미착수)
 2026-03-12 12:19:28 +09:00
김보곤
6b4eae5252 docs: [equipment] 설비관리 화면 설계 스토리보드 PPTX 생성 
- 9개 화면 14슬라이드 기획서
- 대시보드, 대장CRUD, 점검그리드, 수리이력, Import
 2026-03-12 12:19:28 +09:00
김보곤
366d51fcd1 docs: [equipment] API+React 서비스 구축 계획 수립 2026-03-12 12:19:28 +09:00
김보곤
9643994e2c docs: [equipment] 설비관리 R&D 현황 문서 업데이트 
- MNG 완료된 전체 구현 현황 상세 문서화
- DB 테이블 6개, ERD, 주요 컬럼 명세
- 모델/서비스/컨트롤러/뷰/라우트 구조
- InspectionCycle 6주기, 비즈니스 규칙
- API+React 서비스 구축을 위한 참조 문서
 2026-03-12 12:19:28 +09:00
김보곤
f6374867ac docs: [system] Untitled UI 도입 검토 문서 추가 
- Figma/React UI Kit 가격 및 제품 비교
- SAM 현재 디자인 시스템(shadcn/ui)과 호환성 분석
- 도입 방안 3가지 및 시기별 권장안
 2026-03-12 12:19:28 +09:00
김보곤
dc2806b698 docs: [system] React 컴포넌트 아키텍처 현황 문서 추가 
- Atomic Design 적용 현황 분석 (이상 vs 현실)
- Import 비율: ui/ 직접 83.7%, 계층 경유 16.2%
- 핵심 컴포넌트 사용 빈도 TOP 10
- 테마 시스템 (light/dark/senior)
- 신규 화면 개발 가이드
 2026-03-12 12:19:28 +09:00
김보곤
e7bc9232fa docs: [email] features/email 기능 문서 추가 
- features/email/README.md 신규 생성 (기능 개요, 아키텍처, 테이블, 서비스, 라우트)
- INDEX.md features 섹션에 이메일 시스템 항목 추가
 2026-03-12 12:19:28 +09:00
김보곤
73d64d4b03 docs: [email] 테넌트 이메일 연동 가이드 추가 
- 테넌트 메일 연동 기술문서 신규 작성 (SMTP 프리셋, MNG 관리 화면, 연결 테스트)
- 기존 email-policy.md에 연동 가이드 참조 추가
- INDEX.md에 이메일 연동 문서 등록
 2026-03-12 12:19:28 +09:00
유병철
65b6a27479 docs: [frontend] 동적 멀티테넌트 페이지 시스템 JSONB 저장 방식 확정 
- JSONB vs JSON 비교 및 채택 근거 추가
- DB 테이블 구조 제안 (page_configs)
- JSONB가 config 설계에 미치는 영향 정리
- 백엔드 협의 필요 사항 업데이트
- 문서 버전 1.1 → 1.2
 2026-03-11 22:33:38 +09:00
김보곤
f4620889da fix: [pricing] 파일 저장 공간 추가요금 10만원→5만원 변경 
- customer-pricing.md
- 서비스 이용계약서 (01-service-agreement.md)
- CHANGELOG.md
- 요금 슬라이드 (slide-05.html)
 2026-03-11 21:55:19 +09:00
김보곤
5c7685f6aa docs: [email] 멀티테넌시 이메일 정책 문서 및 발표자료 추가 
- 이메일 발송 정책 기술문서 (dev/standards/email-policy.md)
- 개발팀 설명용 PPTX 12슬라이드 (presentations/sam-email-policy.pptx)
- INDEX.md에 이메일 정책 문서 등록
 2026-03-11 21:47:36 +09:00
김보곤
26bd2e024a docs: [approval] MNG↔API 비교 분석 및 React 구현 가이드 추가 
- MNG 결재관리 개발 히스토리 (7단계, ~90커밋)
- MNG vs API 기능 비교 매트릭스
- API 반영 현황 및 미반영 항목 정리
- React 구현 시 참조 파일 가이드
- 구현 우선순위 Phase A~D 제안
 2026-03-11 21:12:26 +09:00
김보곤
1eaf6564e5 docs: [barobill] 바로빌 회계 데이터 REST API 명세 추가 
- 카드 거래/은행 거래/홈택스 세금계산서 42개 엔드포인트 명세
- 아키텍처, 데이터 패턴, 분개 시스템, 구현 파일 목록 포함
- INDEX.md에 문서 등록
 2026-03-11 19:53:11 +09:00
김보곤
dbc34e826d docs: [payroll] 프론트엔드 개발 가이드 추가 
- 급여관리 화면 구성 와이어프레임 (목록, 등록/수정 폼, 명세서)
- 계산 미리보기, 법정공제 수동입력 등 구현 유의사항
- 상태별 UI 제어, 에러 처리 가이드
- 월간 워크플로우 안내
 2026-03-11 19:47:34 +09:00
김보곤
764ef9f82a docs: [approval] 결재관리 통합 계획서 현행화 
- P1~P4 완료 상태 반영 (설계 중 → P1~P4 완료)
- 현재 구현 현황 (45 라우트, 48 서비스 메서드) 추가
- API/MNG 기능 비교표를 실제 코드 기준으로 갱신
- 남은 작업: P5(Leave 연동), P6(테스트), 병렬결재/위임 inbox 검증
 2026-03-11 19:40:29 +09:00
김보곤
e83954eddd docs: [payroll] 급여관리 API 프론트엔드 연동 명세서 추가 
- 18개 엔드포인트 전체 명세 (CRUD, 상태변경, 일괄생성, 미리보기 등)
- 4대보험/근로소득세 계산 엔진 설명
- 상태 흐름도 (draft → confirmed → paid)
- 프론트엔드 구현 가이드 및 UI 와이어프레임
- INDEX.md에 문서 등록
 2026-03-11 19:30:00 +09:00
김보곤
593bef9e5d docs: [payroll] 급여관리 API 구현 기획서 작성 
- MNG 급여관리 시스템 → API 이식 3단계 계획 수립
- Phase 1: 핵심 계산 엔진 (소득세, 4대보험, 공제 오버라이드)
- Phase 2: 상태 관리 + 일괄 처리 (unconfirm, unpay, bulkGenerate)
- Phase 3: 문서 생성 (PDF 명세서, 전표 변환, 엑셀 내보내기)
- INDEX.md에 문서 등록
 2026-03-11 18:04:10 +09:00
김보곤
5493788800 docs: [approval] 결재관리 API 프론트엔드 연동 명세서 추가 
- 28개 엔드포인트 전체 명세 (요청/응답 포맷 포함)
- 상태 흐름도, 탭 구성, 버튼 조건 등 UI 가이드
- INDEX.md에 frontend/api-specs/ 섹션 등록
 2026-03-11 17:40:53 +09:00
김보곤
5517b7f04d docs: [esign] 근로계약서 최신 연봉정보 반영 문서화 
- features/esign/README.md: 근로계약서 사원 연동 섹션 추가
- projects/e-sign/changelog.md: v1.1.1 변경 이력 추가
- rules/employee-api.md: 전자계약 연동 참조 추가
- dev/changes/20260311: esign 연봉정보 개선 내용 추가
 2026-03-11 17:04:27 +09:00
유병철
5cd97962b4 docs: [frontend] v2 동적 멀티테넌트 페이지 시스템 설계 초안 추가 
- v2/01-dynamic-multi-tenant-page-system.md 신규 작성
- _index.md에 v2 섹션 및 문서 목록 추가
- 빠른 참조 가이드에 v1/ 경로 접두사 반영

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-11 16:56:34 +09:00
김보곤
6959fd8fcf docs: [hr] 연봉이력 삭제 기능 문서화 
- rules/employee-api.md: 연봉 API 엔드포인트 및 데이터 구조 추가
- system/database/hr.md: salary_info JSON 구조 추가
- dev/changes/20260311_salary_history_delete.md: 변경 이력 생성
- INDEX.md: 변경 이력 등록
 2026-03-11 16:49:22 +09:00
김보곤
ab0178517e docs: [approval] 결재관리 시스템 통합 계획서 작성 
- MNG→API 결재 기능 이식 6단계 계획
- 모델/서비스/엔드포인트/위임/Leave연동 범위 정리
- INDEX.md에 결재관리 필수 문서 등록
 2026-03-11 16:46:54 +09:00
김보곤
8ba4a60aa2 docs: [changes] 전자서명 체크박스, 전표 적요 동기화, 거래처 드롭다운, 바로빌 중복 키 수정 이력 추가 2026-03-11 15:51:54 +09:00
권혁성
cb77190cd6 docs: [standards] DomPDF 사용 가이드 전면 재작성 
- 인스턴스 규칙, setOptions 금지, chroot/symlink 주의사항 추가
- font-weight 800 금지, 서브셋팅 경량화 섹션 병합
- 배포 환경(릴리스/shared) 대응 가이드 포함
 2026-03-11 14:00:27 +09:00
권혁성
d727673e54 docs: 서버 접근 권한 문서 업데이트 (v1.3) 
- OS 그룹 현황 섹션 추가 (webservice/develop 그룹 역할, 서버별 구성)
- Jenkins 롤백 기능 문서화 (파라미터, 동작 방식, 릴리스 보관)
- sam-cicd pro 계정 현황 추가
- OS 잠금 시 DB 접근 차단 참고사항 추가
- "외부 인원" → "서브 관리자" 문구 수정
- 변경 이력: develop 그룹 삭제(prod/cicd), pro 계정 잠금(prod/cicd)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-11 13:58:36 +09:00
김보곤
e03541b678 docs: [pdf] 폰트 정책 NanumGothic → Pretendard 전환 반영 2026-03-11 11:50:37 +09:00
김보곤
909eb58307 docs: CLAUDE.md PDF 폰트 정책 필수 규칙 추가 2026-03-11 11:05:53 +09:00
김보곤
df19310c2e docs: [standards] PDF 폰트 정책 — 프로젝트 번들링 방식으로 전환 
- 시스템 폰트(fonts-nanum) 의존 → resources/fonts/ 번들링으로 변경
- ensureKoreanFont() 코드 예시 resource_path() 방식으로 갱신
- 체크리스트, 관련 문서 경로 업데이트
 2026-03-11 11:03:19 +09:00
김보곤
95bf896536 docs: [standards] PDF 경량화 설정 및 font-weight 주의사항 추가 
- 폰트 서브셋팅(enable_font_subsetting) 필수 설정 추가
- font-weight 800 이상 사용 금지 규칙 추가
- 섹션 번호 정리 (5.경량화, 6.수정가이드, 7.긴급복구, 8.체크리스트)
 2026-03-11 10:50:06 +09:00
김보곤
f0d7a29be9 docs: [db] codebridge DB 분리 문서에 크로스 DB FK 제거 내용 추가 
- 깨진 FK 제약조건 52개 제거 (users, tenants 등 참조) 문서화
- 운영 서버 적용 절차 5단계 → 6단계로 개정 (API 마이그레이션 단계 추가)
 2026-03-11 10:32:50 +09:00
김보곤
06ce65576c docs: [changes] 자금일보 동기화 및 계정과목 정리 변경이력 추가 
- 20260311 변경이력 문서 추가
- INDEX.md에 dev/changes/ 섹션 추가
 2026-03-11 10:32:42 +09:00
김보곤
d1d6a56702 docs: [standards] PDF 폰트 정책 업데이트 
- NanumGothic 표준 폰트 + ensureKoreanFont 자동 등록 패턴 반영
- DomPDF 미등록 폰트(Malgun Gothic 등) 단독 사용 금지 추가
- storage/fonts/ 캐시 구조 및 서버 환경 체크리스트 추가
 2026-03-11 09:56:13 +09:00
김보곤
909d3e11b8 docs: [standards] PDF 생성 시 폰트 정책 추가 
- 구글 폰트 외부 로드 금지, isRemoteEnabled 금지
- 운영서버 권한 오류 사례 및 긴급 복구 절차
- 시스템 기본 폰트 사용 가이드, 로컬 폰트 설치 방법
 2026-03-11 09:39:41 +09:00
김보곤
1407893c26 docs: [guides] Claude Code → 슬랙 붙여넣기 가이드 추가 
- 터미널 줄바꿈 혼재, Markdown vs mrkdwn 차이, 슬랙 공백 처리 원인 분석
- 클코 to 슬랙 변환기 사용법 안내
- 리치 텍스트 복사 작동 원리 설명
 2026-03-11 09:35:39 +09:00
김보곤
0cd445b546 docs: [payroll] 급여관리 문서 전면 개정 
- 상태 워크플로우, 슈퍼관리자 권한 추가
- 일반전표 변환 분개 구조 상세 기술
- 기타공제 수기 입력 주의사항 명시
- 멀티테넌트 확장 계획 추가
- MNG API 엔드포인트 전체 목록
 2026-03-11 07:06:03 +09:00
권혁성
84fae0041a docs: [QMS] API 연동 계획 상태 업데이트 (Phase 1~3 구현 완료) 
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-10 17:53:23 +09:00
권혁성
47cef8be96 docs: [QMS] API 연동 계획 문서 보강 — 아키텍처 결정 사항 및 실제 코드 기반 상세화 
- IQC 추적 경로: StockLot 직접 → WorkOrderMaterialInput 경유로 수정 (생산입고 vs 투입 관계)
- actions.ts: executeServerAction + buildApiUrl + ActionResult<T> 프로젝트 표준 적용
- snake→camelCase 변환 레이어 및 API 원본 타입 추가
- 필드명 수정: order_code→order_no, order_date→received_at, orderNodes()→nodes()
- 상태 관리 커스텀 훅 설계 (useDay1Audit, useDay2LotAudit) 및 로딩 세분화
- confirm 토글 원자성 보강, null 방어, FormRequest 추가
- Phase 3 일정 재산정 (2.5일→4.5일, 총 9일→11.5일)

- 아키텍처 결정 사항 7건 추가 (2단계 로딩, FG 제품명, 채번 형식, StockLot 기반 IQC, 비관적 업데이트, subType, PR 없는 문서 처리)
- 프론트엔드 상세 구조 추가 (types.ts 전체, page.tsx 상태/핸들러, mockData 계층, 컴포넌트 목록)
- 백엔드 기존 코드 참조 추가 (모델/서비스/컨트롤러 경로, DB 스키마 4개 테이블, 모델 관계 맵)
- 구현 패턴 가이드 추가 (Controller/Service/FormRequest/Model/API 응답/라우트 코드 예시)
- 8종 서류 조합 의사 코드 및 API 응답 매핑 코드 추가
- Phase별 체크리스트 보강

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-10 17:53:23 +09:00
유병철
b1f276aa9d Merge branch 'main' of http://114.203.209.83:3000/SamProject/sam-docs 2026-03-10 17:34:10 +09:00
유병철
7701677418 chore: .gitignore 변경 되돌리기 
- 잘못 포함된 frontend 폴더 추적 허용 제거
 2026-03-10 17:33:39 +09:00
유병철
e34796a53f docs: [frontend] 브라우저 네비게이션 규칙 문서 추가 
- AI/E2E 자동화 시 URL 추측 금지, 메뉴 클릭 필수 규칙
- .gitignore에 frontend 폴더 추적 허용
- _index.md에 11번 문서 항목 추가
 2026-03-10 17:32:05 +09:00
권혁성
cf0c128764 chore: .gitignore 화이트리스트→블랙리스트 방식으로 변경 
- 기존: 모든 파일 무시(*) + 폴더별 허용(!path) → 새 파일 추가 시 git add -f 필요
- 변경: 쓰레기 파일만 제외 (.DS_Store, *.log, *.tmp 등)
 2026-03-10 09:51:32 +09:00
김보곤
13a5a56146 docs: 개발서버 sam-docs 폴더에서 누락 문서 5건 복구 
- guides/project-launch-roadmap.md
- plans/SAM_ERP_Storyboard_D1.4.md
- plans/SAM_ERP_회계관리_Storyboard_D1.6.md
- plans/integrated-master-plan.md
- plans/production-deployment-plan.md
 2026-03-10 09:28:07 +09:00
김보곤
ee1aaf183d chore: .claude 폴더를 git 추적에서 제외 (로컬 전용) 2026-03-09 23:06:34 +09:00