docs(kæde): produktionskæder i manual, changelog og README (v1.61.0.0)

docs/BRUGERMANUAL.md

@@ -609,6 +609,81 @@ Markflådens visning i fanen **Marker** viser puljetraktorer og puljeredskaber m
 
 ---
 
+### Produktionskæder
+
+#### Hvad er en kæde?
+
+En **kæde** holder en produktion kørende helt tilbage til marken. Du slår et produkt til i en fabrik. Så
+regner moden baglæns: hvad skal produktionen bruge, hvilke af dine egne fabrikker og stalde laver det, og
+hvilke afgrøder skal der til. Fabrikken, du slog til, kaldes **rod-produktionen**.
+
+- Moden ser 12 måneder frem. Den gør først noget, når afgrøden mangler mere end 10 % og mere end 0,5 ha.
+- Marker, du har markeret **Fri til kæden**, skifter afgrøde af sig selv (højst 2 skift i minuttet).
+- Andre marker får et **forslag**, som du godkender eller afviser.
+- En afgrøde, du selv har valgt på en mark, ændres aldrig automatisk.
+- Kæden gør ingenting de første 2 minutter efter indlæsning. Kan moden ikke læse alle data, tændes eller
+  stoppes intet.
+
+#### Fanen Kæder
+
+Fanen **Kæder** viser et træ pr. rod-produktion: øverst rod-produktionen, under den hvert led med
+kolonnerne **Vare**, **Kilde**, **l/md**, **Status** og **Lager**. Er der ingen kæder, står der *Ingen kæder:
+slå et produkt til i en fabrik*.
+
+- Rod-produktionens status er *dækket*, *mangel*, *venter* eller *på pause*. Efter navnet står antal
+  forslag.
+- En farvet prik viser status: **grøn** kører, **gul** venter, **rød** fejl, **grå** stoppet. Statusteksten
+  får samme farve.
+- Rækkerne folder ud og ind. Fold ud for at se leddene, kilderne og markerne.
+- Advarsler i rækkerne: *flaskehals: -X/md*, *skal købes: X/md*, *kredsløb*, *mangler X ha*, *lager < 3 md*
+  og *ingen mark*.
+- **[Pause]** stopper kædens handlinger, men slukker ikke noget. **[Start]** genoptager dem.
+- Nederst står *Automatiske skift siden indlæsning*.
+
+#### Markér en mark fri til kæden
+
+Åbn marken i markguiden og slå **Fri til kæden (moden må skifte afgrøde)** til. Kun sådan en mark skifter
+afgrøde automatisk. I fanen står **Marker fri til kæden** med de marker, der er markeret.
+
+Flerårige afgrøder (vin, oliven, poppel) og græsmarker skiftes aldrig, heller ikke når de er markeret.
+
+#### Forslag: Godkend og Afvis
+
+Mangler kæden areal på en mark, der ikke er fri, står der et forslag i kæde-træet: **Forslag [Godkend]**
+og **[Afvis]**. Samme forslag står i **Kræver handling** som *Kæde: F12 Hvede → Mel*.
+
+- **[Godkend]** skifter markens afgrøde.
+- **[Afvis]** fjerner forslaget.
+- Er forslaget forældet, står der *Forslaget gælder ikke længere*.
+- Marker, moden har skiftet på egen hånd, er mærket *skiftet (fri mark)*.
+
+#### Mellemled
+
+Kræver en kæde en mellemvare (fx mel til brød), tænder moden den produktion, der laver den.
+
+- Moden slukker kun en produktion igen, hvis kæden selv tændte den.
+- Slukker du selv sådan en produktion, lader kæden den være slukket.
+- Slukker du rod-produktionen, stoppes kædens flows (se nedenfor), medmindre en anden kæde stadig bruger
+  dem.
+
+#### Kæde-flows
+
+For hvert led opretter moden et flow med navnet **Kæde: <vare> → <bygning>** (højst 2 nye i minuttet).
+
+- Flowet får en ledig pool-traktor og en tipvogn. Moden bruger aldrig en traktor, der hører til et andet
+  flow.
+- Findes der ingen, oprettes flowet stoppet, og kæden viser *mangler traktor/vogn*.
+- Flows med paller oprettes altid stoppet: vælg selv en UAL-vogn.
+- Slås kæden fra, **stoppes** flowene. De slettes ikke.
+- Status i kæden: *flow kører*, *flow stoppet*, *mangler traktor/vogn* eller *intet flow*.
+
+#### Begrænsninger
+
+- Moden **køber ikke** varer og **køber ikke dyr**. Skal noget købes, står det som *skal købes*.
+- Flerårige afgrøder (vin, oliven, poppel) og græsmarker skiftes aldrig.
+- Planen bruger grundudbyttet uden gødningsbonus, så den regner hellere med for mange hektar end for få.
+- Kæden bruger kun dine egne fabrikker og stalde.
+
 ## 8. Start, stop og gemning
 
 **Start flow** gør følgende på hver godkendt traktor:
@@ -1151,3 +1226,6 @@ Moden testes løbende, og fejlrapporter er meget velkomne.
 | **Reserve** | Det, gårdens egne stalde og fabrikker bruger det næste døgn |
 | **Tid til tom** | Hvor længe en fabriks lager af en vare holder ved det nuværende forbrug |
 | **Marksilo** | En silo ved en mark, der bruges som mellemlager |
+| **Kæde** | Den samlede vej fra en produktion tilbage gennem fabrikker og stalde til afgrøderne på markerne |
+| **Rod-produktion** | Den produktion, du selv slår til, og som kæden holder kørende |
+| **Fri til kæden** | Markering på en mark, der lader moden skifte afgrøde automatisk |

docs/USER_MANUAL.md

@@ -622,6 +622,82 @@ The field fleet view in the **Fields** tab shows pool tractors and pool implemen
 
 ---
 
+### Production chains
+
+#### What is a chain?
+
+A **chain** keeps a production running all the way back to the field. You switch on a product in a
+factory. The mod then works backwards: what the production needs, which of your own factories and barns
+make it, and which crops are needed. The factory you switched on is the **root production**.
+
+- The mod looks 12 months ahead. It acts only when a crop is short by more than 10 % and more than 0.5 ha.
+- Fields you marked **Free for chains** change crop by themselves (at most 2 changes a minute).
+- Other fields get a **suggestion** that you approve or reject.
+- A crop you chose on a field is never changed automatically.
+- The chain does nothing during the first 2 minutes after loading. If the mod cannot read all data,
+  nothing is switched on or stopped.
+
+#### The Chains tab
+
+The **Chains** tab shows one tree per root production: the root at the top, and below it each link with
+the columns **Goods**, **Source**, **l/mo**, **Status** and **Stock**. With no chains it says *No chains:
+enable a product in a factory*.
+
+- The root's status is *covered*, *short*, *waiting* or *paused*. The number of suggestions follows the name.
+- A coloured dot shows the status: **green** running, **yellow** waiting, **red** error, **grey** stopped.
+  The status text gets the same colour.
+- Rows fold out and in. Fold out to see the links, sources and fields.
+- Warnings in the rows: *bottleneck: -X/mo*, *must buy: X/mo*, *loop*, *short X ha*, *stock < 3 mo* and
+  *no field*.
+- **[Pause]** stops the chain's actions but switches nothing off. **[Resume]** continues them.
+- At the bottom: *Automatic switches since load*.
+
+#### Mark a field free for chains
+
+Open the field in the field guide and switch on **Free for chains (mod may change the crop)**. Only such a
+field changes crop automatically. The tab lists them under **Fields free for the chain**.
+
+Permanent crops (vine, olive, poplar) and grass fields are never changed, even when marked.
+
+#### Suggestions: Approve and Reject
+
+If the chain lacks area on a field that is not free, the chain tree shows a suggestion: **Suggest
+[Approve]** and **[Reject]**. The same suggestion appears in **Needs attention** as *Chain: F12 Wheat →
+Flour*.
+
+- **[Approve]** changes the field's crop.
+- **[Reject]** removes the suggestion.
+- An outdated suggestion says *The suggestion no longer applies*.
+- Fields the mod changed on its own are marked *switched (free field)*.
+
+#### Intermediate goods
+
+If a chain needs an intermediate good (for example flour for bread), the mod switches on the production
+that makes it.
+
+- The mod switches a production off again only if the chain switched it on.
+- If you switch such a production off yourself, the chain leaves it off.
+- If you switch off the root production, the chain's flows are stopped (see below), unless another chain
+  still uses them.
+
+#### Chain flows
+
+For each link the mod creates a flow named **Chain: <goods> → <building>** (at most 2 new per minute).
+
+- The flow gets a free pool tractor and a tipping trailer. The mod never takes a tractor that belongs to
+  another flow.
+- If none is available, the flow is created stopped and the chain shows *no tractor/trailer*.
+- Flows with pallets are always created stopped: choose a UAL trailer yourself.
+- When the chain is switched off, its flows are **stopped**. They are not deleted.
+- Status in the chain: *flow running*, *flow stopped*, *no tractor/trailer* or *no flow*.
+
+#### Limitations
+
+- The mod does **not buy** goods and does **not buy animals**. What must be bought shows as *must buy*.
+- Permanent crops (vine, olive, poplar) and grass fields are never changed.
+- The plan uses the base yield without fertiliser bonus, so it errs on too many hectares rather than too few.
+- The chain uses only your own factories and barns.
+
 ## 8. Start, stop and saving
 
 **Start flow** does the following for each approved tractor:
@@ -1182,3 +1258,6 @@ The mod is being tested continuously, and bug reports are very welcome.
 | **Reserve** | What the farm's own barns and factories use in the next day |
 | **Time to empty** | How long a factory's stock of a good lasts at the current consumption |
 | **Field silo** | A silo near a field used as intermediate storage |
+| **Chain** | The whole path from a production back through factories and barns to the crops in the fields |
+| **Root production** | The production you switch on yourself, which the chain keeps running |
+| **Free for chains** | A field marking that lets the mod change the crop automatically |