Gitea flags en dash, multiplication sign, minus sign and single angle quotes as confusable characters, which put a warning on most pages; use plain equivalents (docs/SPEC.md stays untouched). STATUS.md now lists the issue numbers per milestone, the items waiting for the owner and the open specification questions tracked by issue #114. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2.6 KiB
2.6 KiB
Contribuire
Stato: bozza · Ultima revisione: 2026-11-10 · Specifica: SPEC §17-§20
Questa pagina riassume come si propone una modifica a Khaemhat. Il processo completo è in
Processo di sviluppo e in
docs/DEVELOPMENT.md.
Prima di iniziare
- Leggi
CLAUDE.md: vincoli non negoziabili ed emendamenti alla specifica. - Cerca o apri un'issue: ogni lavoro parte da un'issue con milestone ed etichette.
- Per l'interfaccia guarda il Mockup corrispondente e la pagina Design-UI.
Regole essenziali
| Regola | Dettaglio |
|---|---|
| Nessuna libreria esterna | Solo framework Microsoft, Npgsql, Microsoft.Data.Sqlite; nei test MSTest. Verifica: scripts/check-packages.sh |
| Lingue | Codice, commenti e commit in inglese; interfaccia in italiano tramite risorse |
| Database | Il codice sopra lo strato dati non conosce il motore; test su SQLite e, se possibile, PostgreSQL |
| Fiscalità | Tutto ciò che è italiano sta in Khaemhat.Fiscal.Italy |
| Qualità | Nessun warning (TreatWarningsAsErrors), Nullable attivo |
| Documentazione | Wiki, docs/*.md e CHANGELOG.md aggiornati nella stessa PR |
| Distribuzione | Solo immagine Docker; nessun installer |
Flusso
- Ramo da
main:feat/<n>-descrizione,fix/<n>-…odocs/<n>-…. - Commit in stile Conventional Commits, in inglese, che citano l'issue (
#n). scripts/check-packages.shescripts/test.shverdi in locale.- Pull request verso
mainconCloses #n, spiegazione di cosa cambia e come è stato verificato, screenshot se cambia l'interfaccia. La CI (Gitea Actions) deve essere verde.
Modificare la wiki
La wiki si modifica solo nei file docs/wiki/*.md del repository: a ogni push su main viene ripubblicata nel
wiki Gitea e le modifiche fatte dall'editor web andrebbero perse. Convenzioni: riquadro di stato in testa, link
[Testo](Nome-Pagina), immagini con URL raw del ramo main, screenshot reali in docs/wiki/img/.
Segnalare un problema
- Bug e richieste: issue con etichetta
Kind/BugoKind/Enhancement, passi per riprodurre, versione dell'immagine, sezione del Log e codice di traccia mostrato dall'errore. - Vulnerabilità di sicurezza: non aprire un'issue pubblica; segui le indicazioni di
docs/SECURITY.md.