53 lines
3.4 KiB
Markdown
53 lines
3.4 KiB
Markdown
# KINTEX AI 전시관리 — 모바일 앱 (mobile/)
|
|
|
|
React Native + Expo(expo-router, TypeScript) 모바일 앱. 조회·승인·현장 시나리오 전용
|
|
(design.md §4). 백엔드는 공유 API `https://kintex.zioinfo.co.kr`.
|
|
|
|
## 스택
|
|
- Expo SDK 51 · expo-router ~3.5 · React Native 0.74 · TypeScript
|
|
- JWT는 `expo-secure-store`(네이티브 keychain/keystore)에 저장, 웹은 AsyncStorage 폴백
|
|
- 디자인 토큰: `theme/`(docs/design.md §1 팔레트·타이포). 신규 토큰 없음.
|
|
|
|
## 실행
|
|
```bash
|
|
cd mobile
|
|
npm install
|
|
npm run typecheck # tsc --noEmit
|
|
npm start # Expo 개발 서버 (Expo Go / 에뮬레이터)
|
|
```
|
|
|
|
API 베이스는 `app.json > extra.apiBase` 또는 `EXPO_PUBLIC_API_BASE` 환경변수로 재정의.
|
|
시크릿(키 등)은 하드코딩하지 않는다.
|
|
|
|
## 화면
|
|
| 경로 | 화면 | 근거 |
|
|
|---|---|---|
|
|
| `app/login.tsx` | 로그인(2FA/OTP·아이디 기억·비번찾기/회원가입) | SCR-01 |
|
|
| `app/register.tsx` | 회원가입 | 04_backend_public_auth §1 |
|
|
| `app/forgot-password.tsx` | 비밀번호 찾기/초기화 | 04 §2·§3 |
|
|
| `app/(tabs)/index.tsx` | 홈/대시보드(역할별 진입) | design §2-2 |
|
|
| `app/(tabs)/field.tsx` | 현장 허브(역할 분기) | — |
|
|
| `app/(tabs)/gallery.tsx` | 시각화 갤러리(워터마크 상시) | SCR-12 |
|
|
| `app/(tabs)/more.tsx` | 계정(내정보 진입)·서버 상태·로그아웃 | — |
|
|
| `app/profile.tsx` | 내정보(WISE mypage 이식·생체인식 잠금·프로필 사진 등록) | WISE `uiws/mypage.tsx` |
|
|
| `app/checklist.tsx` | 현장 체크리스트(48px 터치·오프라인·사진) | SCR-M1 |
|
|
| `app/inspection.tsx` | 현장 검수(승인/반려·AI 플래그) | SCR-M2 |
|
|
|
|
## 계약·보안 준수
|
|
- 응답 오류 봉투 `{ success, data, error }` 처리(`lib/api.ts`), degraded 폴백(`isDegraded`).
|
|
- AI 생성 이미지는 `components/AiImage.tsx`가 워터마크 + "AI 생성 예상 이미지" 고지를 **항상** 표시(제거 불가).
|
|
- 비밀번호는 저장하지 않음. "아이디 기억"은 이메일만 AsyncStorage 보관.
|
|
|
|
## 보안 하드닝(위변조 방지 · 화면보호)
|
|
근거: `docs/security/mobile-security-audit.md`(B1~B13) · 상세: `_workspace/08_mobile_security_hardening.md`. 모두 방어적(네이티브 미지원 기기 graceful).
|
|
- **위변조 탐지(B1/B9)**: `lib/integrity.ts`(jail-monkey) — 루팅·후킹·디버거·개발자모드·USB 디버깅 탐지. 로그인 시 비차단 경고(공공 대민 정책).
|
|
- **화면캡처 방지(B4)+백그라운드 마스킹(B7)**: `context/SecureScreenContext.tsx`의 `useSecureScreen(key)` — 2FA 로그인·티켓 QR·내정보에서 캡처 차단(FLAG_SECURE)+태스크 스위처 마스킹.
|
|
- **난독화(B3)·cleartext 차단(B5)·권한 최소화(B10)**: `app.json`(Hermes·expo-build-properties R8/ProGuard·usesCleartextTraffic:false·iOS ATS·android.permissions/blockedPermissions).
|
|
- **앱 무결성 토큰(B2 전송부)**: `lib/api.ts`가 `X-Integrity-Token` 조건부 첨부(발급기 등록 시). 서버 검증은 backend-dev 인계.
|
|
- **한계**: 인증서 피닝(B6)은 회귀 위험으로 미도입 — 커스텀 config plugin 경로 문서화(`_workspace/08`). EAS 실빌드는 devops·G3 게이트.
|
|
|
|
## 남은 작업
|
|
- 실 화면 데이터 API 배선 확대(부스 목록·검수 요청 제출 — 백엔드 M6/C-4 확장 대기).
|
|
- 앱 아이콘/스플래시 에셋(`assets/`), i18n, 푸시 알림.
|
|
- EAS 실빌드(eas.json 프로파일) — 본 스캐폴드 범위 밖.
|