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
6 changes: 6 additions & 0 deletions docs/AI_AGENT.md
Original file line number Diff line number Diff line change
Expand Up @@ -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을 유지한다.
6 changes: 6 additions & 0 deletions docs/ARCHITECTURE.md
Original file line number Diff line number Diff line change
Expand Up @@ -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을 유지한다.
6 changes: 6 additions & 0 deletions docs/DECISIONS.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 상태를 바꾸지 않는다.
95 changes: 95 additions & 0 deletions docs/TRADING_REVIEW_REPROCESSING_REQUEST_BUDGET_REVIEW_DRAFT.md
Original file line number Diff line number Diff line change
@@ -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 수용은 없었다. 단순 측정 결과를 그 성공으로 확대하지 않는다.
9 changes: 8 additions & 1 deletion docs/TRADING_REVIEW_REPROCESSING_REQUEST_PROFILE_DRAFT.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 의미 검증 별도 |
Expand Down Expand Up @@ -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를 바꾸지 않았다.
Original file line number Diff line number Diff line change
Expand Up @@ -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를 채택으로 해석하지 않는다.
2 changes: 1 addition & 1 deletion openapi/CONTEXT_REVISION
Original file line number Diff line number Diff line change
@@ -1 +1 @@
bd2150941fda13940ad7f3d78188c2f48cf80ce0
15255530729434f2c203404c9d2614cfa397502b
Loading