HeuJung
b5c0ec1178
관리자 상품목록을 한 페이지 여는 것만으로 그 페이지 모든 상품의 옵션이 응답에 실렸다. 같은 패턴을 저장소 전역에서 찾아 14개 목록 엔드포인트를 함께 정리했다. 근본 원인은 둘이다. Resource 가 whenLoaded 로 방어하는데 Repository 가 목록 쿼리에서 관계를 무조건 로드해 가드가 항상 참이 되는 가짜 가드, 그리고 toListArray 경량 표현을 정의해 두고도 컬렉션이 toArray 를 부르는 목록/상세 미분리다. 둘 다 응답만 보면 정상이라 오류도 경고도 없이 페이로드만 불어난다. 목록은 화면이 실제로 그리는 것만 싣는다. 개수·합계는 PHP 컬렉션 연산이 아니라 DB 집계로, 대표 1건이 필요한 곳은 관계 자체를 oldestOfMany 로 좁힌다. eager load 의 limit(1) 은 부모별이 아니라 배치 쿼리 전체에 걸려 첫 행만 값을 갖게 되므로 쓸 수 없다. 뺀 값에는 대체 경로를 먼저 만들었다. 상품 옵션은 행을 펼칠 때 배치로 불러오고(상품 수와 무관하게 쿼리 상수), 종전 동작이 필요한 호출자를 위해 ?with_options=1 등 opt-in 을 남겼다. 배송정책 국가설정과 리뷰 첨부 이미지는 소비처를 실측한 결과 화면이 실제로 그리고 있어 제거하지 않았다 — 그 소비 사실을 회귀 테스트로 고정했다. 재발 방지로 정적 검사 룰 4종과 규정 문서 항목을 함께 넣었다.
47 lines
2.3 KiB
Markdown
47 lines
2.3 KiB
Markdown
# API 레퍼런스 문서 목차
|
|
|
|
> **소유**: 모듈 `sirsoft-ecommerce` · **생성**: `php artisan api:docgen` (실측 기반).
|
|
> 아래 표는 자동 생성됩니다. 각 문서를 열면 엔드포인트별 파라미터·응답·예시를 볼 수 있습니다.
|
|
|
|
<!-- @generated:start:api-readme-index -->
|
|
- **문서 수**: 33 · **엔드포인트 수**: 232
|
|
|
|
| 문서 | 도메인 | 엔드포인트 |
|
|
| --- | --- | --- |
|
|
| [addresses.md](addresses.md) | `addresses` | 6 |
|
|
| [brands.md](brands.md) | `brands` | 6 |
|
|
| [cart.md](cart.md) | `cart` | 11 |
|
|
| [categories.md](categories.md) | `categories` | 14 |
|
|
| [category-image.md](category-image.md) | `category-image` | 1 |
|
|
| [checkout.md](checkout.md) | `checkout` | 5 |
|
|
| [claim-reasons.md](claim-reasons.md) | `claim-reasons` | 8 |
|
|
| [coupons.md](coupons.md) | `coupons` | 4 |
|
|
| [currency.md](currency.md) | `currency` | 2 |
|
|
| [dashboard.md](dashboard.md) | `dashboard` | 4 |
|
|
| [extra-fee-templates.md](extra-fee-templates.md) | `extra-fee-templates` | 10 |
|
|
| [guest.md](guest.md) | `guest` | 5 |
|
|
| [inquiries.md](inquiries.md) | `inquiries` | 10 |
|
|
| [mileage.md](mileage.md) | `mileage` | 3 |
|
|
| [mileage-transactions.md](mileage-transactions.md) | `mileage-transactions` | 5 |
|
|
| [options.md](options.md) | `options` | 3 |
|
|
| [orders.md](orders.md) | `orders` | 22 |
|
|
| [payments.md](payments.md) | `payments` | 1 |
|
|
| [presets.md](presets.md) | `presets` | 4 |
|
|
| [product-common-infos.md](product-common-infos.md) | `product-common-infos` | 6 |
|
|
| [product-image.md](product-image.md) | `product-image` | 1 |
|
|
| [product-labels.md](product-labels.md) | `product-labels` | 6 |
|
|
| [product-notice-templates.md](product-notice-templates.md) | `product-notice-templates` | 7 |
|
|
| [products.md](products.md) | `products` | 31 |
|
|
| [promotion-coupons.md](promotion-coupons.md) | `promotion-coupons` | 9 |
|
|
| [review-image.md](review-image.md) | `review-image` | 1 |
|
|
| [reviews.md](reviews.md) | `reviews` | 12 |
|
|
| [settings.md](settings.md) | `settings` | 10 |
|
|
| [shipping-carriers.md](shipping-carriers.md) | `shipping-carriers` | 7 |
|
|
| [shipping-country.md](shipping-country.md) | `shipping-country` | 2 |
|
|
| [shipping-policies.md](shipping-policies.md) | `shipping-policies` | 11 |
|
|
| [users.md](users.md) | `users` | 2 |
|
|
| [wishlist.md](wishlist.md) | `wishlist` | 3 |
|
|
|
|
<!-- @generated:end -->
|
|
|