docs(wave7): record peer-swarm bug fixes, metrics, and map sync
Some checks failed
ci / 정본·보안·린트·타입·테스트 (push) Failing after 18s
ci / 워크스페이스 빌드 검증 (push) Has been skipped
ci / 모바일 린트·타입·Jest (push) Successful in 45s
ci / Supabase Edge Functions + Cloudflare Worker (push) Successful in 22s
ci / .NET API 서버 테스트 (push) Successful in 11s
deploy-site / deploy (push) Successful in 44s

This commit is contained in:
Yun Chan 2026-11-14 15:41:48 +09:00
parent cc3f7460be
commit 876e72ea2f
15 changed files with 173 additions and 21 deletions

View file

@ -65,6 +65,7 @@ All mutations flow through `ExecuteAdminMutationAsync` (idempotent + audited).
| `AuthService` | Register (one-time SuperAdmin bootstrap only, `PasswordHasher<User>`, serialized), login (timing-safe dummy verify, inactive rejection, rehash), JWT gen (8h, claims id/email/role) |
| `LlmProxyService` | Resolve endpoint by model → fallback → Mock echo; OpenAI-style POST; parse content+usage; token cost → `ApiUsageLog`; errors → `ServerErrorLog` + fallback text |
| `SttProxyService` (~1182 lines) | Provider adapters (groq/openai/custom, deepgram, google, assemblyai, azure, local-sidecar), candidate resolution + fallback, content-type/duration detection, `SttUsageLog` cost, synthetic-tone endpoint test, CRUD with exclusive default, usage report |
| `EndpointUrlPolicy` | Upstream LLM/STT endpoint SSRF validation (`Services/EndpointUrlPolicy.cs`) paired with named `"UpstreamNoRedirect"` `HttpClient` (`AllowAutoRedirect = false`) (Wave 7) |
| `AdminOperationService` | Validates actor/idempotency key/memo, SHA-256 request hash, `Serializable` transaction, idempotent replay, before/after audit entry |
---
@ -88,7 +89,7 @@ DTOs (`Dtos/Dtos.cs`): auth, license audit, LLM, admin/model endpoints, STT (tra
## 5. Tests (`apps/api-server.Tests/`, xUnit)
`AdminAuthorizationE2ETests`, `AdminOperationServiceTests`, `AuthBootstrapControllerTests`, `AuthSecurityTests`, `SttControllerSecurityTests`, `SttFailClosedTests`, `SttGatewayAuthorizationE2ETests` (**32/32 PASS** after Wave 6 2026-11-14: enforced `MaxAudioBytes = 26 * 1024 * 1024` / `MaxBase64Length` cap in `SttProxyService.DecodeAudioBase64` before `Convert.FromBase64String`, and propagated `HttpContext.RequestAborted` `CancellationToken` across `SttController`/`LlmController`/`AdminController` → `SttProxyService`/`LlmProxyService` → EF/HTTP/AssemblyAI polling to abort paid failover immediately on client disconnect).
`AdminAuthorizationE2ETests`, `AdminOperationServiceTests`, `AuthBootstrapControllerTests`, `AuthSecurityTests`, `EndpointSecurityAndSttProxyTests`, `SttControllerSecurityTests`, `SttFailClosedTests`, `SttGatewayAuthorizationE2ETests` (**55 passed, 0 failed** after Wave 7 `c68e81e` 2026-11-14, post-`v1.17.1`; Wave 6 enforced `MaxAudioBytes = 26 * 1024 * 1024` / `MaxBase64Length` cap in `SttProxyService.DecodeAudioBase64` before `Convert.FromBase64String` and propagated `HttpContext.RequestAborted` `CancellationToken`, and Wave 7 added `Services/EndpointUrlPolicy.cs` SSRF validation, named `"UpstreamNoRedirect"` `HttpClient` with `AllowAutoRedirect = false`, and query parameter URL encoding across `AdminController`, `SttController`, `LlmProxyService`, and `SttProxyService`).
---