# Tencent Cloud 기반 WeChat 미니프로그램 백엔드 개발 아이데이션 보고서

## 1. 프로젝트 분석 요약

### 프로젝트 기본 정보
- 공고 번호: 156507
- 공고명: Tencent Cloud 기반 WeChat 미니프로그램 백엔드 개발
- 예산: 15,000,000원
- 기간: 60일
- 분야: 백엔드 API, 관리자 웹, 클라우드 인프라
- 진행 상태: 신규 구축
- 기획 상태: 필요한 내용을 간단히 정리한 상태
- 시작 일정: 계약 체결 이후 즉시 시작
- 모집 마감: 2026년 07월 07일

### 주요 요구사항
1. WeChat 미니프로그램용 백엔드 API 서버 구축
   - WeChat 사용자 로그인 API 연동
   - 사용자 고유 ID 저장
   - 사고 분석 신청 등록 API 제공
   - 사건 목록 및 상세 조회 API 제공
   - 사건 진행 상태 조회 API 제공
   - 결과 영상 및 PDF 보고서 조회, 내려받기 API 제공

2. 대용량 사고 영상 업로드 구조 구축
   - Tencent COS 같은 클라우드 저장소 연동
   - 서버 부하를 줄이는 직접 업로드 또는 서명 업로드 구조 설계
   - 업로드된 영상과 사건 데이터의 안정적 연결

3. 관리자 웹페이지 구축
   - 사건 목록 조회와 상태별 필터링
   - 사건 상세 정보 및 사용자 입력값 확인
   - 원본 사고 영상 브라우저 내 확인
   - 사건 상태 변경
   - 분석 완료 영상과 PDF 보고서 업로드
   - 상태별 건수 기반 기본 통계 대시보드

4. Tencent Cloud 인프라 세팅 및 배포
   - Tencent Cloud 환경에 API 서버, DB, 저장소, 배포 구조 구성
   - 운영 가능한 서버 세팅과 접근 권한 정리
   - 장애 대응과 로그 확인이 가능한 기본 운영 구조 마련

5. 중국 현지 프론트엔드 개발팀과 API 연동 지원
   - Swagger 기반 API 명세서 작성
   - 연동 테스트와 디버깅 지원
   - 요청과 응답 규격, 오류 코드, 파일 업로드 흐름을 명확히 문서화

### 필수 요소
- Tencent Cloud 환경 이해와 실제 배포 역량
- WeChat 로그인 흐름과 미니프로그램 API 연동 경험 또는 빠른 검증 역량
- 대용량 영상 업로드를 위한 저장소 직접 업로드 구조
- 사고 접수, 상태 변경, 결과물 등록까지 이어지는 사건 중심 데이터 모델
- 중국 현지 개발팀과 맞춰갈 수 있는 문서화 중심 협업 방식
- 2주 내 API 명세서 공유라는 빠른 초반 산출물 제공 능력

### 핵심 집중 포인트
- 이 프로젝트의 핵심은 단순 어드민 제작이 아니라, 중국 현지 미니프로그램 프론트엔드와 안정적으로 맞물리는 백엔드 중추를 만드는 것입니다.
- 클라이언트는 이미 현지 개발팀을 두고 있으므로, 한국 개발팀에게 기대하는 가치는 API 설계 품질, 인프라 안정성, 문서화, 연동 지원입니다.
- 사고 영상은 용량이 크고 사용자가 직접 올리는 핵심 데이터이므로, 업로드 안정성과 서버 부하 제어가 프로젝트 성공을 좌우합니다.
- 60일 안에 완료해야 하므로 처음 2주 동안 DB 설계와 API 명세를 빠르게 확정하고, 이후 기능 구현과 연동 테스트를 병렬로 진행해야 합니다.

### 권장 기술 스택
- 백엔드: Node.js 기반 NestJS 또는 Express
- 관리자 웹: React, Next.js 또는 Vite 기반 React
- 데이터베이스: MySQL 또는 PostgreSQL
- 파일 저장소: Tencent COS
- 클라우드: Tencent Cloud CVM, COS, VPC, SSL, 보안 그룹
- API 문서: Swagger 또는 OpenAPI
- 인증: WeChat 로그인 연동, 서버 발급 서비스 토큰, 관리자 권한 분리
- 운영: Docker, PM2 또는 Tencent Cloud 배포 방식, 로그 수집, 기본 모니터링

## 2. 전략적 역제안

### 제안 핵심 메시지
우리팀은 이 프로젝트를 단순한 API 외주가 아니라, 중국 현지 프론트엔드 개발팀과 한국 운영팀 사이를 연결하는 사고 분석 서비스 백엔드 허브로 설계하겠습니다.

핵심은 세 가지입니다.
1. 미니프로그램이 바로 붙을 수 있는 명확한 API 계약
2. 대용량 사고 영상을 안전하게 받는 부하 분산 업로드 구조
3. 운영자가 사건 상태와 결과물을 놓치지 않는 관리자 워크플로우

### 시너지 도출
- 클라이언트는 미니프로그램 UI 개발을 현지 팀에 맡기고 있고, 우리팀은 백엔드와 어드민, 인프라, API 문서화를 맡게 됩니다.
- 이 구조에서는 개발 속도보다 인터페이스 합의가 먼저입니다. 우리팀은 착수 초기에 API 명세, 데이터 모델, 상태 흐름, 업로드 방식을 먼저 고정해 현지팀의 대기 시간을 줄이겠습니다.
- 관리자 화면은 상용 어드민 템플릿을 활용해 구현 속도를 확보하되, 사건 상태 변경과 결과물 업로드 흐름은 서비스 도메인에 맞게 선명하게 커스터마이징하겠습니다.

### 결과물 정의
1. 미니프로그램 연동용 백엔드 API 서버
   - 로그인, 사고 접수, 영상 업로드, 사건 목록, 상태 조회, 결과물 조회 API

2. 관리자 웹페이지
   - 사건 목록, 상세 보기, 영상 확인, 상태 변경, 결과물 업로드, 통계 대시보드

3. Tencent Cloud 운영 환경
   - 서버, DB, 저장소, 배포, 보안 그룹, 기본 운영 절차

4. API 명세서와 연동 가이드
   - Swagger 문서
   - 인증 방식 안내
   - 영상 업로드 순서도
   - 오류 코드 정의
   - 현지 프론트엔드 연동 테스트 체크리스트

5. 납품 문서
   - DB 구조 설명
   - 배포 절차
   - 관리자 사용 안내
   - 운영 점검 항목

### 유사 경험 기반 인사이트
- 외부 프론트엔드 팀과 협업하는 프로젝트는 초반 화면 개발보다 API 계약서의 선명도가 성패를 좌우합니다.
- 대용량 파일 업로드는 서버가 파일을 직접 받는 방식보다 클라이언트가 저장소로 직접 올리고 서버는 메타데이터만 관리하는 방식이 안정적입니다.
- 사건 처리형 서비스는 상태값을 단순 문자열로 두면 운영 중 혼란이 생기기 쉽습니다. 상태 변경 이력, 관리자 메모, 결과물 버전 관리를 함께 설계해야 합니다.
- 해외 개발팀과의 협업에서는 말로 설명하는 것보다 예시 요청, 예시 응답, 오류 응답, 테스트 계정, 샘플 파일이 훨씬 빠릅니다.

## 3. 프로젝트 키컬러 선정

- HEX: #0F766E
- HSL: hsl(176, 77%, 26%)
- 컬러명: Tencent Teal
- 선정 이유: Tencent Cloud와 사고 분석 서비스의 핵심 이미지는 안정성, 신뢰, 데이터 보안, 기술 운영입니다. 짙은 청록 계열은 클라우드 인프라와 보안성, 영상 데이터 처리의 차분함을 함께 전달합니다. 기본 파란색을 피하면서도 관리자 시스템과 API 허브에 어울리는 전문적인 인상을 줄 수 있어 이 프로젝트의 주 색상으로 적합합니다.

## 4. 데이터 주입 설계안

### 02. 포털 화면 데이터 방향
- PAGE_TITLE: WeChat 사고 분석 백엔드 허브
- HEADER_BADGE: Backend and Admin Delivery Package
- HEADER_TITLE: WeChat 사고 분석 접수 서비스 백엔드 구축
- HEADER_DESC: Tencent Cloud 기반 API, 대용량 영상 업로드, 관리자 운영 화면을 하나의 납품 패키지로 정리한 제안 포털
- CARD1_TITLE: 전략 제안서
- CARD1_DESC: API 계약, 업로드 구조, 운영 워크플로우, 일정 전략을 중심으로 프로젝트 성공 방안을 제시
- CARD2_TITLE: 사전 기획서
- CARD2_DESC: 미니프로그램 사용자, 현지 프론트엔드 개발자, 관리자 관점의 화면과 흐름을 설계
- CARD3_TITLE: 인터랙티브 데모
- CARD3_DESC: 사고 접수부터 관리자 결과물 등록까지의 핵심 흐름을 실제처럼 체험

### 03. 제안서 데이터 방향
- 슬라이드 2 핵심 요구사항 카드
  - WeChat 로그인 및 사용자 식별
  - 대용량 사고 영상 업로드
  - 사건 상태 관리와 결과물 제공
- 슬라이드 2 인사이트 카드
  - API 계약 우선 전략
  - 저장소 직접 업로드 구조
  - 운영자 중심 사건 처리 흐름
- 슬라이드 3 전략 과제
  - API 명세 선확정과 현지팀 병렬 연동
  - Tencent COS 기반 영상 업로드 안정화
  - 어드민 템플릿 기반 빠른 운영 화면 완성
- 슬라이드 4 기술 구조
  - 프론트엔드: React, 관리자 템플릿, 상태 관리
  - 백엔드: Node.js, Swagger, WeChat 인증 연동
  - 저장소와 데이터: Tencent COS, MySQL 또는 PostgreSQL
  - 운영: Tencent Cloud, Docker, 로그, 보안 그룹
- 슬라이드 7 일정
  - 1~2주: 요구사항 정리, DB 설계, API 명세
  - 3~4주: 핵심 API와 업로드 구조 구현
  - 5~6주: 관리자 웹과 결과물 등록 흐름 구현
  - 7~8주: 현지팀 연동 테스트, 배포, 안정화

### 04. 와이어프레임 데이터 방향
- 유저 타입 1: 미니프로그램 사용자
  - 로그인
  - 사고 정보 입력
  - 영상 업로드
  - 진행 상태 확인
  - 결과 영상과 PDF 확인
- 유저 타입 2: 중국 현지 프론트엔드 개발자
  - Swagger 문서 확인
  - 인증 토큰 테스트
  - 업로드 서명 요청
  - 사고 접수 API 호출
  - 오류 응답 디버깅
- 유저 타입 3: 관리자
  - 사건 목록 필터링
  - 사건 상세와 원본 영상 확인
  - 상태 변경
  - 결과 영상과 PDF 업로드
  - 통계 대시보드 확인

### 05. 데모 데이터 방향
- 데모 제목: 사고 분석 접수 백엔드 운영 데모
- 시작 화면: 사용자가 사고 영상을 업로드하면, 관리자가 분석 상태를 관리하고 결과물을 등록하는 전체 흐름을 보여줍니다.
- 주요 시나리오
  1. 미니프로그램에서 사고 접수 생성
  2. Tencent COS에 영상 직접 업로드
  3. 관리자가 신규 사건 확인
  4. 분석 완료 후 결과 영상과 PDF 등록
  5. 사용자가 결과를 확인

## 5. 슬라이드별 상세 구성안

### 슬라이드 1. 표지
- 제목: WeChat 사고 분석 접수 서비스 백엔드 구축 제안
- 부제: Tencent Cloud 기반 API, 영상 업로드, 관리자 운영 시스템 통합 구축
- 핵심 문구: 현지 프론트엔드와 한국 운영팀을 연결하는 안정적인 백엔드 허브를 만듭니다.

### 슬라이드 2. 요구사항 분석 및 핵심 전략
- 메시지: 이 프로젝트는 화면보다 API 계약과 영상 업로드 구조가 먼저입니다.
- 구성 요소
  - WeChat 사용자 식별
  - 사고 접수 API
  - Tencent COS 영상 업로드
  - 관리자 사건 처리
  - Swagger 기반 연동 문서
- 강조점: 2주 안에 현지팀이 개발을 멈추지 않도록 API 명세를 먼저 제공합니다.

### 슬라이드 3. 전략 과제별 개발 방안
- 과제 1: API 계약 우선 설계
  - 효과: 현지 개발팀과 병렬 개발 가능
- 과제 2: 대용량 업로드 부하 분산
  - 효과: 서버 장애 위험 감소
- 과제 3: 운영자 중심 사건 워크플로우
  - 효과: 접수, 분석, 완료, 보류 상태가 명확해짐

### 슬라이드 4. 기술 아키텍처
- 관리자 웹: React 기반 상용 어드민 템플릿 활용
- 백엔드: Node.js 기반 REST API와 Swagger 문서
- 저장소: Tencent COS 직접 업로드 구조
- 데이터베이스: MySQL 또는 PostgreSQL
- 클라우드: Tencent Cloud 서버, 보안 그룹, SSL, 배포 자동화
- 운영: 로그, 오류 추적, 기본 모니터링

### 슬라이드 5. 협업 및 문서화 방식
- 메시지: 해외 프론트엔드 협업은 문서, 샘플, 테스트 환경이 핵심입니다.
- 구성 요소
  - API 명세서
  - 샘플 요청과 응답
  - 오류 코드표
  - 업로드 흐름도
  - 테스트 계정과 테스트 파일
- 강조점: 커뮤니케이션 비용을 줄이기 위해 모든 연동 지점을 문서로 고정합니다.

### 슬라이드 6. 관리자 화면 구성
- 메시지: 관리자는 사건 상태와 결과물 등록만 빠르게 처리할 수 있어야 합니다.
- 화면 구성
  - 상태별 사건 목록
  - 사건 상세 정보
  - 원본 영상 미리보기
  - 상태 변경 패널
  - 결과 영상 및 PDF 업로드
  - 상태별 통계 카드

### 슬라이드 7. 60일 실행 일정
- 1~2주: 요구사항 확정, DB 설계, API 명세서, 인프라 기본 세팅
- 3~4주: 로그인, 사고 접수, 목록, 상세, 업로드 API 구현
- 5~6주: 관리자 웹, 상태 관리, 결과물 업로드, 통계 대시보드 구현
- 7~8주: 현지팀 연동 테스트, 버그 수정, 배포, 운영 문서 납품
- 강조점: 초반 2주 산출물로 프로젝트 전체 리스크를 낮춥니다.

### 슬라이드 8. 우리팀 수행 강점 및 마무리
- 메시지: 우리팀은 빠른 구현보다 안정적인 연동과 운영 가능한 납품을 우선합니다.
- 강점
  - API 중심 백엔드 설계
  - 관리자 웹 빠른 구축
  - 외부 개발팀과 협업 가능한 문서화
  - 클라우드 배포와 운영 구조 설계
  - 일정 안에 산출물을 단계별로 확인시키는 진행 방식
- 마무리 문구: 60일 안에 현지팀이 붙기 쉬운 API, 관리자가 쓰기 쉬운 어드민, 운영자가 믿을 수 있는 Tencent Cloud 기반 백엔드를 제공하겠습니다.

## 승인 요청

위 아이데이션 방향으로 진행하면 다음 단계에서 포털, 제안서, 와이어프레임, 데모를 같은 전략과 색상 체계로 제작하겠습니다.
승인해 주시면 02단계 포털 생성으로 넘어가겠습니다.