Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 15 additions & 0 deletions docs/hero-auctions.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
# Hero 관리·XP 광고 경매

API 제공자는 Auth이며 BFF는 `/api/hero`, `/api/user/hero`, `/api/admin/hero`를 Gateway의 `/das`로 전달한다. 세부 API 계약은 Auth의 `docs/hero-api.md`를 따른다.

- `/admin/hero`: 기본 이미지 1~10개 등록·수정·soft delete·순서 변경, 한국 시간 노출 일정, 시간별 최종 노출 미리보기, 사용자 소재 차단, 주차 전체 취소·환불.
- `/hero-auctions`: 소재 등록·선택, 1·2번 개별 입찰, 예약 XP와 참여·거래 이력. 경매 규칙은 화면에서 확인할 수 있다.
- 마이페이지 XP는 `currentXp`를 표시하며 활동 합계 `totalXp`는 기존 API 의미를 유지한다. Auth 우선 배포 중에는 아직 새 필드가 없는 응답만 기존 XP를 표시한다.
- 경매와 지갑은 30초마다 갱신하며 서버 시각으로 마감을 판정한다. 확정은 서버에서 수행한다. 동일 요청의 재시도에는 같은 입찰 멱등성 키를 사용한다.
- Hero는 30초·일정 경계·탭 복귀 시 갱신한다. 종료된 광고는 조회 실패 중에도 제거한다. 공개 조회는 인증 쿠키를 전달하지 않는다.
- 관리 및 사용자 변경 요청은 `X-Hero-Action: 1`과 동일 출처 Origin이 필요하다. 인증은 Auth의 access-token 쿠키를 사용한다.
- 업로드는 JPEG/PNG, 10 MiB, 2,400만 화소 제한이다. 링크 허용 사례는 `hero-link-fixtures.json`을 Auth와 동일하게 유지한다.

검증: `npm run verify`. 주요 회귀 검증은 Hero 캐러셀·일정 만료, URL 우회, BFF 쿠키/CSRF 경계, 관리자 최소 이미지 보호, 입찰 자격·소재 선택, 외부 상위 입찰 후 XP 예약 해제 표시다.

운영에서는 Auth 스키마와 API를 먼저 배포한 후 프런트를 배포한다. Auth의 경매 활성화 및 시작일 설정 전에는 경매 오픈 준비 상태를 표시한다. PR 병합과 운영 설정 변경은 별도 승인 절차를 따른다.
114 changes: 114 additions & 0 deletions docs/hero-link-fixtures.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,114 @@
[
{
"url": "",
"valid": true
},
{
"url": "https://www.memonogi.com",
"valid": true
},
{
"url": "https://guild.memonogi.com/path?q=1#top",
"valid": true
},
{
"url": "HTTPS://WWW.MEMONOGI.COM:443/a",
"valid": true
},
{
"url": "https://a.b.memonogi.com/길드",
"valid": true
},
{
"url": "https://www.memonogi.com/a%20b",
"valid": true
},
{
"url": " ",
"valid": false
},
{
"url": "http://www.memonogi.com",
"valid": false
},
{
"url": "https://memonogi.com",
"valid": false
},
{
"url": "/guilds",
"valid": false
},
{
"url": "//www.memonogi.com",
"valid": false
},
{
"url": "https://memonogi.com.evil.com",
"valid": false
},
{
"url": "https://evil-memonogi.com",
"valid": false
},
{
"url": "https://www.memonogi.com@evil.com",
"valid": false
},
{
"url": "https://@www.memonogi.com",
"valid": false
},
{
"url": "https://user:password@www.memonogi.com",
"valid": false
},
{
"url": "https://www.memonogi.com:444",
"valid": false
},
{
"url": "https://www.memonogi.com.",
"valid": false
},
{
"url": "https://-bad.memonogi.com",
"valid": false
},
{
"url": "https://bad_.memonogi.com",
"valid": false
},
{
"url": "https://www..memonogi.com",
"valid": false
},
{
"url": "https://한글.memonogi.com",
"valid": false
},
{
"url": "https://%77ww.memonogi.com",
"valid": false
},
{
"url": "https://www.memonogi.com/%zz",
"valid": false
},
{
"url": "https://www.memonogi.com/%",
"valid": false
},
{
"url": "https://www.memonogi.com\\@evil.com",
"valid": false
},
{
"url": "https://www.memonogi.com/\nfoo",
"valid": false
},
{
"url": "https://www.memonogi.com/aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"valid": false
}
]
4 changes: 2 additions & 2 deletions package-lock.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "devnogi-front",
"version": "1.0.26",
"version": "1.0.27",
"private": true,
"scripts": {
"dev": "next dev",
Expand Down
2 changes: 1 addition & 1 deletion scripts/test-production-workflow.mjs
Original file line number Diff line number Diff line change
Expand Up @@ -64,7 +64,7 @@ test("production Compose requires the immutable image reference", () => {
test("package and lockfile agree on the next release version", () => {
const pkg = JSON.parse(read("package.json"));
const lock = JSON.parse(read("package-lock.json"));
assert.equal(pkg.version, "1.0.26");
assert.equal(pkg.version, "1.0.27");
assert.equal(lock.version, pkg.version);
assert.equal(lock.packages[""].version, pkg.version);
});
2 changes: 1 addition & 1 deletion scripts/workflow-contract.test.mjs
Original file line number Diff line number Diff line change
Expand Up @@ -68,7 +68,7 @@ test("release version and immutable image contract are fixed", () => {
);
const pkg = JSON.parse(read("package.json"));
const lock = JSON.parse(read("package-lock.json"));
assert.equal(pkg.version, "1.0.26");
assert.equal(pkg.version, "1.0.27");
assert.equal(lock.version, pkg.version);
assert.equal(lock.packages[""].version, pkg.version);
assert.match(
Expand Down
Loading
Loading