> ## Documentation Index
> Fetch the complete documentation index at: https://safia.maximusolution.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Automated Reminders & Financial Alerts in SAFIA

> Set price alerts, daily news digests, expense nudges, and portfolio summaries through natural chat. SAFIA also suggests reminders based on your habits.

SAFIA's reminder system brings your financial life to you — instead of remembering to check prices or log expenses, you set it once in chat and SAFIA delivers polished, AI-composed messages on your chosen schedule. Every reminder is driven by natural language, so there's no configuration UI to navigate.

## Reminder Types

SAFIA supports six kinds of reminders, each serving a different financial need:

<CardGroup cols={2}>
  <Card title="Price Alert" icon="bell">
    Get notified when gold, silver, a stock, or a crypto reaches a price level — or just receive periodic price updates on assets you're watching.
  </Card>

  <Card title="News Digest" icon="newspaper">
    Receive a summarised roundup of Indonesian financial news on a topic you care about (e.g. "saham perbankan", "crypto market").
  </Card>

  <Card title="Expense Nudge" icon="receipt">
    A prompt to log any expenses you may have forgotten during the day — great for staying on top of small daily spending.
  </Card>

  <Card title="Income Nudge" icon="money-bill">
    A reminder to record income (freelance payments, allowances, etc.) so your balance stays accurate.
  </Card>

  <Card title="Portfolio Digest" icon="chart-line">
    A periodic snapshot of your portfolio's total value and allocation — delivered as a readable summary.
  </Card>

  <Card title="Custom Message" icon="comment">
    Any reminder with a custom message you write — motivational notes, savings milestones, bill payment reminders, or anything else.
  </Card>
</CardGroup>

***

## Schedule Options

Each reminder supports four scheduling modes:

| Schedule     | Description                              | Example                         |
| ------------ | ---------------------------------------- | ------------------------------- |
| **Daily**    | Fires once per day at a set time         | Every day at 08:00              |
| **Weekly**   | Fires once per week on a chosen day      | Every Monday at 09:00           |
| **Monthly**  | Fires once per month on a chosen date    | Every 1st of the month at 07:00 |
| **Interval** | Fires every N hours (e.g. every 4 hours) | Every 4 hours                   |

All times use **Asia/Jakarta (WIB, UTC+7)**.

***

## Creating a Reminder

Just describe what you want and when — SAFIA handles the rest. You don't need to specify a "type"; SAFIA infers it from your message.

<Steps>
  <Step title="Price alert — daily">
    ```text theme={null}
    You:    Ingatkan harga Bitcoin setiap hari jam 8 pagi

    SAFIA:  Siap! ⏰ Pengingat harga BTC aktif — kamu akan dapat
            update setiap hari pukul 08.00 WIB.
    ```
  </Step>

  <Step title="News digest — weekly">
    ```text theme={null}
    You:    Kirimkan ringkasan berita saham IDX setiap Senin pagi jam 7

    SAFIA:  ✅ News digest saham IDX dijadwalkan setiap Senin pukul 07.00 WIB.
            Pesan pertama akan terkirim Senin depan.
    ```
  </Step>

  <Step title="Expense nudge — daily evening">
    ```text theme={null}
    You:    Ingatkan aku untuk catat pengeluaran setiap malam jam 9

    SAFIA:  Oke! 📝 Aku akan mengingatkan kamu setiap malam pukul 21.00 WIB
            untuk mencatat pengeluaran hari ini.
    ```
  </Step>

  <Step title="Portfolio digest — monthly">
    ```text theme={null}
    You:    Send me a portfolio summary on the 1st of every month

    SAFIA:  Done! 📊 Your monthly portfolio digest is set for the 1st of each
            month at 08:00 WIB. First delivery: 1 July.
    ```
  </Step>

  <Step title="Custom reminder">
    ```text theme={null}
    You:    Ingatkan aku bayar kartu kredit setiap tanggal 25 jam 10 pagi

    SAFIA:  ✅ Pengingat bayar kartu kredit aktif — setiap tanggal 25 pukul 10.00 WIB.
    ```
  </Step>

  <Step title="Gold price alert (interval)">
    ```text theme={null}
    You:    Cek harga emas setiap 6 jam dan kirimkan ke aku

    SAFIA:  📡 Pengingat harga emas setiap 6 jam aktif.
            Update pertama akan dikirim dalam 6 jam ke depan.
    ```
  </Step>
</Steps>

<Note>
  Each user can have up to **10 active reminders** at a time. If you've reached the limit, SAFIA will let you know and suggest removing reminders you no longer need before creating a new one.
</Note>

***

## Managing Your Reminders

### Listing reminders

```text theme={null}
You:    Tampilkan semua pengingat aktif ku

SAFIA:  Pengingat kamu (4 aktif):
        1. Harga BTC — harian 08.00 ✅
        2. Berita IDX — Senin 07.00 ✅
        3. Catat pengeluaran — harian 21.00 ✅
        4. Bayar kartu kredit — tgl 25 10.00 ✅
```

### Pausing and resuming

Pause a reminder when you're on holiday or don't need updates temporarily — it stays saved and can be resumed anytime.

```text theme={null}
You:    Pause pengingat harga BTC dulu

SAFIA:  Pengingat BTC dijeda ⏸️ — kamu bisa aktifkan kembali kapan saja.
```

```text theme={null}
You:    Aktifkan lagi pengingat BTC ku

SAFIA:  Pengingat harga BTC aktif kembali ✅ — next update besok 08.00 WIB.
```

### Deleting a reminder

```text theme={null}
You:    Hapus pengingat berita IDX

SAFIA:  Pengingat berita IDX sudah dihapus 🗑️
```

***

## Habit-Based Reminder Suggestions

SAFIA learns from your usage patterns — when you usually log expenses, when you check prices, and how often you interact with your portfolio — and can suggest reminders that naturally fit your routine.

```text theme={null}
You:    Rekomendasikan pengingat yang cocok buat kebiasaanku

SAFIA:  Berdasarkan kebiasaanmu, aku punya 3 saran:

        1. 📝 Catat pengeluaran — setiap hari 21.30 WIB
           (kamu sering buka SAFIA malam hari)

        2. 📊 Portfolio digest — setiap Minggu 09.00 WIB
           (kamu cek portofolio hampir setiap akhir pekan)

        3. 📰 Berita kripto — setiap Selasa & Kamis 07.30 WIB
           (kamu sering tanya soal BTC dan ETH di pagi hari)

        Mau aku aktifkan salah satunya? Atau mau modifikasi jadwalnya?
```

<Tip>
  SAFIA will always ask for your confirmation before creating suggestions as actual reminders. You stay in full control of your notification schedule.
</Tip>

***

## How Reminder Messages Look

SAFIA composes every reminder message using AI before sending it — so you receive a natural, readable update rather than a raw data dump.

```text theme={null}
[Reminder — Daily 08:00]

SAFIA:  Selamat pagi! ☀️ Update harga asetmu:

        ₿ BTC     — Rp 1.588.000.000  (+1,2%)
        🥇 Emas   — Rp 1.582.000/gram  (stabil)
        📊 BBCA   — Rp 9.800/lembar    (+0,5%)

        Pasar pagi ini bergerak positif. Portofoliomu naik sekitar
        Rp 2.100.000 dari kemarin 📈
```
