---
status: stable
page_id: A08_Support
related_pages: ["[[A08_Support/A08_frontend]]", "[[A06_Login/A06_backend]]", "[[db_schema/logs_monitoring]]"]
last_updated: 2026-07-12
---

# A08_Support — Backend

기술지원 문의 접수 API. `support_requests` 테이블 저장 + 관리자 알림 메일.

## 파일 구조

| 파일 | 위치 | 역할 |
|---|---|---|
| `A08_Support_Router.py` | `A08_Support/A08_Support_Router.py:1-68` | 문의 접수 API (prefix `/api/a08`) |
| `A08_Support_Schema.py` | `A08_Support/A08_Support_Schema.py:1-13` | 문의 요청 검증 Pydantic 모델 |

## API 엔드포인트

| 엔드포인트 | 위치 | 역할 |
|---|---|---|
| `POST /api/a08/support` | `A08_Support/A08_Support_Router.py:27` | 문의 접수. DB 저장 + ADMIN_EMAIL로 알림 메일 |

## 내부 헬퍼

| 함수 | 위치 | 역할 |
|---|---|---|
| `_get_company_name(company_id)` | `A08_Support/A08_Support_Router.py:16` | company_id로 회사명 조회 (없으면 None) |

## 요청 스키마 (Pydantic)

| 모델 | 위치 | 필드 |
|---|---|---|
| `SupportRequestPayload` | `A08_Support/A08_Support_Schema.py:6` | name(1~255), email(EmailStr), phone?(≤30), subject(1~255), message(1~5000) |

## 접수 로직

1. `get_optional_session()`으로 로그인 여부 확인 (비로그인 허용)
2. 로그인 상태면 세션의 `company_id` → `_get_company_name()`으로 회사명 조회, 비로그인이면 None
3. `support_requests` INSERT (아래 컬럼)
4. ADMIN_EMAIL 설정 시 관리자에게 문의 알림 메일 발송

## DB 저장 컬럼 (실 코드 INSERT 기준)

`support_requests`에 INSERT하는 컬럼:
`company_id, company_name, user_name, user_email, user_phone, subject, message`

→ 테이블 정의 → [[db_schema/logs_monitoring]]

## 특징

- **비로그인도 문의 가능** (`get_optional_session`): 세션 없으면 회사 정보만 None으로 저장
- 로그인 상태면 회사 정보 자동 연결

## 의존성 (공통 유틸)

- [[common_util]] — `common_util_auth`(`get_optional_session`), `common_util_email`(`send_email_background`), `common_util_email_templates`(`support_request_email`)
- `config_system` — `ADMIN_EMAIL`
- DB → [[db_schema/logs_monitoring]]

## ⚠️ DB 스키마 불일치 (확인 필요)

[[db_schema/logs_monitoring]]의 `support_requests` 컬럼은 계획서 기준
(`user_id, title, priority, status`)인데, 실 코드 INSERT는
`company_id, company_name, user_name, user_email, user_phone, subject, message`.
컬럼명이 다름 — 실 DB 스키마 대조 필요 (규칙6: 실 코드 우선). logs_monitoring 갱신 대상.