diff --git a/docs/AI_AGENT.md b/docs/AI_AGENT.md index 0879d6e..31fbea4 100644 --- a/docs/AI_AGENT.md +++ b/docs/AI_AGENT.md @@ -144,3 +144,9 @@ Go 저장 구현에서 추가 값을 버리거나 새 상한/400/413을 먼저 [채택 범위 검토](docs/TRADING_REVIEW_REPROCESSING_REQUEST_PROFILE_REVIEW_DRAFT.md)를 후보와 함께 읽는다. 현재 Config hash/DTO는 같은 instant 표기까지 동일하게 보존하지 않는다. 신규 canonical 입력 표기 수정 권고와 수치 보류를 확인하고 Go에서 자동 정규화/int32 제한을 먼저 적용하지 않는다. ADR-082는 미채택이다. ADR-080/081과 legacy hash/key·원 receipt를 유지하며 source/국소 관측·실제 업무/운영 수용을 구분한다. + +## ADR-082 요청 예산 검토 + +[예산 조합/경계](docs/TRADING_REVIEW_REPROCESSING_REQUEST_BUDGET_REVIEW_DRAFT.md)를 읽는다. +VersionIdentifier200자·UTF8 bytes·map 개수·wire body 예산은 서로 다르며 모두 충족해야 한다. synthetic schema/byte 관측을 실제 HTTP/운영 수용으로 보지 않는다. +정책 채택은 명시 결정 대기이고 정확 수치는 후보다. 현재 schema/hash/legacy·ADR-080/081을 유지한다. diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md index 8b76a4f..cf13a94 100644 --- a/docs/ARCHITECTURE.md +++ b/docs/ARCHITECTURE.md @@ -266,3 +266,9 @@ Go 저장 구현에서 추가 값을 버리거나 새 상한/400/413을 먼저 [채택 범위 검토](TRADING_REVIEW_REPROCESSING_REQUEST_PROFILE_REVIEW_DRAFT.md)를 후보와 함께 읽는다. 현재 Config hash/DTO는 같은 instant 표기까지 동일하게 보존하지 않는다. 신규 canonical 입력 표기 수정 권고와 수치 보류를 확인하고 Go에서 자동 정규화/int32 제한을 먼저 적용하지 않는다. ADR-082는 미채택이다. ADR-080/081과 legacy hash/key·원 receipt를 유지하며 source/국소 관측·실제 업무/운영 수용을 구분한다. + +## ADR-082 요청 예산 검토 + +[예산 조합/경계](TRADING_REVIEW_REPROCESSING_REQUEST_BUDGET_REVIEW_DRAFT.md)를 읽는다. +VersionIdentifier200자·UTF8 bytes·map 개수·wire body 예산은 서로 다르며 모두 충족해야 한다. synthetic schema/byte 관측을 실제 HTTP/운영 수용으로 보지 않는다. +정책 채택은 명시 결정 대기이고 정확 수치는 후보다. 현재 schema/hash/legacy·ADR-080/081을 유지한다. diff --git a/docs/DECISIONS.md b/docs/DECISIONS.md index c494442..edd6a73 100644 --- a/docs/DECISIONS.md +++ b/docs/DECISIONS.md @@ -1570,3 +1570,9 @@ ADR-080/081의 확정 namespace/receipt/수명을 유지하고 shared schema· 상태는 계속 **DRAFT·미채택**이다. [리뷰](TRADING_REVIEW_REPROCESSING_REQUEST_PROFILE_REVIEW_DRAFT.md)는 실제 hash/DTO 관측에 따라 원 동일 시점 표기 동등화 권고를 수정한다. 구조/무손실/오류 분리 원칙은 채택 권고, 신규 시각은 UTC Z·0 fraction 생략/비영6자리 고정 입력으로 수정 권고하며1MiB 등 정확 수치와 int32 상한은 채택 보류를 권고한다. 기존 hash/vector/legacy·ADR-080/081을 유지하고, 후보 문서 merge/기술 관측을 채택·업무 구현/활성화로 보지 않는다. + +### ADR-082 요청 예산 검토 후속(2026-11-16) + +상태는 **DRAFT·미채택**으로 유지한다. [조합/경계 검토](TRADING_REVIEW_REPROCESSING_REQUEST_BUDGET_REVIEW_DRAFT.md)에 synthetic request/schema·JSON byte/depth 관측을 기록했다. +기존 VersionIdentifier200자와 byte 후보는 함께 적용하고 terms4096·길이 상한·body1MiB는 교집합으로 검토한다. 수치는 아직 확정하지 않는다. +저장 타입만을 이유로 int32 제품 상한을 추가하지 않는 방향을 권고한다. 명시 채택 결정 전 policy/schema/runtime 상태를 바꾸지 않는다. diff --git a/docs/TRADING_REVIEW_REPROCESSING_REQUEST_BUDGET_REVIEW_DRAFT.md b/docs/TRADING_REVIEW_REPROCESSING_REQUEST_BUDGET_REVIEW_DRAFT.md new file mode 100644 index 0000000..8e5ddaf --- /dev/null +++ b/docs/TRADING_REVIEW_REPROCESSING_REQUEST_BUDGET_REVIEW_DRAFT.md @@ -0,0 +1,95 @@ +# ADR-082 요청 예산 조합·경계 검토 + +상태: **DRAFT·미채택 수치 검토**, 2026-11-16. [정책 후보](TRADING_REVIEW_REPROCESSING_REQUEST_PROFILE_DRAFT.md)· +[채택 범위 리뷰](TRADING_REVIEW_REPROCESSING_REQUEST_PROFILE_REVIEW_DRAFT.md)에 후속 구조 측정과 결정표를 연결한다. +이번 측정은 수치를 승인/활성화한 것이 아니다. ADR-080/081은 유지하고 ADR-082 채택 여부는 명시 결정 전까지 미채택으로 둔다. + +## 이번 결정표 + +| 항목 | 현재 권고 | 수치/구현 전 조건 | +|---|---|---| +| 검증 구조·원칙 | 새 재처리 전용 closed nested·무손실/strict/presence·형식/자원 오류와 business receipt 분리 채택 권고 | 기존/shared/legacy를 서버만 축소하지 않음 | +| 시각 입력 | 새 profile의 UTC Z·0 fraction 생략/비영6자리 고정 입력 수정안 채택 권고 | hash/DTO 전체 왕복을 계약으로 고정. 자동 legacy 변환 없음 | +| int32 상한 | 저장 타입 이유의 별도 제품 상한을 도입하지 않는 방향 권고 | 기존 양수/JSON·hash 안전 범위는 유지. 무제한 integer 허용 아님 | +| body1MiB/depth16 | 초기 후보로 유지하되 아직 수치 미확정 | 아래 단위·조합·실제 caller·bounded decoder/consumer 검증 필요 | +| key/value·terms4096 | 필드·개수 한도와 전체 body 한도를 동시에 적용하는 방향 권고 |4096개에 모든 최대 길이를 넣을 수 있다는 보장은 하지 않음 | +| version 문자열 | 기존200자 제한과 새 UTF8 byte 후보의 교집합 |256byte 후보가 기존 maxLength200을 완화/대체하지 않음 | + +이 표는 직전 논의의 실행 가능한 결정 범위다. 일반 다음 작업·응답 대기 시간을 채택 승인으로 해석하지 않는다. +수치 미확정은 업무 구현 때 임의로 정하거나 무제한 요청을 받자는 뜻이 아니다. profile/schema·오류/consumer 적용 전에 결정해야 한다. + +## source와 측정 방식 + +[현재 public DRAFT](https://github.com/refinvest-dev/context/blob/bd2150941fda13940ad7f3d78188c2f48cf80ce0/openapi/drafts/trading-review-reprocessing-public.yaml)· +[shared schema](https://github.com/refinvest-dev/context/blob/bd2150941fda13940ad7f3d78188c2f48cf80ce0/openapi/core-api.yaml)· +[기존 checker](https://github.com/refinvest-dev/context/blob/bd2150941fda13940ad7f3d78188c2f48cf80ce0/scripts/verify-trading-review-reprocessing-draft.py)의 resolver/validator를 읽기 전용으로 사용했다. +실행 source는 이 고정 commit 기준이며 checker/YAML·원 hash/vector를 수정하지 않았다. 전체 checker의 모든 assertion을 재실행한 것은 아니다. +기존8개 type/output 예제와 두 synthetic 확장 payload의 현재 DRAFT 구조 검증을 수행했다. 이후 JSON 직렬화 byte와 container depth를 측정했다. +synthetic payload의 version/terms/대상은 실제 registry/lineage/hash 검증 자료가 아니다. schema 통과를 실제 실행 가능 요청/운영 inventory로 보지 않는다. + +## baseline8개 관측 + +compact UTF8 JSON은 BOM/공백 없이 ensure_ascii=False로 생성했다. 일반 client의 실제 wire bytes가 항상 이 크기라는 뜻은 아니다. + +| 예제 | compact bytes | container depth | +|---|---:|---:| +| REPARSE_SOURCE·LEDGER_ONLY |1648 |4 | +| REPARSE_SOURCE·LEDGER_AND_ANALYSIS |2321 |4 | +| REBUILD_LEDGER·LEDGER_ONLY |1648 |4 | +| REBUILD_LEDGER·LEDGER_AND_ANALYSIS |2321 |4 | +| RERUN_RECONSTRUCTION·LEDGER_ONLY |1654 |4 | +| RERUN_RECONSTRUCTION·LEDGER_AND_ANALYSIS |2327 |4 | +| RERUN_ANALYTICS·ANALYSIS_ONLY |2316 |4 | +| REEVALUATE_FINDINGS·ANALYSIS_ONLY |2363 |4 | + +여기서 root object의 container depth는1이다. object/array를 통과할 때만1 증가하고 scalar는 증가시키지 않는다. 빈 object/array도 container 한 단계다. +예제 깊이4는 전체 current schema의 최대 깊이 증명이 아니다. 현재 open nested extension·향후 profile 구조도 별도로 확인해야 한다. + +## terms 개수·길이·body 후보의 조합 + +REBUILD_LEDGER·LEDGER_ONLY 예제의 terms map만 확장했다. key는256 ASCII bytes,4096개의 서로 다른 synthetic key다. + +| version value | decoded 길이 | compact UTF8 JSON | ASCII escape JSON | +|---|---|---:|---:| +| ASCII200자 |200자/200bytes |1,893,969bytes |1,893,969bytes | +| 한글85자+ASCII1자 |86자/256bytes |2,123,345bytes |3,167,825bytes | + +두 payload는 현재 DRAFT의 구조 검증을 통과했고 후보 terms 개수·key256bytes·value256bytes에도 들어가지만 **둘 다 body1MiB를 초과**한다. +이는 상한 조합의 의미를 명시해야 한다는 증거다. 각 필드의 최대값이 모두 동시에 허용되는 보장과, 여러 독립 상한을 함께 적용하는 계약은 다르다. +같은 기본 예제의 compact 직렬화에서1MiB 안에 들어가는 최대 entry 수를 이 구조에 한해 탐색한 결과: + +| version value | 최대 fit entries/bytes | 다음1개 추가 시 | +|---|---|---| +| ASCII200자 |2266개/1,048,509bytes |1,048,971bytes | +| UTF8 256bytes·86자 |2021개/1,048,495bytes |1,049,013bytes | + +이 숫자를 새로운 제품 terms 상한으로 채택하지 않는다. 다른 field·문자열·escape/공백이면 달라지며 전체 허용 payload의 수학적 최대도 아니다. +권고는 **본문 byte·필드 byte/문자·entry 상한을 모두 만족해야 한다고 명시**하는 것이다.4096개를 긴 값으로 반드시 보내야 하는 실제 caller가 확인되면 body/개수/문자 제한을 함께 재검토한다. +body에 맞추려고 terms/Config/미사용 Target component를 자르거나 hash만 남기지 않는다. exact Target/원 request 비교 의미를 유지한다. + +## VersionIdentifier200자와256byte는 다르다 + +현재 VersionIdentifier는 minLength1/maxLength200이다. ASCII256자는 현재 schema에서 거절됐고,86자인256UTF8 bytes 값은 구조상 허용됐다. +따라서 새 profile에256byte 후보를 두더라도 기존200자·각 필드의 원 형식과 함께 적용해야 한다. JSON Schema maxLength를 UTF8 byte 수로 오해하거나256으로 늘리지 않는다. +implementationDigest·instrument key·opaque source ID는 같은 VersionIdentifier scalar가 아니므로 원 schema별 조건을 구분한다. registry에 실제 존재하는 identifier인지의 업무 검증도 별개다. +확장 payload가 구조상 허용됐다는 사실로 non-ASCII version/임의 instrument가 실제 등록돼 있다고 주장하지 않는다. + +## body·깊이 경계의 단위 + +같은 정상 예제 뒤에 JSON whitespace를 더해1,048,575 /1,048,576 /1,048,577 octets를 만들었다. 모두 같은 JSON document로 파싱되지만 후보1MiB 이하 여부는 앞 두 개만 해당한다. +이는 byte 측정/조건의 관측이며 서버가 실제로413을 반환했다는 HTTP 검증이 아니다. body 예산은 semantic object 크기/Content-Length만으로 판정할 수 없다. +ensure_ascii 출력 차이도 wire bytes에 영향을 준다. decoded field의 UTF8 byte 제한은 JSON escape 자체의 byte 수와 구분한다. +별도 nested container16/17을 구성해 계산 단위를 확인했다. 이 두 값은 정상 재처리 request shape가 아니며 depth16 parser 수용을 검증한 것도 아니다. +content encoding을 허용한다면 실제 수신 octet·해제 후 JSON 예산·해제 과정의 한도를 함께 정의한다. 이번에는 압축/HTTP/streaming decoder를 실행하지 않았다. + +## 남은 확인과 다음 결정 + +| 남은 범위 | 필요한 확인 | +|---|---| +| 실제 caller/legacy | 최대 terms·원 문자열/형식·특수 escape·body 생성 방식. repository 예제만으로 운영 입력을 대표하지 않음 | +| ingress/decoder | profile별 byte/depth의 실제 위치·bounded 수신/파싱·메모리·중복/정밀도/취소·정확400/413 | +| producer/consumer | full Target/Config·원 hash·Core relay/Web status/code·같은 key와 원 receipt 의미 유지 | +| 적용 문서 | 수치·단위·교집합/초과 우선순위·현재 authority·profile/version·schema가 표현 못하는 byte/depth 검증 | + +구조·시각·저장 타입 기반 int32 제한 배제의 채택 여부와 크기 수치 결정은 구분한다. 현재는 정책 결정 답변을 기다리며 수치 후보를 검토한 상태다. +새 API/schema/checker·runtime/SQL·메모리/HTTP/부하·실제 운영 inventory/E2E 수용은 없었다. 단순 측정 결과를 그 성공으로 확대하지 않는다. diff --git a/docs/TRADING_REVIEW_REPROCESSING_REQUEST_PROFILE_DRAFT.md b/docs/TRADING_REVIEW_REPROCESSING_REQUEST_PROFILE_DRAFT.md index 74dda15..35bd1f2 100644 --- a/docs/TRADING_REVIEW_REPROCESSING_REQUEST_PROFILE_DRAFT.md +++ b/docs/TRADING_REVIEW_REPROCESSING_REQUEST_PROFILE_DRAFT.md @@ -47,7 +47,7 @@ schema 구현 시 closed 하위 object를 해당 profile에서 정의한다. 불 | JSON request body |1,048,576 bytes, 수신 JSON octet 기준 | 초과413, business receipt/Run 생성 없음 | | JSON nesting | root object를 depth1로 셌을 때16 | 초과400 | | resource ID 문자열 |256 UTF-8 bytes | 초과400. opaque legacy ID를 숫자로 강제 변환하지 않음 | -| version ID·implementationDigest·동적 instrument key | 각256 UTF-8 bytes | 초과400. exact 값 trim/case-fold 금지 | +| version ID·implementationDigest·동적 instrument key | 각256 UTF-8 bytes 후보. VersionIdentifier는 기존 maxLength200도 동시 적용 | 초과400 후보. 기존 문자 한도 완화·exact 값 trim/case-fold 금지 | | reviewTimezone |128 UTF-8 bytes | 초과400. 유효 IANA/버전 검증은 별도 | | instrumentTermsVersionByInstrument | 최대4096 entries | 초과400. body 상한도 동시에 적용 | | MetricMinimums/FindingMinimums의 integer |1~2,147,483,647 | 범위 밖400. 실제 정책상 허용 최소/Config 의미 검증 별도 | @@ -79,3 +79,10 @@ body는 정확 octet 수를 검증하고 Content-Length만 신뢰하지 않는 기존 WR/WF/WUC/WFP/TR-ACC를 재사용한다. 새 public Scenario ID/Run 상태를 만들지 않는다. 현재는 후보 문서만 작성했다. OpenAPI/hash/vector/DB/runtime 변경·새 codec/SQL·실제 inventory/semantic/HTTP/부하/E2E 실행은 없다. 권고 수치/closed nested/시각 비교는 미채택이다. ADR-080/081의 확정 사항과 혼동하거나 후보 merge/CI를 정책 채택으로 해석하지 않는다. + +## 요청 예산 조합 검토 후속 + +[실측 구조/byte 검토](TRADING_REVIEW_REPROCESSING_REQUEST_BUDGET_REVIEW_DRAFT.md)에 기존8개 예제·큰 terms payload2개·본문/깊이 경계를 기록했다. +terms4096/key·value256bytes 후보를 만족해도 전체1MiB를 넘을 수 있다. 모든 필드 최대 조합 허용 보장이 아니라 독립 상한의 교집합으로 검토한다. +VersionIdentifier의 기존200자와 byte 후보를 구분한다. int32는 저장 타입 때문에 별도 제품 제한을 두지 않는 방향을 권고하되 현재 정책은 미채택이다. +새 수치/형식/400/413을 서버에 적용하거나 hash/legacy를 바꾸지 않았다. diff --git a/docs/TRADING_REVIEW_REPROCESSING_REQUEST_PROFILE_REVIEW_DRAFT.md b/docs/TRADING_REVIEW_REPROCESSING_REQUEST_PROFILE_REVIEW_DRAFT.md index bbe5f37..2f94089 100644 --- a/docs/TRADING_REVIEW_REPROCESSING_REQUEST_PROFILE_REVIEW_DRAFT.md +++ b/docs/TRADING_REVIEW_REPROCESSING_REQUEST_PROFILE_REVIEW_DRAFT.md @@ -87,3 +87,9 @@ result timestamp 직렬화 규칙을 Config 입력 문자열에 일괄 적용하 먼저 위 채택/수정/보류 범위를 결정한다. 그 뒤 versioned profile 식별·local closed schema·canonical 입력 vectors·registry/consumer를 일관되게 설계한다. 수치·운영 inventory 및 정확 Run/control FK·권한/DB history는 별도 gate다. DB lock 기술 실험은 채택과 독립적으로 계획할 수 있으나 업무/운영 활성화 증거는 아니다. 현재 새 YAML/code/DB·새 golden fixture·HTTP/SQL/경합/복원/부하/E2E는 추가·실행하지 않았다. local hash/DTO 관측을 그 수용 성공으로 확대하지 않는다. + +## 논의 정리·요청 예산 후속 + +[요청 예산 검토](TRADING_REVIEW_REPROCESSING_REQUEST_BUDGET_REVIEW_DRAFT.md)는 기존200자 제한·UTF8 bytes·terms/body/depth 후보의 조합을 실제 synthetic 측정으로 보완한다. +int32에 대해서는 단순 수치 보류를 넘어 **저장 타입 때문에 별도 제품 상한을 도입하지 않는 방향**을 권고한다. 기존 JSON/hash 안전 범위·양수 조건은 유지한다. +구조/검증 원칙·수정 시각 입력의 채택 여부는 명시 결정 대기이며, 정확 크기 수치는 여전히 후보다. 측정/문서 merge를 채택으로 해석하지 않는다. diff --git a/openapi/CONTEXT_REVISION b/openapi/CONTEXT_REVISION index 844a27d..4db9307 100644 --- a/openapi/CONTEXT_REVISION +++ b/openapi/CONTEXT_REVISION @@ -1 +1 @@ -bd2150941fda13940ad7f3d78188c2f48cf80ce0 +15255530729434f2c203404c9d2614cfa397502b