Files
Anubis/docs/adr/0004-componenti-esterni.md
T
Alby96andClaude Opus 5.5 b4bf864f74
ci / test (postgres) (push) Successful in 1m18s
ci / test (sqlite) (push) Successful in 1m23s
ci / image (push) Successful in 41s
Set up phase 0: .NET 10 solution, toolchain, minimal app, Docker and CI
Empty but complete solution so every later phase starts from a working
toolchain: analyzers as errors, locked restore, format check, policy tests
that keep packages within ADR 0004 and keep live trading switched off,
a /health endpoint served from Docker, and a Gitea workflow with only
run steps. API facts of SPEC section 4 re-checked in docs/API-NOTES.md;
ADR 0006 records what changed (MSTest base packages, Ubuntu images,
OKX WebSocket on 443, Alpaca margin-only accounts).

refs #1 refs #2 refs #3 refs #4 refs #5

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-10 09:51:41 +01:00

4.9 KiB

0004 — Nessun SDK o componente esterno senza il permesso dell'utente

Data: 2026-11-09 · Stato: accettata · Precisata dall'ADR 0006 (MSTest tramite i suoi pacchetti di base; libgomp1 nella Fase 8)

Contesto

L'utente ha chiesto che il bot non usi SDK né componenti aggiuntivi. Se uno è davvero indispensabile, va chiesto prima, spiegando cosa si aggiunge e perché. Il motivo: ogni libreria esterna porta codice che non si controlla, aggiornamenti da seguire e, a volte, cose da installare sulla macchina.

Questa regola fa eccezione alla SPEC 2.1 ("non chiedere conferme"): per i componenti esterni si chiede sempre.

Decisione

Cosa è sempre permesso. .NET 10 e i suoi framework condivisi:

  • Microsoft.NETCore.App;
  • Microsoft.AspNetCore.App, che comprende Blazor;
  • Microsoft.WindowsDesktop.App, che comprende WinForms.

Con questi si scrive tutto il resto in casa.

Componenti autorizzati dall'utente (9 novembre 2026). Sono gli unici pacchetti NuGet ammessi, con le versioni fissate in Directory.Packages.props:

Componente Di chi A cosa serve Dove finisce
Microsoft.Data.Sqlite Microsoft Database SQLite Applicazione
System.Security.Cryptography.ProtectedData Microsoft Cifra la chiave dei segreti con DPAPI su Windows Applicazione desktop
Microsoft.Web.WebView2 Microsoft Finestra dell'applicazione desktop (il runtime è già in Windows 11) Applicazione desktop
MSTest Microsoft Test Solo sviluppo
Npgsql Progetto open source (licenza PostgreSQL) Database PostgreSQL Applicazione
Microsoft.ML, Microsoft.ML.LightGbm, Microsoft.ML.FastTree Microsoft Modelli della Fase 5. LightGBM porta una libreria nativa; in Docker serve libgomp1 Applicazione
Microsoft.ML.OnnxRuntime, Microsoft.ML.Tokenizers Microsoft Classificatore locale delle notizie della Fase 7 Applicazione

I pacchetti che questi si portano dietro si accettano con loro. Per esempio Microsoft.Data.Sqlite usa SQLitePCLRaw, che contiene la libreria nativa di SQLite. La Fase 0 attiva i file di blocco (packages.lock.json) ed elenca in docs/API-NOTES.md ogni dipendenza indiretta. Se una di queste è di terze parti, lo dice all'utente nel riepilogo della fase.

Infrastruttura, già prevista dalla specifica:

  • immagini Docker ufficiali mcr.microsoft.com/dotnet/sdk:10.0 e aspnet:10.0, più il pacchetto di sistema libgomp1;
  • PostgreSQL, se l'utente lo sceglie, come server a parte;
  • per sviluppare: .NET 10 SDK, Docker, git e Microsoft Edge (già in Windows) per le fotografie delle schermate.

Risorse che non sono codice:

  • il carattere Instrument Sans (licenza SIL OFL), incluso come file nell'applicazione e non caricato da internet;
  • il modello ONNX del classificatore, scaricato con revisione e hash fissati (SPEC 10).

Escluso, e sostituito da codice scritto in casa:

Escluso Al suo posto
Alpaca.Markets, ccxt Client su HttpClient e ClientWebSocket
Parquet.Net File .csv.gz con GZipStream
EF Core, Dapper ADO.NET con mappatura ed esecutore di migrazioni propri
System.ServiceModel.Syndication Lettura di RSS e Atom con System.Xml.Linq
ASP.NET Core Identity PBKDF2 del framework, TOTP (RFC 6238) in casa
React, Vite, Tailwind, TanStack Query, lightweight-charts, qualsiasi pacchetto npm Blazor e componenti SVG propri
xUnit, FsCheck, Playwright, bUnit MSTest, generatore casuale a seme fisso, Edge senza finestra
Photino.NET Finestra WinForms con WebView2
Inno Setup, WiX Installatore Anubis.Setup scritto in C#
make tools/Anubis.Tasks
Azioni GitHub nella CI (actions/checkout …) Passi run: con git, dotnet e docker
Librerie di analisi tecnica e di backtest Già vietate da SPEC 2.7: indicatori e motore scritti in casa

Come si aggiunge qualcosa che non è in elenco:

  1. Ci si ferma prima di aggiungerlo.
  2. Si chiede all'utente, spiegando in italiano semplice:
    • cos'è e di chi è;
    • a cosa serve e perché scriverlo in casa non conviene (tempo, rischio, qualità);
    • cosa si porta dietro e se richiede di installare qualcosa.
  3. Solo con il sì dell'utente si aggiunge, con un nuovo ADR che aggiorna questa tabella.

Alternative scartate

  • Lasciare l'appendice D così com'è, con SDK dei broker, ccxt, Parquet.Net, xUnit, FsCheck, Playwright, React e Inno Setup. Contraddice la richiesta dell'utente.
  • Scrivere in casa anche il driver PostgreSQL e i modelli di apprendimento. Sarebbe lavoro enorme e rischioso senza vantaggi; per questo l'utente li ha autorizzati.

Conseguenze

  • Un controllo in tasks check fallisce se in un progetto compare un pacchetto non presente in Directory.Packages.props. Quel file contiene solo i pacchetti di questa tabella.
  • Più codice proprio nelle Fasi 2 e 3 (client dei broker) e nella Fase 10 (installatore). Ogni parte scritta in casa ha i suoi test.