Chamelion - MediaOps

MediaOps 문서 홈

5 min read

MediaOps 문서 시스템 소개

현재 작성중으로 아래 내용과 문서 및 폴더가 다수 맞지 않습니다.

MediaOps는 전사 기술 운영을 체계적으로 관리하기 위한 플랫폼입니다.
이 저장소는 시스템 및 프로젝트 관련 문서들을 프로젝트 중심 + 문서 유형 기반으로 체계화하여 관리합니다.

1. 폴더 구조 안내

폴더 경로설명
00_overview/MediaOps 문서 시스템의 소개, 가이드, 규칙 등을 포함합니다.
01_projects/프로젝트별 문서를 구성하며, 예: mediaflow, mediatrack 등이 있습니다.
02_db/전사 시스템의 데이터베이스 스키마, ERD, 변경 이력을 관리합니다.
03_ops/배포, 모니터링, 장애 대응 등 운영 매뉴얼 및 핸드북 문서를 포함합니다.
04_diary/일간 업무일지, 주간 회의록,index.md 월간 보고서 등을 기록합니다.
05_templates/문서 자동 생성을 위한 템플릿 파일들을 보관합니다.
99_archive/더 이상 사용하지 않지만 보관이 필요한 문서들을 보존합니다.

2. 문서 작성 가이드

모든 문서는 상단에 YAML 메타정보 블럭을 포함해야 합니다:

---
title: 문서 제목
description: 문서 요약 설명
tags:
  - project/프로젝트명
  - type/문서유형 (e.g. design, meeting, daily, report)
  - status/draft or final
  - author/작성자명
date: YYYY-MM-DD
draft: false
---

2.1. 문서 작성 규칙

  • 모든 문서는 YAML 메타정보를 포함해야 합니다.
  • 적절한 title, description, tags, date, draft 필드를 작성해 주세요.
  • 문서 제목은 명확하게, 중복 없이 작성합니다.
  • 문서 파일명은 2025-08-08_회의록.md, dag-structure.md처럼 소문자와 하이픈을 사용합니다.

2.2. 디렉토리 기준

  • 문서는 목적에 따라 다음 디렉토리 중 하나에 작성합니다:
    • 01_projects/프로젝트명/
    • 02_db/schema/
    • 03_ops/
    • 04_diary/daily/, weekly/, meetings/, monthly-report/

2.3. Git 워크플로우

    gitGraph BT:
       commit
       commit
       branch docs/note-main
       checkout docs/note-main
       commit
       checkout main
       commit
       checkout docs/note-main
       branch docs/note/member_id
       checkout docs/note/member_id
       commit id: "docs: xxx 기록 문서 수정"
       commit id: "docs: xxx 기록 문서 작성"
       checkout docs/note-main
       merge docs/note/member_id id: "Merge branch 'docs/note/mino' into docs/note-main" type: REVERSE
       checkout main
       merge docs/note-main id: "Merge branch 'docs/note-main'" type: REVERSE

3. 태그 전략

태그는 문서를 빠르게 분류하고 탐색하며, 자동으로 목록을 생성하기 위해 사용됩니다.
Obsidian에서는 검색, Dataview, Graph View에 활용되고, Quartz에서는 자동 태그 페이지 및 링크 생성에 사용됩니다.

3.1. 태그 네이밍 규칙

  • 계층 구조는 슬래시(/)로 구분합니다.
  • 태그는 소문자 + 영어/숫자 조합을 사용합니다.
  • 단어 간 구분은 하이픈(-)을 사용할 수 있습니다 (예: type/monthly-report)
  • 가능한 공통된 패턴을 따르며 불필요한 태그는 최소화합니다.

3.️2. 태그 분류 체계

분류접두어예시설명
프로젝트project/project/mediaflow문서가 속한 프로젝트 이름
문서 유형type/type/spec # 사양서,
type/overview # 개요,
type/design # 설계,
type/changelog # 변경 이력,
type/meeting # 회의록,
type/report # 보고서,
type/daily # 일일 업무일지,
type/weekly # 주간 회의/업무,
type/monthly # 월간 보고서,
type/checklist # 점검표, SOP 등		문서의 형태 또는 목적
작성 상태status/status/draft # 초안,
status/review # 검토 중,
status/final # 확정 완료		초안, 완료 여부
작성자author/author/정민호(mino), author/배인환(dame2623)작성자 이름 (옵션)
사용 기술tech/tech/airflow, tech/postgresql주요 사용 기술 (옵션)

예: project/mediaflow, type/meeting, status/final, author/minho, tech/airflow

3.3. 태그 조합 예시

시스템 설계 문서

tags:
  - project/mediaflow
  - type/design
  - status/final
  - author/minho

일일 업무일지 초안

tags:
  - type/daily
  - status/draft
  - author/minho

회의록 (검토 완료)

tags:
  - project/mediaops
  - type/meeting
  - status/final

그래프 뷰