[MOTH]: https://hackmd.io/@goonstation/designdocguide

# Surgery Design Proposals

Ignore all rulez. Write your ideas.
Shorthand defs are for nerds who think they're smart.

## Goals
*[G1]: Project Goal 1, Improve surgery feedback
*[G2]: Project Goal 2, Surgery should be intuitive
*[G3]: Project Goal 3, Reduce memorization
*[G4]: Project Goal 4, Uniform tool usage
*[G5]: Project Goal 5, Trained doctors matter
*[G6]: Project Goal 6, Keep it simple, stupid.

1. Improve surgeon-patient feedback during surgery
2. Provide an intuitive surgery user interaction
3. Reduce reliance on memorization and external resources.
4. Provide a uniform and clear purpose for surgery tools.
5. Differentiate trained and untrained doctors when preforming surgery.
6. Clean up and simplify surgery code.

## Non-Goals
*[NG1]: Project Non-Goal 1, Remove amateur doctors.

1. Make the crew reliant on doctors for all surgeries.

## Proposals
### Context Menu Surgery
#### version where the uh where u arent told where everything is
* interacting with someone on a surgery table (or in an equivalent operable position) pops up a context menu that lets you choose an area to cut into with your tools
* from there you make the cut and then go to a node (also a context menu) with the organs there you can take out/put in. see Figure 1 for an example
* lightly rewards anatomical knowledge, also makes it easier for the surgeon to visualize where in the process they are based on which node they're at
*Figure 1.*

flowchart TD
	Start--scissors-->Abdomen
	Start--scalpel-->Chest
	Start--saw-->Back
	Chest--scissors-->Liver
	Chest--saw-->Ribcage
	Ribcage--scissors-->Lungs
	Ribcage--scalpel-->Heart

#### version where u are told where everything is
* Interacting with someone on an operating table pops up a context menu that lets you choose an area to perform surgery in.
* From the initial menu you may navigate freely between the organ menus without a surgery action (see Figure 2 for an example). This avoids issues where the surgeon needs to spend time backtracking (sewing up) because they navigated into the wrong area (e.g. due to lack of memorization).
* This is meant to target a scenario where the surgeon knows beforehand which organ needs to be removed/replaced (see Figure 3), but does not know which surgery steps are necessary for this.

<figure>
<center>
<img
src="https://i.imgur.com/Ukf2smI.png">
<center><b>Figure 2:</b> Navigating the nodes (except for the actual surgery steps) do not require a surgery action to encourage exploration and avoid penalizing lack of prior surgery knowledge.</center>
</center>
</figure>

<figure>
<center>
<img
src="https://i.imgur.com/hLY4MGC.png">
<center><b>Figure 3.</b></center>
</center>
</figure>

#### Goals

#### Non-Goals

### Surgery Computer
*[SC]: Surgery Computer Proposal

The Surgery Computer provides improved diagnostics when operating on a patient inside of the operating theater. It augments less specific surgery feedback by providing specific warnings for conditions, and guidance on certain operations or treatments.

Examples of Surgery Computer feedback:
- Audio cue and text alert when patient suffers severe blood loss
- Audio cue when patient enters cardiac arrest
- Audio cue when patient enters critical condition
- Text alert when blood pressure becomes elevated or lowered
- Audio cue when blood pressure is dangerously high or low.
- Helpful reminder on how to remove an appendix

#### Goals
*[SCG1]: SC Goal 1, Fulfill G1-3
*[SCG2]: SC Goal 2, Provide clear feedback
*[SCG3]: SC Goal 3, Help newcomers with surgery.

1. Fulfill G1, G2, G3
2. Provide clear feedback for life-threatening situations.
3. Help newcomers get familiar with simple surgeries.

#### Non-Goals
*[SCNG1]: SC Non-Goal 1, Be a mentor replacement
*[SCNG2]: SC Non-Goal 2, Always provide perfect advice

1. Become a perfect mentor for new players, or replace assistant doctors.
2. Provide perfect advice in all circumstances.

#### Alternatives

1. Enhancement of cues from the patient rather than from the machine, but this does not help SCG3 or G3.
2. Add a surgery robot which can automatically preform routine surgeries. This goes against SCNG1 and just makes it easier to do surgery without actually making surgery better.

#### Potential Changes

Should the Surgery Computer prove too powerful of a tool, the amount or precision of alerts generated could be reduced without affecting any of the goals significantly.

<!-- IGNORE ALL RULEZ. ADD A NEW LEVEL 3 HEADER for New ideas. -->

----