완전 개발 가이드 v1.0

PHP 8.2+ / MariaDB 10.11+ / 멀티테넌트 SaaS 패키지
최종 업데이트: 2025

목차

  1. 프로젝트 개요 및 철학
  2. 경쟁 차별화 전략
  3. 시스템 아키텍처
  4. 데이터베이스 설계
  5. 디렉토리 구조
  6. 핵심 기능 상세 설계
  7. 템플릿 및 AI 스타일 시스템
  8. 관리자 패널 구성
  9. 보안 설계
  10. 성능 최적화
  11. 개발 로드맵
  12. 패키지 출시 체크리스트

1. 프로젝트 개요 및 철학

1-1. 기본 정보

항목 내용
솔루션명 BrandOS
접속 방식 https://myoc.kr/{tenant_slug} (파라미터형 멀티테넌트)
주요 타겟 정치지망생, 퇴직 공무원/공기업인, 1인 기업/브랜드
개발 스택 PHP 8.2+, MariaDB 10.11+, Redis(캐시/세션), Nginx

1-2. 핵심 철학

"홈페이지 만드는 도구가 아니라, 찍으면 알아서 퍼지는 나만의 발행 시스템"

  • 윅스/아임웹 = 집 짓기 도구 → 만들고 나면 방치
  • BrandOS = 내가 움직이는 곳마다 자동으로 기록되고 알려지는 시스템

사용자가 하는 일: 사진 선택 → 한 줄 메모 → 올리기 버튼 하나
솔루션이 하는 일:

  • 내 브랜드 홈에 게시 (SEO 누적)
  • 인스타그램 자동 발행
  • 카카오스토리 자동 발행
  • 회원들에게 알림
  • 구글 검색에 내 이름이 쌓임

2. 경쟁 차별화 전략

2-1. 경쟁사 한계 분석

경쟁사 한계
윅스/아임웹 만들고 나면 끝. 운영·발행·SNS 연동은 사용자 몫 → 방치
AI 뚝딱 홈페이지 생성은 쉬우나 콘텐츠가 살아 움직이지 않음 → 예쁜 명함
SNS 직접 운영 플랫폼 알고리즘 종속, 계정 정지 시 전부 소멸, 플랫폼별 반복 노동

2-2. 5대 차별화 전략

① Zero Friction 입력 설계

  • 에디터를 없앰. 사진 → EXIF 날짜·장소 자동 추출 → 한 줄 메모 → 완료
  • 모바일 첫 화면 = 카메라롤 접근
  • 긴 글은 옵션, 기본은 사진+한줄+태그

② SEO 자동 누적

  • 올릴수록 검색 노출이 쌓이는 구조
  • Person 스키마, OG 태그 자동 생성
  • 올리는 행위 자체가 SEO 작업

③ SNS는 "복사"가 아닌 "연장" (플랫폼 독립 전략)

  • 원본은 내 홈에 존재
  • SNS는 트래픽을 내 홈으로 끌어오는 유입 채널
  • 계정이 막혀도 내 콘텐츠는 내 홈에 영구 보존

④ 타겟 특화 기능

  • 활동 연표: 연도별 활동 자동 정리 (이력 아카이빙)
  • 지지자 관계 관리: 생일 알림, 포인트(감사 표현)
  • 구역/지역 태깅: "○○구 활동" 자동 필터
  • 공약/약속 게시판: 진행 상태 추적 가능한 전용 스킨

⑤ 운영 부담 제로

  • 게시물 예약 발행
  • 자동 콘텐츠 리마인더 ("2주째 새 소식이 없어요")
  • 통계는 문장으로 표시 ("이번 주 127명이 홍보사진을 봤어요")

2-3. 공통 콘텐츠 허브 전략

중앙에서 고퀄리티 영상/정보성 게시물을 올리면 전체 테넌트 사이트에 노출.
테넌트별 URL로 공유 시 테넌트 브랜딩이 유지된 채로 전달됨.

공통 게시물 원본: https://myoc.kr/_common/health/123
홍길동 테넌트 공유 URL: https://myoc.kr/hong/health/123
→ 카카오톡 수신자가 링크 열면 홍길동 브랜딩으로 공통 콘텐츠 표시
→ 자연스럽게 홍길동 팬/지지자 유입으로 연결

효과: 공통 콘텐츠 1건 → 수만 테넌트가 각자 팔로워에게 자연 확산

https://claude.ai/public/artifacts/e3618f3c-5a8c-4ae4-b4c5-8823dbab363b