ASC Project DB

ASC 보안 동아리 프로젝트 보고서 관리 시스템

쿼드 팀이 Git PR로 격주 보고서를 제출하면, 관리자 리뷰 후 merge 시 저장소에 반영됩니다.

마감

• 매주 화요일 23:59 까지 PR merge 완료 시 해당 주차 제출로 인정

구조

학기를 선택해 보고서를 확인하세요: 2026년 1학기 · 2026년 2학기

보고서는 제출 날짜가 아니라 프로젝트가 소속된 학기로 나눕니다. 1학기 프로젝트의 여름·9월 지연 제출도 1학기에 보관합니다.

reports/
└── {YYYY}/
    ├── 1학기/
    └── 2학기/
        └── {쿼드조명 또는 개인}/
            └── {프로젝트명}/
                ├── report-00.md    # 프로젝트 계획서 (0회차)
                ├── report-01.md    # 격주 진행 보고서
                ├── report-02.md
                ├── ...
                ├── report-08.md    # 최종 기술 보고서 (is_final: true)
                └── assets/         # 스크린샷, 다이어그램 (선택)

보고 회차

회차	제출일
0차 (계획서)
1차
2차
3차
4차
5차
6차
7차
8차

보고서 종류

팀 프로젝트 계획서 (project-plan-template.md → report-00.md)

프로젝트 시작 전 0회차로 제출하는 계획서입니다. KUCIS 서식7 양식을 기반으로 합니다. 주요 항목:

• 프로젝트 개요: 학교명, 동아리명, 프로젝트명, 분야, 개요, 기대효과
• 세부 계획서: 목적, 세부내용, 기대효과, 수행시 문제점, 요구사항, 장비/물품, 팀원 역할 분담

팀 프로젝트 진행 보고서 (report-template.md)

2주 단위로 제출하는 진행 보고서입니다. 주요 항목:

• 팀 전체 진행 현황: 이번 회차 목표, 현재 진행률, 주요 달성 사항
• 개인별 기여 내역: 수행 작업 + 산출물 링크(GitHub 커밋, PR 등) + 기여도(%)
• 이슈 및 해결 방안: 기술적 병목, 일정 지연 사유 및 해결 현황
• 다음 회차 목표: 다음 2주간 완료할 구체적 작업 리스트

개인 프로젝트 계획서 (individual-project-plan-template.md → report-00.md)

혼자 수행하는 개인 프로젝트의 시작 계획서입니다. 팀원 역할 분담 없이 본인의 수행 계획, 예상 산출물, 검증 방법을 작성합니다.

개인 프로젝트 진행 보고서 (individual-report-template.md)

개인이 단독으로 수행하는 프로젝트용 진행 보고서입니다. 팀 기여도 표 대신 본인이 직접 수행한 작업과 산출물, 검증 내용을 중심으로 기록합니다.

• 프로젝트 진행 현황: 이번 회차 목표, 현재 진행률, 주요 달성 사항
• 수행 내역: 직접 수행한 작업, 산출물 링크, 검증/확인 내용
• 이슈 및 해결 방안: 기술적 병목과 해결 과정
• 다음 회차 목표: 다음 2주 동안 완료할 구체적 작업
• 수동 제출 시 frontmatter의 quad_name은 개인, 단일 members, contributions 100% 형식을 사용합니다.

팀 프로젝트 최종 기술 보고서 (final-report-template.md)

프로젝트 마지막 회차에 제출하는 최종 보고서입니다. is_final: true, status: "완료" 필수.

• 개요 및 목적: 연구/개발 배경, 해결하고자 한 보안 이슈
• 기술적 상세 분석: 환경 구성, 핵심 로직/취약점 분석
• 최종 결과물: 산출물 요약, GitHub repo/데모 링크
• 실전 입증 및 성과 (심화 프로젝트 필수): 성능 수치, PoC, CVE/KISA 등
• 팀원별 기여 상세: 전체 기간 기여도
• 고찰 및 결론: 한계점, 기술적 역량 입증

개인 프로젝트 최종 기술 보고서 (individual-final-report-template.md)

혼자 수행한 개인 프로젝트의 최종 결과를 정리합니다. 팀원별 기여도 표 대신 본인이 직접 수행한 핵심 작업, 산출물, 검증 결과, 해결한 기술적 문제를 작성합니다.

ASC_WEB 자동 제출 보고서

ASC_WEB에서 승인된 프로젝트 보고서는 기존 ProjectDB 안에 자동으로 저장됩니다. 별도 보고서 저장소를 만들지 않습니다.

• 팀 프로젝트: reports/{YYYY}/{1학기|2학기}/{팀명}/{round_key}-{프로젝트명}/report-01.md
• 개인 프로젝트: reports/{YYYY}/{1학기|2학기}/개인/{GitHubID 또는 이름_학번}-{N회차}-{프로젝트주제}/report-01.md
• source: asc_web, project_type: team|individual, semester: YYYY-1|YYYY-2 메타데이터가 붙습니다.
• 학기는 ASC_WEB 제출물의 학기로 결정하며 같은 팀·개인·회차도 학기가 다르면 다른 경로에 저장됩니다.
• 개인 프로젝트는 quad_name: "개인"을 사용합니다.
• ASC_WEB 생성 보고서는 실제 DB 회원/팀 정보를 사용하므로 cl_level, contributions를 임의로 만들지 않으며 두 필드는 선택입니다.
• 기존 수동/레거시 보고서는 기존 cl_level, contributions 필수 규칙을 그대로 사용합니다.
• 개인 프로젝트는 팀 제출현황 집계에 포함되지 않습니다.

회원이 올린 Markdown 본문에는 YAML frontmatter가 없어야 하며, ASC_WEB이 승인 시 신뢰 가능한 frontmatter를 자동 생성합니다.

빠른 시작

1. 레포 Fork & Clone

# 본인 GitHub 계정으로 Fork 후
git clone https://github.com/<your-username>/ProjectDB.git
cd ProjectDB

2. 보고서 작성

# 디렉토리 생성
mkdir -p reports/2026/2학기/A조/web-scanner

# 프로젝트 계획서 (0회차) 템플릿 복사
cp templates/project-plan-template.md reports/2026/2학기/A조/web-scanner/report-00.md

# 격주 보고서 템플릿 복사
cp templates/report-template.md reports/2026/2학기/A조/web-scanner/report-01.md

# 개인 프로젝트 진행 보고서 템플릿 복사
mkdir -p reports/2026/2학기/개인/20260001-personal-project
cp templates/individual-report-template.md reports/2026/2학기/개인/20260001-personal-project/report-01.md

# 개인 프로젝트 계획서
cp templates/individual-project-plan-template.md reports/2026/2학기/개인/20260001-personal-project/report-00.md

# 개인 프로젝트 최종 보고서
cp templates/individual-final-report-template.md reports/2026/2학기/개인/20260001-personal-project/report-08.md

# 최종 보고서의 경우
cp templates/final-report-template.md reports/2026/2학기/A조/web-scanner/report-08.md

3. 로컬 검증

템플릿의 semester를 해당 프로젝트 학기(2026-1 또는 2026-2)로 입력하고 저장 폴더와 맞춰주세요. 기존 이관 보고서는 학기 폴더로 구분하며 본문과 이미지 경로를 유지합니다. 과거 commit SHA에 연결된 보고서 링크도 계속 열 수 있습니다.

pip install -r scripts/requirements.txt
python scripts/validate_frontmatter.py

4. PR 제출

git checkout -b project/A조/web-scanner/report-01
git add .
git commit -m "Add report: A조/web-scanner report-01"
git push origin project/A조/web-scanner/report-01
# GitHub에서 PR 생성

자세한 제출 방법은 CONTRIBUTING.md를 참고하세요.

파이프라인

[쿼드 팀] -> fork/branch -> [PR 제출] -> 리뷰 -> [merge] -> [main 반영]
                                 |
                           CI: frontmatter 검증

설정 (관리자)

브랜치 보호 규칙 (권장)

• main 브랜치 직접 push 금지
• PR 필수, CI 통과 필수
• 최소 1명 리뷰 승인 필수