docs: add send upload deep dive validation items

This commit is contained in:
zhaoyilun
2026-07-12 12:33:01 +08:00
parent a9e692a574
commit 7718e2dd34
4 changed files with 890 additions and 3 deletions

View File

@@ -0,0 +1,75 @@
# Login Reachability Validation Items
Date: 2026-07-12
Purpose: this is the operator-facing checklist for the 2026-07-13 logged-in environment. It is generated from the offline send/upload deep dive and should be used to build the one-shot reachability probe package.
## P0 items
### Confirm logged-in IMPlatformClient.exe process and loaded assemblies
- Category: runtime
- Evidence to capture: process id, module list, loaded managed assemblies
- Unlocks: all B-route adapter tests
### Confirm AppContextManager/IAppContextManager reachability
- Category: runtime
- Evidence to capture: type visible, instance path, SendTxtMessageByJid callable shape
- Unlocks: text send high-level path
### Confirm Chat/XMPPConnection authenticated state
- Category: runtime
- Evidence to capture: Chat instance, XMPPConnection state, target JID mapping
- Unlocks: text and file message finalization
### Capture FileUploadPara required values without leaking token
- Category: file_upload
- Evidence to capture: host, port, domain, local path presence, IsImg/IsPublic, token-present boolean/hash only
- Unlocks: upload_file probe
### Confirm IFileTransfer/FileTransfer.FileUpload reachability
- Category: file_upload
- Evidence to capture: service instance or constructor path, method signature, safe call readiness
- Unlocks: file upload
### Confirm FileUploadResult.FileID after safe test upload
- Category: file_upload_result
- Evidence to capture: FileID present, size/name or URL/remote folder metadata, failure code if upload fails
- Unlocks: send_file_message
### Confirm trans_UploadCompleted/SendFileMessage consumes FileID
- Category: send_file_message
- Evidence to capture: FileID enters payload, Chat.sendFileMessage invoked, sent file record/ack
- Unlocks: production file send
### Correlate sent record/ack with content hash or file hash
- Category: ack
- Evidence to capture: sent record timestamp, target ref, body/file metadata hash, ack/ref id
- Unlocks: production gate
## P1 items
### Confirm group ChatRoom branch and permissions
- Category: group
- Evidence to capture: ChatRoom type, speech/upload permission state, group JID
- Unlocks: group send/file send
### If B-route reachability fails, capture A-route UI evidence
- Category: fallback
- Evidence to capture: window hwnd, rtbSendMessage, btnSend, screenshots, failure reason
- Unlocks: demo fallback only
## Pass criteria
- Text send can move forward when logged-in runtime exposes AppContextManager or MessageScheduling plus Chat/XMPPConnection and sent-record/ack correlation is possible.
- File send can move forward when logged-in runtime exposes IFileTransfer/FileUpload, FileUploadPara values, FileUploadResult.FileID, and Chat.sendFileMessage finalization evidence.
- Production remains blocked if any P0 item is missing or only static evidence is available.