From 9e33a577e8f758bcf7fad14cde88322eca3da214 Mon Sep 17 00:00:00 2001 From: "AzureAD\\SylvainDUVERNAY" Date: Fri, 8 May 2026 08:56:26 +0200 Subject: [PATCH] Project organisation --- .../docs/backlog/market-price-import-backlog.md | 12 ++++++------ modules/purchase_trade/docs/bugs.md | 2 +- .../{rules => business rules}/invoice-freight.md | 0 .../docs/{rules => business rules}/lot-navigation.md | 0 .../docs/{rules => business rules}/lot-quantity.md | 0 .../{rules => business rules}/market-price-import.md | 0 modules/purchase_trade/docs/business-rules.md | 10 +++++----- .../purchase_trade/docs/documentation-management.md | 2 +- 8 files changed, 13 insertions(+), 13 deletions(-) rename modules/purchase_trade/docs/{rules => business rules}/invoice-freight.md (100%) rename modules/purchase_trade/docs/{rules => business rules}/lot-navigation.md (100%) rename modules/purchase_trade/docs/{rules => business rules}/lot-quantity.md (100%) rename modules/purchase_trade/docs/{rules => business rules}/market-price-import.md (100%) diff --git a/modules/purchase_trade/docs/backlog/market-price-import-backlog.md b/modules/purchase_trade/docs/backlog/market-price-import-backlog.md index f646ad3..664fd25 100644 --- a/modules/purchase_trade/docs/backlog/market-price-import-backlog.md +++ b/modules/purchase_trade/docs/backlog/market-price-import-backlog.md @@ -7,7 +7,7 @@ Scope: code changes related only to `BR-PT-004 - Market Price Import`. - Status: done - Implementation commit: `eaae2e5` - Priority: high -- Source: [rules/market-price-import.md](../rules/market-price-import.md) +- Source: [business rules/market-price-import.md](../business%20rules/market-price-import.md) - Requirement: enforce uniqueness of `(price, price_date)` at model level without adding a database constraint yet. - Work done: - added model-level validation on `price.price_value` @@ -27,7 +27,7 @@ Scope: code changes related only to `BR-PT-004 - Market Price Import`. - Status: open - Priority: medium -- Source: [rules/market-price-import.md](../rules/market-price-import.md) +- Source: [business rules/market-price-import.md](../business%20rules/market-price-import.md) - Requirement: prefer the user's/default locale date format for ambiguous slash dates, then fall back to the current parsing order only if no locale preference is available. - Current behavior: `DD/MM/YYYY` is tried before `MM/DD/YYYY`. - Expected code impact: @@ -41,7 +41,7 @@ Scope: code changes related only to `BR-PT-004 - Market Price Import`. - Status: open - Priority: high -- Source: [rules/market-price-import.md](../rules/market-price-import.md) +- Source: [business rules/market-price-import.md](../business%20rules/market-price-import.md) - Requirement: `price_value` is mandatory for imported rows. Missing `price_value` must be reported as a row error. - Current behavior: empty `price_value` is imported as an empty value. - Expected code impact: @@ -55,7 +55,7 @@ Scope: code changes related only to `BR-PT-004 - Market Price Import`. - Status: open - Priority: high -- Source: [rules/market-price-import.md](../rules/market-price-import.md) +- Source: [business rules/market-price-import.md](../business%20rules/market-price-import.md) - Requirement: duplicate rows for the same `(price_index, price_date)` inside the same Excel file must be reported as row errors. The duplicate row must not import or update data. - Expected code impact: - `modules/purchase_trade/pricing.py` @@ -68,7 +68,7 @@ Scope: code changes related only to `BR-PT-004 - Market Price Import`. - Status: open - Priority: medium -- Source: [rules/market-price-import.md](../rules/market-price-import.md) +- Source: [business rules/market-price-import.md](../business%20rules/market-price-import.md) - Requirement: distinguish business validation errors from file, parsing, and technical errors in the import result. - Current behavior: row errors are grouped under one `Errors` section. - Expected code impact: @@ -84,7 +84,7 @@ Scope: code changes related only to `BR-PT-004 - Market Price Import`. - Status: open - Priority: high - Source bug: [BUG-PT-001](../bugs.md#bug-pt-001---missing-default-currency-in-price-index-automatic-creation) -- Source rule: [rules/market-price-import.md](../rules/market-price-import.md) +- Source rule: [business rules/market-price-import.md](../business%20rules/market-price-import.md) - Requirement: when the market price import automatically creates a missing `price.price`, the created price index must have default currency `USD`. - Current behavior: the created price index can miss the default currency even though the import specification expects `USD`. - Expected code impact: diff --git a/modules/purchase_trade/docs/bugs.md b/modules/purchase_trade/docs/bugs.md index 5447c2f..26dd477 100644 --- a/modules/purchase_trade/docs/bugs.md +++ b/modules/purchase_trade/docs/bugs.md @@ -49,7 +49,7 @@ This file is the bug register for `purchase_trade`. - Area: Market Price Import - Reported date: `2026-05-08` - Reported by: user -- Related rule: [BR-PT-004 - Market Price Import](rules/market-price-import.md) +- Related rule: [BR-PT-004 - Market Price Import](business%20rules/market-price-import.md) - Backlog entry: [PT-BL-006](backlog/market-price-import-backlog.md#pt-bl-006---fix-missing-default-currency-on-created-price-index) - Severity: - Environment: diff --git a/modules/purchase_trade/docs/rules/invoice-freight.md b/modules/purchase_trade/docs/business rules/invoice-freight.md similarity index 100% rename from modules/purchase_trade/docs/rules/invoice-freight.md rename to modules/purchase_trade/docs/business rules/invoice-freight.md diff --git a/modules/purchase_trade/docs/rules/lot-navigation.md b/modules/purchase_trade/docs/business rules/lot-navigation.md similarity index 100% rename from modules/purchase_trade/docs/rules/lot-navigation.md rename to modules/purchase_trade/docs/business rules/lot-navigation.md diff --git a/modules/purchase_trade/docs/rules/lot-quantity.md b/modules/purchase_trade/docs/business rules/lot-quantity.md similarity index 100% rename from modules/purchase_trade/docs/rules/lot-quantity.md rename to modules/purchase_trade/docs/business rules/lot-quantity.md diff --git a/modules/purchase_trade/docs/rules/market-price-import.md b/modules/purchase_trade/docs/business rules/market-price-import.md similarity index 100% rename from modules/purchase_trade/docs/rules/market-price-import.md rename to modules/purchase_trade/docs/business rules/market-price-import.md diff --git a/modules/purchase_trade/docs/business-rules.md b/modules/purchase_trade/docs/business-rules.md index 9371caa..44da7f1 100644 --- a/modules/purchase_trade/docs/business-rules.md +++ b/modules/purchase_trade/docs/business-rules.md @@ -30,16 +30,16 @@ Owner technique: `Open Squared` | ID | Titre | Domaine | Detail | | --- | --- | --- | --- | -| BR-PT-001 | Ajustement de la quantite theorique apres creation du contrat | Lot / Purchase | [rules/lot-quantity.md](rules/lot-quantity.md) | -| BR-PT-002 | Le lot physique est le pont metier entre purchase, sale et shipment | Lot / Navigation | [rules/lot-navigation.md](rules/lot-navigation.md) | -| BR-PT-003 | Le freight amount des templates facture vient du fee de shipment | Invoice / Freight | [rules/invoice-freight.md](rules/invoice-freight.md) | -| BR-PT-004 | Market Price Import | Pricing | [rules/market-price-import.md](rules/market-price-import.md) | +| BR-PT-001 | Ajustement de la quantite theorique apres creation du contrat | Lot / Purchase | [business rules/lot-quantity.md](business%20rules/lot-quantity.md) | +| BR-PT-002 | Le lot physique est le pont metier entre purchase, sale et shipment | Lot / Navigation | [business rules/lot-navigation.md](business%20rules/lot-navigation.md) | +| BR-PT-003 | Le freight amount des templates facture vient du fee de shipment | Invoice / Freight | [business rules/invoice-freight.md](business%20rules/invoice-freight.md) | +| BR-PT-004 | Market Price Import | Pricing | [business rules/market-price-import.md](business%20rules/market-price-import.md) | ## 4) Convention pour les nouvelles regles Voir aussi [documentation-management.md](documentation-management.md) pour le workflow complet de gestion documentaire. -Ajouter une ligne au catalogue puis creer une fiche detaillee dans `docs/rules/`. +Ajouter une ligne au catalogue puis creer une fiche detaillee dans `docs/business rules/`. Structure recommandee: diff --git a/modules/purchase_trade/docs/documentation-management.md b/modules/purchase_trade/docs/documentation-management.md index 045a947..3e42cd0 100644 --- a/modules/purchase_trade/docs/documentation-management.md +++ b/modules/purchase_trade/docs/documentation-management.md @@ -5,7 +5,7 @@ This guide records the documentation workflow to apply for future `purchase_trad ## Rule Documentation Structure - Keep `business-rules.md` as the entry point and rule catalog. -- Store detailed business rules in `docs/rules/`, one file per substantial rule. +- Store detailed business rules in `docs/business rules/`, one file per substantial rule. - Use stable business rule IDs such as `BR-PT-004`. - Add every new detailed rule to the catalog in `business-rules.md`. - Keep rule files focused on business behavior, expected outcomes, edge cases, impacted files, tests, and open questions.