Files
plm-lottery/apps/lottery/migrations/0001_initial.py
T
davideandClaude Sonnet 5.5 0eba7bcfe6 A2: lottery models and database constraints (WEB-04, ADR-10, ADR-15, ADR-22, DAT-76..79, AUD-47)
LotteryConfig (single row, parameters and the three pause switches), Round
(single active round, own rules, split within the pool), Participation (one
bet per player and round, unique draw position), Movement (signed ledger,
idempotency key per player), ChainTransaction and an append-only AuditEntry
enforced by the model and by SQLite triggers. Every foreign key is PROTECT.
One test per constraint, each checked to hit the intended constraint.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-16 12:13:10 +01:00

275 lines
19 KiB
Python

# Generated by Django 5.2.19 on 2026-11-16 11:02
import django.db.models.deletion
import django.db.models.expressions
import django.utils.timezone
from django.conf import settings
from django.db import migrations, models
class Migration(migrations.Migration):
initial = True
dependencies = [
migrations.swappable_dependency(settings.AUTH_USER_MODEL),
]
operations = [
migrations.CreateModel(
name='ChainTransaction',
fields=[
('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
('kind', models.CharField(choices=[('bet', 'Bet'), ('withdrawal', 'Withdrawal'), ('payout', 'Payout')], max_length=16)),
('status', models.CharField(choices=[('building', 'Building'), ('pending', 'Pending'), ('confirmed', 'Confirmed'), ('failed', 'Failed')], default='building', max_length=16)),
('current_txid', models.CharField(blank=True, max_length=64, null=True)),
('raw_hex', models.TextField(blank=True, default='')),
('created_at', models.DateTimeField(default=django.utils.timezone.now)),
('broadcast_at', models.DateTimeField(blank=True, null=True)),
('confirmed_at', models.DateTimeField(blank=True, null=True)),
('failed_at', models.DateTimeField(blank=True, null=True)),
('failure_reason', models.TextField(blank=True, default='')),
('user', models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.PROTECT, related_name='chain_transactions', to=settings.AUTH_USER_MODEL)),
],
),
migrations.CreateModel(
name='LotteryConfig',
fields=[
('id', models.PositiveSmallIntegerField(default=1, primary_key=True, serialize=False)),
('fee_address', models.CharField(blank=True, default='', max_length=128)),
('bet_amount_sats', models.BigIntegerField(default=1000000000)),
('round_duration_seconds', models.PositiveIntegerField(default=600)),
('round_cooldown_seconds', models.PositiveIntegerField(default=30)),
('draw_confirmations', models.PositiveSmallIntegerField(default=3)),
('max_round_pool_sats', models.BigIntegerField(default=0)),
('pause_after_round', models.BooleanField(default=False)),
('new_bets_suspended', models.BooleanField(default=False)),
('withdrawals_suspended', models.BooleanField(default=False)),
('updated_at', models.DateTimeField(auto_now=True)),
],
options={
'constraints': [models.CheckConstraint(condition=models.Q(('id', 1)), name='lottery_config_single_row'), models.CheckConstraint(condition=models.Q(('bet_amount_sats__gt', 0)), name='lottery_config_bet_positive'), models.CheckConstraint(condition=models.Q(('round_duration_seconds__gt', 0)), name='lottery_config_duration_positive'), models.CheckConstraint(condition=models.Q(('max_round_pool_sats__gte', 0)), name='lottery_config_cap_not_negative'), models.CheckConstraint(condition=models.Q(('draw_confirmations__gte', 1), ('draw_confirmations__lte', 20)), name='lottery_config_draw_confirmations_range')],
},
),
migrations.CreateModel(
name='Round',
fields=[
('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
('status', models.CharField(choices=[('open', 'Open'), ('closing', 'Closing'), ('drawing', 'Drawing'), ('paying_out', 'Paying Out'), ('closed', 'Closed')], default='open', max_length=16)),
('opened_at', models.DateTimeField(default=django.utils.timezone.now)),
('closed_at', models.DateTimeField(blank=True, null=True)),
('duration_seconds', models.PositiveIntegerField(default=600)),
('cooldown_seconds', models.PositiveIntegerField(default=30)),
('bet_amount_sats', models.BigIntegerField(default=1000000000)),
('fee_address', models.CharField(blank=True, default='', max_length=128)),
('max_round_pool_sats', models.BigIntegerField(default=0)),
('draw_confirmations', models.PositiveSmallIntegerField(default=3)),
('pool_address', models.CharField(blank=True, default='', max_length=128)),
('server_seed_enc', models.TextField(blank=True, null=True)),
('server_seed', models.CharField(blank=True, max_length=64, null=True)),
('server_seed_hash', models.CharField(blank=True, max_length=64, null=True)),
('participants_hash', models.CharField(blank=True, max_length=64, null=True)),
('drawing_started_at', models.DateTimeField(blank=True, null=True)),
('draw_height', models.PositiveIntegerField(blank=True, null=True)),
('draw_block_hash', models.CharField(blank=True, max_length=64, null=True)),
('pool_amount_sats', models.BigIntegerField(blank=True, null=True)),
('winner_amount_sats', models.BigIntegerField(blank=True, null=True)),
('fee_amount_sats', models.BigIntegerField(blank=True, null=True)),
('payout_transaction', models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.PROTECT, related_name='paid_rounds', to='lottery.chaintransaction')),
('winner', models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.PROTECT, related_name='rounds_won', to=settings.AUTH_USER_MODEL)),
],
),
migrations.CreateModel(
name='Participation',
fields=[
('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
('bet_amount_sats', models.BigIntegerField()),
('status', models.CharField(choices=[('pending', 'Pending'), ('confirmed', 'Confirmed'), ('rejected', 'Rejected'), ('excluded', 'Excluded')], default='pending', max_length=16)),
('created_at', models.DateTimeField(default=django.utils.timezone.now)),
('confirmed_at', models.DateTimeField(blank=True, null=True)),
('draw_position', models.PositiveIntegerField(blank=True, null=True)),
('bet_txid', models.CharField(blank=True, default='', max_length=64)),
('bet_vout', models.PositiveIntegerField(default=0)),
('user', models.ForeignKey(on_delete=django.db.models.deletion.PROTECT, related_name='participations', to=settings.AUTH_USER_MODEL)),
('round', models.ForeignKey(on_delete=django.db.models.deletion.PROTECT, related_name='participations', to='lottery.round')),
],
),
migrations.CreateModel(
name='Movement',
fields=[
('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
('kind', models.CharField(choices=[('deposit', 'Deposit'), ('bet', 'Bet'), ('win', 'Win'), ('refund', 'Refund'), ('withdrawal', 'Withdrawal')], max_length=16)),
('status', models.CharField(choices=[('pending', 'Pending'), ('confirmed', 'Confirmed'), ('failed', 'Failed')], default='pending', max_length=16)),
('amount_sats', models.BigIntegerField()),
('request_id', models.UUIDField(blank=True, null=True)),
('destination', models.CharField(blank=True, default='', max_length=128)),
('created_at', models.DateTimeField(default=django.utils.timezone.now)),
('confirmed_at', models.DateTimeField(blank=True, null=True)),
('chain_transaction', models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.PROTECT, related_name='movements', to='lottery.chaintransaction')),
('user', models.ForeignKey(on_delete=django.db.models.deletion.PROTECT, related_name='movements', to=settings.AUTH_USER_MODEL)),
('participation', models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.PROTECT, related_name='movements', to='lottery.participation')),
('round', models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.PROTECT, related_name='movements', to='lottery.round')),
],
),
migrations.AddField(
model_name='chaintransaction',
name='round',
field=models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.PROTECT, related_name='chain_transactions', to='lottery.round'),
),
migrations.CreateModel(
name='AuditEntry',
fields=[
('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
('created_at', models.DateTimeField(db_index=True, default=django.utils.timezone.now)),
('actor_label', models.CharField(max_length=150)),
('action', models.CharField(db_index=True, max_length=64)),
('reason', models.TextField(blank=True, default='')),
('outcome', models.CharField(choices=[('ok', 'Ok'), ('denied', 'Denied'), ('error', 'Error')], default='ok', max_length=8)),
('subject_type', models.CharField(blank=True, default='', max_length=32)),
('subject_id', models.CharField(blank=True, default='', max_length=64)),
('payload', models.JSONField(blank=True, default=dict)),
('actor', models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.PROTECT, related_name='audit_entries', to=settings.AUTH_USER_MODEL)),
],
options={
'verbose_name_plural': 'audit entries',
'constraints': [models.CheckConstraint(condition=models.Q(('outcome__in', ['ok', 'denied', 'error'])), name='lottery_audit_outcome_valid')],
},
),
migrations.AddIndex(
model_name='round',
index=models.Index(fields=['status'], name='lottery_rou_status_0bc276_idx'),
),
migrations.AddIndex(
model_name='round',
index=models.Index(fields=['-opened_at'], name='lottery_rou_opened__cab610_idx'),
),
migrations.AddConstraint(
model_name='round',
constraint=models.UniqueConstraint(models.Value(1), condition=models.Q(('status__in', ['open', 'closing', 'drawing', 'paying_out'])), name='lottery_round_single_active'),
),
migrations.AddConstraint(
model_name='round',
constraint=models.CheckConstraint(condition=models.Q(('status__in', ['open', 'closing', 'drawing', 'paying_out', 'closed'])), name='lottery_round_status_valid'),
),
migrations.AddConstraint(
model_name='round',
constraint=models.CheckConstraint(condition=models.Q(('bet_amount_sats__gt', 0)), name='lottery_round_bet_positive'),
),
migrations.AddConstraint(
model_name='round',
constraint=models.CheckConstraint(condition=models.Q(('duration_seconds__gt', 0)), name='lottery_round_duration_positive'),
),
migrations.AddConstraint(
model_name='round',
constraint=models.CheckConstraint(condition=models.Q(('max_round_pool_sats__gte', 0)), name='lottery_round_cap_not_negative'),
),
migrations.AddConstraint(
model_name='round',
constraint=models.CheckConstraint(condition=models.Q(('draw_confirmations__gte', 1), ('draw_confirmations__lte', 20)), name='lottery_round_draw_confirmations_range'),
),
migrations.AddConstraint(
model_name='round',
constraint=models.CheckConstraint(condition=models.Q(models.Q(('status', 'closed'), _negated=True), ('closed_at__isnull', False), _connector='OR'), name='lottery_round_closed_has_time'),
),
migrations.AddConstraint(
model_name='round',
constraint=models.CheckConstraint(condition=models.Q(('pool_amount_sats__isnull', True), ('pool_amount_sats__gte', 0), _connector='OR'), name='lottery_round_pool_not_negative'),
),
migrations.AddConstraint(
model_name='round',
constraint=models.CheckConstraint(condition=models.Q(('pool_amount_sats__isnull', True), ('winner_amount_sats__isnull', True), ('fee_amount_sats__isnull', True), models.Q(('fee_amount_sats__gte', 0), ('winner_amount_sats__gte', 0), ('winner_amount_sats__lte', django.db.models.expressions.CombinedExpression(models.F('pool_amount_sats'), '-', models.F('fee_amount_sats')))), _connector='OR'), name='lottery_round_split_within_pool'),
),
migrations.AddConstraint(
model_name='participation',
constraint=models.UniqueConstraint(fields=('round', 'user'), name='lottery_participation_one_per_round'),
),
migrations.AddConstraint(
model_name='participation',
constraint=models.UniqueConstraint(condition=models.Q(('draw_position__isnull', False)), fields=('round', 'draw_position'), name='lottery_participation_unique_position'),
),
migrations.AddConstraint(
model_name='participation',
constraint=models.CheckConstraint(condition=models.Q(('bet_amount_sats__gt', 0)), name='lottery_participation_amount_positive'),
),
migrations.AddConstraint(
model_name='participation',
constraint=models.CheckConstraint(condition=models.Q(('status__in', ['pending', 'confirmed', 'rejected', 'excluded'])), name='lottery_participation_status_valid'),
),
migrations.AddConstraint(
model_name='participation',
constraint=models.CheckConstraint(condition=models.Q(models.Q(('status', 'confirmed'), _negated=True), ('confirmed_at__isnull', False), _connector='OR'), name='lottery_participation_confirmed_has_time'),
),
migrations.AddConstraint(
model_name='participation',
constraint=models.CheckConstraint(condition=models.Q(('draw_position__isnull', True), ('status', 'confirmed'), _connector='OR'), name='lottery_participation_position_only_confirmed'),
),
migrations.AddIndex(
model_name='movement',
index=models.Index(fields=['user', '-created_at'], name='lottery_mov_user_id_a94bbb_idx'),
),
migrations.AddIndex(
model_name='movement',
index=models.Index(fields=['user', 'status'], name='lottery_mov_user_id_5821a0_idx'),
),
migrations.AddConstraint(
model_name='movement',
constraint=models.UniqueConstraint(condition=models.Q(('request_id__isnull', False)), fields=('user', 'request_id'), name='lottery_movement_idempotency'),
),
migrations.AddConstraint(
model_name='movement',
constraint=models.CheckConstraint(condition=models.Q(('amount_sats', 0), _negated=True), name='lottery_movement_amount_not_zero'),
),
migrations.AddConstraint(
model_name='movement',
constraint=models.CheckConstraint(condition=models.Q(('kind__in', ['deposit', 'bet', 'win', 'refund', 'withdrawal'])), name='lottery_movement_kind_valid'),
),
migrations.AddConstraint(
model_name='movement',
constraint=models.CheckConstraint(condition=models.Q(('status__in', ['pending', 'confirmed', 'failed'])), name='lottery_movement_status_valid'),
),
migrations.AddConstraint(
model_name='movement',
constraint=models.CheckConstraint(condition=models.Q(models.Q(('kind__in', ['deposit', 'win', 'refund']), ('amount_sats__gt', 0)), models.Q(('kind__in', ['bet', 'withdrawal']), ('amount_sats__lt', 0)), _connector='OR'), name='lottery_movement_sign_follows_kind'),
),
migrations.AddConstraint(
model_name='movement',
constraint=models.CheckConstraint(condition=models.Q(models.Q(('kind__in', ['bet', 'win', 'refund']), _negated=True), ('round__isnull', False), _connector='OR'), name='lottery_movement_round_kinds_have_round'),
),
migrations.AddConstraint(
model_name='movement',
constraint=models.CheckConstraint(condition=models.Q(models.Q(('status', 'confirmed'), _negated=True), ('confirmed_at__isnull', False), _connector='OR'), name='lottery_movement_confirmed_has_time'),
),
migrations.AddIndex(
model_name='chaintransaction',
index=models.Index(fields=['status'], name='lottery_cha_status_9a6ca9_idx'),
),
migrations.AddConstraint(
model_name='chaintransaction',
constraint=models.UniqueConstraint(condition=models.Q(('current_txid__isnull', False)), fields=('current_txid',), name='lottery_chaintx_unique_txid'),
),
migrations.AddConstraint(
model_name='chaintransaction',
constraint=models.CheckConstraint(condition=models.Q(('kind__in', ['bet', 'withdrawal', 'payout'])), name='lottery_chaintx_kind_valid'),
),
migrations.AddConstraint(
model_name='chaintransaction',
constraint=models.CheckConstraint(condition=models.Q(('status__in', ['building', 'pending', 'confirmed', 'failed'])), name='lottery_chaintx_status_valid'),
),
migrations.AddConstraint(
model_name='chaintransaction',
constraint=models.CheckConstraint(condition=models.Q(models.Q(('status', 'confirmed'), _negated=True), ('confirmed_at__isnull', False), _connector='OR'), name='lottery_chaintx_confirmed_has_time'),
),
migrations.AddConstraint(
model_name='chaintransaction',
constraint=models.CheckConstraint(condition=models.Q(models.Q(('status', 'failed'), _negated=True), models.Q(('failed_at__isnull', False), models.Q(('failure_reason', ''), _negated=True)), _connector='OR'), name='lottery_chaintx_failed_has_reason'),
),
migrations.AddConstraint(
model_name='chaintransaction',
constraint=models.CheckConstraint(condition=models.Q(models.Q(('kind__in', ['bet', 'withdrawal']), _negated=True), ('user__isnull', False), _connector='OR'), name='lottery_chaintx_user_kinds_have_user'),
),
migrations.AddConstraint(
model_name='chaintransaction',
constraint=models.CheckConstraint(condition=models.Q(models.Q(('kind', 'payout'), _negated=True), ('round__isnull', False), _connector='OR'), name='lottery_chaintx_payout_has_round'),
),
]