feat(member): add away billing policies

2026-03-31 10:24:02 +00:00 · 2026-03-11 14:05:52 +04:00
parent 773abf2531
commit 98988159eb
34 changed files with 4218 additions and 39 deletions
--- a/apps/bot/src/anonymous-feedback.test.ts
+++ b/apps/bot/src/anonymous-feedback.test.ts
@@ -253,7 +253,9 @@ function createHouseholdConfigurationRepository(): HouseholdConfigurationReposit
    }),
    promoteHouseholdAdmin: async () => null,
    updateHouseholdMemberRentShareWeight: async () => null,
-    updateHouseholdMemberStatus: async () => null
+    updateHouseholdMemberStatus: async () => null,
+    listHouseholdMemberAbsencePolicies: async () => [],
+    upsertHouseholdMemberAbsencePolicy: async () => null
  }
 }

--- a/apps/bot/src/bot-i18n.test.ts
+++ b/apps/bot/src/bot-i18n.test.ts
@@ -133,7 +133,9 @@ function createRepository(isAdmin = false): HouseholdConfigurationRepository {
    updateMemberPreferredLocale: async () => null,
    promoteHouseholdAdmin: async () => null,
    updateHouseholdMemberRentShareWeight: async () => null,
-    updateHouseholdMemberStatus: async () => null
+    updateHouseholdMemberStatus: async () => null,
+    listHouseholdMemberAbsencePolicies: async () => [],
+    upsertHouseholdMemberAbsencePolicy: async () => null
  }
 }

--- a/apps/bot/src/dm-assistant.test.ts
+++ b/apps/bot/src/dm-assistant.test.ts
@@ -194,7 +194,9 @@ function createHouseholdRepository(): HouseholdConfigurationRepository {
    updateMemberPreferredLocale: async () => null,
    promoteHouseholdAdmin: async () => null,
    updateHouseholdMemberRentShareWeight: async () => null,
-    updateHouseholdMemberStatus: async () => null
+    updateHouseholdMemberStatus: async () => null,
+    listHouseholdMemberAbsencePolicies: async () => [],
+    upsertHouseholdMemberAbsencePolicy: async () => null
  }
 }

--- a/apps/bot/src/finance-commands.test.ts
+++ b/apps/bot/src/finance-commands.test.ts
@@ -111,7 +111,9 @@ function createRepository(): HouseholdConfigurationRepository {
    updateMemberPreferredLocale: async () => null,
    promoteHouseholdAdmin: async () => null,
    updateHouseholdMemberRentShareWeight: async () => null,
-    updateHouseholdMemberStatus: async () => null
+    updateHouseholdMemberStatus: async () => null,
+    listHouseholdMemberAbsencePolicies: async () => [],
+    upsertHouseholdMemberAbsencePolicy: async () => null
  }
 }

--- a/apps/bot/src/household-setup.test.ts
+++ b/apps/bot/src/household-setup.test.ts
@@ -497,6 +497,12 @@ function createHouseholdConfigurationRepository(): HouseholdConfigurationReposit
    },
    async updateHouseholdMemberStatus() {
      return null
+    },
+    async listHouseholdMemberAbsencePolicies() {
+      return []
+    },
+    async upsertHouseholdMemberAbsencePolicy() {
+      return null
    }
  }
 }
--- a/apps/bot/src/index.ts
+++ b/apps/bot/src/index.ts
@@ -49,6 +49,7 @@ import {
  createMiniAppPendingMembersHandler,
  createMiniAppPromoteMemberHandler,
  createMiniAppSettingsHandler,
+  createMiniAppUpdateMemberAbsencePolicyHandler,
  createMiniAppUpdateMemberStatusHandler,
  createMiniAppUpdateMemberRentWeightHandler,
  createMiniAppUpdateSettingsHandler,
@@ -546,6 +547,15 @@ const server = createBotWebhookServer({
        logger: getLogger('miniapp-admin')
      })
    : undefined,
+  miniAppUpdateMemberAbsencePolicy: householdOnboardingService
+    ? createMiniAppUpdateMemberAbsencePolicyHandler({
+        allowedOrigins: runtime.miniAppAllowedOrigins,
+        botToken: runtime.telegramBotToken,
+        onboardingService: householdOnboardingService,
+        miniAppAdminService: miniAppAdminService!,
+        logger: getLogger('miniapp-admin')
+      })
+    : undefined,
  miniAppBillingCycle: householdOnboardingService
    ? createMiniAppBillingCycleHandler({
        allowedOrigins: runtime.miniAppAllowedOrigins,
--- a/apps/bot/src/miniapp-admin.test.ts
+++ b/apps/bot/src/miniapp-admin.test.ts
@@ -11,6 +11,7 @@ import {
  createMiniAppPendingMembersHandler,
  createMiniAppPromoteMemberHandler,
  createMiniAppSettingsHandler,
+  createMiniAppUpdateMemberAbsencePolicyHandler,
  createMiniAppUpdateMemberStatusHandler,
  createMiniAppUpdateSettingsHandler
 } from './miniapp-admin'
@@ -25,6 +26,12 @@ function onboardingRepository(): HouseholdConfigurationRepository {
    title: 'Kojori House',
    defaultLocale: 'ru' as const
  }
+  let memberAbsencePolicies: {
+    householdId: string
+    memberId: string
+    effectiveFromPeriod: string
+    policy: 'resident' | 'away_rent_and_utilities' | 'away_rent_only' | 'inactive'
+  }[] = []

  return {
    registerTelegramHouseholdChat: async () => ({
@@ -83,7 +90,19 @@ function onboardingRepository(): HouseholdConfigurationRepository {
      isAdmin: input.isAdmin === true
    }),
    getHouseholdMember: async () => null,
-    listHouseholdMembers: async () => [],
+    listHouseholdMembers: async () => [
+      {
+        id: 'member-123456',
+        householdId: household.householdId,
+        telegramUserId: '123456',
+        displayName: 'Stan',
+        status: 'active',
+        preferredLocale: null,
+        householdDefaultLocale: household.defaultLocale,
+        rentShareWeight: 1,
+        isAdmin: true
+      }
+    ],
    listHouseholdMembersByTelegramUserId: async () => [],
    listPendingHouseholdMembers: async () => [
      {
@@ -208,7 +227,28 @@ function onboardingRepository(): HouseholdConfigurationRepository {
            rentShareWeight: 1,
            isAdmin: false
          }
-        : null
+        : null,
+    listHouseholdMemberAbsencePolicies: async () => memberAbsencePolicies,
+    upsertHouseholdMemberAbsencePolicy: async (input) => {
+      const next = {
+        householdId: input.householdId,
+        memberId: input.memberId,
+        effectiveFromPeriod: input.effectiveFromPeriod,
+        policy: input.policy
+      }
+      memberAbsencePolicies = [
+        ...memberAbsencePolicies.filter(
+          (entry) =>
+            !(
+              entry.householdId === input.householdId &&
+              entry.memberId === input.memberId &&
+              entry.effectiveFromPeriod === input.effectiveFromPeriod
+            )
+        ),
+        next
+      ]
+      return next
+    }
  }
 }

@@ -423,6 +463,7 @@ describe('createMiniAppSettingsHandler', () => {
        }
      ],
      categories: [],
+      memberAbsencePolicies: [],
      assistantUsage: [],
      members: [
        {
@@ -641,4 +682,63 @@ describe('createMiniAppUpdateMemberStatusHandler', () => {
      }
    })
  })
+
+  test('updates a household member absence policy for an authenticated admin', async () => {
+    const authDate = Math.floor(Date.now() / 1000)
+    const repository = onboardingRepository()
+    repository.listHouseholdMembersByTelegramUserId = async () => [
+      {
+        id: 'member-123456',
+        householdId: 'household-1',
+        telegramUserId: '123456',
+        displayName: 'Stan',
+        status: 'active',
+        preferredLocale: null,
+        householdDefaultLocale: 'ru',
+        rentShareWeight: 1,
+        isAdmin: true
+      }
+    ]
+
+    const handler = createMiniAppUpdateMemberAbsencePolicyHandler({
+      allowedOrigins: ['http://localhost:5173'],
+      botToken: 'test-bot-token',
+      onboardingService: createHouseholdOnboardingService({
+        repository
+      }),
+      miniAppAdminService: createMiniAppAdminService(repository)
+    })
+
+    const response = await handler.handler(
+      new Request('http://localhost/api/miniapp/admin/members/absence-policy', {
+        method: 'POST',
+        headers: {
+          origin: 'http://localhost:5173',
+          'content-type': 'application/json'
+        },
+        body: JSON.stringify({
+          initData: buildMiniAppInitData('test-bot-token', authDate, {
+            id: 123456,
+            first_name: 'Stan',
+            username: 'stanislav',
+            language_code: 'ru'
+          }),
+          memberId: 'member-123456',
+          policy: 'away_rent_only'
+        })
+      })
+    )
+
+    expect(response.status).toBe(200)
+    expect(await response.json()).toEqual({
+      ok: true,
+      authorized: true,
+      policy: {
+        householdId: 'household-1',
+        memberId: 'member-123456',
+        effectiveFromPeriod: '2026-03',
+        policy: 'away_rent_only'
+      }
+    })
+  })
 })
--- a/apps/bot/src/miniapp-admin.ts
+++ b/apps/bot/src/miniapp-admin.ts
@@ -1,8 +1,10 @@
 import type { HouseholdOnboardingService, MiniAppAdminService } from '@household/application'
 import type { Logger } from '@household/observability'
 import {
+  HOUSEHOLD_MEMBER_ABSENCE_POLICIES,
  HOUSEHOLD_MEMBER_LIFECYCLE_STATUSES,
  type HouseholdBillingSettingsRecord,
+  type HouseholdMemberAbsencePolicy,
  type HouseholdMemberLifecycleStatus
 } from '@household/ports'
 import type { MiniAppSessionResult } from './miniapp-auth'
@@ -257,6 +259,42 @@ async function readMemberStatusPayload(request: Request): Promise<{
  }
 }

+async function readMemberAbsencePolicyPayload(request: Request): Promise<{
+  initData: string
+  memberId: string
+  policy: HouseholdMemberAbsencePolicy
+}> {
+  const clonedRequest = request.clone()
+  const payload = await readMiniAppRequestPayload(request)
+  if (!payload.initData) {
+    throw new Error('Missing initData')
+  }
+
+  const text = await clonedRequest.text()
+  let parsed: { memberId?: string; policy?: string }
+  try {
+    parsed = JSON.parse(text)
+  } catch {
+    throw new Error('Invalid JSON body')
+  }
+
+  const memberId = parsed.memberId?.trim()
+  const policy = parsed.policy?.trim().toLowerCase()
+  if (!memberId || !policy) {
+    throw new Error('Missing member absence policy fields')
+  }
+
+  if (!(HOUSEHOLD_MEMBER_ABSENCE_POLICIES as readonly string[]).includes(policy)) {
+    throw new Error('Invalid member absence policy')
+  }
+
+  return {
+    initData: payload.initData,
+    memberId,
+    policy: policy as HouseholdMemberAbsencePolicy
+  }
+}
+
 function serializeBillingSettings(settings: HouseholdBillingSettingsRecord) {
  return {
    householdId: settings.householdId,
@@ -442,6 +480,7 @@ export function createMiniAppSettingsHandler(options: {
            topics: result.topics,
            categories: result.categories,
            members: result.members,
+            memberAbsencePolicies: result.memberAbsencePolicies,
            assistantUsage:
              options.assistantUsageTracker?.listHouseholdUsage(member.householdId) ?? []
          },
@@ -923,6 +962,87 @@ export function createMiniAppUpdateMemberStatusHandler(options: {
  }
 }

+export function createMiniAppUpdateMemberAbsencePolicyHandler(options: {
+  allowedOrigins: readonly string[]
+  botToken: string
+  onboardingService: HouseholdOnboardingService
+  miniAppAdminService: MiniAppAdminService
+  logger?: Logger
+}): {
+  handler: (request: Request) => Promise<Response>
+} {
+  const sessionService = createMiniAppSessionService({
+    botToken: options.botToken,
+    onboardingService: options.onboardingService
+  })
+
+  return {
+    handler: async (request) => {
+      const origin = allowedMiniAppOrigin(request, options.allowedOrigins)
+
+      if (request.method === 'OPTIONS') {
+        return miniAppJsonResponse({ ok: true }, 204, origin)
+      }
+
+      if (request.method !== 'POST') {
+        return miniAppJsonResponse({ ok: false, error: 'Method Not Allowed' }, 405, origin)
+      }
+
+      try {
+        const payload = await readMemberAbsencePolicyPayload(request)
+        const session = await sessionService.authenticate({
+          initData: payload.initData
+        })
+
+        if (
+          !session ||
+          !session.authorized ||
+          !session.member ||
+          session.member.status !== 'active' ||
+          !session.member.isAdmin
+        ) {
+          return miniAppJsonResponse(
+            { ok: false, error: 'Admin access required for active household members' },
+            session ? 403 : 401,
+            origin
+          )
+        }
+
+        const result = await options.miniAppAdminService.updateMemberAbsencePolicy({
+          householdId: session.member.householdId,
+          actorIsAdmin: session.member.isAdmin,
+          memberId: payload.memberId,
+          policy: payload.policy
+        })
+
+        if (result.status === 'rejected') {
+          return miniAppJsonResponse(
+            {
+              ok: false,
+              error:
+                result.reason === 'member_not_found' ? 'Member not found' : 'Admin access required'
+            },
+            result.reason === 'member_not_found' ? 404 : 403,
+            origin
+          )
+        }
+
+        return miniAppJsonResponse(
+          {
+            ok: true,
+            authorized: true,
+            policy: result.policy
+          },
+          200,
+          origin
+        )
+      } catch (error) {
+        return miniAppErrorResponse(error, origin, options.logger)
+      }
+    }
+  }
+}
+
 export function createMiniAppApproveMemberHandler(options: {
  allowedOrigins: readonly string[]
  botToken: string
--- a/apps/bot/src/miniapp-auth.test.ts
+++ b/apps/bot/src/miniapp-auth.test.ts
@@ -154,6 +154,8 @@ function onboardingRepository(): HouseholdConfigurationRepository {
          }
        : null
    },
+    listHouseholdMemberAbsencePolicies: async () => [],
+    upsertHouseholdMemberAbsencePolicy: async () => null,
    getHouseholdBillingSettings: async (householdId) => ({
      householdId,
      settlementCurrency: 'GEL',
--- a/apps/bot/src/miniapp-billing.test.ts
+++ b/apps/bot/src/miniapp-billing.test.ts
@@ -132,7 +132,9 @@ function onboardingRepository(): HouseholdConfigurationRepository {
    updateMemberPreferredLocale: async () => null,
    promoteHouseholdAdmin: async () => null,
    updateHouseholdMemberRentShareWeight: async () => null,
-    updateHouseholdMemberStatus: async () => null
+    updateHouseholdMemberStatus: async () => null,
+    listHouseholdMemberAbsencePolicies: async () => [],
+    upsertHouseholdMemberAbsencePolicy: async () => null
  }
 }

--- a/apps/bot/src/miniapp-dashboard.test.ts
+++ b/apps/bot/src/miniapp-dashboard.test.ts
@@ -185,7 +185,19 @@ function onboardingRepository(): HouseholdConfigurationRepository {
      isAdmin: input.isAdmin === true
    }),
    getHouseholdMember: async () => null,
-    listHouseholdMembers: async () => [],
+    listHouseholdMembers: async () => [
+      {
+        id: 'member-1',
+        householdId: household.householdId,
+        telegramUserId: '123456',
+        displayName: 'Stan',
+        status: 'active',
+        preferredLocale: null,
+        householdDefaultLocale: household.defaultLocale,
+        rentShareWeight: 1,
+        isAdmin: true
+      }
+    ],
    listHouseholdMembersByTelegramUserId: async () => [],
    listPendingHouseholdMembers: async () => [],
    approvePendingHouseholdMember: async () => null,
@@ -227,7 +239,9 @@ function onboardingRepository(): HouseholdConfigurationRepository {
    }),
    promoteHouseholdAdmin: async () => null,
    updateHouseholdMemberRentShareWeight: async () => null,
-    updateHouseholdMemberStatus: async () => null
+    updateHouseholdMemberStatus: async () => null,
+    listHouseholdMemberAbsencePolicies: async () => [],
+    upsertHouseholdMemberAbsencePolicy: async () => null
  }
 }

--- a/apps/bot/src/miniapp-locale.test.ts
+++ b/apps/bot/src/miniapp-locale.test.ts
@@ -165,7 +165,9 @@ function repository(): HouseholdConfigurationRepository {
    }),
    promoteHouseholdAdmin: async () => null,
    updateHouseholdMemberRentShareWeight: async () => null,
-    updateHouseholdMemberStatus: async () => null
+    updateHouseholdMemberStatus: async () => null,
+    listHouseholdMemberAbsencePolicies: async () => [],
+    upsertHouseholdMemberAbsencePolicy: async () => null
  }
 }

--- a/apps/bot/src/server.ts
+++ b/apps/bot/src/server.ts
@@ -68,6 +68,12 @@ export interface BotWebhookServerOptions {
        handler: (request: Request) => Promise<Response>
      }
    | undefined
+  miniAppUpdateMemberAbsencePolicy?:
+    | {
+        path?: string
+        handler: (request: Request) => Promise<Response>
+      }
+    | undefined
  miniAppBillingCycle?:
    | {
        path?: string
@@ -194,6 +200,8 @@ export function createBotWebhookServer(options: BotWebhookServerOptions): {
    options.miniAppUpdateMemberRentWeight?.path ?? '/api/miniapp/admin/members/rent-weight'
  const miniAppUpdateMemberStatusPath =
    options.miniAppUpdateMemberStatus?.path ?? '/api/miniapp/admin/members/status'
+  const miniAppUpdateMemberAbsencePolicyPath =
+    options.miniAppUpdateMemberAbsencePolicy?.path ?? '/api/miniapp/admin/members/absence-policy'
  const miniAppBillingCyclePath =
    options.miniAppBillingCycle?.path ?? '/api/miniapp/admin/billing-cycle'
  const miniAppOpenCyclePath =
@@ -280,6 +288,13 @@ export function createBotWebhookServer(options: BotWebhookServerOptions): {
        return await options.miniAppUpdateMemberStatus.handler(request)
      }

+      if (
+        options.miniAppUpdateMemberAbsencePolicy &&
+        url.pathname === miniAppUpdateMemberAbsencePolicyPath
+      ) {
+        return await options.miniAppUpdateMemberAbsencePolicy.handler(request)
+      }
+
      if (options.miniAppBillingCycle && url.pathname === miniAppBillingCyclePath) {
        return await options.miniAppBillingCycle.handler(request)
      }
--- a/apps/miniapp/src/App.tsx
+++ b/apps/miniapp/src/App.tsx
@@ -17,10 +17,12 @@ import {
  joinMiniAppHousehold,
  openMiniAppBillingCycle,
  promoteMiniAppMember,
+  updateMiniAppMemberAbsencePolicy,
  updateMiniAppMemberStatus,
  updateMiniAppMemberRentWeight,
  type MiniAppAdminCycleState,
  type MiniAppAdminSettingsPayload,
+  type MiniAppMemberAbsencePolicy,
  updateMiniAppLocalePreference,
  updateMiniAppBillingSettings,
  updateMiniAppCycleRent,
@@ -282,10 +284,16 @@ function App() {
  const [promotingMemberId, setPromotingMemberId] = createSignal<string | null>(null)
  const [savingRentWeightMemberId, setSavingRentWeightMemberId] = createSignal<string | null>(null)
  const [savingMemberStatusId, setSavingMemberStatusId] = createSignal<string | null>(null)
+  const [savingMemberAbsencePolicyId, setSavingMemberAbsencePolicyId] = createSignal<string | null>(
+    null
+  )
  const [rentWeightDrafts, setRentWeightDrafts] = createSignal<Record<string, string>>({})
  const [memberStatusDrafts, setMemberStatusDrafts] = createSignal<
    Record<string, 'active' | 'away' | 'left'>
  >({})
+  const [memberAbsencePolicyDrafts, setMemberAbsencePolicyDrafts] = createSignal<
+    Record<string, MiniAppMemberAbsencePolicy>
+  >({})
  const [savingMemberLocale, setSavingMemberLocale] = createSignal(false)
  const [savingHouseholdLocale, setSavingHouseholdLocale] = createSignal(false)
  const [savingBillingSettings, setSavingBillingSettings] = createSignal(false)
@@ -400,6 +408,39 @@ function App() {
    }
  }

+  function defaultAbsencePolicyForStatus(
+    status: 'active' | 'away' | 'left'
+  ): MiniAppMemberAbsencePolicy {
+    if (status === 'away') {
+      return 'away_rent_and_utilities'
+    }
+
+    if (status === 'left') {
+      return 'inactive'
+    }
+
+    return 'resident'
+  }
+
+  function resolvedMemberAbsencePolicy(
+    memberId: string,
+    status: 'active' | 'away' | 'left',
+    settings = adminSettings()
+  ) {
+    const current = settings?.memberAbsencePolicies
+      .filter((policy) => policy.memberId === memberId)
+      .sort((left, right) => left.effectiveFromPeriod.localeCompare(right.effectiveFromPeriod))
+      .at(-1)
+
+    return (
+      current ?? {
+        memberId,
+        effectiveFromPeriod: '',
+        policy: defaultAbsencePolicyForStatus(status)
+      }
+    )
+  }
+
  async function loadDashboard(initData: string) {
    try {
      const nextDashboard = await fetchMiniAppDashboard(initData)
@@ -441,6 +482,14 @@ function App() {
      setMemberStatusDrafts(
        Object.fromEntries(payload.members.map((member) => [member.id, member.status]))
      )
+      setMemberAbsencePolicyDrafts(
+        Object.fromEntries(
+          payload.members.map((member) => [
+            member.id,
+            resolvedMemberAbsencePolicy(member.id, member.status, payload).policy
+          ])
+        )
+      )
      setCycleForm((current) => ({
        ...current,
        rentCurrency: payload.settings.rentCurrency,
@@ -1276,11 +1325,66 @@ function App() {
        ...current,
        [member.id]: member.status
      }))
+      setMemberAbsencePolicyDrafts((current) => ({
+        ...current,
+        [member.id]:
+          current[member.id] ??
+          resolvedMemberAbsencePolicy(member.id, member.status).policy ??
+          defaultAbsencePolicyForStatus(member.status)
+      }))
    } finally {
      setSavingMemberStatusId(null)
    }
  }

+  async function handleSaveMemberAbsencePolicy(memberId: string) {
+    const initData = webApp?.initData?.trim()
+    const currentReady = readySession()
+    const member = adminSettings()?.members.find((entry) => entry.id === memberId)
+    const nextPolicy = memberAbsencePolicyDrafts()[memberId]
+    const effectiveStatus = memberStatusDrafts()[memberId] ?? member?.status
+
+    if (
+      !initData ||
+      currentReady?.mode !== 'live' ||
+      !currentReady.member.isAdmin ||
+      !member ||
+      !nextPolicy ||
+      effectiveStatus !== 'away'
+    ) {
+      return
+    }
+
+    setSavingMemberAbsencePolicyId(memberId)
+
+    try {
+      const savedPolicy = await updateMiniAppMemberAbsencePolicy(initData, memberId, nextPolicy)
+      setAdminSettings((current) =>
+        current
+          ? {
+              ...current,
+              memberAbsencePolicies: [
+                ...current.memberAbsencePolicies.filter(
+                  (policy) =>
+                    !(
+                      policy.memberId === savedPolicy.memberId &&
+                      policy.effectiveFromPeriod === savedPolicy.effectiveFromPeriod
+                    )
+                ),
+                savedPolicy
+              ]
+            }
+          : current
+      )
+      setMemberAbsencePolicyDrafts((current) => ({
+        ...current,
+        [memberId]: savedPolicy.policy
+      }))
+    } finally {
+      setSavingMemberAbsencePolicyId(null)
+    }
+  }
+
  const renderPanel = () => {
    switch (activeNav()) {
      case 'balances':
@@ -2447,6 +2551,44 @@ function App() {
                                <option value="left">{copy().memberStatusLeft}</option>
                              </select>
                            </label>
+                            <label class="settings-field settings-field--wide">
+                              <span>{copy().absencePolicyLabel}</span>
+                              <select
+                                value={
+                                  memberAbsencePolicyDrafts()[member.id] ??
+                                  resolvedMemberAbsencePolicy(member.id, member.status).policy
+                                }
+                                disabled={
+                                  (memberStatusDrafts()[member.id] ?? member.status) !== 'away'
+                                }
+                                onChange={(event) =>
+                                  setMemberAbsencePolicyDrafts((current) => ({
+                                    ...current,
+                                    [member.id]: event.currentTarget
+                                      .value as MiniAppMemberAbsencePolicy
+                                  }))
+                                }
+                              >
+                                <option value="away_rent_and_utilities">
+                                  {copy().absencePolicyAwayRentAndUtilities}
+                                </option>
+                                <option value="away_rent_only">
+                                  {copy().absencePolicyAwayRentOnly}
+                                </option>
+                                <option value="inactive">{copy().absencePolicyInactive}</option>
+                                <option value="resident">{copy().absencePolicyResident}</option>
+                              </select>
+                              <small>
+                                {resolvedMemberAbsencePolicy(member.id, member.status)
+                                  .effectiveFromPeriod
+                                  ? copy().absencePolicyEffectiveFrom.replace(
+                                      '{period}',
+                                      resolvedMemberAbsencePolicy(member.id, member.status)
+                                        .effectiveFromPeriod
+                                    )
+                                  : copy().absencePolicyHint}
+                              </small>
+                            </label>
                            <label class="settings-field settings-field--wide">
                              <span>{copy().rentWeightLabel}</span>
                              <input
@@ -2474,6 +2616,19 @@ function App() {
                                ? copy().savingMemberStatus
                                : copy().saveMemberStatusAction}
                            </button>
+                            <button
+                              class="ghost-button"
+                              type="button"
+                              disabled={
+                                savingMemberAbsencePolicyId() === member.id ||
+                                (memberStatusDrafts()[member.id] ?? member.status) !== 'away'
+                              }
+                              onClick={() => void handleSaveMemberAbsencePolicy(member.id)}
+                            >
+                              {savingMemberAbsencePolicyId() === member.id
+                                ? copy().savingAbsencePolicy
+                                : copy().saveAbsencePolicyAction}
+                            </button>
                            <button
                              class="ghost-button"
                              type="button"
--- a/apps/miniapp/src/i18n.ts
+++ b/apps/miniapp/src/i18n.ts
@@ -144,6 +144,15 @@ export const dictionary = {
    memberStatusActive: 'Active',
    memberStatusAway: 'Away',
    memberStatusLeft: 'Left',
+    absencePolicyLabel: 'Away billing policy',
+    absencePolicyResident: 'Resident billing',
+    absencePolicyAwayRentAndUtilities: 'Away: rent and utilities',
+    absencePolicyAwayRentOnly: 'Away: rent only',
+    absencePolicyInactive: 'Inactive / moved out',
+    absencePolicyHint: 'Applies to future cycle calculations for away members.',
+    absencePolicyEffectiveFrom: 'Effective from {period}',
+    saveAbsencePolicyAction: 'Save away policy',
+    savingAbsencePolicy: 'Saving policy…',
    memberStatusSummary: 'Your household status: {status}.',
    rentWeightLabel: 'Rent weight',
    saveRentWeightAction: 'Save rent weight',
@@ -309,6 +318,15 @@ export const dictionary = {
    memberStatusActive: 'Активный',
    memberStatusAway: 'В отъезде',
    memberStatusLeft: 'Выехал',
+    absencePolicyLabel: 'Политика начислений в отъезде',
+    absencePolicyResident: 'Как у проживающего',
+    absencePolicyAwayRentAndUtilities: 'В отъезде: аренда и коммуналка',
+    absencePolicyAwayRentOnly: 'В отъезде: только аренда',
+    absencePolicyInactive: 'Неактивен / выехал',
+    absencePolicyHint: 'Применяется к будущим расчётам для участников со статусом «В отъезде».',
+    absencePolicyEffectiveFrom: 'Действует с {period}',
+    saveAbsencePolicyAction: 'Сохранить политику',
+    savingAbsencePolicy: 'Сохраняем политику…',
    memberStatusSummary: 'Твой статус в household: {status}.',
    rentWeightLabel: 'Вес аренды',
    saveRentWeightAction: 'Сохранить вес аренды',
--- a/apps/miniapp/src/miniapp-api.ts
+++ b/apps/miniapp/src/miniapp-api.ts
@@ -37,6 +37,18 @@ export interface MiniAppPendingMember {
  languageCode: string | null
 }

+export type MiniAppMemberAbsencePolicy =
+  | 'resident'
+  | 'away_rent_and_utilities'
+  | 'away_rent_only'
+  | 'inactive'
+
+export interface MiniAppMemberAbsencePolicyRecord {
+  memberId: string
+  effectiveFromPeriod: string
+  policy: MiniAppMemberAbsencePolicy
+}
+
 export interface MiniAppMember {
  id: string
  displayName: string
@@ -116,6 +128,7 @@ export interface MiniAppAdminSettingsPayload {
  topics: readonly MiniAppTopicBinding[]
  categories: readonly MiniAppUtilityCategory[]
  members: readonly MiniAppMember[]
+  memberAbsencePolicies: readonly MiniAppMemberAbsencePolicyRecord[]
 }

 export interface MiniAppAdminCycleState {
@@ -362,6 +375,7 @@ export async function fetchMiniAppAdminSettings(
    topics?: MiniAppTopicBinding[]
    categories?: MiniAppUtilityCategory[]
    members?: MiniAppMember[]
+    memberAbsencePolicies?: MiniAppMemberAbsencePolicyRecord[]
    error?: string
  }

@@ -371,7 +385,8 @@ export async function fetchMiniAppAdminSettings(
    !payload.settings ||
    !payload.topics ||
    !payload.categories ||
-    !payload.members
+    !payload.members ||
+    !payload.memberAbsencePolicies
  ) {
    throw new Error(payload.error ?? 'Failed to load admin settings')
  }
@@ -380,7 +395,8 @@ export async function fetchMiniAppAdminSettings(
    settings: payload.settings,
    topics: payload.topics,
    categories: payload.categories,
-    members: payload.members
+    members: payload.members,
+    memberAbsencePolicies: payload.memberAbsencePolicies
  }
 }

@@ -547,6 +563,37 @@ export async function updateMiniAppMemberStatus(
  return payload.member
 }

+export async function updateMiniAppMemberAbsencePolicy(
+  initData: string,
+  memberId: string,
+  policy: MiniAppMemberAbsencePolicy
+): Promise<MiniAppMemberAbsencePolicyRecord> {
+  const response = await fetch(`${apiBaseUrl()}/api/miniapp/admin/members/absence-policy`, {
+    method: 'POST',
+    headers: {
+      'content-type': 'application/json'
+    },
+    body: JSON.stringify({
+      initData,
+      memberId,
+      policy
+    })
+  })
+
+  const payload = (await response.json()) as {
+    ok: boolean
+    authorized?: boolean
+    policy?: MiniAppMemberAbsencePolicyRecord
+    error?: string
+  }
+
+  if (!response.ok || !payload.policy) {
+    throw new Error(payload.error ?? 'Failed to update member absence policy')
+  }
+
+  return payload.policy
+}
+
 export async function fetchMiniAppBillingCycle(initData: string): Promise<MiniAppAdminCycleState> {
  const response = await fetch(`${apiBaseUrl()}/api/miniapp/admin/billing-cycle`, {
    method: 'POST',
--- a/packages/adapters-db/src/household-config-repository.ts
+++ b/packages/adapters-db/src/household-config-repository.ts
@@ -8,8 +8,11 @@ import {
  type CurrencyCode
 } from '@household/domain'
 import {
+  HOUSEHOLD_MEMBER_ABSENCE_POLICIES,
  HOUSEHOLD_MEMBER_LIFECYCLE_STATUSES,
  HOUSEHOLD_TOPIC_ROLES,
+  type HouseholdMemberAbsencePolicy,
+  type HouseholdMemberAbsencePolicyRecord,
  type HouseholdBillingSettingsRecord,
  type HouseholdConfigurationRepository,
  type HouseholdJoinTokenRecord,
@@ -44,6 +47,16 @@ function normalizeMemberLifecycleStatus(raw: string): HouseholdMemberLifecycleSt
  throw new Error(`Unsupported household member lifecycle status: ${raw}`)
 }

+function normalizeMemberAbsencePolicy(raw: string): HouseholdMemberAbsencePolicy {
+  const normalized = raw.trim().toLowerCase()
+
+  if ((HOUSEHOLD_MEMBER_ABSENCE_POLICIES as readonly string[]).includes(normalized)) {
+    return normalized as HouseholdMemberAbsencePolicy
+  }
+
+  throw new Error(`Unsupported household member absence policy: ${raw}`)
+}
+
 function toHouseholdTelegramChatRecord(row: {
  householdId: string
  householdName: string
@@ -232,6 +245,20 @@ function toHouseholdUtilityCategoryRecord(row: {
  }
 }

+function toHouseholdMemberAbsencePolicyRecord(row: {
+  householdId: string
+  memberId: string
+  effectiveFromPeriod: string
+  policy: string
+}): HouseholdMemberAbsencePolicyRecord {
+  return {
+    householdId: row.householdId,
+    memberId: row.memberId,
+    effectiveFromPeriod: row.effectiveFromPeriod,
+    policy: normalizeMemberAbsencePolicy(row.policy)
+  }
+}
+
 function utilityCategorySlug(name: string): string {
  return name
    .trim()
@@ -1343,6 +1370,55 @@ export function createDbHouseholdConfigurationRepository(databaseUrl: string): {
        ...row,
        defaultLocale: household.defaultLocale
      })
+    },
+
+    async listHouseholdMemberAbsencePolicies(householdId) {
+      const rows = await db
+        .select({
+          householdId: schema.memberAbsencePolicies.householdId,
+          memberId: schema.memberAbsencePolicies.memberId,
+          effectiveFromPeriod: schema.memberAbsencePolicies.effectiveFromPeriod,
+          policy: schema.memberAbsencePolicies.policy
+        })
+        .from(schema.memberAbsencePolicies)
+        .where(eq(schema.memberAbsencePolicies.householdId, householdId))
+        .orderBy(
+          asc(schema.memberAbsencePolicies.memberId),
+          asc(schema.memberAbsencePolicies.effectiveFromPeriod)
+        )
+
+      return rows.map(toHouseholdMemberAbsencePolicyRecord)
+    },
+
+    async upsertHouseholdMemberAbsencePolicy(input) {
+      const rows = await db
+        .insert(schema.memberAbsencePolicies)
+        .values({
+          householdId: input.householdId,
+          memberId: input.memberId,
+          effectiveFromPeriod: input.effectiveFromPeriod,
+          policy: input.policy
+        })
+        .onConflictDoUpdate({
+          target: [
+            schema.memberAbsencePolicies.householdId,
+            schema.memberAbsencePolicies.memberId,
+            schema.memberAbsencePolicies.effectiveFromPeriod
+          ],
+          set: {
+            policy: input.policy,
+            updatedAt: instantToDate(nowInstant())
+          }
+        })
+        .returning({
+          householdId: schema.memberAbsencePolicies.householdId,
+          memberId: schema.memberAbsencePolicies.memberId,
+          effectiveFromPeriod: schema.memberAbsencePolicies.effectiveFromPeriod,
+          policy: schema.memberAbsencePolicies.policy
+        })
+
+      const row = rows[0]
+      return row ? toHouseholdMemberAbsencePolicyRecord(row) : null
    }
  }

--- a/packages/application/src/finance-command-service.test.ts
+++ b/packages/application/src/finance-command-service.test.ts
@@ -19,6 +19,12 @@ class FinanceRepositoryStub implements FinanceRepository {
  householdId = 'household-1'
  member: FinanceMemberRecord | null = null
  members: readonly FinanceMemberRecord[] = []
+  memberStatuses = new Map<string, 'active' | 'away' | 'left'>()
+  memberAbsencePolicies: readonly {
+    memberId: string
+    effectiveFromPeriod: string
+    policy: 'resident' | 'away_rent_and_utilities' | 'away_rent_only' | 'inactive'
+  }[] = []
  openCycleRecord: FinanceCycleRecord | null = null
  cycleByPeriodRecord: FinanceCycleRecord | null = null
  latestCycleRecord: FinanceCycleRecord | null = null
@@ -204,7 +210,7 @@ class FinanceRepositoryStub implements FinanceRepository {

 const householdConfigurationRepository: Pick<
  HouseholdConfigurationRepository,
-  'getHouseholdBillingSettings'
+  'getHouseholdBillingSettings' | 'listHouseholdMembers' | 'listHouseholdMemberAbsencePolicies'
 > = {
  async getHouseholdBillingSettings(householdId) {
    return {
@@ -218,9 +224,43 @@ const householdConfigurationRepository: Pick<
      utilitiesReminderDay: 3,
      timezone: 'Asia/Tbilisi'
    }
+  },
+  async listHouseholdMembers(householdId) {
+    const repository = financeRepositoryForHousehold(householdId)
+
+    return repository.members.map((member) => ({
+      id: member.id,
+      householdId,
+      telegramUserId: member.telegramUserId,
+      displayName: member.displayName,
+      status: repository.memberStatuses.get(member.id) ?? 'active',
+      preferredLocale: null,
+      householdDefaultLocale: 'en' as const,
+      rentShareWeight: member.rentShareWeight,
+      isAdmin: member.isAdmin
+    }))
+  },
+  async listHouseholdMemberAbsencePolicies(householdId) {
+    return financeRepositoryForHousehold(householdId).memberAbsencePolicies.map((policy) => ({
+      householdId,
+      memberId: policy.memberId,
+      effectiveFromPeriod: policy.effectiveFromPeriod,
+      policy: policy.policy
+    }))
  }
 }

+const financeRepositories = new Map<string, FinanceRepositoryStub>()
+
+function financeRepositoryForHousehold(householdId: string): FinanceRepositoryStub {
+  const repository = financeRepositories.get(householdId)
+  if (!repository) {
+    throw new Error(`Missing finance repository stub for ${householdId}`)
+  }
+
+  return repository
+}
+
 const exchangeRateProvider: ExchangeRateProvider = {
  async getRate(input) {
    if (input.baseCurrency === input.quoteCurrency) {
@@ -254,6 +294,8 @@ const exchangeRateProvider: ExchangeRateProvider = {
 }

 function createService(repository: FinanceRepositoryStub) {
+  financeRepositories.set(repository.householdId, repository)
+
  return createFinanceCommandService({
    householdId: repository.householdId,
    repository,
@@ -482,4 +524,83 @@ describe('createFinanceCommandService', () => {

    expect(dashboard?.period).toBe('2026-03')
  })
+
+  test('generateDashboard excludes away members from purchases and utilities based on absence policy', async () => {
+    const repository = new FinanceRepositoryStub()
+    repository.members = [
+      {
+        id: 'alice',
+        telegramUserId: '1',
+        displayName: 'Alice',
+        rentShareWeight: 1,
+        isAdmin: true
+      },
+      {
+        id: 'bob',
+        telegramUserId: '2',
+        displayName: 'Bob',
+        rentShareWeight: 1,
+        isAdmin: false
+      },
+      {
+        id: 'carol',
+        telegramUserId: '3',
+        displayName: 'Carol',
+        rentShareWeight: 1,
+        isAdmin: false
+      }
+    ]
+    repository.memberStatuses.set('carol', 'away')
+    repository.memberAbsencePolicies = [
+      {
+        memberId: 'carol',
+        effectiveFromPeriod: '2026-03',
+        policy: 'away_rent_only'
+      }
+    ]
+    repository.openCycleRecord = {
+      id: 'cycle-2026-03',
+      period: '2026-03',
+      currency: 'GEL'
+    }
+    repository.rentRule = {
+      amountMinor: 90000n,
+      currency: 'GEL'
+    }
+    repository.utilityBills = [
+      {
+        id: 'utility-1',
+        billName: 'Gas',
+        amountMinor: 12000n,
+        currency: 'GEL',
+        createdByMemberId: 'alice',
+        createdAt: instantFromIso('2026-03-12T12:00:00.000Z')
+      }
+    ]
+    repository.purchases = [
+      {
+        id: 'purchase-1',
+        payerMemberId: 'alice',
+        amountMinor: 3000n,
+        currency: 'GEL',
+        description: 'Kitchen towels',
+        occurredAt: instantFromIso('2026-03-10T12:00:00.000Z')
+      }
+    ]
+
+    const service = createService(repository)
+    const dashboard = await service.generateDashboard()
+
+    expect(
+      dashboard?.members.map((line) => ({
+        memberId: line.memberId,
+        utility: line.utilityShare.amountMinor,
+        purchaseOffset: line.purchaseOffset.amountMinor
+      }))
+    ).toEqual([
+      { memberId: 'alice', utility: 6000n, purchaseOffset: -1500n },
+      { memberId: 'bob', utility: 6000n, purchaseOffset: 1500n },
+      { memberId: 'carol', utility: 0n, purchaseOffset: 0n }
+    ])
+  })
 })
--- a/packages/application/src/finance-command-service.ts
+++ b/packages/application/src/finance-command-service.ts
@@ -7,7 +7,10 @@ import type {
  FinancePaymentKind,
  FinanceRentRuleRecord,
  FinanceRepository,
-  HouseholdConfigurationRepository
+  HouseholdConfigurationRepository,
+  HouseholdMemberAbsencePolicy,
+  HouseholdMemberAbsencePolicyRecord,
+  HouseholdMemberRecord
 } from '@household/ports'
 import {
  BillingCycleId,
@@ -100,6 +103,9 @@ function expectedOpenCyclePeriod(
 export interface FinanceDashboardMemberLine {
  memberId: string
  displayName: string
+  status?: 'active' | 'away' | 'left'
+  absencePolicy?: HouseholdMemberAbsencePolicy
+  absencePolicyEffectiveFromPeriod?: string | null
  rentShare: Money
  utilityShare: Money
  purchaseOffset: Money
@@ -157,11 +163,45 @@ interface FinanceCommandServiceDependencies {
  repository: FinanceRepository
  householdConfigurationRepository: Pick<
    HouseholdConfigurationRepository,
-    'getHouseholdBillingSettings'
+    'getHouseholdBillingSettings' | 'listHouseholdMembers' | 'listHouseholdMemberAbsencePolicies'
  >
  exchangeRateProvider: ExchangeRateProvider
 }

+interface ResolvedMemberAbsencePolicy {
+  memberId: string
+  policy: HouseholdMemberAbsencePolicy
+  effectiveFromPeriod: string | null
+}
+
+function resolveMemberAbsencePolicies(input: {
+  members: readonly HouseholdMemberRecord[]
+  policies: readonly HouseholdMemberAbsencePolicyRecord[]
+  period: string
+}): ReadonlyMap<string, ResolvedMemberAbsencePolicy> {
+  const resolved = new Map<string, ResolvedMemberAbsencePolicy>()
+
+  for (const member of input.members) {
+    const applicable = input.policies
+      .filter(
+        (policy) =>
+          policy.memberId === member.id &&
+          policy.effectiveFromPeriod.localeCompare(input.period) <= 0
+      )
+      .sort((left, right) => left.effectiveFromPeriod.localeCompare(right.effectiveFromPeriod))
+      .at(-1)
+
+    resolved.set(member.id, {
+      memberId: member.id,
+      policy:
+        applicable?.policy ?? (member.status === 'away' ? 'away_rent_and_utilities' : 'resident'),
+      effectiveFromPeriod: applicable?.effectiveFromPeriod ?? null
+    })
+  }
+
+  return resolved
+}
+
 interface ConvertedCycleMoney {
  originalAmount: Money
  settlementAmount: Money
@@ -240,8 +280,11 @@ async function buildFinanceDashboard(
    return null
  }

-  const [members, rentRule, settings] = await Promise.all([
-    dependencies.repository.listMembers(),
+  const [members, memberAbsencePolicies, rentRule, settings] = await Promise.all([
+    dependencies.householdConfigurationRepository.listHouseholdMembers(dependencies.householdId),
+    dependencies.householdConfigurationRepository.listHouseholdMemberAbsencePolicies(
+      dependencies.householdId
+    ),
    dependencies.repository.getRentRuleForPeriod(cycle.period),
    dependencies.householdConfigurationRepository.getHouseholdBillingSettings(
      dependencies.householdId
@@ -258,6 +301,11 @@ async function buildFinanceDashboard(

  const period = BillingPeriod.fromString(cycle.period)
  const { start, end } = monthRange(period)
+  const resolvedAbsencePolicies = resolveMemberAbsencePolicies({
+    members,
+    policies: memberAbsencePolicies,
+    period: cycle.period
+  })
  const [purchases, utilityBills] = await Promise.all([
    dependencies.repository.listParsedPurchasesForRange(start, end),
    dependencies.repository.listUtilityBillsForCycle(cycle.id)
@@ -319,7 +367,17 @@ async function buildFinanceDashboard(
    utilitySplitMode: 'equal',
    members: members.map((member) => ({
      memberId: MemberId.from(member.id),
-      active: true,
+      active: member.status !== 'left',
+      participatesInRent:
+        member.status === 'left'
+          ? false
+          : (resolvedAbsencePolicies.get(member.id)?.policy ?? 'resident') !== 'inactive',
+      participatesInUtilities:
+        member.status === 'away'
+          ? (resolvedAbsencePolicies.get(member.id)?.policy ?? 'resident') ===
+            'away_rent_and_utilities'
+          : member.status !== 'left',
+      participatesInPurchases: member.status === 'active',
      rentWeight: member.rentShareWeight
    })),
    purchases: convertedPurchases.map(({ purchase, converted }) => ({
@@ -374,6 +432,10 @@ async function buildFinanceDashboard(
  const dashboardMembers = settlement.lines.map((line) => ({
    memberId: line.memberId.toString(),
    displayName: memberNameById.get(line.memberId.toString()) ?? line.memberId.toString(),
+    status: members.find((member) => member.id === line.memberId.toString())?.status ?? 'active',
+    absencePolicy: resolvedAbsencePolicies.get(line.memberId.toString())?.policy ?? 'resident',
+    absencePolicyEffectiveFromPeriod:
+      resolvedAbsencePolicies.get(line.memberId.toString())?.effectiveFromPeriod ?? null,
    rentShare: line.rentShare,
    utilityShare: line.utilityShare,
    purchaseOffset: line.purchaseOffset,
--- a/packages/application/src/household-admin-service.test.ts
+++ b/packages/application/src/household-admin-service.test.ts
@@ -178,7 +178,9 @@ function createRepositoryStub() {
    }),
    promoteHouseholdAdmin: async () => null,
    updateHouseholdMemberRentShareWeight: async () => null,
-    updateHouseholdMemberStatus: async () => null
+    updateHouseholdMemberStatus: async () => null,
+    listHouseholdMemberAbsencePolicies: async () => [],
+    upsertHouseholdMemberAbsencePolicy: async () => null
  }

  return {
--- a/packages/application/src/household-onboarding-service.test.ts
+++ b/packages/application/src/household-onboarding-service.test.ts
@@ -203,6 +203,12 @@ function createRepositoryStub() {
    },
    async updateHouseholdMemberStatus() {
      return null
+    },
+    async listHouseholdMemberAbsencePolicies() {
+      return []
+    },
+    async upsertHouseholdMemberAbsencePolicy() {
+      return null
    }
  }

--- a/packages/application/src/household-setup-service.test.ts
+++ b/packages/application/src/household-setup-service.test.ts
@@ -337,6 +337,14 @@ function createRepositoryStub() {
      }
      members.set(`${householdId}:${member.telegramUserId}`, next)
      return next
+    },
+
+    async listHouseholdMemberAbsencePolicies() {
+      return []
+    },
+
+    async upsertHouseholdMemberAbsencePolicy() {
+      return null
    }
  }

--- a/packages/application/src/locale-preference-service.test.ts
+++ b/packages/application/src/locale-preference-service.test.ts
@@ -111,7 +111,9 @@ function createRepository(): HouseholdConfigurationRepository {
    }),
    promoteHouseholdAdmin: async () => null,
    updateHouseholdMemberRentShareWeight: async () => null,
-    updateHouseholdMemberStatus: async () => null
+    updateHouseholdMemberStatus: async () => null,
+    listHouseholdMemberAbsencePolicies: async () => [],
+    upsertHouseholdMemberAbsencePolicy: async () => null
  }
 }

--- a/packages/application/src/miniapp-admin-service.test.ts
+++ b/packages/application/src/miniapp-admin-service.test.ts
@@ -5,6 +5,13 @@ import type { HouseholdConfigurationRepository } from '@household/ports'
 import { createMiniAppAdminService } from './miniapp-admin-service'

 function repository(): HouseholdConfigurationRepository {
+  let memberAbsencePolicies: {
+    householdId: string
+    memberId: string
+    effectiveFromPeriod: string
+    policy: 'resident' | 'away_rent_and_utilities' | 'away_rent_only' | 'inactive'
+  }[] = []
+
  return {
    registerTelegramHouseholdChat: async () => ({
      status: 'existing',
@@ -68,7 +75,19 @@ function repository(): HouseholdConfigurationRepository {
      isAdmin: input.isAdmin === true
    }),
    getHouseholdMember: async () => null,
-    listHouseholdMembers: async () => [],
+    listHouseholdMembers: async () => [
+      {
+        id: 'member-123456',
+        householdId: 'household-1',
+        telegramUserId: '123456',
+        displayName: 'Stan',
+        status: 'active',
+        preferredLocale: null,
+        householdDefaultLocale: 'ru',
+        rentShareWeight: 1,
+        isAdmin: false
+      }
+    ],
    listHouseholdMembersByTelegramUserId: async () => [],
    listPendingHouseholdMembers: async () => [
      {
@@ -189,7 +208,28 @@ function repository(): HouseholdConfigurationRepository {
            rentShareWeight: 1,
            isAdmin: false
          }
-        : null
+        : null,
+    listHouseholdMemberAbsencePolicies: async () => memberAbsencePolicies,
+    upsertHouseholdMemberAbsencePolicy: async (input) => {
+      const next = {
+        householdId: input.householdId,
+        memberId: input.memberId,
+        effectiveFromPeriod: input.effectiveFromPeriod,
+        policy: input.policy
+      }
+      memberAbsencePolicies = [
+        ...memberAbsencePolicies.filter(
+          (entry) =>
+            !(
+              entry.householdId === input.householdId &&
+              entry.memberId === input.memberId &&
+              entry.effectiveFromPeriod === input.effectiveFromPeriod
+            )
+        ),
+        next
+      ]
+      return next
+    }
  }
 }

@@ -224,7 +264,20 @@ describe('createMiniAppAdminService', () => {
        }
      ],
      categories: [],
-      members: []
+      members: [
+        {
+          id: 'member-123456',
+          householdId: 'household-1',
+          telegramUserId: '123456',
+          displayName: 'Stan',
+          status: 'active',
+          preferredLocale: null,
+          householdDefaultLocale: 'ru',
+          rentShareWeight: 1,
+          isAdmin: false
+        }
+      ],
+      memberAbsencePolicies: []
    })
  })

@@ -259,6 +312,27 @@ describe('createMiniAppAdminService', () => {
    })
  })

+  test('stores an away absence policy from the current local period', async () => {
+    const service = createMiniAppAdminService(repository())
+
+    const result = await service.updateMemberAbsencePolicy({
+      householdId: 'household-1',
+      actorIsAdmin: true,
+      memberId: 'member-123456',
+      policy: 'away_rent_only'
+    })
+
+    expect(result).toEqual({
+      status: 'ok',
+      policy: {
+        householdId: 'household-1',
+        memberId: 'member-123456',
+        effectiveFromPeriod: '2026-03',
+        policy: 'away_rent_only'
+      }
+    })
+  })
+
  test('upserts utility categories for admins', async () => {
    const service = createMiniAppAdminService(repository())

--- a/packages/application/src/miniapp-admin-service.ts
+++ b/packages/application/src/miniapp-admin-service.ts
@@ -1,13 +1,15 @@
 import type {
  HouseholdBillingSettingsRecord,
  HouseholdConfigurationRepository,
+  HouseholdMemberAbsencePolicy,
+  HouseholdMemberAbsencePolicyRecord,
  HouseholdMemberLifecycleStatus,
  HouseholdMemberRecord,
  HouseholdPendingMemberRecord,
  HouseholdTopicBindingRecord,
  HouseholdUtilityCategoryRecord
 } from '@household/ports'
-import { Money, type CurrencyCode } from '@household/domain'
+import { Money, Temporal, type CurrencyCode } from '@household/domain'

 function isValidDay(value: number): boolean {
  return Number.isInteger(value) && value >= 1 && value <= 31
@@ -29,6 +31,7 @@ export interface MiniAppAdminService {
        settings: HouseholdBillingSettingsRecord
        categories: readonly HouseholdUtilityCategoryRecord[]
        members: readonly HouseholdMemberRecord[]
+        memberAbsencePolicies: readonly HouseholdMemberAbsencePolicyRecord[]
        topics: readonly HouseholdTopicBindingRecord[]
      }
    | {
@@ -142,6 +145,29 @@ export interface MiniAppAdminService {
        reason: 'not_admin' | 'member_not_found'
      }
  >
+  updateMemberAbsencePolicy(input: {
+    householdId: string
+    actorIsAdmin: boolean
+    memberId: string
+    policy: HouseholdMemberAbsencePolicy
+  }): Promise<
+    | {
+        status: 'ok'
+        policy: HouseholdMemberAbsencePolicyRecord
+      }
+    | {
+        status: 'rejected'
+        reason: 'not_admin' | 'member_not_found'
+      }
+  >
+}
+
+function localDateInTimezone(timezone: string) {
+  return Temporal.Now.instant().toZonedDateTimeISO(timezone).toPlainDate()
+}
+
+function periodFromLocalDate(localDate: Temporal.PlainDate): string {
+  return `${localDate.year}-${String(localDate.month).padStart(2, '0')}`
 }

 export function createMiniAppAdminService(
@@ -156,10 +182,11 @@ export function createMiniAppAdminService(
        }
      }

-      const [settings, categories, members, topics] = await Promise.all([
+      const [settings, categories, members, memberAbsencePolicies, topics] = await Promise.all([
        repository.getHouseholdBillingSettings(input.householdId),
        repository.listHouseholdUtilityCategories(input.householdId),
        repository.listHouseholdMembers(input.householdId),
+        repository.listHouseholdMemberAbsencePolicies(input.householdId),
        repository.listHouseholdTopicBindings(input.householdId)
      ])

@@ -168,6 +195,7 @@ export function createMiniAppAdminService(
        settings,
        categories,
        members,
+        memberAbsencePolicies,
        topics
      }
    },
@@ -395,6 +423,47 @@ export function createMiniAppAdminService(
        status: 'ok',
        member
      }
+    },
+
+    async updateMemberAbsencePolicy(input) {
+      if (!input.actorIsAdmin) {
+        return {
+          status: 'rejected',
+          reason: 'not_admin'
+        }
+      }
+
+      const [member, settings] = await Promise.all([
+        repository.listHouseholdMembers(input.householdId),
+        repository.getHouseholdBillingSettings(input.householdId)
+      ])
+      const target = member.find((candidate) => candidate.id === input.memberId)
+      if (!target) {
+        return {
+          status: 'rejected',
+          reason: 'member_not_found'
+        }
+      }
+
+      const effectiveFromPeriod = periodFromLocalDate(localDateInTimezone(settings.timezone))
+      const policy = await repository.upsertHouseholdMemberAbsencePolicy({
+        householdId: input.householdId,
+        memberId: input.memberId,
+        effectiveFromPeriod,
+        policy: input.policy
+      })
+
+      if (!policy) {
+        return {
+          status: 'rejected',
+          reason: 'member_not_found'
+        }
+      }
+
+      return {
+        status: 'ok',
+        policy
+      }
    }
  }
 }
--- a/packages/application/src/settlement-engine.test.ts
+++ b/packages/application/src/settlement-engine.test.ts
@@ -183,4 +183,58 @@ describe('calculateMonthlySettlement', () => {

    expect(() => calculateMonthlySettlement(input)).toThrow(DomainError)
  })
+
+  test('excludes away members from utilities and purchases when policy requires it', () => {
+    const input = {
+      ...fixtureBase(),
+      utilitySplitMode: 'equal' as const,
+      members: [
+        { memberId: MemberId.from('resident-a'), active: true },
+        { memberId: MemberId.from('resident-b'), active: true },
+        {
+          memberId: MemberId.from('away-member'),
+          active: true,
+          participatesInUtilities: false,
+          participatesInPurchases: false
+        }
+      ],
+      purchases: [
+        {
+          purchaseId: PurchaseEntryId.from('p1'),
+          payerId: MemberId.from('resident-a'),
+          amount: Money.fromMajor('30.00', 'USD')
+        }
+      ]
+    }
+
+    const result = calculateMonthlySettlement(input)
+
+    expect(result.lines.map((line) => line.utilityShare.amountMinor)).toEqual([6000n, 6000n, 0n])
+    expect(result.lines.map((line) => line.purchaseOffset.amountMinor)).toEqual([-1500n, 1500n, 0n])
+    expect(result.lines.map((line) => line.netDue.amountMinor)).toEqual([27834n, 30833n, 23333n])
+  })
+
+  test('excludes inactive members from all future charges', () => {
+    const input = {
+      ...fixtureBase(),
+      utilitySplitMode: 'equal' as const,
+      members: [
+        { memberId: MemberId.from('resident-a'), active: true },
+        {
+          memberId: MemberId.from('inactive-member'),
+          active: true,
+          participatesInRent: false,
+          participatesInUtilities: false,
+          participatesInPurchases: false
+        }
+      ],
+      purchases: []
+    }
+
+    const result = calculateMonthlySettlement(input)
+
+    expect(result.lines.map((line) => line.rentShare.amountMinor)).toEqual([70000n, 0n])
+    expect(result.lines.map((line) => line.utilityShare.amountMinor)).toEqual([12000n, 0n])
+    expect(result.lines.map((line) => line.netDue.amountMinor)).toEqual([82000n, 0n])
+  })
 })
--- a/packages/application/src/settlement-engine.ts
+++ b/packages/application/src/settlement-engine.ts
@@ -44,6 +44,53 @@ function ensureActiveMembers(
  return active
 }

+function rentParticipants(
+  members: readonly SettlementMemberInput[]
+): readonly SettlementMemberInput[] {
+  const participants = members.filter((member) => member.participatesInRent !== false)
+
+  if (participants.length === 0) {
+    throw new DomainError(
+      DOMAIN_ERROR_CODE.INVALID_SETTLEMENT_INPUT,
+      'Settlement must include at least one rent participant'
+    )
+  }
+
+  return participants
+}
+
+function utilityParticipants(
+  members: readonly SettlementMemberInput[],
+  utilities: Money
+): readonly SettlementMemberInput[] {
+  const participants = members.filter((member) => member.participatesInUtilities !== false)
+
+  if (participants.length === 0 && utilities.amountMinor > 0n) {
+    throw new DomainError(
+      DOMAIN_ERROR_CODE.INVALID_SETTLEMENT_INPUT,
+      'Settlement must include at least one utilities participant when utilities are present'
+    )
+  }
+
+  return participants
+}
+
+function purchaseParticipants(
+  members: readonly SettlementMemberInput[],
+  amount: Money
+): readonly SettlementMemberInput[] {
+  const participants = members.filter((member) => member.participatesInPurchases !== false)
+
+  if (participants.length === 0 && amount.amountMinor > 0n) {
+    throw new DomainError(
+      DOMAIN_ERROR_CODE.INVALID_SETTLEMENT_INPUT,
+      'Settlement must include at least one purchase participant when purchases are present'
+    )
+  }
+
+  return participants
+}
+
 function ensureNonNegativeMoney(label: string, value: Money): void {
  if (value.isNegative()) {
    throw new DomainError(
@@ -134,13 +181,15 @@ export function calculateMonthlySettlement(input: SettlementInput): SettlementRe

  const currency = input.rent.currency
  const activeMembers = ensureActiveMembers(input.members)
+  const rentMembers = rentParticipants(activeMembers)
+  const utilityMembers = utilityParticipants(activeMembers, input.utilities)

  const membersById = new Map<string, ComputationMember>(
    activeMembers.map((member) => [member.memberId.toString(), createMemberState(member, currency)])
  )

-  const rentShares = input.rent.splitByWeights(validateRentWeights(activeMembers))
-  for (const [index, member] of activeMembers.entries()) {
+  const rentShares = input.rent.splitByWeights(validateRentWeights(rentMembers))
+  for (const [index, member] of rentMembers.entries()) {
    const state = membersById.get(member.memberId.toString())
    if (!state) {
      continue
@@ -149,18 +198,20 @@ export function calculateMonthlySettlement(input: SettlementInput): SettlementRe
    state.rentShare = rentShares[index] ?? Money.zero(currency)
  }

-  const utilityShares =
-    input.utilitySplitMode === 'equal'
-      ? input.utilities.splitEvenly(activeMembers.length)
-      : input.utilities.splitByWeights(validateWeightedUtilityDays(activeMembers))
+  if (utilityMembers.length > 0) {
+    const utilityShares =
+      input.utilitySplitMode === 'equal'
+        ? input.utilities.splitEvenly(utilityMembers.length)
+        : input.utilities.splitByWeights(validateWeightedUtilityDays(utilityMembers))

-  for (const [index, member] of activeMembers.entries()) {
-    const state = membersById.get(member.memberId.toString())
-    if (!state) {
-      continue
+    for (const [index, member] of utilityMembers.entries()) {
+      const state = membersById.get(member.memberId.toString())
+      if (!state) {
+        continue
+      }
+
+      state.utilityShare = utilityShares[index] ?? Money.zero(currency)
    }
-
-    state.utilityShare = utilityShares[index] ?? Money.zero(currency)
  }

  for (const purchase of input.purchases) {
@@ -176,8 +227,9 @@ export function calculateMonthlySettlement(input: SettlementInput): SettlementRe

    payer.purchasePaid = payer.purchasePaid.add(purchase.amount)

-    const purchaseShares = purchase.amount.splitEvenly(activeMembers.length)
-    for (const [index, member] of activeMembers.entries()) {
+    const participants = purchaseParticipants(activeMembers, purchase.amount)
+    const purchaseShares = purchase.amount.splitEvenly(participants.length)
+    for (const [index, member] of participants.entries()) {
      const state = membersById.get(member.memberId.toString())
      if (!state) {
        continue
--- a/packages/db/drizzle/0015_white_owl.sql
+++ b/packages/db/drizzle/0015_white_owl.sql
@@ -0,0 +1,14 @@
+CREATE TABLE "member_absence_policies" (
+	"id" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,
+	"household_id" uuid NOT NULL,
+	"member_id" uuid NOT NULL,
+	"effective_from_period" text NOT NULL,
+	"policy" text NOT NULL,
+	"created_at" timestamp with time zone DEFAULT now() NOT NULL,
+	"updated_at" timestamp with time zone DEFAULT now() NOT NULL
+);
+--> statement-breakpoint
+ALTER TABLE "member_absence_policies" ADD CONSTRAINT "member_absence_policies_household_id_households_id_fk" FOREIGN KEY ("household_id") REFERENCES "public"."households"("id") ON DELETE cascade ON UPDATE no action;--> statement-breakpoint
+ALTER TABLE "member_absence_policies" ADD CONSTRAINT "member_absence_policies_member_id_members_id_fk" FOREIGN KEY ("member_id") REFERENCES "public"."members"("id") ON DELETE cascade ON UPDATE no action;--> statement-breakpoint
+CREATE UNIQUE INDEX "member_absence_policies_household_member_period_unique" ON "member_absence_policies" USING btree ("household_id","member_id","effective_from_period");--> statement-breakpoint
+CREATE INDEX "member_absence_policies_household_member_idx" ON "member_absence_policies" USING btree ("household_id","member_id");
--- a/packages/db/drizzle/meta/0015_snapshot.json
+++ b/packages/db/drizzle/meta/0015_snapshot.json
--- a/packages/db/drizzle/meta/_journal.json
+++ b/packages/db/drizzle/meta/_journal.json
@@ -106,6 +106,13 @@
      "when": 1773222186943,
      "tag": "0014_empty_risque",
      "breakpoints": true
+    },
+    {
+      "idx": 15,
+      "version": "7",
+      "when": 1773223414625,
+      "tag": "0015_white_owl",
+      "breakpoints": true
    }
  ]
 }
--- a/packages/db/src/schema.ts
+++ b/packages/db/src/schema.ts
@@ -209,6 +209,32 @@ export const members = pgTable(
  })
 )

+export const memberAbsencePolicies = pgTable(
+  'member_absence_policies',
+  {
+    id: uuid('id').defaultRandom().primaryKey(),
+    householdId: uuid('household_id')
+      .notNull()
+      .references(() => households.id, { onDelete: 'cascade' }),
+    memberId: uuid('member_id')
+      .notNull()
+      .references(() => members.id, { onDelete: 'cascade' }),
+    effectiveFromPeriod: text('effective_from_period').notNull(),
+    policy: text('policy').notNull(),
+    createdAt: timestamp('created_at', { withTimezone: true }).defaultNow().notNull(),
+    updatedAt: timestamp('updated_at', { withTimezone: true }).defaultNow().notNull()
+  },
+  (table) => ({
+    householdMemberPeriodUnique: uniqueIndex(
+      'member_absence_policies_household_member_period_unique'
+    ).on(table.householdId, table.memberId, table.effectiveFromPeriod),
+    householdMemberIdx: index('member_absence_policies_household_member_idx').on(
+      table.householdId,
+      table.memberId
+    )
+  })
+)
+
 export const billingCycles = pgTable(
  'billing_cycles',
  {
--- a/packages/domain/src/settlement-primitives.ts
+++ b/packages/domain/src/settlement-primitives.ts
@@ -7,6 +7,9 @@ export type UtilitySplitMode = 'equal' | 'weighted_by_days'
 export interface SettlementMemberInput {
  memberId: MemberId
  active: boolean
+  participatesInRent?: boolean
+  participatesInUtilities?: boolean
+  participatesInPurchases?: boolean
  rentWeight?: number
  utilityDays?: number
 }
--- a/packages/ports/src/household-config.ts
+++ b/packages/ports/src/household-config.ts
@@ -3,9 +3,16 @@ import type { ReminderTarget } from './reminders'

 export const HOUSEHOLD_TOPIC_ROLES = ['purchase', 'feedback', 'reminders', 'payments'] as const
 export const HOUSEHOLD_MEMBER_LIFECYCLE_STATUSES = ['active', 'away', 'left'] as const
+export const HOUSEHOLD_MEMBER_ABSENCE_POLICIES = [
+  'resident',
+  'away_rent_and_utilities',
+  'away_rent_only',
+  'inactive'
+] as const

 export type HouseholdTopicRole = (typeof HOUSEHOLD_TOPIC_ROLES)[number]
 export type HouseholdMemberLifecycleStatus = (typeof HOUSEHOLD_MEMBER_LIFECYCLE_STATUSES)[number]
+export type HouseholdMemberAbsencePolicy = (typeof HOUSEHOLD_MEMBER_ABSENCE_POLICIES)[number]

 export interface HouseholdTelegramChatRecord {
  householdId: string
@@ -52,6 +59,13 @@ export interface HouseholdMemberRecord {
  isAdmin: boolean
 }

+export interface HouseholdMemberAbsencePolicyRecord {
+  householdId: string
+  memberId: string
+  effectiveFromPeriod: string
+  policy: HouseholdMemberAbsencePolicy
+}
+
 export interface HouseholdBillingSettingsRecord {
  householdId: string
  settlementCurrency: CurrencyCode
@@ -197,4 +211,13 @@ export interface HouseholdConfigurationRepository {
    memberId: string,
    status: HouseholdMemberLifecycleStatus
  ): Promise<HouseholdMemberRecord | null>
+  listHouseholdMemberAbsencePolicies(
+    householdId: string
+  ): Promise<readonly HouseholdMemberAbsencePolicyRecord[]>
+  upsertHouseholdMemberAbsencePolicy(input: {
+    householdId: string
+    memberId: string
+    effectiveFromPeriod: string
+    policy: HouseholdMemberAbsencePolicy
+  }): Promise<HouseholdMemberAbsencePolicyRecord | null>
 }
--- a/packages/ports/src/index.ts
+++ b/packages/ports/src/index.ts
@@ -13,8 +13,11 @@ export type {
  ReleaseProcessedBotMessageInput
 } from './processed-bot-messages'
 export {
+  HOUSEHOLD_MEMBER_ABSENCE_POLICIES,
  HOUSEHOLD_MEMBER_LIFECYCLE_STATUSES,
  HOUSEHOLD_TOPIC_ROLES,
+  type HouseholdMemberAbsencePolicy,
+  type HouseholdMemberAbsencePolicyRecord,
  type HouseholdConfigurationRepository,
  type HouseholdBillingSettingsRecord,
  type HouseholdJoinTokenRecord,