Parties, items and the CRM archives need codes given by the system without
duplicates, and the address and bank fields should fill themselves; this adds
both before the party and item screens that use them.
- CodeMask ({seq:0000}, {anno}, {categoria}) and code_sequences (migration
015): one sequence per rule, year and category, taken under a lock in the
transaction that saves the record, skipping codes written by hand
- CodeRuleService: rules in company settings with the masks of SPEC 11.12,
validation, preview of the next code, manual code allowed or not
- AutoFillService: municipality from postal code and back, personal tax code,
VIES, bank and BIC from the IBAN, delivery date on working days, options
that can be switched off (the ECB job honours its option)
- IBankDirectory.ReadIban gives ABI and CAB even without the ABI list; the
Italian pack now registers the directory
- Company preferences page (mockup 074) at /tabelle/preferenze, in the menu
- aria-checked now renders true/false on switch rows and profile radios
- ADR 0027, wiki, CHANGELOG, STATUS, DATA-MODEL
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Gives the company tables of the previous commit their screens, so a company
can be configured from the browser, and makes the base data runnable outside
the web server.
- one generic editor for the 26 coded tables (/tabelle/<slug>), described in
TableScreens: grid with active/disabled filter, detail with errors and
warnings, disable instead of delete, CSV export and all-or-nothing import,
"update from base tables"; index page and menu entries
- company profile in tabs with the fiscal pack checks, fiscal years with
month lock/unlock, exchange rates with manual rates
- PaymentTermService: installments saved together, percentages must sum to 100
- a new profile proposes the registered company name instead of its code
- seed verb in Khaemhat.Web and scripts/seed.sh --base [--company CODE],
shipped in the image under /app/scripts
- ADR 0026 (base data only adds missing codes; ISTAT and ABI/CAB lists come
as separate datasets), wiki, CHANGELOG, STATUS
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Adds the company tables of SPEC 11.1 behind one generic service so that every
table gets the same rules, history, cache and CSV import/export, plus the
company profile, fiscal years with monthly lock and the base-data seeder.
- 26 coded tables, exchange rates, company profile, fiscal years and periods:
entities, maps and migrations 010-014
- TableService + TableCatalog: unique codes, per-table rules (VAT codes are
checked by the fiscal pack), delete or disable when in use, single default,
CSV export/import all-or-nothing, cache with cross-instance invalidation
- CompanyProfileService (Italian identifiers through the pack),
FiscalYearService with the date check used by every dated record
- EcbRatesClient and the ECB rates system task; CsvReader
- ISeeder/SeedRunner with the data version in company settings; base tables
from the pack (IBaseTablesTemplate) and an embedded ISO country list
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Parties need their identifiers checked before they reach documents. IBAN, EAN
and e-mail checks are international and live in Core. The Italian VAT number,
fiscal code (with calculator, decoder and omocodia) and SDI recipient code are
Italian, so they sit in the Italian pack behind ITaxIdentifierRules, as the
non-negotiable rule of SPEC 1.10 wins over the class list of SPEC 21 (ADR 0025).
IBankDirectory reads ABI and CAB from an Italian IBAN; its bank list arrives
with the base data.
ViesClient calls the VIES REST service and never reports a number as invalid
when the service could not answer.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The rest of the product needs tax codes, natures, code lists and VAT rules
without knowing the country. IFiscalPack exposes the parts every country has
(tax code catalog, tax engine, calendar) and optional features by type, so a
module can tell a missing feature from a broken one. FiscalPackCatalog finds
the pack by country; only the composition root names the Italian pack, as an
architecture test now checks.
The Italian pack carries the FatturaPA 1.9.1 code lists, VAT natures and base
tax codes with their rules, summary rounding on the total per rate, the stamp
duty rule, VAT deadlines with the August and holiday shifts, withholding kinds,
basic depreciation rules and F24 codes. ADR 0025 records the design.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
STATUS is the resume point of every session; after the M3 merge and tag
it must point at M4 instead of the pending merge.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The milestone's Definition of Done asks for real screenshots, complete
wiki pages and a changelog for everything delivered. Fifteen screenshots
taken on a fresh instance now sit next to the mockups in the wiki;
Interfaccia, Dashboard, Preferenze, Design UI and Allegati are marked
complete, with the date-field shortcuts and the profile tabs that are not
built yet described as they really are. ADR 0024 records the Kh component
library, record pages and the shared list query, which shipped without
one, and the changelog gains its entries and a 0.3.0 section.
The visual check against the mockups found three layout bugs, fixed here:
the document total label took the timeline's .tl style and was cut, the
radar's .kh-choices class stacked the profile's theme cards in a column
(renamed .kh-radio-set), and on phones the top bar wrapped; it now keeps
icons only and the status bar shows only the live values.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Documents need to show, upload and generate their files from the interface,
and users need to see who changed a record. This adds the attachment list
(upload, preview, download, lock, trash and restore, older versions, ZIP,
generate/regenerate), in-app previews for PDF, images, XML, text, CSV and
XLSX, an A4 print preview with "save as attachment", and an audit history
list read through a permission-checked AuditTrailService.
Files are served by /files endpoints that require a signed-in user and the
company permissions; only PDF and images open inline, with their own CSP
that allows framing by this site only.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
F1 and "?" now open the wiki page of the screen inside the application
(/aiuto, mockup 011) from a copy of the wiki shipped next to the program,
so help works offline and always matches the installed version. Markdown
is converted in-house and fully encoded; images of the repository are
served from the copy. KHAEMHAT_HELP_URL sets the online wiki behind
"Apri nel wiki"; "Segnala un problema" opens a new issue of that repo.
A test checks that every page and menu entry has an existing wiki page.
The bell opens a notifications panel (mockup 010) with all/unread
filters and mark read. Broadcast notifications are now read per user
through sys_notification_reads / notification_reads instead of one
shared read_at.
The global search asks ISearchProvider implementations through
GlobalSearchService after a short pause; the first provider finds help
pages and sections, # and @ say which modules will fill them.
Escape also closes a side panel when the focus fell out of it.
Decisions in ADR 0023.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The home page becomes the widget dashboard of mockups 004-006. Each user
switches widgets on and off, orders them (drag and drop or buttons that
also work from the keyboard), sizes them on the 12-column grid and picks
the start page; every change is saved at once. Whoever may change the
company settings sets a default layout per role, used by people who
never customized; Reset goes back to it.
Todo, Done and Deadlines collect lines from sources each module
registers, so later milestones fill them without touching the widgets;
a failing source is logged and skipped. M3 provides licence, unread
warnings and scheduled task runs. Notes, Shortcuts and System status
work now; widgets of modules still to come say which milestone brings
their data instead of showing fake numbers.
Role defaults live in the new company_settings table, written through
CompanySettingsService with company.settings.write (ADR 0022).
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Documents need attachments and generated files (SPEC 9.4) before the UI of
M3 can show them, and the spec forbids external libraries for PDF and
spreadsheets.
- VolumeFileStore keeps files under <data>/files/<COMPANY>/<yyyy>/<guid>,
writing a .part file in the same folder with size limit and SHA-256, then
quota and scanner checks (IFileScanner hook, no-op by default).
- attachments table (migration 007) with kind, version series, lock, trash
and the uploading user; AttachmentService uploads, adds generated files as
the next version, lists, opens, zips, locks, trashes, restores and purges
after 30 days (new system job system.attachments-trash).
- FileGenerationService runs IFileGenerator implementations into the store;
three generators for the fictitious test document (PDF, CSV, XLSX).
- CsvWriter (Italian Excel defaults, formula-injection guard), XlsxWriter,
ZipStreamWriter and PdfWriter (standard Type1 fonts, WinAnsi, AFM widths,
JPEG, Flate, xref) only write asynchronously, so they can stream to an
HTTP response.
- ADR 0021 records versioning, storage layout, PDF scope and CSV defaults.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The pages built so far now live inside the shell of the mockups instead of the
M0 placeholder, every interface text comes from Resources/it-IT, and each user
keeps their own look and start page.
- Shell: top bar, collapsible side menu with fly-out sub-menus, status bar and
tabs that keep each page alive (page type and route values per tab, so a tab
never shows another page); at most 12 tabs, least-used clean tab evicted.
- One shortcut table with Alt variants for the combinations browsers keep
(Ctrl+W, Ctrl+Tab, Ctrl+N); command palette for pages and commands.
- ITexts over embedded JSON; tests forbid literal texts in .razor components
and check that every key used exists.
- User settings in sys_user_settings / user_settings; theme written on the
server; profile page with live preview, start page, sessions and shortcuts.
- Home, coming-soon pages for later milestones, localized sign-in and error
pages; ADR 0020; wiki, CHANGELOG, STATUS and data model updated.
Refs #25#26#31#33
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The instance now starts on its own from KHAEMHAT_* variables: it migrates the system
and company databases, creates the super user and the first company, and only then
reports ready. Users sign in with password and TOTP through revocable database
sessions, and licences decide which modules and how many companies are available.
- Configuration: every wrong variable reported at once (exit code 2), _FILE variants
- Accounts, password policy and lockout, TOTP with recovery codes, session states
with token rotation, security audit with a hash chain
- Sign-in pages (mockups 001-003), authorization attributes, security headers and a
CSP without inline scripts, login rate limit
- Signed licences, activation codes, test mode, licence tool
- DataProtection keys in the system database, encrypted with the instance key
- Memory or Redis cache (in-house RESP client) that falls back to memory
- Database log by section with trace id; cron scheduler with locks and system jobs;
record history (audit_log)
- Company creation, states, company context and X-Company, 503 in maintenance
- In-memory SQLite databases stay alive for the process (tests, demo)
- Tests for all of the above, ADR 0019, wiki, SECURITY, CHANGELOG, STATUS, DATA-MODEL
Refs #15#16#17#18#19#20#21#22#23#24
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
M1 is tagged v0.1.0. STATUS now points at M2 and lists what M1 handed over to it (migration log section, startup
refusal without a valid KHAEMHAT_SECRET_KEY, PostgreSQL performance numbers); the wiki explains the encrypted
company registry and the two engines in plain words.
Refs #14
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Every later milestone stores its data through this layer, so it has to behave the same on both engines and be safe
by construction:
- Khaemhat.Data: explicit entity maps, typed queries over a safe expression subset, SqlFragment where every
interpolated value becomes a parameter, unit of work with transactions, repositories with audit columns and
optimistic concurrency on row_version, retries on transient errors.
- SQLite provider (STRICT tables, WAL, exact decimals as integers scaled by 10^6, Unicode case-insensitive LIKE,
serialised writes) and PostgreSQL 16+ provider (numeric(19,6), timestamptz, jsonb, advisory locks, database
creation and server info). Databases are configured from postgres:// and sqlite:// URLs whose password never
appears in messages.
- C# migrations with system and company catalogues, schema_version with checksums, one transaction per migration
under a lock, refusal of unknown applied versions; first system tables sys_companies and sys_settings.
- CompanyRegistry stores each company's database URL encrypted with the instance key (AES-256-GCM, HKDF-derived key,
purpose as associated data), so a copied row cannot be read for another company.
- tools/Khaemhat.DataModelTool, scripts/gen-datamodel.sh and scripts/new-migration.sh: the current schema section of
docs/DATA-MODEL.md is generated from the migrations and a test fails when it is stale.
- C# 14 binds array.Contains to MemoryExtensions over spans; the query translator unwraps the span conversion.
- Tests run every data scenario on SQLite and PostgreSQL (PostgreSQL in CI); ADR 0018 records where the contracts
differ from SPEC 5.1. Docs, wiki, changelog and status updated.
Closes#7, #8, #9, #10, #11, #12, #13, #14
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Start development with the skeleton every later milestone builds on, so
that code, image and release path exist and are verified from day one.
- Khaemhat.sln with the ten projects of SPEC section 3 and six MSTest
projects; shared build rules with warnings as errors, analyzers and
Central Package Management restricted to the allowlist.
- Architecture tests and scripts/check-packages.sh fail on any project
reference or package that SPEC does not allow.
- Khaemhat.Web serves an Italian "under construction" page with the
official icons and version, plus /health/live, /health/ready and
/health (ADR 0012); honours KHAEMHAT_URLS and KHAEMHAT_LOG_LEVEL.
- docker/Dockerfile (non-root app user aligned to PUID/PGID by the
entrypoint, pg_dump 17, healthcheck, OCI and Unraid labels) and
compose files for PostgreSQL and a standalone SQLite demo.
- Gitea Actions: ci.yml (build, tests, image smoke test, PostgreSQL
16/17 on tags, YAML check), release.yml (image and release from a
vX.Y.Z tag, skipping versions already published) and wiki.yml.
- Development scripts, VS Code launch/tasks for debugging, and ADR
0012-0017 deciding the M0 open points of docs/STATUS.md.
Closes#1, #2, #3, #4, #5, #114
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
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>
Prepare everything needed before development starts on Khaemhat, the
ERP + CRM for Italian SMEs:
- docs/SPEC.md: the original project specification, unchanged, plus
CLAUDE.md with operational rules and amendments (Gitea instead of
GitHub/GHCR, Docker image as the only deliverable).
- ADR 0001-0011 for the baseline decisions.
- Mockups: 22 high-resolution screens, the full gallery, 88 thumbnails
cropped from it, mockup.css and an index.
- Technical docs (architecture, data model, modules, API, MCP, deploy,
security, development process, status with open spec questions).
- Full draft wiki in docs/wiki (already published to the Gitea wiki).
- Icons in assets/ and deploy files for Docker Compose and Unraid,
pointing to the Gitea package registry.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>