WBS-7.9 Evidence Packet Final

Scope

WBS-7.9 is the Synology external-service POC for snapshot_admin_server_v1.py. The implementation is ready for deployment, but the final external live verification on the NAS is still pending.

Current artifact set

src/quant_engine/snapshot_admin_server_v1.py
tools/run_snapshot_admin_server_v1.py
tools/run_snapshot_admin_synology.sh
tests/unit/test_snapshot_admin_web_v1.py
docs/SYNOLOGY_SNAPSHOT_ADMIN_POC.md
docs/SYNOLOGY_SNAPSHOT_ADMIN_DEPLOYMENT_CHECKLIST.md
docs/SYNOLOGY_SNAPSHOT_ADMIN_DEPLOYMENT_CHECKLIST_FILLED.md
docs/SYNOLOGY_SNAPSHOT_ADMIN_FIREWALL_PROXY_TABLE.md
docs/SYNOLOGY_SNAPSHOT_ADMIN_FIREWALL_PROXY_COPYPASTE.md
docs/SYNOLOGY_SNAPSHOT_ADMIN_FINAL_PREFLIGHT_10.md
Temp/snapshot_admin_approval_packet_v1.json
Temp/snapshot_admin_approval_packet_v1.md
Temp/snapshot_admin_export_v1.json
Temp/snapshot_admin_web_validation.json

Local validation evidence

python -m pytest tests/unit/test_snapshot_admin_web_v1.py -q
- Result: 10 passed
python tools/validate_snapshot_admin_web_v1.py
- Result: PASS
python tools/validate_snapshot_admin_workflow_v1.py
- Result: PASS

Local HTTP verification evidence

The following loopback checks were executed against a real server process started from tools/run_snapshot_admin_server_v1.py with Basic Auth enabled:

Unauthenticated GET /api/state
- Result: 401 Unauthorized
- WWW-Authenticate: Basic realm="Snapshot Admin", charset="UTF-8"
Authenticated GET /api/state
- Result: 200 OK
- version.app = snapshot-admin-web-v7
Authenticated GET /tables
- Result: 200 OK
- Tabler grid surface present

This confirms the localhost-side service path, auth gate, and /tables route work as expected in the workspace. It does not replace the NAS-side reverse proxy verification.

Workspace topology evidence

From Temp/snapshot_admin_approval_packet_v1.json:

workspace_db = C:\\Temp\\data_feed\\Temp\\snapshot_admin_web_validation.db
collector_db = C:\\Temp\\data_feed\\outputs\\kis_data_collection\\kis_data_collection.db
settings_rows = 31
account_snapshot_rows = 40
settings_and_snapshot_share_db = true
collector_separate_db = true

Live verification still required

The NAS-side POC is not complete until these are observed on the real Synology host:

curl -i http://127.0.0.1:8787/api/state returns 200 OK
curl -i https://<public-host>/api/state returns 401 Unauthorized without credentials
curl -u '<user>:<password>' https://<public-host>/api/state returns 200 OK
Browser access to https://<public-host>/ and https://<public-host>/tables works after Basic Auth
DSM reverse proxy and firewall values are recorded as evidence

Final disposition

Implementation status: ready
Deployment guide: ready
External live verification: pending
Promote to 실배포 검증 완료 only after the NAS curl evidence and browser screenshot are archived

3.0 KiB Raw Blame History