ABL 산출물 · PLAQ Lab

01

게시 현황

ABL은 운영 중인 시스템이라 대부분의 산출물이 코드 · 빌드 파이프라인에 이미 존재합니다. 이 페이지는 그것들이 어디에 있고 어떻게 만드는지를 가리킵니다.

산출물	위치 / 생성	상태
API 명세	Swagger `/api/docs` (컨트롤러 자동 생성)	존재
DB 스키마 · 마이그레이션	`apps/backend/src/migrations` (69개)	존재
웹 빌드	`pnpm build:frontend`	존재
백엔드 빌드	`pnpm build:backend`	존재
모바일 빌드	`flutter build ios/apk/appbundle --release`	존재
e2e 테스트	`pnpm test:e2e` (Playwright)	존재
ERD 다이어그램(내보내기)	—	미게시
테스트 커버리지 리포트	—	미게시

02

백엔드는 컨트롤러에서 Swagger(OpenAPI) 문서를 자동 생성합니다. 경로는 /api/docs이며, 운영에서는 비활성입니다(개발 환경에서 확인).

공개 API/api/leagues · /api/members/:id/public · /api/stats/leaderboard · /api/health

회원 API/api/match-days/:id/apply · /api/my/participations · /api/payments/my · /api/settlements/my 등 (JWT)

관리자 API/api/admin/* · /api/matching/batch-generate · /api/lanes/:id/assign · /api/verification/* (JWT + RBAC)

웹훅/api/webhooks/payment/pg-callback (HMAC 검증)

전체 그룹·권한은 개발 기획서 §06(API 구조)에 정리되어 있습니다.

03

스키마는 마이그레이션이 정본입니다(synchronize:false). 현재 69개가 있으며, 스키마 변경은 반드시 마이그레이션으로만 반영합니다.

마이그레이션apps/backend/src/migrations/{timestamp}-{PascalCaseName}.ts · 실행 pnpm --filter @abl/backend migration:run

datasource앱 src/config/database.config.ts(autoLoadEntities:true) · CLI src/config/typeorm.datasource.ts

엔티티(도메인 모델)TypeORM @Entity 클래스. 핵심 그룹은 개발 기획서 §03(도메인 모델) 참고.

04

대상	빌드	배포
웹(frontend)	`pnpm build:frontend`	`./scripts/deploy.sh --frontend`
백엔드(backend)	`pnpm build:backend`	`./scripts/deploy.sh --backend`
모바일 iOS	`flutter build ios --release`	App Store (수동)
모바일 Android	`flutter build appbundle --release`	Play Store (수동)

운영 API는 abl.plaq.co.kr/api로 서비스됩니다(별도 ABL 서버).

05

백엔드 유닛pnpm --filter @abl/backend test (jest)

백엔드 e2epnpm --filter @abl/backend test:e2e (.env.test 사용)

전체 e2epnpm test:e2e (Playwright)

06

아래는 실제로 만들어진 뒤에만 이 페이지에 링크합니다. 미리 채워 넣지 않습니다.

ERD 다이어그램(내보내기)

엔티티 관계도를 이미지/문서로 내보낸 산출물. 현재는 개발 기획서 §03의 개념 계층도로 대체.

테스트 커버리지 리포트

유닛/e2e 커버리지 측정 결과. 파이프라인에 커버리지 수집이 배선되면 게시.

참고 이 페이지는 산출물의 위치·생성법 인덱스입니다. 실제 명세·리포트 본문은 각 산출물이 있는 곳(Swagger · 저장소)에서 확인합니다.