feat: fiscal_series, fiscal_certificates, fiscal_documents models + migrations

Ports the three tables that change owner per the design spec (decision #2):
FiscalSeries (was tenants.FiscalDocumentSeries), FiscalCertificate,
FiscalDocument (both from fiscal.models) — organization_id/branch_id
replaced by product_id (FK products) + tenant_ref/branch_ref (opaque
strings) per the porte table. sale_id/service_order_id dropped (no Sale
concept here). document_model is now a plain String(2) + Python enum,
never a Postgres enum (Global Constraints: zero enum PG — the auto's own
version of this column was a real PG enum, a documented debt not repeated
here).

Constraints preserved: UNIQUE chave_acesso, partial-unique
cert-vivo-per-(product_id, branch_ref) (product-scoped in addition to the
auto's branch_id, since branch_ref is an opaque string two different
products could coincidentally share), UNIQUE (product_id, tenant_ref,
branch_ref, document_model, serie) on the series.

documents.service.allocate_fiscal_number ported verbatim (mechanism +
contract): SELECT ... FOR UPDATE + populate_existing=True, no-commit
contract (caller commits together with the FiscalDocument insert, Task 5).
The next_number regression guard is deliberately deferred to Task 4's
PATCH /v1/series endpoint (needs FiscalDocument, which now exists).

AST guard (tests/shared/test_for_update_populate_existing.py) ported and
adapted to scan src/fiscal_svc/, plus two new self-tests proving the
detection logic itself in both directions (flags a missing fix, does not
false-positive on a correctly fixed multi-line chain) — the ported guard
alone only proves "currently green", not "actually detects".

33 tests green via `make k8s-test` (real-migration round trips + unique
constraint violations, N=10 concurrency, identity-map staleness repro,
tenancy-scoping not-found across product/tenant_ref/branch_ref).

This commit is contained in:

jonatanritter

2026-07-22 16:25:41 -03:00

parent 1791435a8d

commit 836c267e09

10 changed files with 1237 additions and 1 deletions

									
										alembic/env.py
									
		+1
		-1
	
												View File
												
				@@ -13,7 +13,7 @@ from fiscal_svc.core.db import Base

				# Uncomment as modules gain SQLAlchemy models, so autogenerate can see them

				# (mirrors auto/backend/alembic/env.py's own convention):

				from fiscal_svc.tenancy import models as tenancy_models  # noqa: F401

				# from fiscal_svc.documents import models as documents_models  # noqa: F401

				from fiscal_svc.documents import models as documents_models  # noqa: F401

				# this is the Alembic Config object, which provides

				# access to the values within the .ini file in use.