2 Commits

Include renames

Author	SHA1	Message	Date
HeuJung	809409f3cf	fix(api-docs): 문서 샘플 언어팩이 전역 지원 로케일을 오염시키는 문제 수정 ... api:docgen --seed 가 생성하는 샘플 언어팩이 scope=core + status=active 로 만들어져 getActiveCoreLocales 승격 쿼리에 걸렸다. 그 결과 시스템 전역 supported_locales/translatable_locales 가 넓어지고, 그 아래에서 시드된 다국어 데이터에 실재하지 않는 로케일 키가 박혔다. 샘플을 비활성화하면 그 키가 TranslatableField 검증을 통과하지 못해 저장이 막힌다. 문서용 샘플은 조회 예시일 뿐 시스템 동작을 바꿀 자격이 없으므로, 승격 경로를 벗어난 조합(module 스코프 + installed 상태 + 실재 번들 로케일) 으로 생성하도록 바꾸고 audit 룰로 재발을 차단한다. README 재생성 시 사람이 덧붙인 헤딩 섹션이 통째로 소실되던 사전 결함도 함께 수정했다(경계를 임의의 ## 이 아닌 확장 목차 헤딩으로 특정).	2026-07-10 19:27:27 +09:00
HeuJung	70452745c4	feat(api-docs): API 레퍼런스 문서 전면화 — 추출 파이프라인·전 대상 문서화·audit 강제 ... 코드에만 존재하던 REST API 계약(약 663 엔드포인트)을 코어/확장 책임별로 분리된 마크다운 레퍼런스로 전면 문서화한다. 674개 규모에서 수기 문서는 반드시 drift 하므로 "코드 추출 → 스캐폴딩 → 사람이 서술 채움 → 하네스가 커버리지 강제" 하이브리드로 구성했다. 추출 파이프라인 (app/Support/ApiDoc): - ApiRouteInventory / FormRequestIntrospector / ApiEndpointProbe(실측 HTTP) / ResponseSchemaInferrer / ApiDocScaffolder / ColumnCommentResolver / ResourceFieldDescriber / ParameterDescriber - api:docgen 커맨드(--scope/--seed/--check/--dry-run/--base-url/--user) + 응답/파라미터 in-place 백필 커맨드 2종(재생성 없이 TODO 셀만 치환, 멱등) - ApiDocSampleSeeder 계약 + 코어/확장 시더로 실측용 완전 샘플 멱등 생성 문서화 (실측 기반, GET read-only 실호출): - 코어 291엔드포인트 35파일(docs/backend/api) + 규정 docs/backend/api-documentation.md - 확장: ecommerce(231)·board(80)·page(17)·hello_module(2)·pay_kginicis(22)· gdpr(15)·ckeditor5(2)·marketing(2)·verification_kginicis(1) - 표준 4구성(헤더·요청 파라미터·응답 필드·에러 표) + 엔드포인트 용도 서술 - 파라미터 용도·응답 필드 설명 셀 전수 채움(도메인 지식 수기) 하네스: - audit 룰 api-doc-coverage — API 표면(라우트/컨트롤러/FormRequest/Resource) 변경 시 대응 문서 미동반이면 차단. 전 대상 문서 완비로 error 승격 - file-rules 리마인더(컨트롤러/라우트 편집 시), coverage.json, dev-dashboard 카드 - docs/backend/routing.md 확장 공개 API URL 스킴 정정(/api/modules|plugins/{id}) - /AGENTS.md/docs-index 동기	2026-07-08 18:22:33 +09:00