Implement debtors prison features across the application: Enhance FalukantController to include debtors prison logic in various service methods. Update FalukantService to manage debtors prison state and integrate it into user data retrieval. Modify frontend components, including DashboardWidget, StatusBar, and BankView, to display debtors prison status and warnings. Add localization for debtors prison messages in English, German, and Spanish, ensuring clarity in user notifications and actions.

backend/controllers/falukantController.js

@@ -29,30 +29,30 @@ class FalukantController {
     // Dashboard widget: originaler Endpoint (siehe Commit 62d8cd7)
     this.getDashboardWidget = this._wrapWithUser((userId) => this.service.getDashboardWidget(userId));
         this.getBranches = this._wrapWithUser((userId) => this.service.getBranches(userId));
-        this.createBranch = this._wrapWithUser((userId, req) => this.service.createBranch(userId, req.body.cityId, req.body.branchTypeId));
+        this.createBranch = this._wrapWithUser((userId, req) => this.service.createBranch(userId, req.body.cityId, req.body.branchTypeId), { blockInDebtorsPrison: true });
         this.getBranchTypes = this._wrapWithUser((userId) => this.service.getBranchTypes(userId));
         this.getBranch = this._wrapWithUser((userId, req) => this.service.getBranch(userId, req.params.branch));
-        this.upgradeBranch = this._wrapWithUser((userId, req) => this.service.upgradeBranch(userId, req.body.branchId));
+        this.upgradeBranch = this._wrapWithUser((userId, req) => this.service.upgradeBranch(userId, req.body.branchId), { blockInDebtorsPrison: true });
         this.createProduction = this._wrapWithUser((userId, req) => {
             const { branchId, productId, quantity } = req.body;
             return this.service.createProduction(userId, branchId, productId, quantity);
-        }, { successStatus: 201 });
+        }, { successStatus: 201, blockInDebtorsPrison: true });
         this.getProduction = this._wrapWithUser((userId, req) => this.service.getProduction(userId, req.params.branchId));
         this.getStock = this._wrapWithUser((userId, req) => this.service.getStock(userId, req.params.branchId || null));
         this.createStock = this._wrapWithUser((userId, req) => {
             const { branchId, stockTypeId, stockSize } = req.body;
             return this.service.createStock(userId, branchId, stockTypeId, stockSize);
-        }, { successStatus: 201 });
+        }, { successStatus: 201, blockInDebtorsPrison: true });
         this.getProducts = this._wrapWithUser((userId) => this.service.getProducts(userId));
         this.getInventory = this._wrapWithUser((userId, req) => this.service.getInventory(userId, req.params.branchId));
         this.sellProduct = this._wrapWithUser((userId, req) => {
             const { branchId, productId, quality, quantity } = req.body;
             return this.service.sellProduct(userId, branchId, productId, quality, quantity);
-        }, { successStatus: 201 });
+        }, { successStatus: 201, blockInDebtorsPrison: true });
         this.sellAllProducts = this._wrapWithUser((userId, req) => {
             const { branchId } = req.body;
             return this.service.sellAllProducts(userId, branchId);
-        }, { successStatus: 201 });
+        }, { successStatus: 201, blockInDebtorsPrison: true });
         this.moneyHistory = this._wrapWithUser((userId, req) => {
             let { page, filter } = req.body;
             if (!page) page = 1;
@@ -66,11 +66,11 @@ class FalukantController {
         this.buyStorage = this._wrapWithUser((userId, req) => {
             const { branchId, amount, stockTypeId } = req.body;
             return this.service.buyStorage(userId, branchId, amount, stockTypeId);
-        }, { successStatus: 201 });
+        }, { successStatus: 201, blockInDebtorsPrison: true });
         this.sellStorage = this._wrapWithUser((userId, req) => {
             const { branchId, amount, stockTypeId } = req.body;
             return this.service.sellStorage(userId, branchId, amount, stockTypeId);
-        }, { successStatus: 202 });
+        }, { successStatus: 202, blockInDebtorsPrison: true });
 
         this.getStockTypes = this._wrapSimple(() => this.service.getStockTypes());
         this.getStockOverview = this._wrapSimple(() => this.service.getStockOverview());
@@ -80,18 +80,18 @@ class FalukantController {
             console.log('🔍 getDirectorProposals called with userId:', userId, 'branchId:', req.body.branchId);
             return this.service.getDirectorProposals(userId, req.body.branchId);
         });
-        this.convertProposalToDirector = this._wrapWithUser((userId, req) => this.service.convertProposalToDirector(userId, req.body.proposalId));
+        this.convertProposalToDirector = this._wrapWithUser((userId, req) => this.service.convertProposalToDirector(userId, req.body.proposalId), { blockInDebtorsPrison: true });
         this.getDirectorForBranch = this._wrapWithUser((userId, req) => this.service.getDirectorForBranch(userId, req.params.branchId));
         this.getAllDirectors = this._wrapWithUser((userId) => this.service.getAllDirectors(userId));
         this.updateDirector = this._wrapWithUser((userId, req) => {
             const { directorId, income } = req.body;
             return this.service.updateDirector(userId, directorId, income);
-        });
+        }, { blockInDebtorsPrison: true });
 
         this.setSetting = this._wrapWithUser((userId, req) => {
             const { branchId, directorId, settingKey, value } = req.body;
             return this.service.setSetting(userId, branchId, directorId, settingKey, value);
-        });
+        }, { blockInDebtorsPrison: true });
 
         this.getFamily = this._wrapWithUser(async (userId) => {
             const result = await this.service.getFamily(userId);
@@ -99,9 +99,9 @@ class FalukantController {
             return result;
         });
         this.getPotentialHeirs = this._wrapWithUser((userId) => this.service.getPotentialHeirs(userId));
-        this.selectHeir = this._wrapWithUser((userId, req) => this.service.selectHeir(userId, req.body.heirId));
-        this.setHeir = this._wrapWithUser((userId, req) => this.service.setHeir(userId, req.body.childCharacterId));
-        this.acceptMarriageProposal = this._wrapWithUser((userId, req) => this.service.acceptMarriageProposal(userId, req.body.proposalId));
+        this.selectHeir = this._wrapWithUser((userId, req) => this.service.selectHeir(userId, req.body.heirId), { blockInDebtorsPrison: true });
+        this.setHeir = this._wrapWithUser((userId, req) => this.service.setHeir(userId, req.body.childCharacterId), { blockInDebtorsPrison: true });
+        this.acceptMarriageProposal = this._wrapWithUser((userId, req) => this.service.acceptMarriageProposal(userId, req.body.proposalId), { blockInDebtorsPrison: true });
         this.cancelWooing = this._wrapWithUser(async (userId) => {
             try {
                 return await this.service.cancelWooing(userId);
@@ -111,25 +111,25 @@ class FalukantController {
                 }
                 throw e;
             }
-        }, { successStatus: 202 });
+        }, { successStatus: 202, blockInDebtorsPrison: true });
         this.getGifts = this._wrapWithUser((userId) => {
             console.log('🔍 getGifts called with userId:', userId);
             return this.service.getGifts(userId);
         });
         this.setLoverMaintenance = this._wrapWithUser((userId, req) =>
-            this.service.setLoverMaintenance(userId, req.params.relationshipId, req.body?.maintenanceLevel));
+            this.service.setLoverMaintenance(userId, req.params.relationshipId, req.body?.maintenanceLevel), { blockInDebtorsPrison: true });
         this.createLoverRelationship = this._wrapWithUser((userId, req) =>
-            this.service.createLoverRelationship(userId, req.body?.targetCharacterId, req.body?.loverRole), { successStatus: 201 });
+            this.service.createLoverRelationship(userId, req.body?.targetCharacterId, req.body?.loverRole), { successStatus: 201, blockInDebtorsPrison: true });
         this.spendTimeWithSpouse = this._wrapWithUser((userId) =>
-            this.service.spendTimeWithSpouse(userId));
+            this.service.spendTimeWithSpouse(userId), { blockInDebtorsPrison: true });
         this.giftToSpouse = this._wrapWithUser((userId, req) =>
-            this.service.giftToSpouse(userId, req.body?.giftLevel));
+            this.service.giftToSpouse(userId, req.body?.giftLevel), { blockInDebtorsPrison: true });
         this.reconcileMarriage = this._wrapWithUser((userId) =>
-            this.service.reconcileMarriage(userId));
+            this.service.reconcileMarriage(userId), { blockInDebtorsPrison: true });
         this.acknowledgeLover = this._wrapWithUser((userId, req) =>
-            this.service.acknowledgeLover(userId, req.params.relationshipId));
+            this.service.acknowledgeLover(userId, req.params.relationshipId), { blockInDebtorsPrison: true });
         this.endLoverRelationship = this._wrapWithUser((userId, req) =>
-            this.service.endLoverRelationship(userId, req.params.relationshipId));
+            this.service.endLoverRelationship(userId, req.params.relationshipId), { blockInDebtorsPrison: true });
         this.getChildren = this._wrapWithUser((userId) => this.service.getChildren(userId));
         this.sendGift = this._wrapWithUser(async (userId, req) => {
             try {
@@ -140,59 +140,59 @@ class FalukantController {
                 }
                 throw e;
             }
-        });
+        }, { blockInDebtorsPrison: true });
 
         this.getTitlesOfNobility = this._wrapWithUser((userId) => this.service.getTitlesOfNobility(userId));
         this.getReputationActions = this._wrapWithUser((userId) => this.service.getReputationActions(userId));
         this.executeReputationAction = this._wrapWithUser((userId, req) =>
-            this.service.executeReputationAction(userId, req.body?.actionTypeId), { successStatus: 201 });
+            this.service.executeReputationAction(userId, req.body?.actionTypeId), { successStatus: 201, blockInDebtorsPrison: true });
         this.getHouseTypes = this._wrapWithUser((userId) => this.service.getHouseTypes(userId));
         this.getMoodAffect = this._wrapWithUser((userId) => this.service.getMoodAffect(userId));
         this.getCharacterAffect = this._wrapWithUser((userId) => this.service.getCharacterAffect(userId));
         this.getUserHouse = this._wrapWithUser((userId) => this.service.getUserHouse(userId));
         this.getBuyableHouses = this._wrapWithUser((userId) => this.service.getBuyableHouses(userId));
-        this.buyUserHouse = this._wrapWithUser((userId, req) => this.service.buyUserHouse(userId, req.body.houseId), { successStatus: 201 });
-        this.hireServants = this._wrapWithUser((userId, req) => this.service.hireServants(userId, req.body?.amount), { successStatus: 201 });
-        this.dismissServants = this._wrapWithUser((userId, req) => this.service.dismissServants(userId, req.body?.amount));
-        this.setServantPayLevel = this._wrapWithUser((userId, req) => this.service.setServantPayLevel(userId, req.body?.payLevel));
-        this.tidyHousehold = this._wrapWithUser((userId) => this.service.tidyHousehold(userId));
+        this.buyUserHouse = this._wrapWithUser((userId, req) => this.service.buyUserHouse(userId, req.body.houseId), { successStatus: 201, blockInDebtorsPrison: true });
+        this.hireServants = this._wrapWithUser((userId, req) => this.service.hireServants(userId, req.body?.amount), { successStatus: 201, blockInDebtorsPrison: true });
+        this.dismissServants = this._wrapWithUser((userId, req) => this.service.dismissServants(userId, req.body?.amount), { blockInDebtorsPrison: true });
+        this.setServantPayLevel = this._wrapWithUser((userId, req) => this.service.setServantPayLevel(userId, req.body?.payLevel), { blockInDebtorsPrison: true });
+        this.tidyHousehold = this._wrapWithUser((userId) => this.service.tidyHousehold(userId), { blockInDebtorsPrison: true });
 
         this.getPartyTypes = this._wrapWithUser((userId) => this.service.getPartyTypes(userId));
         this.createParty = this._wrapWithUser((userId, req) => {
             const { partyTypeId, musicId, banquetteId, nobilityIds, servantRatio } = req.body;
             return this.service.createParty(userId, partyTypeId, musicId, banquetteId, nobilityIds, servantRatio);
-        }, { successStatus: 201 });
+        }, { successStatus: 201, blockInDebtorsPrison: true });
         this.getParties = this._wrapWithUser((userId) => this.service.getParties(userId));
 
         this.getNotBaptisedChildren = this._wrapWithUser((userId) => this.service.getNotBaptisedChildren(userId));
         this.baptise = this._wrapWithUser((userId, req) => {
             const { characterId: childId, firstName } = req.body;
             return this.service.baptise(userId, childId, firstName);
-        });
+        }, { blockInDebtorsPrison: true });
         this.getChurchOverview = this._wrapWithUser((userId) => this.service.getChurchOverview(userId));
         this.getAvailableChurchPositions = this._wrapWithUser((userId) => this.service.getAvailableChurchPositions(userId));
         this.getSupervisedApplications = this._wrapWithUser((userId) => this.service.getSupervisedApplications(userId));
         this.applyForChurchPosition = this._wrapWithUser((userId, req) => {
             const { officeTypeId, regionId } = req.body;
             return this.service.applyForChurchPosition(userId, officeTypeId, regionId);
-        });
+        }, { blockInDebtorsPrison: true });
         this.decideOnChurchApplication = this._wrapWithUser((userId, req) => {
             const { applicationId, decision } = req.body;
             return this.service.decideOnChurchApplication(userId, applicationId, decision);
-        });
+        }, { blockInDebtorsPrison: true });
 
         this.getEducation = this._wrapWithUser((userId) => this.service.getEducation(userId));
         this.sendToSchool = this._wrapWithUser((userId, req) => {
             const { item, student, studentId } = req.body;
             return this.service.sendToSchool(userId, item, student, studentId);
-        });
+        }, { blockInDebtorsPrison: true });
 
         this.getBankOverview = this._wrapWithUser((userId) => this.service.getBankOverview(userId));
         this.getBankCredits = this._wrapWithUser((userId) => this.service.getBankCredits(userId));
-        this.takeBankCredits = this._wrapWithUser((userId, req) => this.service.takeBankCredits(userId, req.body.height));
+        this.takeBankCredits = this._wrapWithUser((userId, req) => this.service.takeBankCredits(userId, req.body.height), { blockInDebtorsPrison: true });
 
         this.getNobility = this._wrapWithUser((userId) => this.service.getNobility(userId));
-        this.advanceNobility = this._wrapWithUser((userId) => this.service.advanceNobility(userId));
+        this.advanceNobility = this._wrapWithUser((userId) => this.service.advanceNobility(userId), { blockInDebtorsPrison: true });
 
         this.getHealth = this._wrapWithUser((userId) => this.service.getHealth(userId));
         this.healthActivity = this._wrapWithUser(async (userId, req) => {
@@ -204,13 +204,13 @@ class FalukantController {
                 }
                 throw e;
             }
-        });
+        }, { blockInDebtorsPrison: true });
 
         this.getPoliticsOverview = this._wrapWithUser((userId) => this.service.getPoliticsOverview(userId));
         this.getOpenPolitics = this._wrapWithUser((userId) => this.service.getOpenPolitics(userId));
         this.getElections = this._wrapWithUser((userId) => this.service.getElections(userId));
-        this.vote = this._wrapWithUser((userId, req) => this.service.vote(userId, req.body.votes));
-        this.applyForElections = this._wrapWithUser((userId, req) => this.service.applyForElections(userId, req.body.electionIds));
+        this.vote = this._wrapWithUser((userId, req) => this.service.vote(userId, req.body.votes), { blockInDebtorsPrison: true });
+        this.applyForElections = this._wrapWithUser((userId, req) => this.service.applyForElections(userId, req.body.electionIds), { blockInDebtorsPrison: true });
 
         this.getRegions = this._wrapWithUser((userId) => this.service.getRegions(userId));
     this.getBranchTaxes = this._wrapWithUser((userId, req) => this.service.getBranchTaxes(userId, req.params.branchId));
@@ -248,8 +248,8 @@ class FalukantController {
             })).filter(i => !Number.isNaN(i.productId) && !Number.isNaN(i.currentPrice));
             return this.service.getProductPricesInCitiesBatch(userId, valid, Number.isNaN(currentRegionId) ? null : currentRegionId);
         });
-        this.renovate = this._wrapWithUser((userId, req) => this.service.renovate(userId, req.body.element));
-        this.renovateAll = this._wrapWithUser((userId) => this.service.renovateAll(userId));
+        this.renovate = this._wrapWithUser((userId, req) => this.service.renovate(userId, req.body.element), { blockInDebtorsPrison: true });
+        this.renovateAll = this._wrapWithUser((userId) => this.service.renovateAll(userId), { blockInDebtorsPrison: true });
 
         this.getUndergroundTypes = this._wrapWithUser((userId) => this.service.getUndergroundTypes(userId));
         this.getUndergroundActivities = this._wrapWithUser((userId) => this.service.getUndergroundActivities(userId));
@@ -277,7 +277,7 @@ class FalukantController {
                 throw { status: 400, message: 'goal is required for corrupt_politician' };
             }
             return this.service.createUndergroundActivity(userId, payload);
-        }, { successStatus: 201 });
+        }, { successStatus: 201, blockInDebtorsPrison: true });
 
         this.getUndergroundAttacks = this._wrapWithUser((userId, req) => {
             const direction = (req.query.direction || '').toLowerCase();
@@ -291,14 +291,14 @@ class FalukantController {
         this.getVehicleTypes = this._wrapWithUser((userId) => this.service.getVehicleTypes(userId));
         this.buyVehicles = this._wrapWithUser(
             (userId, req) => this.service.buyVehicles(userId, req.body),
-            { successStatus: 201 }
+            { successStatus: 201, blockInDebtorsPrison: true }
         );
         this.getVehicles = this._wrapWithUser(
             (userId, req) => this.service.getVehicles(userId, req.query.regionId)
         );
         this.createTransport = this._wrapWithUser(
             (userId, req) => this.service.createTransport(userId, req.body),
-            { successStatus: 201 }
+            { successStatus: 201, blockInDebtorsPrison: true }
         );
         this.getTransportRoute = this._wrapWithUser(
             (userId, req) => this.service.getTransportRoute(userId, req.query)
@@ -308,23 +308,26 @@ class FalukantController {
         );
         this.repairVehicle = this._wrapWithUser(
             (userId, req) => this.service.repairVehicle(userId, req.params.vehicleId),
-            { successStatus: 200 }
+            { successStatus: 200, blockInDebtorsPrison: true }
         );
         this.repairAllVehicles = this._wrapWithUser(
             (userId, req) => this.service.repairAllVehicles(userId, req.body.vehicleIds),
-            { successStatus: 200 }
+            { successStatus: 200, blockInDebtorsPrison: true }
         );
 
     }
 
 
-    _wrapWithUser(fn, { successStatus = 200, postProcess } = {}) {
+    _wrapWithUser(fn, { successStatus = 200, postProcess, blockInDebtorsPrison = false } = {}) {
         return async (req, res) => {
             try {
                 const hashedUserId = extractHashedUserId(req);
                 if (!hashedUserId) {
                     return res.status(400).json({ error: 'Missing user identifier' });
                 }
+                if (blockInDebtorsPrison) {
+                    await this.service.assertActionAllowedOutsideDebtorsPrison(hashedUserId);
+                }
                 const result = await fn(hashedUserId, req, res);
                 const toSend = postProcess ? postProcess(result) : result;
                 res.status(successStatus).json(toSend);

backend/migrations/20260323010000-expand-debtors-prism.cjs

@@ -0,0 +1,83 @@
+'use strict';
+
+/** @type {import('sequelize-cli').Migration} */
+module.exports = {
+  async up(queryInterface, Sequelize) {
+    const table = { schema: 'falukant_data', tableName: 'debtors_prism' };
+
+    await queryInterface.addColumn(table, 'status', {
+      type: Sequelize.STRING,
+      allowNull: false,
+      defaultValue: 'delinquent'
+    });
+
+    await queryInterface.addColumn(table, 'entered_at', {
+      type: Sequelize.DATE,
+      allowNull: true
+    });
+
+    await queryInterface.addColumn(table, 'released_at', {
+      type: Sequelize.DATE,
+      allowNull: true
+    });
+
+    await queryInterface.addColumn(table, 'debt_at_entry', {
+      type: Sequelize.DECIMAL(14, 2),
+      allowNull: true
+    });
+
+    await queryInterface.addColumn(table, 'remaining_debt', {
+      type: Sequelize.DECIMAL(14, 2),
+      allowNull: true
+    });
+
+    await queryInterface.addColumn(table, 'days_overdue', {
+      type: Sequelize.INTEGER,
+      allowNull: false,
+      defaultValue: 0
+    });
+
+    await queryInterface.addColumn(table, 'reason', {
+      type: Sequelize.STRING,
+      allowNull: true
+    });
+
+    await queryInterface.addColumn(table, 'creditworthiness_penalty', {
+      type: Sequelize.INTEGER,
+      allowNull: false,
+      defaultValue: 0
+    });
+
+    await queryInterface.addColumn(table, 'next_forced_action', {
+      type: Sequelize.STRING,
+      allowNull: true
+    });
+
+    await queryInterface.addColumn(table, 'assets_seized_json', {
+      type: Sequelize.JSONB,
+      allowNull: true
+    });
+
+    await queryInterface.addColumn(table, 'public_known', {
+      type: Sequelize.BOOLEAN,
+      allowNull: false,
+      defaultValue: false
+    });
+  },
+
+  async down(queryInterface) {
+    const table = { schema: 'falukant_data', tableName: 'debtors_prism' };
+
+    await queryInterface.removeColumn(table, 'public_known');
+    await queryInterface.removeColumn(table, 'assets_seized_json');
+    await queryInterface.removeColumn(table, 'next_forced_action');
+    await queryInterface.removeColumn(table, 'creditworthiness_penalty');
+    await queryInterface.removeColumn(table, 'reason');
+    await queryInterface.removeColumn(table, 'days_overdue');
+    await queryInterface.removeColumn(table, 'remaining_debt');
+    await queryInterface.removeColumn(table, 'debt_at_entry');
+    await queryInterface.removeColumn(table, 'released_at');
+    await queryInterface.removeColumn(table, 'entered_at');
+    await queryInterface.removeColumn(table, 'status');
+  }
+};

backend/models/falukant/data/debtors_prism.js

@@ -7,7 +7,57 @@ DebtorsPrism.init({
   // Verknüpfung auf FalukantCharacter
   characterId: {
     type: DataTypes.INTEGER,
-    allowNull: false}}, {
+    allowNull: false
+  },
+  status: {
+    type: DataTypes.STRING,
+    allowNull: false,
+    defaultValue: 'delinquent'
+  },
+  enteredAt: {
+    type: DataTypes.DATE,
+    allowNull: true
+  },
+  releasedAt: {
+    type: DataTypes.DATE,
+    allowNull: true
+  },
+  debtAtEntry: {
+    type: DataTypes.DECIMAL(14, 2),
+    allowNull: true
+  },
+  remainingDebt: {
+    type: DataTypes.DECIMAL(14, 2),
+    allowNull: true
+  },
+  daysOverdue: {
+    type: DataTypes.INTEGER,
+    allowNull: false,
+    defaultValue: 0
+  },
+  reason: {
+    type: DataTypes.STRING,
+    allowNull: true
+  },
+  creditworthinessPenalty: {
+    type: DataTypes.INTEGER,
+    allowNull: false,
+    defaultValue: 0
+  },
+  nextForcedAction: {
+    type: DataTypes.STRING,
+    allowNull: true
+  },
+  assetsSeizedJson: {
+    type: DataTypes.JSONB,
+    allowNull: true
+  },
+  publicKnown: {
+    type: DataTypes.BOOLEAN,
+    allowNull: false,
+    defaultValue: false
+  }
+}, {
   sequelize,
   modelName: 'DebtorsPrism',
   tableName: 'debtors_prism',

backend/services/falukantService.js

@@ -48,6 +48,7 @@ import ChildRelation from '../models/falukant/data/child_relation.js';
 import Learning from '../models/falukant/data/learning.js';
 import LearnRecipient from '../models/falukant/type/learn_recipient.js';
 import Credit from '../models/falukant/data/credit.js';
+import DebtorsPrism from '../models/falukant/data/debtors_prism.js';
 import TitleRequirement from '../models/falukant/type/title_requirement.js';
 import HealthActivity from '../models/falukant/log/health_activity.js';
 import Election from '../models/falukant/data/election.js';
@@ -808,6 +809,7 @@ class FalukantService extends BaseService {
             }
             if (userHouse) user.setDataValue('userHouse', userHouse);
         }
+        user.setDataValue('debtorsPrison', await this.getDebtorsPrisonStateForUser(user));
         return user;
     }
 
@@ -865,6 +867,7 @@ class FalukantService extends BaseService {
         }
         if (userHouse) u.setDataValue('userHouse', userHouse);
         if (u.character?.birthdate) u.character.setDataValue('age', calcAge(u.character.birthdate));
+        u.setDataValue('debtorsPrison', await this.getDebtorsPrisonStateForUser(u));
         return u;
     }
 
@@ -1026,6 +1029,8 @@ class FalukantService extends BaseService {
             falukantUser.setDataValue('unreadNotifications', 0);
         }
 
+        falukantUser.setDataValue('debtorsPrison', await this.getDebtorsPrisonStateForUser(falukantUser));
+
         return falukantUser;
     }
 
@@ -3278,6 +3283,7 @@ class FalukantService extends BaseService {
             householdTension: householdTension.label,
             householdTensionScore: householdTension.score,
             householdTensionReasons: householdTension.reasons,
+            debtorsPrison: await this.getDebtorsPrisonStateForUser(user),
             lovers,
             deathPartners: relationships.filter(r => r.relationshipType === 'widowed'),
             children: children.map(({ _createdAt, ...rest }) => rest),
@@ -4385,6 +4391,7 @@ class FalukantService extends BaseService {
 
             const plainHouse = userHouse.get({ plain: true });
             plainHouse.servantSummary = this.buildServantSummary(plainHouse, falukantUser.character);
+            plainHouse.debtorsPrison = await this.getDebtorsPrisonStateForUser(falukantUser);
             return plainHouse;
         } catch (error) {
             console.log(error);
@@ -5121,6 +5128,115 @@ class FalukantService extends BaseService {
         return true;
     }
 
+    deriveDebtNextForcedAction(status, daysOverdue) {
+        if (status === 'imprisoned') return 'asset_seizure';
+        if (daysOverdue >= 3) return 'debtors_prison';
+        if (daysOverdue === 2) return 'final_warning';
+        if (daysOverdue === 1) return 'reminder';
+        return null;
+    }
+
+    calculateCreditworthinessFromDebtState(record) {
+        if (!record) return 100;
+
+        const penalty = Number(record.creditworthinessPenalty || 0);
+        const daysOverdue = Number(record.daysOverdue || 0);
+
+        if (record.status === 'imprisoned') {
+            return Math.max(0, 20 - penalty);
+        }
+        if (record.status === 'delinquent') {
+            return Math.max(15, 100 - (daysOverdue * 20) - penalty);
+        }
+        return Math.max(0, 80 - penalty);
+    }
+
+    serializeDebtorsPrisonRecord(record, totalDebt = 0) {
+        if (!record) {
+            return {
+                active: false,
+                inDebtorsPrison: false,
+                status: null,
+                daysOverdue: 0,
+                debtAtEntry: null,
+                remainingDebt: Number(totalDebt || 0),
+                reason: null,
+                creditworthinessPenalty: 0,
+                creditworthiness: 100,
+                nextForcedAction: null,
+                publicKnown: false,
+                enteredAt: null,
+                releasedAt: null,
+                assetsSeized: null
+            };
+        }
+
+        const remainingDebt = Number(record.remainingDebt ?? totalDebt ?? 0);
+        const debtState = {
+            active: record.status !== 'released' && !record.releasedAt,
+            inDebtorsPrison: record.status === 'imprisoned' && !record.releasedAt,
+            status: record.status || null,
+            daysOverdue: Number(record.daysOverdue || 0),
+            debtAtEntry: record.debtAtEntry != null ? Number(record.debtAtEntry) : null,
+            remainingDebt,
+            reason: record.reason || null,
+            creditworthinessPenalty: Number(record.creditworthinessPenalty || 0),
+            nextForcedAction: record.nextForcedAction || this.deriveDebtNextForcedAction(record.status, Number(record.daysOverdue || 0)),
+            publicKnown: !!record.publicKnown,
+            enteredAt: record.enteredAt || null,
+            releasedAt: record.releasedAt || null,
+            assetsSeized: record.assetsSeizedJson || null
+        };
+        debtState.creditworthiness = this.calculateCreditworthinessFromDebtState(debtState);
+        return debtState;
+    }
+
+    async getDebtorsPrisonStateForUser(falukantUser) {
+        if (!falukantUser?.id) {
+            return this.serializeDebtorsPrisonRecord(null);
+        }
+
+        const character = falukantUser.character || await FalukantCharacter.findOne({
+            where: { userId: falukantUser.id },
+            attributes: ['id']
+        });
+
+        if (!character?.id) {
+            return this.serializeDebtorsPrisonRecord(null);
+        }
+
+        const records = await DebtorsPrism.findAll({
+            where: { characterId: character.id },
+            order: [['createdAt', 'DESC']]
+        });
+
+        const activeRecord = records.find((record) => record.status !== 'released' && !record.releasedAt)
+            || records[0]
+            || null;
+
+        const totalDebt = await Credit.sum('remaining_amount', {
+            where: { falukant_user_id: falukantUser.id }
+        }) || 0;
+
+        return this.serializeDebtorsPrisonRecord(activeRecord, totalDebt);
+    }
+
+    async assertActionAllowedOutsideDebtorsPrison(hashedUserId) {
+        const falukantUser = await getFalukantUserOrFail(hashedUserId);
+        const debtorsPrison = await this.getDebtorsPrisonStateForUser(falukantUser);
+
+        if (debtorsPrison.inDebtorsPrison) {
+            throw {
+                status: 423,
+                message: 'Aktion im Schuldturm gesperrt',
+                code: 'falukant.debtorsPrison.actionBlocked',
+                debtorsPrison
+            };
+        }
+
+        return { falukantUser, debtorsPrison };
+    }
+
     async getBankOverview(hashedUserId) {
         const falukantUser = await getFalukantUserOrFail(hashedUserId);
         if (!falukantUser) throw new Error('User not found');
@@ -5149,9 +5265,14 @@ class FalukantService extends BaseService {
         const branchCount = await Branch.count({ where: { falukantUserId: falukantUser.id } });
         const branchValue = branchCount * 1000;
 
+        const debtorsPrison = await this.getDebtorsPrisonStateForUser(falukantUser);
+
         // 5) Maximaler Kredit und verfügbare Linie
         const maxCredit = Math.floor(houseValue + branchValue);
-        const availableCredit = maxCredit - totalDebt;
+        const availableCreditRaw = maxCredit - totalDebt;
+        const availableCredit = debtorsPrison.inDebtorsPrison
+            ? 0
+            : Math.max(0, availableCreditRaw);
 
         // 6) aktive Kredite laden
         const activeCredits = await Credit.findAll({
@@ -5165,7 +5286,12 @@ class FalukantService extends BaseService {
             maxCredit,
             availableCredit,
             activeCredits,
-            fee: 7
+            fee: 7,
+            inDebtorsPrison: debtorsPrison.inDebtorsPrison,
+            daysOverdue: debtorsPrison.daysOverdue,
+            nextForcedAction: debtorsPrison.nextForcedAction,
+            creditworthiness: debtorsPrison.creditworthiness,
+            debtorsPrison
         };
     }
 
@@ -5182,6 +5308,9 @@ class FalukantService extends BaseService {
         const falukantUser = await getFalukantUserOrFail(hashedUserId);
         if (!falukantUser) throw new Error('User not found');
         const financialData = await this.getBankOverview(hashedUserId);
+        if (financialData.inDebtorsPrison) {
+            throw new Error('debtorPrisonBlocksCredit');
+        }
         if (financialData.availableCredit < height) {
             throw new Error('Not enough credit');
         }
@@ -6454,7 +6583,7 @@ ORDER BY r.id`,
         const characterName = titleLabelTr ? [titleLabelTr, firstName, lastName].filter(Boolean).join(' ') : nameWithoutTitle;
         const age = character.birthdate ? calcAge(character.birthdate) : null;
 
-        const [unreadNotificationsCount, childrenCount] = await Promise.all([
+        const [unreadNotificationsCount, childrenCount, debtorsPrison] = await Promise.all([
             Notification.count({ where: { userId: falukantUser.id, shown: false } }),
             ChildRelation.count({
                 where: {
@@ -6463,7 +6592,8 @@ ORDER BY r.id`,
                         { motherCharacterId: character.id }
                     ]
                 }
-            })
+            }),
+            this.getDebtorsPrisonStateForUser(falukantUser)
         ]);
 
         return {
@@ -6474,7 +6604,8 @@ ORDER BY r.id`,
             age,
             money: Number(falukantUser.money ?? 0),
             unreadNotificationsCount,
-            childrenCount
+            childrenCount,
+            debtorsPrison
         };
     }
 

backend/sql/expand_debtors_prism.sql

@@ -0,0 +1,32 @@
+ALTER TABLE falukant_data.debtors_prism
+ADD COLUMN IF NOT EXISTS status varchar(255) NOT NULL DEFAULT 'delinquent';
+
+ALTER TABLE falukant_data.debtors_prism
+ADD COLUMN IF NOT EXISTS entered_at timestamp with time zone NULL;
+
+ALTER TABLE falukant_data.debtors_prism
+ADD COLUMN IF NOT EXISTS released_at timestamp with time zone NULL;
+
+ALTER TABLE falukant_data.debtors_prism
+ADD COLUMN IF NOT EXISTS debt_at_entry numeric(14,2) NULL;
+
+ALTER TABLE falukant_data.debtors_prism
+ADD COLUMN IF NOT EXISTS remaining_debt numeric(14,2) NULL;
+
+ALTER TABLE falukant_data.debtors_prism
+ADD COLUMN IF NOT EXISTS days_overdue integer NOT NULL DEFAULT 0;
+
+ALTER TABLE falukant_data.debtors_prism
+ADD COLUMN IF NOT EXISTS reason varchar(255) NULL;
+
+ALTER TABLE falukant_data.debtors_prism
+ADD COLUMN IF NOT EXISTS creditworthiness_penalty integer NOT NULL DEFAULT 0;
+
+ALTER TABLE falukant_data.debtors_prism
+ADD COLUMN IF NOT EXISTS next_forced_action varchar(255) NULL;
+
+ALTER TABLE falukant_data.debtors_prism
+ADD COLUMN IF NOT EXISTS assets_seized_json jsonb NULL;
+
+ALTER TABLE falukant_data.debtors_prism
+ADD COLUMN IF NOT EXISTS public_known boolean NOT NULL DEFAULT false;