# G2G Mail Sender - მასტერ ინსტრუქცია

## მიზანი
`mail sender` არის G2G tool, რომელიც მუშაობს მხოლოდ G2G ავტორიზებული მომხმარებლებისთვის და აგზავნის ელ.ფოსტებს ერთჯერადად/მასიურად.

## ბოლო სტატუსი (2026-03-01)
- მოდული შექმნილია: `ai.g2g.ge/mail sender`
- tool key: `mailsender`
- G2G token ავტორიზაცია ჩართულია (`auth/helpers.php`)
- user-isolated history ჩართულია (მომხმარებელი ხედავს მხოლოდ თავის ჩანაწერს)
- გაგზავნის ისტორიიდან წაშლა გამორთულია
- ექსპორტი CSV (Excel-compatible) ჩართულია

## ძირითადი მისამართები
- მთავარი: `/mail%20sender/index.php`
- API პროფილი: `/mail%20sender/api/me.php`
- API გაგზავნა: `/mail%20sender/api/send_mail.php`
- API history list: `/mail%20sender/api/list_campaigns.php`
- API export: `/mail%20sender/api/export_campaign.php?id={campaign_id}`
- API excel parse: `/mail%20sender/api/parse_recipients.php`

## UI ფუნქციები
- ელ.ფოსტების ხელით შეყვანა
- გამყოფი სიმბოლო: `;` (მხარს უჭერს comma/newline-საც)
- Excel/CSV/TXT ატვირთვა და ელ.ფოსტების ავტომატური დათვლა
- სათაური + ტექსტი + ფოტოს მიბმა
- გაგზავნის ისტორია + დროითი ფილტრები + export
- 3-ენოვანი ინტერფეისი: KA/EN/RU

## Storage / ლიმიტი
- თითო გაგზავნაზე იქმნება JSON report და იტვირთება G2G storage-ში (`tool=mailsender`)
- attachment-ის არსებობისას attachment ფაილიც იტვირთება G2G storage-ში
- ეს უზრუნველყოფს პაკეტის სივრცის ხარჯვის ასახვას tool storage-ში

## ბაზა
- DB: `jobersg2_mailsender`
- სქემა: `db/schema.sql`
- დამატებითი ცვლილებები: `db/migrations.sql`
- ცხრილები:
  - `users`
  - `mail_campaigns`
  - `mail_recipients`
  - `audit_logs`

## კრიტიკული კონფიგურაცია
- `auth/config.php`
  - `BASE_URL = '/mail%20sender'`
  - `G2G_TOOL_SECRET` უნდა ემთხვეოდეს g2g.ge მხარეს
- `auth/db.php`
  - DB_HOST / DB_NAME / DB_USER / DB_PASS
- `config/mail.php`
  - MAIL_HOST / MAIL_PORT / MAIL_USERNAME / MAIL_PASSWORD / MAIL_FROM_ADDRESS

## ინტეგრაცია G2G-თან
- g2g.ge module settings-ში tool key უნდა იყოს `mailsender`
- tool URL რეკომენდაცია: `https://ai.g2g.ge/mail%20sender/`

## შემდეგი სესიის სწრაფი ჩართვა
1. გადახედე `db/schema.sql` და დარწმუნდი, რომ ბაზაში გაშვებულია.
2. გადაამოწმე `G2G_TOOL_SECRET` და SMTP კონფიგურაცია.
3. API smoke:
   - `api/me.php`
   - `api/parse_recipients.php`
   - `api/send_mail.php`
   - `api/list_campaigns.php`
   - `api/export_campaign.php`
4. გ2გ-დან tool launch ტესტი token-ით.
