feat(member): add household lifecycle states

apps/bot/src/anonymous-feedback.test.ts

@@ -178,6 +178,7 @@ function createHouseholdConfigurationRepository(): HouseholdConfigurationReposit
       householdId: input.householdId,
       telegramUserId: input.telegramUserId,
       displayName: input.displayName,
+      status: input.status ?? 'active',
       preferredLocale: input.preferredLocale ?? null,
       householdDefaultLocale: 'ru',
       rentShareWeight: 1,
@@ -191,6 +192,7 @@ function createHouseholdConfigurationRepository(): HouseholdConfigurationReposit
         householdId: 'household-1',
         telegramUserId: '123456',
         displayName: 'Stan',
+        status: 'active',
         preferredLocale: null,
         householdDefaultLocale: 'ru',
         rentShareWeight: 1,
@@ -212,6 +214,7 @@ function createHouseholdConfigurationRepository(): HouseholdConfigurationReposit
       householdId: 'household-1',
       telegramUserId,
       displayName: 'Stan',
+      status: 'active',
       preferredLocale: locale,
       householdDefaultLocale: 'ru',
       rentShareWeight: 1,
@@ -249,7 +252,8 @@ function createHouseholdConfigurationRepository(): HouseholdConfigurationReposit
       isActive: input.isActive
     }),
     promoteHouseholdAdmin: async () => null,
-    updateHouseholdMemberRentShareWeight: async () => null
+    updateHouseholdMemberRentShareWeight: async () => null,
+    updateHouseholdMemberStatus: async () => null
   }
 }
 
@@ -351,6 +355,7 @@ describe('registerAnonymousFeedback', () => {
         householdId: 'household-1',
         telegramUserId: '123456',
         displayName: 'Stan',
+        status: 'active',
         preferredLocale: 'en',
         householdDefaultLocale: 'ru',
         rentShareWeight: 1,

apps/bot/src/bot-i18n.test.ts

@@ -117,6 +117,7 @@ function createRepository(isAdmin = false): HouseholdConfigurationRepository {
               householdId: 'household-1',
               telegramUserId: '123456',
               displayName: 'Stan',
+              status: 'active',
               preferredLocale: 'ru',
               householdDefaultLocale: 'ru',
               rentShareWeight: 1,
@@ -131,7 +132,8 @@ function createRepository(isAdmin = false): HouseholdConfigurationRepository {
     },
     updateMemberPreferredLocale: async () => null,
     promoteHouseholdAdmin: async () => null,
-    updateHouseholdMemberRentShareWeight: async () => null
+    updateHouseholdMemberRentShareWeight: async () => null,
+    updateHouseholdMemberStatus: async () => null
   }
 }
 

apps/bot/src/dm-assistant.test.ts

@@ -150,6 +150,7 @@ function createHouseholdRepository(): HouseholdConfigurationRepository {
       householdId: 'household-1',
       telegramUserId: '123456',
       displayName: 'Stan',
+      status: 'active',
       preferredLocale: null,
       householdDefaultLocale: 'en',
       rentShareWeight: 1,
@@ -180,6 +181,7 @@ function createHouseholdRepository(): HouseholdConfigurationRepository {
         householdId: 'household-1',
         telegramUserId: '123456',
         displayName: 'Stan',
+        status: 'active',
         preferredLocale: null,
         householdDefaultLocale: 'en',
         rentShareWeight: 1,
@@ -191,7 +193,8 @@ function createHouseholdRepository(): HouseholdConfigurationRepository {
     updateHouseholdDefaultLocale: async () => household,
     updateMemberPreferredLocale: async () => null,
     promoteHouseholdAdmin: async () => null,
-    updateHouseholdMemberRentShareWeight: async () => null
+    updateHouseholdMemberRentShareWeight: async () => null,
+    updateHouseholdMemberStatus: async () => null
   }
 }
 

apps/bot/src/finance-commands.test.ts

@@ -78,6 +78,7 @@ function createRepository(): HouseholdConfigurationRepository {
         householdId: 'household-1',
         telegramUserId: '123456',
         displayName: 'Stan',
+        status: 'active',
         preferredLocale: 'ru',
         householdDefaultLocale: 'ru',
         rentShareWeight: 1,
@@ -109,7 +110,8 @@ function createRepository(): HouseholdConfigurationRepository {
     },
     updateMemberPreferredLocale: async () => null,
     promoteHouseholdAdmin: async () => null,
-    updateHouseholdMemberRentShareWeight: async () => null
+    updateHouseholdMemberRentShareWeight: async () => null,
+    updateHouseholdMemberStatus: async () => null
   }
 }
 

apps/bot/src/household-setup.test.ts

@@ -384,6 +384,7 @@ function createHouseholdConfigurationRepository(): HouseholdConfigurationReposit
         householdId: input.householdId,
         telegramUserId: input.telegramUserId,
         displayName: input.displayName,
+        status: input.status ?? existing?.status ?? 'active',
         preferredLocale: input.preferredLocale ?? existing?.preferredLocale ?? null,
         householdDefaultLocale: household.defaultLocale,
         rentShareWeight: input.rentShareWeight ?? existing?.rentShareWeight ?? 1,
@@ -456,6 +457,7 @@ function createHouseholdConfigurationRepository(): HouseholdConfigurationReposit
         householdId: pending.householdId,
         telegramUserId: pending.telegramUserId,
         displayName: pending.displayName,
+        status: 'active',
         preferredLocale: null,
         householdDefaultLocale: pending.householdDefaultLocale,
         rentShareWeight: 1,
@@ -492,6 +494,9 @@ function createHouseholdConfigurationRepository(): HouseholdConfigurationReposit
     },
     async updateHouseholdMemberRentShareWeight() {
       return null
+    },
+    async updateHouseholdMemberStatus() {
+      return null
     }
   }
 }

apps/bot/src/index.ts

@@ -49,6 +49,7 @@ import {
   createMiniAppPendingMembersHandler,
   createMiniAppPromoteMemberHandler,
   createMiniAppSettingsHandler,
+  createMiniAppUpdateMemberStatusHandler,
   createMiniAppUpdateMemberRentWeightHandler,
   createMiniAppUpdateSettingsHandler,
   createMiniAppUpsertUtilityCategoryHandler
@@ -536,6 +537,15 @@ const server = createBotWebhookServer({
         logger: getLogger('miniapp-admin')
       })
     : undefined,
+  miniAppUpdateMemberStatus: householdOnboardingService
+    ? createMiniAppUpdateMemberStatusHandler({
+        allowedOrigins: runtime.miniAppAllowedOrigins,
+        botToken: runtime.telegramBotToken,
+        onboardingService: householdOnboardingService,
+        miniAppAdminService: miniAppAdminService!,
+        logger: getLogger('miniapp-admin')
+      })
+    : undefined,
   miniAppBillingCycle: householdOnboardingService
     ? createMiniAppBillingCycleHandler({
         allowedOrigins: runtime.miniAppAllowedOrigins,

apps/bot/src/miniapp-admin.test.ts

@@ -11,6 +11,7 @@ import {
   createMiniAppPendingMembersHandler,
   createMiniAppPromoteMemberHandler,
   createMiniAppSettingsHandler,
+  createMiniAppUpdateMemberStatusHandler,
   createMiniAppUpdateSettingsHandler
 } from './miniapp-admin'
 import { buildMiniAppInitData } from './telegram-miniapp-test-helpers'
@@ -75,6 +76,7 @@ function onboardingRepository(): HouseholdConfigurationRepository {
       householdId: household.householdId,
       telegramUserId: input.telegramUserId,
       displayName: input.displayName,
+      status: input.status ?? 'active',
       preferredLocale: input.preferredLocale ?? null,
       householdDefaultLocale: household.defaultLocale,
       rentShareWeight: 1,
@@ -101,6 +103,7 @@ function onboardingRepository(): HouseholdConfigurationRepository {
             householdId: household.householdId,
             telegramUserId: '555777',
             displayName: 'Mia',
+            status: 'active',
             preferredLocale: null,
             householdDefaultLocale: household.defaultLocale,
             rentShareWeight: 1,
@@ -118,6 +121,7 @@ function onboardingRepository(): HouseholdConfigurationRepository {
             householdId: household.householdId,
             telegramUserId,
             displayName: 'Mia',
+            status: 'active',
             preferredLocale: locale,
             householdDefaultLocale: household.defaultLocale,
             rentShareWeight: 1,
@@ -162,6 +166,7 @@ function onboardingRepository(): HouseholdConfigurationRepository {
           householdId,
           telegramUserId: '123456',
           displayName: 'Stan',
+          status: 'active' as const,
           preferredLocale: null,
           householdDefaultLocale: household.defaultLocale,
           rentShareWeight: 1,
@@ -183,11 +188,26 @@ function onboardingRepository(): HouseholdConfigurationRepository {
             householdId: household.householdId,
             telegramUserId: '123456',
             displayName: 'Stan',
+            status: 'active',
             preferredLocale: null,
             householdDefaultLocale: household.defaultLocale,
             rentShareWeight,
             isAdmin: false
           }
+        : null,
+    updateHouseholdMemberStatus: async (_householdId, memberId, status) =>
+      memberId === 'member-123456'
+        ? {
+            id: memberId,
+            householdId: household.householdId,
+            telegramUserId: '123456',
+            displayName: 'Stan',
+            status,
+            preferredLocale: null,
+            householdDefaultLocale: household.defaultLocale,
+            rentShareWeight: 1,
+            isAdmin: false
+          }
         : null
   }
 }
@@ -202,6 +222,7 @@ describe('createMiniAppPendingMembersHandler', () => {
         householdId: 'household-1',
         telegramUserId: '123456',
         displayName: 'Stan',
+        status: 'active',
         preferredLocale: null,
         householdDefaultLocale: 'ru',
         rentShareWeight: 1,
@@ -265,6 +286,7 @@ describe('createMiniAppApproveMemberHandler', () => {
         householdId: 'household-1',
         telegramUserId: '123456',
         displayName: 'Stan',
+        status: 'active',
         preferredLocale: null,
         householdDefaultLocale: 'ru',
         rentShareWeight: 1,
@@ -309,6 +331,7 @@ describe('createMiniAppApproveMemberHandler', () => {
         householdId: 'household-1',
         telegramUserId: '555777',
         displayName: 'Mia',
+        status: 'active',
         preferredLocale: null,
         householdDefaultLocale: 'ru',
         rentShareWeight: 1,
@@ -328,6 +351,7 @@ describe('createMiniAppSettingsHandler', () => {
         householdId: 'household-1',
         telegramUserId: '123456',
         displayName: 'Stan',
+        status: 'active',
         preferredLocale: null,
         householdDefaultLocale: 'ru',
         rentShareWeight: 1,
@@ -340,6 +364,7 @@ describe('createMiniAppSettingsHandler', () => {
         householdId: 'household-1',
         telegramUserId: '123456',
         displayName: 'Stan',
+        status: 'active',
         preferredLocale: null,
         householdDefaultLocale: 'ru',
         rentShareWeight: 1,
@@ -405,6 +430,7 @@ describe('createMiniAppSettingsHandler', () => {
           householdId: 'household-1',
           telegramUserId: '123456',
           displayName: 'Stan',
+          status: 'active',
           preferredLocale: null,
           householdDefaultLocale: 'ru',
           rentShareWeight: 1,
@@ -425,6 +451,7 @@ describe('createMiniAppUpdateSettingsHandler', () => {
         householdId: 'household-1',
         telegramUserId: '123456',
         displayName: 'Stan',
+        status: 'active',
         preferredLocale: null,
         householdDefaultLocale: 'ru',
         rentShareWeight: 1,
@@ -495,6 +522,7 @@ describe('createMiniAppPromoteMemberHandler', () => {
         householdId: 'household-1',
         telegramUserId: '123456',
         displayName: 'Stan',
+        status: 'active',
         preferredLocale: null,
         householdDefaultLocale: 'ru',
         rentShareWeight: 1,
@@ -539,6 +567,7 @@ describe('createMiniAppPromoteMemberHandler', () => {
         householdId: 'household-1',
         telegramUserId: '123456',
         displayName: 'Stan',
+        status: 'active',
         preferredLocale: null,
         householdDefaultLocale: 'ru',
         rentShareWeight: 1,
@@ -547,3 +576,69 @@ describe('createMiniAppPromoteMemberHandler', () => {
     })
   })
 })
+
+describe('createMiniAppUpdateMemberStatusHandler', () => {
+  test('updates a household member status 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 = createMiniAppUpdateMemberStatusHandler({
+      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/status', {
+        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',
+          status: 'away'
+        })
+      })
+    )
+
+    expect(response.status).toBe(200)
+    expect(await response.json()).toEqual({
+      ok: true,
+      authorized: true,
+      member: {
+        id: 'member-123456',
+        householdId: 'household-1',
+        telegramUserId: '123456',
+        displayName: 'Stan',
+        status: 'away',
+        preferredLocale: null,
+        householdDefaultLocale: 'ru',
+        rentShareWeight: 1,
+        isAdmin: false
+      }
+    })
+  })
+})

apps/bot/src/miniapp-admin.ts

@@ -1,6 +1,10 @@
 import type { HouseholdOnboardingService, MiniAppAdminService } from '@household/application'
 import type { Logger } from '@household/observability'
-import type { HouseholdBillingSettingsRecord } from '@household/ports'
+import {
+  HOUSEHOLD_MEMBER_LIFECYCLE_STATUSES,
+  type HouseholdBillingSettingsRecord,
+  type HouseholdMemberLifecycleStatus
+} from '@household/ports'
 import type { MiniAppSessionResult } from './miniapp-auth'
 import type { AssistantUsageTracker } from './dm-assistant'
 
@@ -217,6 +221,42 @@ async function readRentWeightPayload(request: Request): Promise<{
   }
 }
 
+async function readMemberStatusPayload(request: Request): Promise<{
+  initData: string
+  memberId: string
+  status: HouseholdMemberLifecycleStatus
+}> {
+  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; status?: string }
+  try {
+    parsed = JSON.parse(text)
+  } catch {
+    throw new Error('Invalid JSON body')
+  }
+
+  const memberId = parsed.memberId?.trim()
+  const status = parsed.status?.trim().toLowerCase()
+  if (!memberId || !status) {
+    throw new Error('Missing member status fields')
+  }
+
+  if (!(HOUSEHOLD_MEMBER_LIFECYCLE_STATUSES as readonly string[]).includes(status)) {
+    throw new Error('Invalid member status')
+  }
+
+  return {
+    initData: payload.initData,
+    memberId,
+    status: status as HouseholdMemberLifecycleStatus
+  }
+}
+
 function serializeBillingSettings(settings: HouseholdBillingSettingsRecord) {
   return {
     householdId: settings.householdId,
@@ -253,7 +293,15 @@ async function authenticateAdminSession(
 
   if (!session.authorized || !session.member) {
     return miniAppJsonResponse(
-      { ok: false, error: 'Access limited to active household members' },
+      { ok: false, error: 'Admin access required for active household members' },
+      403,
+      origin
+    )
+  }
+
+  if (session.member.status !== 'active' || !session.member.isAdmin) {
+    return miniAppJsonResponse(
+      { ok: false, error: 'Admin access required for active household members' },
       403,
       origin
     )
@@ -305,9 +353,14 @@ export function createMiniAppPendingMembersHandler(options: {
           )
         }
 
-        if (!session.authorized || !session.member) {
+        if (
+          !session.authorized ||
+          !session.member ||
+          session.member.status !== 'active' ||
+          !session.member.isAdmin
+        ) {
           return miniAppJsonResponse(
-            { ok: false, error: 'Access limited to active household members' },
+            { ok: false, error: 'Admin access required for active household members' },
             403,
             origin
           )
@@ -442,9 +495,14 @@ export function createMiniAppUpdateSettingsHandler(options: {
           )
         }
 
-        if (!session.authorized || !session.member) {
+        if (
+          !session.authorized ||
+          !session.member ||
+          session.member.status !== 'active' ||
+          !session.member.isAdmin
+        ) {
           return miniAppJsonResponse(
-            { ok: false, error: 'Access limited to active household members' },
+            { ok: false, error: 'Admin access required for active household members' },
             403,
             origin
           )
@@ -545,9 +603,14 @@ export function createMiniAppUpsertUtilityCategoryHandler(options: {
           )
         }
 
-        if (!session.authorized || !session.member) {
+        if (
+          !session.authorized ||
+          !session.member ||
+          session.member.status !== 'active' ||
+          !session.member.isAdmin
+        ) {
           return miniAppJsonResponse(
-            { ok: false, error: 'Access limited to active household members' },
+            { ok: false, error: 'Admin access required for active household members' },
             403,
             origin
           )
@@ -636,9 +699,14 @@ export function createMiniAppPromoteMemberHandler(options: {
           )
         }
 
-        if (!session.authorized || !session.member) {
+        if (
+          !session.authorized ||
+          !session.member ||
+          session.member.status !== 'active' ||
+          !session.member.isAdmin
+        ) {
           return miniAppJsonResponse(
-            { ok: false, error: 'Access limited to active household members' },
+            { ok: false, error: 'Admin access required for active household members' },
             403,
             origin
           )
@@ -718,9 +786,14 @@ export function createMiniAppUpdateMemberRentWeightHandler(options: {
           )
         }
 
-        if (!session.authorized || !session.member) {
+        if (
+          !session.authorized ||
+          !session.member ||
+          session.member.status !== 'active' ||
+          !session.member.isAdmin
+        ) {
           return miniAppJsonResponse(
-            { ok: false, error: 'Access limited to active household members' },
+            { ok: false, error: 'Admin access required for active household members' },
             403,
             origin
           )
@@ -769,6 +842,87 @@ export function createMiniAppUpdateMemberRentWeightHandler(options: {
   }
 }
 
+export function createMiniAppUpdateMemberStatusHandler(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 readMemberStatusPayload(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.updateMemberStatus({
+          householdId: session.member.householdId,
+          actorIsAdmin: session.member.isAdmin,
+          memberId: payload.memberId,
+          status: payload.status
+        })
+
+        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,
+            member: result.member
+          },
+          200,
+          origin
+        )
+      } catch (error) {
+        return miniAppErrorResponse(error, origin, options.logger)
+      }
+    }
+  }
+}
+
 export function createMiniAppApproveMemberHandler(options: {
   allowedOrigins: readonly string[]
   botToken: string
@@ -809,9 +963,14 @@ export function createMiniAppApproveMemberHandler(options: {
           )
         }
 
-        if (!session.authorized || !session.member) {
+        if (
+          !session.authorized ||
+          !session.member ||
+          session.member.status !== 'active' ||
+          !session.member.isAdmin
+        ) {
           return miniAppJsonResponse(
-            { ok: false, error: 'Access limited to active household members' },
+            { ok: false, error: 'Admin access required for active household members' },
             403,
             origin
           )

apps/bot/src/miniapp-auth.test.ts

@@ -3,6 +3,7 @@ import { describe, expect, test } from 'bun:test'
 import { createHouseholdOnboardingService } from '@household/application'
 import type {
   HouseholdConfigurationRepository,
+  HouseholdMemberRecord,
   HouseholdTopicBindingRecord
 } from '@household/ports'
 
@@ -19,19 +20,7 @@ function onboardingRepository(): HouseholdConfigurationRepository {
     defaultLocale: 'ru' as const
   }
   let joinToken: string | null = 'join-token'
-  const members = new Map<
+  const members = new Map<string, HouseholdMemberRecord>()
-    string,
-    {
-      id: string
-      householdId: string
-      telegramUserId: string
-      displayName: string
-      preferredLocale: 'en' | 'ru' | null
-      householdDefaultLocale: 'en' | 'ru'
-      rentShareWeight: number
-      isAdmin: boolean
-    }
-  >()
   let pending: {
     householdId: string
     householdName: string
@@ -97,6 +86,7 @@ function onboardingRepository(): HouseholdConfigurationRepository {
         householdId: household.householdId,
         telegramUserId: input.telegramUserId,
         displayName: input.displayName,
+        status: input.status ?? 'active',
         preferredLocale: input.preferredLocale ?? null,
         householdDefaultLocale: household.defaultLocale,
         rentShareWeight: 1,
@@ -118,11 +108,12 @@ function onboardingRepository(): HouseholdConfigurationRepository {
         return null
       }
 
-      const member = {
+      const member: HouseholdMemberRecord = {
         id: `member-${pending.telegramUserId}`,
         householdId: household.householdId,
         telegramUserId: pending.telegramUserId,
         displayName: pending.displayName,
+        status: 'active',
         preferredLocale: null,
         householdDefaultLocale: household.defaultLocale,
         rentShareWeight: 1,
@@ -154,6 +145,15 @@ function onboardingRepository(): HouseholdConfigurationRepository {
           }
         : null
     },
+    updateHouseholdMemberStatus: async (_householdId, memberId, status) => {
+      const member = [...members.values()].find((entry) => entry.id === memberId)
+      return member
+        ? {
+            ...member,
+            status
+          }
+        : null
+    },
     getHouseholdBillingSettings: async (householdId) => ({
       householdId,
       settlementCurrency: 'GEL',
@@ -232,6 +232,7 @@ describe('createMiniAppAuthHandler', () => {
       authorized: true,
       member: {
         displayName: 'Stan',
+        status: 'active',
         isAdmin: true,
         preferredLocale: null,
         householdDefaultLocale: 'ru'

apps/bot/src/miniapp-auth.ts

@@ -101,6 +101,7 @@ export interface MiniAppSessionResult {
     id: string
     householdId: string
     displayName: string
+    status: 'active' | 'away' | 'left'
     isAdmin: boolean
     preferredLocale: SupportedLocale | null
     householdDefaultLocale: SupportedLocale

apps/bot/src/miniapp-billing.test.ts

@@ -71,6 +71,7 @@ function onboardingRepository(): HouseholdConfigurationRepository {
       householdId: household.householdId,
       telegramUserId: input.telegramUserId,
       displayName: input.displayName,
+      status: input.status ?? 'active',
       preferredLocale: input.preferredLocale ?? null,
       householdDefaultLocale: household.defaultLocale,
       rentShareWeight: 1,
@@ -115,6 +116,7 @@ function onboardingRepository(): HouseholdConfigurationRepository {
         householdId: 'household-1',
         telegramUserId: '123456',
         displayName: 'Stan',
+        status: 'active',
         preferredLocale: null,
         householdDefaultLocale: 'ru',
         rentShareWeight: 1,
@@ -129,7 +131,8 @@ function onboardingRepository(): HouseholdConfigurationRepository {
     }),
     updateMemberPreferredLocale: async () => null,
     promoteHouseholdAdmin: async () => null,
-    updateHouseholdMemberRentShareWeight: async () => null
+    updateHouseholdMemberRentShareWeight: async () => null,
+    updateHouseholdMemberStatus: async () => null
   }
 }
 

apps/bot/src/miniapp-dashboard.test.ts

@@ -178,6 +178,7 @@ function onboardingRepository(): HouseholdConfigurationRepository {
       householdId: household.householdId,
       telegramUserId: input.telegramUserId,
       displayName: input.displayName,
+      status: input.status ?? 'active',
       preferredLocale: input.preferredLocale ?? null,
       householdDefaultLocale: household.defaultLocale,
       rentShareWeight: 1,
@@ -225,7 +226,8 @@ function onboardingRepository(): HouseholdConfigurationRepository {
       isActive: input.isActive
     }),
     promoteHouseholdAdmin: async () => null,
-    updateHouseholdMemberRentShareWeight: async () => null
+    updateHouseholdMemberRentShareWeight: async () => null,
+    updateHouseholdMemberStatus: async () => null
   }
 }
 
@@ -252,6 +254,7 @@ describe('createMiniAppDashboardHandler', () => {
         householdId: 'household-1',
         telegramUserId: '123456',
         displayName: 'Stan',
+        status: 'active',
         preferredLocale: null,
         householdDefaultLocale: 'ru',
         rentShareWeight: 1,
@@ -354,6 +357,7 @@ describe('createMiniAppDashboardHandler', () => {
         householdId: 'household-1',
         telegramUserId: '123456',
         displayName: 'Stan',
+        status: 'active',
         preferredLocale: null,
         householdDefaultLocale: 'ru',
         rentShareWeight: 1,

apps/bot/src/miniapp-locale.test.ts

@@ -31,6 +31,7 @@ function repository(): HouseholdConfigurationRepository {
         householdId: household.householdId,
         telegramUserId: '123456',
         displayName: 'Stan',
+        status: 'active',
         preferredLocale: null,
         householdDefaultLocale: household.defaultLocale,
         rentShareWeight: 1,
@@ -44,6 +45,7 @@ function repository(): HouseholdConfigurationRepository {
         householdId: household.householdId,
         telegramUserId: '222222',
         displayName: 'Mia',
+        status: 'active',
         preferredLocale: null,
         householdDefaultLocale: household.defaultLocale,
         rentShareWeight: 1,
@@ -93,6 +95,7 @@ function repository(): HouseholdConfigurationRepository {
         householdId: input.householdId,
         telegramUserId: input.telegramUserId,
         displayName: input.displayName,
+        status: input.status ?? 'active',
         preferredLocale: input.preferredLocale ?? null,
         householdDefaultLocale: household.defaultLocale,
         rentShareWeight: 1,
@@ -161,7 +164,8 @@ function repository(): HouseholdConfigurationRepository {
       isActive: input.isActive
     }),
     promoteHouseholdAdmin: async () => null,
-    updateHouseholdMemberRentShareWeight: async () => null
+    updateHouseholdMemberRentShareWeight: async () => null,
+    updateHouseholdMemberStatus: async () => null
   }
 }
 

apps/bot/src/server.test.ts

@@ -82,6 +82,15 @@ describe('createBotWebhookServer', () => {
           }
         })
     },
+    miniAppUpdateMemberStatus: {
+      handler: async () =>
+        new Response(JSON.stringify({ ok: true, authorized: true, member: {} }), {
+          status: 200,
+          headers: {
+            'content-type': 'application/json; charset=utf-8'
+          }
+        })
+    },
     miniAppBillingCycle: {
       handler: async () =>
         new Response(JSON.stringify({ ok: true, authorized: true, cycleState: {} }), {
@@ -347,6 +356,22 @@ describe('createBotWebhookServer', () => {
     })
   })
 
+  test('accepts mini app member status update request', async () => {
+    const response = await server.fetch(
+      new Request('http://localhost/api/miniapp/admin/members/status', {
+        method: 'POST',
+        body: JSON.stringify({ initData: 'payload' })
+      })
+    )
+
+    expect(response.status).toBe(200)
+    expect(await response.json()).toEqual({
+      ok: true,
+      authorized: true,
+      member: {}
+    })
+  })
+
   test('accepts mini app billing cycle request', async () => {
     const response = await server.fetch(
       new Request('http://localhost/api/miniapp/admin/billing-cycle', {

apps/bot/src/server.ts

@@ -62,6 +62,12 @@ export interface BotWebhookServerOptions {
         handler: (request: Request) => Promise<Response>
       }
     | undefined
+  miniAppUpdateMemberStatus?:
+    | {
+        path?: string
+        handler: (request: Request) => Promise<Response>
+      }
+    | undefined
   miniAppBillingCycle?:
     | {
         path?: string
@@ -186,6 +192,8 @@ export function createBotWebhookServer(options: BotWebhookServerOptions): {
     options.miniAppPromoteMember?.path ?? '/api/miniapp/admin/members/promote'
   const miniAppUpdateMemberRentWeightPath =
     options.miniAppUpdateMemberRentWeight?.path ?? '/api/miniapp/admin/members/rent-weight'
+  const miniAppUpdateMemberStatusPath =
+    options.miniAppUpdateMemberStatus?.path ?? '/api/miniapp/admin/members/status'
   const miniAppBillingCyclePath =
     options.miniAppBillingCycle?.path ?? '/api/miniapp/admin/billing-cycle'
   const miniAppOpenCyclePath =
@@ -268,6 +276,10 @@ export function createBotWebhookServer(options: BotWebhookServerOptions): {
         return await options.miniAppUpdateMemberRentWeight.handler(request)
       }
 
+      if (options.miniAppUpdateMemberStatus && url.pathname === miniAppUpdateMemberStatusPath) {
+        return await options.miniAppUpdateMemberStatus.handler(request)
+      }
+
       if (options.miniAppBillingCycle && url.pathname === miniAppBillingCyclePath) {
         return await options.miniAppBillingCycle.handler(request)
       }

apps/miniapp/src/App.tsx

@@ -17,6 +17,7 @@ import {
   joinMiniAppHousehold,
   openMiniAppBillingCycle,
   promoteMiniAppMember,
+  updateMiniAppMemberStatus,
   updateMiniAppMemberRentWeight,
   type MiniAppAdminCycleState,
   type MiniAppAdminSettingsPayload,
@@ -56,6 +57,7 @@ type SessionState =
       member: {
         id: string
         displayName: string
+        status: 'active' | 'away' | 'left'
         isAdmin: boolean
         preferredLocale: Locale | null
         householdDefaultLocale: Locale
@@ -95,6 +97,7 @@ const demoSession: Extract<SessionState, { status: 'ready' }> = {
   member: {
     id: 'demo-member',
     displayName: 'Demo Resident',
+    status: 'active',
     isAdmin: false,
     preferredLocale: 'en',
     householdDefaultLocale: 'en'
@@ -278,7 +281,11 @@ function App() {
   const [approvingTelegramUserId, setApprovingTelegramUserId] = createSignal<string | null>(null)
   const [promotingMemberId, setPromotingMemberId] = createSignal<string | null>(null)
   const [savingRentWeightMemberId, setSavingRentWeightMemberId] = createSignal<string | null>(null)
+  const [savingMemberStatusId, setSavingMemberStatusId] = createSignal<string | null>(null)
   const [rentWeightDrafts, setRentWeightDrafts] = createSignal<Record<string, string>>({})
+  const [memberStatusDrafts, setMemberStatusDrafts] = createSignal<
+    Record<string, 'active' | 'away' | 'left'>
+  >({})
   const [savingMemberLocale, setSavingMemberLocale] = createSignal(false)
   const [savingHouseholdLocale, setSavingHouseholdLocale] = createSignal(false)
   const [savingBillingSettings, setSavingBillingSettings] = createSignal(false)
@@ -382,6 +389,17 @@ function App() {
     }
   }
 
+  function memberStatusLabel(status: 'active' | 'away' | 'left'): string {
+    switch (status) {
+      case 'active':
+        return copy().memberStatusActive
+      case 'away':
+        return copy().memberStatusAway
+      case 'left':
+        return copy().memberStatusLeft
+    }
+  }
+
   async function loadDashboard(initData: string) {
     try {
       const nextDashboard = await fetchMiniAppDashboard(initData)
@@ -420,6 +438,9 @@ function App() {
           payload.members.map((member) => [member.id, String(member.rentShareWeight)])
         )
       )
+      setMemberStatusDrafts(
+        Object.fromEntries(payload.members.map((member) => [member.id, member.status]))
+      )
       setCycleForm((current) => ({
         ...current,
         rentCurrency: payload.settings.rentCurrency,
@@ -1231,6 +1252,35 @@ function App() {
     }
   }
 
+  async function handleSaveMemberStatus(memberId: string) {
+    const initData = webApp?.initData?.trim()
+    const currentReady = readySession()
+    const nextStatus = memberStatusDrafts()[memberId]
+    if (!initData || currentReady?.mode !== 'live' || !currentReady.member.isAdmin || !nextStatus) {
+      return
+    }
+
+    setSavingMemberStatusId(memberId)
+
+    try {
+      const member = await updateMiniAppMemberStatus(initData, memberId, nextStatus)
+      setAdminSettings((current) =>
+        current
+          ? {
+              ...current,
+              members: current.members.map((item) => (item.id === member.id ? member : item))
+            }
+          : current
+      )
+      setMemberStatusDrafts((current) => ({
+        ...current,
+        [member.id]: member.status
+      }))
+    } finally {
+      setSavingMemberStatusId(null)
+    }
+  }
+
   const renderPanel = () => {
     switch (activeNav()) {
       case 'balances':
@@ -2372,9 +2422,31 @@ function App() {
                         <article class="utility-bill-row">
                           <header>
                             <strong>{member.displayName}</strong>
-                            <span>{member.isAdmin ? copy().adminTag : copy().residentTag}</span>
+                            <span>
+                              {member.isAdmin ? copy().adminTag : copy().residentTag}
+                              {` · ${memberStatusLabel(member.status)}`}
+                            </span>
                           </header>
                           <div class="settings-grid">
+                            <label class="settings-field settings-field--wide">
+                              <span>{copy().memberStatusLabel}</span>
+                              <select
+                                value={memberStatusDrafts()[member.id] ?? member.status}
+                                onChange={(event) =>
+                                  setMemberStatusDrafts((current) => ({
+                                    ...current,
+                                    [member.id]: event.currentTarget.value as
+                                      | 'active'
+                                      | 'away'
+                                      | 'left'
+                                  }))
+                                }
+                              >
+                                <option value="active">{copy().memberStatusActive}</option>
+                                <option value="away">{copy().memberStatusAway}</option>
+                                <option value="left">{copy().memberStatusLeft}</option>
+                              </select>
+                            </label>
                             <label class="settings-field settings-field--wide">
                               <span>{copy().rentWeightLabel}</span>
                               <input
@@ -2392,6 +2464,16 @@ function App() {
                             </label>
                           </div>
                           <div class="inline-actions">
+                            <button
+                              class="ghost-button"
+                              type="button"
+                              disabled={savingMemberStatusId() === member.id}
+                              onClick={() => void handleSaveMemberStatus(member.id)}
+                            >
+                              {savingMemberStatusId() === member.id
+                                ? copy().savingMemberStatus
+                                : copy().saveMemberStatusAction}
+                            </button>
                             <button
                               class="ghost-button"
                               type="button"
@@ -2770,6 +2852,11 @@ function App() {
               <span class="pill pill--muted">
                 {readySession()?.member.isAdmin ? copy().adminTag : copy().residentTag}
               </span>
+              <span class="pill pill--muted">
+                {readySession()?.member.status
+                  ? memberStatusLabel(readySession()!.member.status)
+                  : copy().memberStatusActive}
+              </span>
             </div>
 
             <h2>
@@ -2802,6 +2889,14 @@ function App() {
             <article class="panel panel--wide">
               <p class="eyebrow">{copy().overviewTitle}</p>
               <h3>{readySession()?.member.displayName}</h3>
+              <p>
+                {copy().memberStatusSummary.replace(
+                  '{status}',
+                  readySession()?.member.status
+                    ? memberStatusLabel(readySession()!.member.status)
+                    : copy().memberStatusActive
+                )}
+              </p>
               <div>{renderPanel()}</div>
             </article>
           </section>

apps/miniapp/src/i18n.ts

@@ -138,6 +138,13 @@ export const dictionary = {
     savingCategory: 'Saving…',
     adminsTitle: 'Admins',
     adminsBody: 'Promote trusted household members so they can manage billing and approvals.',
+    memberStatusLabel: 'Member status',
+    saveMemberStatusAction: 'Save status',
+    savingMemberStatus: 'Saving status…',
+    memberStatusActive: 'Active',
+    memberStatusAway: 'Away',
+    memberStatusLeft: 'Left',
+    memberStatusSummary: 'Your household status: {status}.',
     rentWeightLabel: 'Rent weight',
     saveRentWeightAction: 'Save rent weight',
     savingRentWeight: 'Saving weight…',
@@ -296,6 +303,13 @@ export const dictionary = {
     adminsTitle: 'Админы',
     adminsBody:
       'Повышай доверенных участников, чтобы они могли управлять биллингом и подтверждениями.',
+    memberStatusLabel: 'Статус участника',
+    saveMemberStatusAction: 'Сохранить статус',
+    savingMemberStatus: 'Сохраняем статус…',
+    memberStatusActive: 'Активный',
+    memberStatusAway: 'В отъезде',
+    memberStatusLeft: 'Выехал',
+    memberStatusSummary: 'Твой статус в household: {status}.',
     rentWeightLabel: 'Вес аренды',
     saveRentWeightAction: 'Сохранить вес аренды',
     savingRentWeight: 'Сохраняем вес…',

apps/miniapp/src/miniapp-api.ts

@@ -6,6 +6,7 @@ export interface MiniAppSession {
     id: string
     householdId: string
     displayName: string
+    status: 'active' | 'away' | 'left'
     isAdmin: boolean
     preferredLocale: 'en' | 'ru' | null
     householdDefaultLocale: 'en' | 'ru'
@@ -39,6 +40,7 @@ export interface MiniAppPendingMember {
 export interface MiniAppMember {
   id: string
   displayName: string
+  status: 'active' | 'away' | 'left'
   rentShareWeight: number
   isAdmin: boolean
 }
@@ -514,6 +516,37 @@ export async function updateMiniAppMemberRentWeight(
   return payload.member
 }
 
+export async function updateMiniAppMemberStatus(
+  initData: string,
+  memberId: string,
+  status: 'active' | 'away' | 'left'
+): Promise<MiniAppMember> {
+  const response = await fetch(`${apiBaseUrl()}/api/miniapp/admin/members/status`, {
+    method: 'POST',
+    headers: {
+      'content-type': 'application/json'
+    },
+    body: JSON.stringify({
+      initData,
+      memberId,
+      status
+    })
+  })
+
+  const payload = (await response.json()) as {
+    ok: boolean
+    authorized?: boolean
+    member?: MiniAppMember
+    error?: string
+  }
+
+  if (!response.ok || !payload.member) {
+    throw new Error(payload.error ?? 'Failed to update member status')
+  }
+
+  return payload.member
+}
+
 export async function fetchMiniAppBillingCycle(initData: string): Promise<MiniAppAdminCycleState> {
   const response = await fetch(`${apiBaseUrl()}/api/miniapp/admin/billing-cycle`, {
     method: 'POST',

packages/adapters-db/src/household-config-repository.ts

@@ -8,10 +8,12 @@ import {
   type CurrencyCode
 } from '@household/domain'
 import {
+  HOUSEHOLD_MEMBER_LIFECYCLE_STATUSES,
   HOUSEHOLD_TOPIC_ROLES,
   type HouseholdBillingSettingsRecord,
   type HouseholdConfigurationRepository,
   type HouseholdJoinTokenRecord,
+  type HouseholdMemberLifecycleStatus,
   type HouseholdMemberRecord,
   type HouseholdPendingMemberRecord,
   type HouseholdTelegramChatRecord,
@@ -32,6 +34,16 @@ function normalizeTopicRole(role: string): HouseholdTopicRole {
   throw new Error(`Unsupported household topic role: ${role}`)
 }
 
+function normalizeMemberLifecycleStatus(raw: string): HouseholdMemberLifecycleStatus {
+  const normalized = raw.trim().toLowerCase()
+
+  if ((HOUSEHOLD_MEMBER_LIFECYCLE_STATUSES as readonly string[]).includes(normalized)) {
+    return normalized as HouseholdMemberLifecycleStatus
+  }
+
+  throw new Error(`Unsupported household member lifecycle status: ${raw}`)
+}
+
 function toHouseholdTelegramChatRecord(row: {
   householdId: string
   householdName: string
@@ -113,6 +125,7 @@ function toHouseholdMemberRecord(row: {
   householdId: string
   telegramUserId: string
   displayName: string
+  lifecycleStatus: string
   preferredLocale: string | null
   defaultLocale: string
   rentShareWeight: number
@@ -128,6 +141,7 @@ function toHouseholdMemberRecord(row: {
     householdId: row.householdId,
     telegramUserId: row.telegramUserId,
     displayName: row.displayName,
+    status: normalizeMemberLifecycleStatus(row.lifecycleStatus),
     preferredLocale: normalizeSupportedLocale(row.preferredLocale),
     householdDefaultLocale,
     rentShareWeight: row.rentShareWeight,
@@ -775,6 +789,7 @@ export function createDbHouseholdConfigurationRepository(databaseUrl: string): {
           householdId: input.householdId,
           telegramUserId: input.telegramUserId,
           displayName: input.displayName,
+          lifecycleStatus: input.status ?? 'active',
           preferredLocale: input.preferredLocale ?? null,
           rentShareWeight: input.rentShareWeight ?? 1,
           isAdmin: input.isAdmin ? 1 : 0
@@ -783,6 +798,7 @@ export function createDbHouseholdConfigurationRepository(databaseUrl: string): {
           target: [schema.members.householdId, schema.members.telegramUserId],
           set: {
             displayName: input.displayName,
+            lifecycleStatus: input.status ?? schema.members.lifecycleStatus,
             preferredLocale: input.preferredLocale ?? schema.members.preferredLocale,
             rentShareWeight: input.rentShareWeight ?? schema.members.rentShareWeight,
             ...(input.isAdmin
@@ -797,6 +813,7 @@ export function createDbHouseholdConfigurationRepository(databaseUrl: string): {
           householdId: schema.members.householdId,
           telegramUserId: schema.members.telegramUserId,
           displayName: schema.members.displayName,
+          lifecycleStatus: schema.members.lifecycleStatus,
           preferredLocale: schema.members.preferredLocale,
           rentShareWeight: schema.members.rentShareWeight,
           isAdmin: schema.members.isAdmin
@@ -825,6 +842,7 @@ export function createDbHouseholdConfigurationRepository(databaseUrl: string): {
           householdId: schema.members.householdId,
           telegramUserId: schema.members.telegramUserId,
           displayName: schema.members.displayName,
+          lifecycleStatus: schema.members.lifecycleStatus,
           preferredLocale: schema.members.preferredLocale,
           rentShareWeight: schema.members.rentShareWeight,
           defaultLocale: schema.households.defaultLocale,
@@ -851,6 +869,7 @@ export function createDbHouseholdConfigurationRepository(databaseUrl: string): {
           householdId: schema.members.householdId,
           telegramUserId: schema.members.telegramUserId,
           displayName: schema.members.displayName,
+          lifecycleStatus: schema.members.lifecycleStatus,
           preferredLocale: schema.members.preferredLocale,
           rentShareWeight: schema.members.rentShareWeight,
           defaultLocale: schema.households.defaultLocale,
@@ -1033,6 +1052,7 @@ export function createDbHouseholdConfigurationRepository(databaseUrl: string): {
           householdId: schema.members.householdId,
           telegramUserId: schema.members.telegramUserId,
           displayName: schema.members.displayName,
+          lifecycleStatus: schema.members.lifecycleStatus,
           preferredLocale: schema.members.preferredLocale,
           rentShareWeight: schema.members.rentShareWeight,
           defaultLocale: schema.households.defaultLocale,
@@ -1104,6 +1124,7 @@ export function createDbHouseholdConfigurationRepository(databaseUrl: string): {
             householdId: pending.householdId,
             telegramUserId: pending.telegramUserId,
             displayName: pending.displayName,
+            lifecycleStatus: 'active',
             preferredLocale: normalizeSupportedLocale(pending.languageCode),
             rentShareWeight: 1,
             isAdmin: input.isAdmin ? 1 : 0
@@ -1112,6 +1133,7 @@ export function createDbHouseholdConfigurationRepository(databaseUrl: string): {
             target: [schema.members.householdId, schema.members.telegramUserId],
             set: {
               displayName: pending.displayName,
+              lifecycleStatus: 'active',
               preferredLocale:
                 normalizeSupportedLocale(pending.languageCode) ?? schema.members.preferredLocale,
               ...(input.isAdmin
@@ -1126,6 +1148,7 @@ export function createDbHouseholdConfigurationRepository(databaseUrl: string): {
             householdId: schema.members.householdId,
             telegramUserId: schema.members.telegramUserId,
             displayName: schema.members.displayName,
+            lifecycleStatus: schema.members.lifecycleStatus,
             preferredLocale: schema.members.preferredLocale,
             rentShareWeight: schema.members.rentShareWeight,
             isAdmin: schema.members.isAdmin
@@ -1198,6 +1221,7 @@ export function createDbHouseholdConfigurationRepository(databaseUrl: string): {
           householdId: schema.members.householdId,
           telegramUserId: schema.members.telegramUserId,
           displayName: schema.members.displayName,
+          lifecycleStatus: schema.members.lifecycleStatus,
           preferredLocale: schema.members.preferredLocale,
           rentShareWeight: schema.members.rentShareWeight,
           isAdmin: schema.members.isAdmin
@@ -1231,6 +1255,7 @@ export function createDbHouseholdConfigurationRepository(databaseUrl: string): {
           householdId: schema.members.householdId,
           telegramUserId: schema.members.telegramUserId,
           displayName: schema.members.displayName,
+          lifecycleStatus: schema.members.lifecycleStatus,
           preferredLocale: schema.members.preferredLocale,
           rentShareWeight: schema.members.rentShareWeight,
           isAdmin: schema.members.isAdmin
@@ -1264,6 +1289,7 @@ export function createDbHouseholdConfigurationRepository(databaseUrl: string): {
           householdId: schema.members.householdId,
           telegramUserId: schema.members.telegramUserId,
           displayName: schema.members.displayName,
+          lifecycleStatus: schema.members.lifecycleStatus,
           preferredLocale: schema.members.preferredLocale,
           rentShareWeight: schema.members.rentShareWeight,
           isAdmin: schema.members.isAdmin
@@ -1279,6 +1305,40 @@ export function createDbHouseholdConfigurationRepository(databaseUrl: string): {
         throw new Error('Failed to resolve household chat after rent weight update')
       }
 
+      return toHouseholdMemberRecord({
+        ...row,
+        defaultLocale: household.defaultLocale
+      })
+    },
+
+    async updateHouseholdMemberStatus(householdId, memberId, status) {
+      const rows = await db
+        .update(schema.members)
+        .set({
+          lifecycleStatus: status
+        })
+        .where(and(eq(schema.members.householdId, householdId), eq(schema.members.id, memberId)))
+        .returning({
+          id: schema.members.id,
+          householdId: schema.members.householdId,
+          telegramUserId: schema.members.telegramUserId,
+          displayName: schema.members.displayName,
+          lifecycleStatus: schema.members.lifecycleStatus,
+          preferredLocale: schema.members.preferredLocale,
+          rentShareWeight: schema.members.rentShareWeight,
+          isAdmin: schema.members.isAdmin
+        })
+
+      const row = rows[0]
+      if (!row) {
+        return null
+      }
+
+      const household = await this.getHouseholdChatByHouseholdId(householdId)
+      if (!household) {
+        throw new Error('Failed to resolve household chat after member status update')
+      }
+
       return toHouseholdMemberRecord({
         ...row,
         defaultLocale: household.defaultLocale

packages/application/src/household-admin-service.test.ts

@@ -28,6 +28,7 @@ function createRepositoryStub() {
     householdId: household.householdId,
     telegramUserId: '1',
     displayName: 'Stan',
+    status: 'active',
     preferredLocale: null,
     householdDefaultLocale: household.defaultLocale,
     rentShareWeight: 1,
@@ -94,6 +95,7 @@ function createRepositoryStub() {
         householdId: input.householdId,
         telegramUserId: input.telegramUserId,
         displayName: input.displayName,
+        status: input.status ?? 'active',
         preferredLocale: input.preferredLocale ?? null,
         householdDefaultLocale: household.defaultLocale,
         rentShareWeight: 1,
@@ -121,6 +123,7 @@ function createRepositoryStub() {
         householdId: pending.householdId,
         telegramUserId: pending.telegramUserId,
         displayName: pending.displayName,
+        status: 'active',
         preferredLocale: null,
         householdDefaultLocale: household.defaultLocale,
         rentShareWeight: 1,
@@ -174,7 +177,8 @@ function createRepositoryStub() {
       isActive: input.isActive
     }),
     promoteHouseholdAdmin: async () => null,
-    updateHouseholdMemberRentShareWeight: async () => null
+    updateHouseholdMemberRentShareWeight: async () => null,
+    updateHouseholdMemberStatus: async () => null
   }
 
   return {
@@ -243,6 +247,7 @@ describe('createHouseholdAdminService', () => {
         householdId: 'household-1',
         telegramUserId: '2',
         displayName: 'Alice',
+        status: 'active',
         preferredLocale: null,
         householdDefaultLocale: 'ru',
         rentShareWeight: 1,

packages/application/src/household-onboarding-service.test.ts

@@ -99,6 +99,7 @@ function createRepositoryStub() {
         householdId: input.householdId,
         telegramUserId: input.telegramUserId,
         displayName: input.displayName,
+        status: input.status ?? 'active',
         preferredLocale: input.preferredLocale ?? null,
         householdDefaultLocale: household.defaultLocale,
         rentShareWeight: 1,
@@ -133,6 +134,7 @@ function createRepositoryStub() {
         householdId: pending.householdId,
         telegramUserId: pending.telegramUserId,
         displayName: pending.displayName,
+        status: 'active',
         preferredLocale: null,
         householdDefaultLocale: household.defaultLocale,
         rentShareWeight: 1,
@@ -198,6 +200,9 @@ function createRepositoryStub() {
     },
     async updateHouseholdMemberRentShareWeight() {
       return null
+    },
+    async updateHouseholdMemberStatus() {
+      return null
     }
   }
 
@@ -325,6 +330,7 @@ describe('createHouseholdOnboardingService', () => {
         id: 'member-42',
         householdId: 'household-1',
         displayName: 'Stan',
+        status: 'active',
         preferredLocale: null,
         householdDefaultLocale: 'ru',
         rentShareWeight: 1,
@@ -340,6 +346,7 @@ describe('createHouseholdOnboardingService', () => {
       householdId: 'household-1',
       telegramUserId: '42',
       displayName: 'Stan',
+      status: 'active',
       preferredLocale: null,
       householdDefaultLocale: 'ru',
       rentShareWeight: 1,
@@ -358,6 +365,7 @@ describe('createHouseholdOnboardingService', () => {
         householdId: 'household-2',
         telegramUserId: '42',
         displayName: 'Stan elsewhere',
+        status: 'active',
         preferredLocale: null,
         householdDefaultLocale: 'ru',
         rentShareWeight: 1,

packages/application/src/household-onboarding-service.ts

@@ -17,6 +17,7 @@ export type HouseholdMiniAppAccess =
         id: string
         householdId: string
         displayName: string
+        status: HouseholdMemberRecord['status']
         isAdmin: boolean
         preferredLocale: SupportedLocale | null
         householdDefaultLocale: SupportedLocale
@@ -68,6 +69,7 @@ export interface HouseholdOnboardingService {
           id: string
           householdId: string
           displayName: string
+          status: HouseholdMemberRecord['status']
           isAdmin: boolean
           preferredLocale: SupportedLocale | null
           householdDefaultLocale: SupportedLocale
@@ -84,6 +86,7 @@ function toMember(member: HouseholdMemberRecord): {
   id: string
   householdId: string
   displayName: string
+  status: HouseholdMemberRecord['status']
   isAdmin: boolean
   preferredLocale: SupportedLocale | null
   householdDefaultLocale: SupportedLocale
@@ -93,6 +96,7 @@ function toMember(member: HouseholdMemberRecord): {
     id: member.id,
     householdId: member.householdId,
     displayName: member.displayName,
+    status: member.status,
     isAdmin: member.isAdmin,
     preferredLocale: member.preferredLocale,
     householdDefaultLocale: member.householdDefaultLocale,

packages/application/src/household-setup-service.test.ts

@@ -174,6 +174,7 @@ function createRepositoryStub() {
         householdId: input.householdId,
         telegramUserId: input.telegramUserId,
         displayName: input.displayName,
+        status: input.status ?? existing?.status ?? 'active',
         preferredLocale: input.preferredLocale ?? existing?.preferredLocale ?? null,
         householdDefaultLocale:
           [...households.values()].find((household) => household.householdId === input.householdId)
@@ -215,6 +216,7 @@ function createRepositoryStub() {
         householdId: pending.householdId,
         telegramUserId: pending.telegramUserId,
         displayName: pending.displayName,
+        status: 'active',
         preferredLocale: null,
         householdDefaultLocale:
           [...households.values()].find(
@@ -319,6 +321,22 @@ function createRepositoryStub() {
       }
       members.set(`${householdId}:${member.telegramUserId}`, next)
       return next
+    },
+
+    async updateHouseholdMemberStatus(householdId, memberId, status) {
+      const member = [...members.values()].find(
+        (entry) => entry.householdId === householdId && entry.id === memberId
+      )
+      if (!member) {
+        return null
+      }
+
+      const next = {
+        ...member,
+        status
+      }
+      members.set(`${householdId}:${member.telegramUserId}`, next)
+      return next
     }
   }
 
@@ -353,6 +371,7 @@ describe('createHouseholdSetupService', () => {
       householdId: result.household.householdId,
       telegramUserId: '42',
       displayName: 'Stan',
+      status: 'active',
       preferredLocale: null,
       householdDefaultLocale: 'ru',
       rentShareWeight: 1,
@@ -391,6 +410,7 @@ describe('createHouseholdSetupService', () => {
       householdId: result.household.householdId,
       telegramUserId: '77',
       displayName: 'Mia',
+      status: 'active',
       preferredLocale: null,
       householdDefaultLocale: 'ru',
       rentShareWeight: 1,

packages/application/src/locale-preference-service.test.ts

@@ -19,6 +19,7 @@ function createRepository(): HouseholdConfigurationRepository {
     householdId: 'household-1',
     telegramUserId: '123456',
     displayName: 'Stan',
+    status: 'active',
     preferredLocale: null,
     householdDefaultLocale: 'ru',
     rentShareWeight: 1,
@@ -109,7 +110,8 @@ function createRepository(): HouseholdConfigurationRepository {
       isActive: input.isActive
     }),
     promoteHouseholdAdmin: async () => null,
-    updateHouseholdMemberRentShareWeight: async () => null
+    updateHouseholdMemberRentShareWeight: async () => null,
+    updateHouseholdMemberStatus: async () => null
   }
 }
 

packages/application/src/miniapp-admin-service.test.ts

@@ -61,6 +61,7 @@ function repository(): HouseholdConfigurationRepository {
       householdId: input.householdId,
       telegramUserId: input.telegramUserId,
       displayName: input.displayName,
+      status: input.status ?? 'active',
       preferredLocale: input.preferredLocale ?? null,
       householdDefaultLocale: 'ru',
       rentShareWeight: 1,
@@ -87,6 +88,7 @@ function repository(): HouseholdConfigurationRepository {
             householdId: input.householdId,
             telegramUserId: input.telegramUserId,
             displayName: 'Stan',
+            status: 'active',
             preferredLocale: null,
             householdDefaultLocale: 'ru',
             rentShareWeight: 1,
@@ -108,6 +110,7 @@ function repository(): HouseholdConfigurationRepository {
             householdId: 'household-1',
             telegramUserId,
             displayName: 'Stan',
+            status: 'active',
             preferredLocale: locale,
             householdDefaultLocale: 'ru',
             rentShareWeight: 1,
@@ -152,6 +155,7 @@ function repository(): HouseholdConfigurationRepository {
             householdId,
             telegramUserId: '123456',
             displayName: 'Stan',
+            status: 'active',
             preferredLocale: null,
             householdDefaultLocale: 'ru',
             rentShareWeight: 1,
@@ -165,11 +169,26 @@ function repository(): HouseholdConfigurationRepository {
             householdId: 'household-1',
             telegramUserId: '123456',
             displayName: 'Stan',
+            status: 'active',
             preferredLocale: null,
             householdDefaultLocale: 'ru',
             rentShareWeight,
             isAdmin: false
           }
+        : null,
+    updateHouseholdMemberStatus: async (_householdId, memberId, status) =>
+      memberId === 'member-123456'
+        ? {
+            id: memberId,
+            householdId: 'household-1',
+            telegramUserId: '123456',
+            displayName: 'Stan',
+            status,
+            preferredLocale: null,
+            householdDefaultLocale: 'ru',
+            rentShareWeight: 1,
+            isAdmin: false
+          }
         : null
   }
 }
@@ -318,6 +337,7 @@ describe('createMiniAppAdminService', () => {
         householdId: 'household-1',
         telegramUserId: '123456',
         displayName: 'Stan',
+        status: 'active',
         preferredLocale: null,
         householdDefaultLocale: 'ru',
         rentShareWeight: 1,
@@ -342,6 +362,7 @@ describe('createMiniAppAdminService', () => {
         householdId: 'household-1',
         telegramUserId: '123456',
         displayName: 'Stan',
+        status: 'active',
         preferredLocale: null,
         householdDefaultLocale: 'ru',
         rentShareWeight: 1,
@@ -349,4 +370,30 @@ describe('createMiniAppAdminService', () => {
       }
     })
   })
+
+  test('updates a household member lifecycle status for admins', async () => {
+    const service = createMiniAppAdminService(repository())
+
+    const result = await service.updateMemberStatus({
+      householdId: 'household-1',
+      actorIsAdmin: true,
+      memberId: 'member-123456',
+      status: 'away'
+    })
+
+    expect(result).toEqual({
+      status: 'ok',
+      member: {
+        id: 'member-123456',
+        householdId: 'household-1',
+        telegramUserId: '123456',
+        displayName: 'Stan',
+        status: 'away',
+        preferredLocale: null,
+        householdDefaultLocale: 'ru',
+        rentShareWeight: 1,
+        isAdmin: false
+      }
+    })
+  })
 })

packages/application/src/miniapp-admin-service.ts

@@ -1,6 +1,7 @@
 import type {
   HouseholdBillingSettingsRecord,
   HouseholdConfigurationRepository,
+  HouseholdMemberLifecycleStatus,
   HouseholdMemberRecord,
   HouseholdPendingMemberRecord,
   HouseholdTopicBindingRecord,
@@ -126,6 +127,21 @@ export interface MiniAppAdminService {
         reason: 'not_admin' | 'invalid_weight' | 'member_not_found'
       }
   >
+  updateMemberStatus(input: {
+    householdId: string
+    actorIsAdmin: boolean
+    memberId: string
+    status: HouseholdMemberLifecycleStatus
+  }): Promise<
+    | {
+        status: 'ok'
+        member: HouseholdMemberRecord
+      }
+    | {
+        status: 'rejected'
+        reason: 'not_admin' | 'member_not_found'
+      }
+  >
 }
 
 export function createMiniAppAdminService(
@@ -349,6 +365,32 @@ export function createMiniAppAdminService(
         }
       }
 
+      return {
+        status: 'ok',
+        member
+      }
+    },
+
+    async updateMemberStatus(input) {
+      if (!input.actorIsAdmin) {
+        return {
+          status: 'rejected',
+          reason: 'not_admin'
+        }
+      }
+
+      const member = await repository.updateHouseholdMemberStatus(
+        input.householdId,
+        input.memberId,
+        input.status
+      )
+      if (!member) {
+        return {
+          status: 'rejected',
+          reason: 'member_not_found'
+        }
+      }
+
       return {
         status: 'ok',
         member

packages/db/drizzle/0014_empty_risque.sql

@@ -0,0 +1 @@
+ALTER TABLE "members" ADD COLUMN "lifecycle_status" text DEFAULT 'active' NOT NULL;

packages/db/drizzle/meta/_journal.json

@@ -99,6 +99,13 @@
       "when": 1773147481265,
       "tag": "0013_wild_avengers",
       "breakpoints": true
+    },
+    {
+      "idx": 14,
+      "version": "7",
+      "when": 1773222186943,
+      "tag": "0014_empty_risque",
+      "breakpoints": true
     }
   ]
 }

packages/db/src/schema.ts

@@ -194,6 +194,7 @@ export const members = pgTable(
       .references(() => households.id, { onDelete: 'cascade' }),
     telegramUserId: text('telegram_user_id').notNull(),
     displayName: text('display_name').notNull(),
+    lifecycleStatus: text('lifecycle_status').default('active').notNull(),
     preferredLocale: text('preferred_locale'),
     rentShareWeight: integer('rent_share_weight').default(1).notNull(),
     isAdmin: integer('is_admin').default(0).notNull(),

packages/ports/src/household-config.ts

@@ -2,8 +2,10 @@ import type { CurrencyCode, SupportedLocale } from '@household/domain'
 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 type HouseholdTopicRole = (typeof HOUSEHOLD_TOPIC_ROLES)[number]
+export type HouseholdMemberLifecycleStatus = (typeof HOUSEHOLD_MEMBER_LIFECYCLE_STATUSES)[number]
 
 export interface HouseholdTelegramChatRecord {
   householdId: string
@@ -43,6 +45,7 @@ export interface HouseholdMemberRecord {
   householdId: string
   telegramUserId: string
   displayName: string
+  status: HouseholdMemberLifecycleStatus
   preferredLocale: SupportedLocale | null
   householdDefaultLocale: SupportedLocale
   rentShareWeight: number
@@ -130,6 +133,7 @@ export interface HouseholdConfigurationRepository {
     householdId: string
     telegramUserId: string
     displayName: string
+    status?: HouseholdMemberLifecycleStatus
     preferredLocale?: SupportedLocale | null
     rentShareWeight?: number
     isAdmin?: boolean
@@ -188,4 +192,9 @@ export interface HouseholdConfigurationRepository {
     memberId: string,
     rentShareWeight: number
   ): Promise<HouseholdMemberRecord | null>
+  updateHouseholdMemberStatus(
+    householdId: string,
+    memberId: string,
+    status: HouseholdMemberLifecycleStatus
+  ): Promise<HouseholdMemberRecord | null>
 }

packages/ports/src/index.ts

@@ -13,10 +13,12 @@ export type {
   ReleaseProcessedBotMessageInput
 } from './processed-bot-messages'
 export {
+  HOUSEHOLD_MEMBER_LIFECYCLE_STATUSES,
   HOUSEHOLD_TOPIC_ROLES,
   type HouseholdConfigurationRepository,
   type HouseholdBillingSettingsRecord,
   type HouseholdJoinTokenRecord,
+  type HouseholdMemberLifecycleStatus,
   type HouseholdMemberRecord,
   type HouseholdPendingMemberRecord,
   type HouseholdTelegramChatRecord,