Skip to content

fix: update terminology from "series number" to "number in series" - #305

Open
Himura2la wants to merge 1 commit into
fabiodalez-dev:mainfrom
hackerembassy:l8n-series-number
Open

fix: update terminology from "series number" to "number in series"#305
Himura2la wants to merge 1 commit into
fabiodalez-dev:mainfrom
hackerembassy:l8n-series-number

Conversation

@Himura2la

@Himura2la Himura2la commented Jul 29, 2026

Copy link
Copy Markdown
Contributor

It was hard to distinguish from "Cycle order"

To be honest, I'd prefer the "Volume Number in Series" wording for absolute clarity, but this would require multi-language fix, and I'm not sure it's a good idea.

"number in series" is clear enough

Summary by CodeRabbit

  • Correzioni

    • Migliorata l’importazione CSV riconoscendo correttamente l’intestazione inglese “number in series”.
    • Aggiornate le traduzioni inglesi del campo relativo al numero nella serie.
  • Documentazione

    • Chiarita la gestione dei metadati di serie e cicli nei moduli di creazione e modifica dei libri.
    • Aggiornata la descrizione della pagina amministrativa delle collane e dei relativi raggruppamenti.

@coderabbitai

coderabbitai Bot commented Jul 29, 2026

Copy link
Copy Markdown

Review Change Stack

📝 Walkthrough

Walkthrough

La mappatura CSV per numero_serie, le traduzioni inglesi correlate e la voce di changelog vengono aggiornate per usare la terminologia “number in series” e descrivere i metadati delle serie.

Changes

Terminologia delle serie

Layer / File(s) Summary
Aggiornamento di intestazioni, traduzioni e changelog
app/Controllers/CsvImportController.php, locale/en_US.json, README.md
La variante CSV riconosciuta diventa “number in series”; le due traduzioni inglesi passano a “Number in Series” e “Number in series”; il changelog descrive i metadati di gruppo, ciclo e serie aggiornati.

Estimated code review effort: 1 (Trivial) | ~5 minuti

Suggested reviewers: fabiodalez-dev, fabiodalez

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed Il titolo riflette correttamente il cambio terminologico principale da "series number" a "number in series".
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@app/Controllers/CsvImportController.php`:
- Line 1102: Ripristina l’alias CSV precedente “series number” nell’elenco degli
alias associati a `numero_serie` in `CsvImportController`, mantenendo anche gli
alias attuali. Verifica che l’intestazione venga nuovamente mappata a
`numero_serie` durante l’import per preservare i valori esistenti.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: dc9421d7-03c5-4ec4-985a-f5f1808c60a8

📥 Commits

Reviewing files that changed from the base of the PR and between 96f2745 and 2660c14.

📒 Files selected for processing (3)
  • README.md
  • app/Controllers/CsvImportController.php
  • locale/en_US.json

'copie_totali' => ['copie_totali', 'copie', 'copies', 'quantity', 'quantità', 'cantidad'],
'collana' => ['collana', 'series', 'collection', 'collections', 'colección', 'reihe'],
'numero_serie' => ['numero_serie', 'series number', 'número de serie', 'numéro de série'],
'numero_serie' => ['numero_serie', 'number in series', 'número de serie', 'numéro de série'],

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🗄️ Data Integrity & Integration | 🟠 Major | ⚡ Quick win

Mantieni anche l’alias CSV precedente.

La rimozione di series number rompe i CSV già esportati: l’intestazione non viene mappata a numero_serie, che alla Line 849 risulta quindi assente. Un re-import può così cancellare il valore esistente in libri.numero_serie.

-            'numero_serie' => ['numero_serie', 'number in series', 'número de serie', 'numéro de série'],
+            'numero_serie' => ['numero_serie', 'series number', 'number in series', 'número de serie', 'numéro de série'],
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
'numero_serie' => ['numero_serie', 'number in series', 'número de serie', 'numéro de série'],
'numero_serie' => ['numero_serie', 'series number', 'number in series', 'número de serie', 'numéro de série'],
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@app/Controllers/CsvImportController.php` at line 1102, Ripristina l’alias CSV
precedente “series number” nell’elenco degli alias associati a `numero_serie` in
`CsvImportController`, mantenendo anche gli alias attuali. Verifica che
l’intestazione venga nuovamente mappata a `numero_serie` durante l’import per
preservare i valori esistenti.

@fabiodalez-dev

Copy link
Copy Markdown
Owner

Thanks for tightening this up — "number in series" reads clearer than "series number", especially next to "cycle order", and the README/locale wording is a good change.

One caveat on the CSV import mapping, though: swapping 'series number' for 'number in series' in mapColumnHeaders() is a silent breaking change — any existing CSV whose header reads "series number" would stop being recognised. For a CSV column that spelling was already unambiguous (there's no "cycle order" header to confuse it with), so I'd rather leave the import mapping untouched and keep the wording change to the UI (README + locale). If you do want the new alias recognised as well, please add it rather than replace, since the header list exists precisely to accept multiple spellings:

'numero_serie' => ['numero_serie', 'number in series', 'series number', 'número de serie', 'numéro de série'],

Happy to take the README/locale part as-is.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants