[Process] Устранить current hourly/local/online documentation drift #34

Closed
opened 2026-10-11 21:52:14 +03:00 by codex-bot · 0 comments
Owner

Problem

Portfolio overview описывает минутную freshness/старый refresh, stocks body — persisted background reference рядом с online appendix. Container/bonds current explanations также сохраняют request-driven claims. Новая freshness page не исправляет reader entrypoint.

Expected Behavior

README/domain/Container маршруты согласованно объясняют actual default hourly/local/online модель и отдельно legacy compatibility.

Evidence

Audit date 2026-10-11; 15, technical. IDs SPEC-003, TA-F16 (current docs arm); cross-signals ARCH-004 (withdrawn ID, не новый finding). Revision e6fd4f64b81dd73b33959b845a1babcfac1891c8; Confidence High; Verification status static.
Affected: portfolio overview:82–93; stocks.md:149–169,194–199; bonds.md:105–134,147–151; architecture/containers.md:142–148; current data-freshness/portfolio-loading owners.

Scope

In scope

Addressed current claims, default vs observe scope, one thematic owner references и truthful value-history capability.

Out of scope

Historical ADR017/019/020 rewrite, new audit pages/docs generator, обещание ещё отсутствующего history API/UI, undocumented product decision.

Proposed Approach

Заменить obsolete statements и интегрировать/удалить contradictory appendices после evidence review. Не распространять online reference на saved financial calendars/quotes/candles.

Acceptance Criteria

  • README→Portfolio/Stocks/Bonds/Container→freshness route не даёт противоположных default ownership/TTL утверждений.
  • Local financial reads, narrow first-load exceptions, online request errors и legacy observe scope различены.
  • Internal value points не выданы за публичный график/history API; unknown/zero/fallback/access guarantees корректно описаны.
  • Historical originals/ADR supersession сохранены, входящие links не сломаны.

Verification

Local docs Markdown/link gate и semantic comparison указанных backend call chains/approved requirements; application build/full tests не нужны для text-only diff.

Dependencies

Нет для уже подтверждённой AS-IS correction; последующие behavioral fixes обновляют affected docs своим diff, не ждут массового rewrite.

Traceability

Campaign WealthLedger/main#23 . Findings SPEC-003, TA-F16. WealthLedger/docs; T33.

<!-- wealthledger-audit:2026-10-11:current-system-documentation --> ## Problem Portfolio overview описывает минутную freshness/старый refresh, stocks body — persisted background reference рядом с online appendix. Container/bonds current explanations также сохраняют request-driven claims. Новая freshness page не исправляет reader entrypoint. ## Expected Behavior README/domain/Container маршруты согласованно объясняют actual default hourly/local/online модель и отдельно legacy compatibility. ## Evidence Audit date `2026-10-11`; [15](https://git.personal.ksv741.ru/WealthLedger/main/src/commit/d07fbfabb1295780952a554185989d2d5b5c8349/audits/2026-10-11/reports/15-sdd-specs-and-documentation.md), [technical](https://git.personal.ksv741.ru/WealthLedger/main/src/commit/d07fbfabb1295780952a554185989d2d5b5c8349/audits/2026-10-11/reports/previous/technical-audit-2026-10-11.md). IDs SPEC-003, TA-F16 (current docs arm); cross-signals ARCH-004 (withdrawn ID, не новый finding). Revision `e6fd4f64b81dd73b33959b845a1babcfac1891c8`; Confidence High; Verification status static. Affected: [portfolio overview:82–93](https://git.personal.ksv741.ru/WealthLedger/docs/src/commit/e6fd4f64b81dd73b33959b845a1babcfac1891c8/domains/portfolio/overview.md#L82-L93); stocks.md:149–169,194–199; bonds.md:105–134,147–151; architecture/containers.md:142–148; current data-freshness/portfolio-loading owners. ## Scope ### In scope Addressed current claims, default vs observe scope, one thematic owner references и truthful value-history capability. ### Out of scope Historical ADR017/019/020 rewrite, new audit pages/docs generator, обещание ещё отсутствующего history API/UI, undocumented product decision. ## Proposed Approach Заменить obsolete statements и интегрировать/удалить contradictory appendices после evidence review. Не распространять online reference на saved financial calendars/quotes/candles. ## Acceptance Criteria - [ ] README→Portfolio/Stocks/Bonds/Container→freshness route не даёт противоположных default ownership/TTL утверждений. - [ ] Local financial reads, narrow first-load exceptions, online request errors и legacy observe scope различены. - [ ] Internal value points не выданы за публичный график/history API; unknown/zero/fallback/access guarantees корректно описаны. - [ ] Historical originals/ADR supersession сохранены, входящие links не сломаны. ## Verification Local docs Markdown/link gate и semantic comparison указанных backend call chains/approved requirements; application build/full tests не нужны для text-only diff. ## Dependencies Нет для уже подтверждённой AS-IS correction; последующие behavioral fixes обновляют affected docs своим diff, не ждут массового rewrite. ## Traceability Campaign https://git.personal.ksv741.ru/WealthLedger/main/issues/23 . Findings SPEC-003, TA-F16. WealthLedger/docs; T33.
codex-bot added this to the Technical Audit Remediation — 2026-10-11 milestone 2026-10-11 21:52:14 +03:00
codex-bot added the Kind/Documentation
Priority
Medium
3
audit/2026-10-11
labels 2026-10-11 21:52:14 +03:00
codex-bot was assigned by hermes-agent 2026-10-12 00:04:16 +03:00
hermes-agent added this to the WealthLedger — Delivery Board project 2026-10-12 00:04:16 +03:00
hermes-agent added Kind/Process and removed Kind/Documentation labels 2026-10-12 00:04:16 +03:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: WealthLedger/docs#34