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

CHANGELOG.md

@@ -6,6 +6,10 @@ står i [docs/BRUGERMANUAL.md](docs/BRUGERMANUAL.md) (dansk) og [docs/USER_MANUA
 
 ---
 
+## 1.61 — Produktionskæder
+
+- **1.61.0** Produktionskæder: slå et produkt til i en fabrik, og moden holder det kørende helt tilbage til marken. Kæden regner baglæns gennem dine egne fabrikker og stalde til afgrøderne og ser 12 måneder frem. Ny fane **Kæder** med træ pr. rod-produktion, farvet status, fold ud/ind og **[Pause]**/**[Start]**. Marker markeret **Fri til kæden** skifter afgrøde automatisk (højst 2 i minuttet); andre marker får forslag med **[Godkend]**/**[Afvis]** i fanen og i **Kræver handling**. En afgrøde, du selv har valgt, ændres aldrig. Mellemled tændes og slukkes kun igen, hvis kæden tændte dem. Flows **Kæde: <vare> → <bygning>** oprettes med en ledig pool-traktor og tipvogn (ellers stoppet: *mangler traktor/vogn*; paller altid stoppet) og stoppes, ikke slettes, når kæden slås fra. Ingen handlinger de første 2 minutter og ved delvise læsefejl. Begrænsninger: intet køb, ingen dyrekøb, flerårige afgrøder og græsmarker skiftes aldrig, grundudbytte uden gødningsbonus. Manual og ordliste opdateret.
+
 ## 1.60 — "Kræver handling" → flow, menuplacering, flow-vogne i guiden
 
 - **1.60.21** Flow-vogne: kun et redskab med lastrum (ikke plov, kultivator eller såmaskine) huskes som flowets vogn. Før kunne en plov, der hang bag en flow-traktor, blive gemt som gyllevogn, og gyllen blev aldrig kørt.

FS25_ADSmartPickup/modDesc.xml

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="utf-8" standalone="no"?>
 <modDesc descVersion="107">
     <author>masterdraco</author>
-    <version>1.60.21.0</version>
+    <version>1.61.0.0</version>
     <title>
         <en>AD Smart Pickup</en>
     </title>

README.md

@@ -16,6 +16,7 @@ Alt sættes op i menuen **Smart Pickup** i ESC-menuen.
   startes eller stoppes samlet fra en farvet liste.
 - **Flow-vogne og maskinpulje:** en traktor uden vogn kan selv hente sin vogn ved en Connect-markør og
   sætte den på plads igen. Frakoblede redskaber og ledige traktorer bruges som en fælles pulje.
+- **Produktionskæder:** slå et produkt til i en fabrik, og moden holder det kørende tilbage til marken. Fanen Kæder viser træet, marker markeret "Fri til kæden" skifter afgrøde automatisk, og andre marker får forslag, du godkender eller afviser. Mellemled og flows oprettes efter behov.
 - **Markarbejde:** slåning, høst, klargøring, såning og pleje på alle marker. AutoDrive kører på vejen,
   og Courseplay arbejder på marken.
 - **Marksiloer:** varer i marksiloer køres automatisk hjem til gårdens lagre.
@@ -70,6 +71,7 @@ is set up in the **Smart Pickup** menu in the ESC menu.
   start or stop them from a colour-coded list.
 - **Flow trailers and machine pool:** a tractor without a trailer can fetch its trailer at a Connect
   marker and park it again. Detached implements and free tractors form a shared pool.
+- **Production chains:** switch on a product in a factory and the mod keeps it running back to the field. The Chains tab shows the tree, fields marked "Free for chains" change crop automatically, and other fields get suggestions you approve or reject. Intermediate goods and flows are set up as needed.
 - **Field work:** mowing, harvesting, preparation, sowing and crop care on every field. AutoDrive
   drives the roads and Courseplay works the field.
 - **Field silos:** goods in field silos are brought home to the farm's storages automatically.

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 |