- Section 5 of the SOP now names a real "To" (the developer) and "CC" (the developer's manager, not the operator's), and the email block to copy starts with To: and CC: lines. The skill asks for both addresses. - to_docx.py --pdf also writes the PDF (Word through PowerShell on Windows, LibreOffice elsewhere) and prints the real page count against MAX_PAGES. The PDF is what ops gets. - Tebra reference and README updated; new test for the To/CC lines. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2.6 KiB
{{PROJECT_NAME}} Handover SOP
Version {{VERSION}} · {{DATE}} · Problems: email {{DEV_EMAIL}}, CC {{MANAGER_EMAIL}} (section 5)
{{ONE_LINE: what the bot does, from which app or portal, and what it produces}}
1. How to run
- {{e.g. Open https://... in Chrome / Open "" from the Desktop.}}
- {{e.g. Sign in with the team password.}}
- {{e.g. Click "Run".}}
- {{e.g. Wait until the status says "Finished" or "Stopped" (section 2).}}
Before you click {{RUN_LABEL}}:
- {{WHAT A NEW CLICK DOES: e.g. "Every click starts a fresh run on today's data. It deletes the previous run's reports first, so download them before you click."}}
- {{e.g. "Only one run at a time. A greyed-out button means a run is going."}}
2. What you see while it runs
| Where on the screen | What it shows |
|---|---|
| {{AREA, exact label}} | {{TEXTS IT SHOWS, in order}} |
A normal run:
- {{e.g. Both lanes say "Signing in…".}}
- {{e.g. Each lane fills: "3 of 10 locations".}}
- {{e.g. Status "Finished", last line "Finished. Your reports are ready to download below."}}
| Step | The bot waits at most | Then |
|---|---|---|
| {{STEP}} | {{e.g. 3 min}} | {{e.g. skips that location / stops / retries 3 times}} |
Step in only when: {{e.g. the run has ended, or nothing new has appeared for 10 minutes}}.
3. Result
- Good run: {{HOW IT ENDS ON SCREEN}}
- Needs a look: {{HOW IT ENDS, including any misleading green or "Finished"}}
Where: {{e.g. Reports box → Download. Excel: Summary sheet, Reconciliation sheet, Result column.}}
| Status | Meaning | What you do |
|---|---|---|
| {{STATUS}} | {{ONE LINE}} | {{ACTION or "nothing"}} |
4. When something goes wrong
How it shows: {{e.g. a red or orange dot in the activity list under the Run button; the lane turns red}}.
| ID | Message you see | What it means | What you do |
|---|---|---|---|
| E01 | {{EXACT MESSAGE}} | {{ONE LINE}} | {{STEPS. "Email us" when ops can't fix it}} |
Don't:
- {{DON'T + short reason}}
To stop it: {{THE ONE RIGHT WAY}}
5. Email us
Email {{DEV_EMAIL}} with {{MANAGER_NAME}} ({{MANAGER_EMAIL}}) in CC when section 4 says "email us", or when the same error comes back after one re-run. Answer: {{RESPONSE_TIME}}.
To: {{DEV_EMAIL}}
CC: {{MANAGER_EMAIL}}
Subject: {{PROJECT_NAME}} - E<number> - <date>
Run started: <time from the screen>
Error: E<number> - <the message, copied>
Where: <location / item>
What I did: <e.g. ran it again once>
Attached: screenshot of the screen
Never send: passwords, {{SENSITIVE: e.g. the Excel reports (they hold patient names)}}.