ספרינט 1

Backend — שלבים

cd backend
python -m venv .venv
.venv\Scripts\activate          # Windows
# source .venv/bin/activate     # Mac/Linux
pip install -r requirements.txt -r requirements-dev.txt

cp .env.example .env            # ואז ממלאות:
# DATABASE_URL=postgresql://user:password@localhost:5432/prayers_db
# STRIPE_SECRET_KEY=sk_test_...
# FIREBASE_CREDENTIALS_PATH=./firebase-service-account.json

docker-compose up -d            # PostgreSQL על port 5432
uvicorn app.main:app --reload   # Server על port 8000

# בדיקה:
curl http://localhost:8000/health   # → {"status": "ok"}

Frontend — שלבים

cd prayers-app
npm install
cp .env.example .env            # ואז ממלאות:
# EXPO_PUBLIC_API_URL=http://localhost:8000
# EXPO_PUBLIC_STRIPE_PUBLISHABLE_KEY=pk_test_...
# EXPO_PUBLIC_FIREBASE_API_KEY=...  (4 משתנים נוספים)

npx expo start
# → לוחצות w לפתוח web

⚠️ מלכודות נפוצות

• Firebase: מורידות serviceAccountKey.json מ-Firebase Console → שמות ב-backend/firebase-service-account.json → מוסיפות ל-.gitignore לפני כל commit
• Stripe: sk_test_... הולך ל-backend/.env. pk_test_... הולך ל-prayers-app/.env. לא לבלבל.
• EXPO_PUBLIC_* הולכים רק ל-prayers-app/.env, לא ל-backend/.env
• Docker Desktop חייב לרוץ לפני docker-compose up

שלב 1 — הוספת prayer_name למודל

פותחות backend/app/models/models.py, מוצאות את class Donation (שורה ~65). אחרי donor_name:

# backend/app/models/models.py — בתוך class Donation:
prayer_name = Column(String, nullable=True)  # שם לתפילה — שונה מ-donor_name (שם לקבלה)

שלב 2 — הוספה ל-Schema

# backend/app/schemas/schemas.py — בתוך DonationCreate:
prayer_name: str | None = None

שלב 3 — Autogenerate migration

cd backend
alembic revision --autogenerate -m "initial"
# → נוצר backend/alembic/versions/xxxx_initial.py

# ⚠️ פתחי את הקובץ שנוצר ובדקי:
# ✅ op.create_table('prayers', ...)
# ✅ op.create_table('donations', ...) — כולל prayer_name
# ✅ 6 טבלאות: prayers, users, donations, categories, quick_buttons, recurring_donations
# אם prayer_name חסר → מחקי את הקובץ, חזרי לשלב 1

שלב 4 — Apply migration

alembic upgrade head
# → No errors

# ואז בדיקה ב-psql (או pgAdmin):
\dt   # → 6 טבלאות
SELECT column_name FROM information_schema.columns WHERE table_name='donations';
# → חייב להופיע: prayer_name

שלב 5 — כתיבת seed.py

יוצרות backend/scripts/seed.py (לא קיים). מריצות מתוך תיקיית backend:

cd backend
python scripts/seed.py
# → Categories ready: 5
# → Prayers seeded: 5 new

# בדיקה:
SELECT COUNT(*) FROM prayers;     # → 5
SELECT COUNT(*) FROM categories;  # → 5

✅ קריטריוני קבלה

• prayer_name = Column(String, nullable=True) קיים ב-Donation model
• קובץ migration קיים ב-alembic/versions/ ואוּמת ידנית
• alembic upgrade head רץ ללא שגיאות
• SELECT COUNT(*) FROM prayers → 5
• SELECT COUNT(*) FROM categories → 5
• הרצה כפולה של seed.py לא יוצרת כפילויות (אידמפוטנטי)
• PR עבר review של המפתחת השנייה + אישור שרה

Contract קריטי — Backend ↔ Frontend

שלב 1 — הרחבת PrayerResponse ב-schemas.py

# backend/app/schemas/schemas.py
class PrayerResponse(BaseModel):
    id: str
    slug: str
    title: str | None = None
    body: str | None = None
    seo_description: str | None = None
    seo_keywords: list[str] | None = None
    lang: str = "he"
    category_id: str | None = None
    view_count: int = 0

    model_config = ConfigDict(from_attributes=True)

שלב 2 — _localize helper ב-prayer_service.py

# backend/app/services/prayer_service.py
def _localize(prayer: PrayerModel, lang: str) -> PrayerResponse:
    """Map Prayer ORM → PrayerResponse for a given lang, with Hebrew fallback."""
    supported = ["he", "en", "fr", "ru", "es", "ar"]
    if lang not in supported:
        lang = "he"

    title   = getattr(prayer, f"title_{lang}", None)   or prayer.title_he
    body    = getattr(prayer, f"body_{lang}", None)    or prayer.body_he
    seo_d   = getattr(prayer, f"seo_description_{lang}", None) or prayer.seo_description_he
    seo_kw  = getattr(prayer, f"seo_keywords_{lang}", None)    or prayer.seo_keywords_he or []

    return PrayerResponse(
        id=str(prayer.id),
        slug=prayer.slug,
        title=title, body=body,
        seo_description=seo_d, seo_keywords=seo_kw,
        lang=lang,
        category_id=str(prayer.category_id) if prayer.category_id else None,
        view_count=prayer.view_count,
    )

שלב 3 — 4 service functions

# list_prayers
def list_prayers(db, lang="he"):
    prayers = db.query(PrayerModel).filter(PrayerModel.is_active == True).all()
    return [_localize(p, lang) for p in prayers]

# get_prayer_by_slug — מגדיל view_count!
def get_prayer_by_slug(db, slug, lang="he"):
    prayer = db.query(PrayerModel).filter(
        PrayerModel.slug == slug, PrayerModel.is_active == True
    ).first()
    if not prayer:
        raise HTTPException(status_code=404, detail="Prayer not found")
    prayer.view_count += 1
    db.commit()
    return _localize(prayer, lang)

# list_by_category
def list_by_category(db, category, lang="he"):
    prayers = (db.query(PrayerModel)
        .join(Category, PrayerModel.category_id == Category.id)
        .filter(Category.slug == category, PrayerModel.is_active == True).all())
    return [_localize(p, lang) for p in prayers]

# search_prayers
def search_prayers(db, q, lang="he"):
    title_col = getattr(PrayerModel, f"title_{lang}")
    body_col  = getattr(PrayerModel, f"body_{lang}")
    prayers = (db.query(PrayerModel)
        .filter(PrayerModel.is_active == True,
                (title_col.ilike(f"%{q}%") | body_col.ilike(f"%{q}%"))).all())
    return [_localize(p, lang) for p in prayers]

שלב 4 — Router (סדר חשוב!)

# backend/app/routers/prayers.py
# ⚠️ סדר חשוב: /search ו-/category/{cat} חייבים לפני /{slug}
# אחרת FastAPI יתפוס "search" כ-slug!

@router.get("/", response_model=list[PrayerResponse])
def list_prayers(lang: str = "he", db = Depends(get_db)):
    return prayer_service.list_prayers(db, lang)

@router.get("/search", response_model=list[PrayerResponse])
def search(q: str, lang: str = "he", db = Depends(get_db)):
    return prayer_service.search_prayers(db, q, lang)

@router.get("/category/{category}", response_model=list[PrayerResponse])
def by_category(category: str, lang: str = "he", db = Depends(get_db)):
    return prayer_service.list_by_category(db, category, lang)

@router.get("/{slug}", response_model=PrayerResponse)
def get_prayer(slug: str, lang: str = "he", db = Depends(get_db)):
    return prayer_service.get_prayer_by_slug(db, slug, lang)

✅ קריטריוני קבלה

• GET /api/prayers?lang=he → 5 תפילות עם כל 8 שדות
• GET /api/prayers/health?lang=he → title: "תפילה לרפואה שלמה"
• 2 קריאות ל-/api/prayers/health → view_count עלה ב-DB
• GET /api/prayers/search?q=רפואה → מחזיר תפילת health
• GET /api/prayers/category/health → מחזיר תפילת health
• GET /api/prayers/nonexistent → 404 (לא 500)
• Router לא מכיל לוגיקה עסקית — רק קריאה ל-service
• ruff check . עובר ללא שגיאות
• PR עבר review + אישור שרה

3 שינויים ב-_layout.tsx

1. הוסיפי import:

import { signInAnon } from '@/services/firebase';
import { StripeProvider } from '@stripe/stripe-react-native';
import { useAuth } from '@/hooks/useAuth';

2. הוסיפי signInAnon() ל-Promise.all:

Promise.all([
  initI18n(),
  initializeStripe(),
  signInAnon(),   // ← הוסיפי שורה זו
]).then(() => setReady(true));

3. עטפי עם StripeProvider + הוסיפי useAuth():

// בתוך function RootLayout():
useAuth(); // stub — Sprint 3 ימלא

// בתוך ה-return:
<StripeProvider publishableKey={process.env.EXPO_PUBLIC_STRIPE_PUBLISHABLE_KEY ?? ''}>
  <I18nextProvider i18n={i18n}>
    <Stack screenOptions={{ headerShown: false }} />
  </I18nextProvider>
</StripeProvider>

✅ קריטריוני קבלה

• האפליקציה נפתחת ב-web ללא מסך שגיאה אדום
• Firebase Console → Authentication → Users מציג user אנונימי חדש (תוך דקה)
• npm run type-check עובר
• npm run lint עובר
• PR עבר review + אישור שרה

שלב 1 — usePrayers() ב-hooks/usePrayer.ts

// hooks/usePrayer.ts — הוסיפי אחרי ה-stub הקיים:
export function usePrayers(): {
  prayers: LocalizedPrayer[];
  isLoading: boolean;
  error: string | null;
} {
  const { lang } = useLanguageStore();
  const [prayers, setPrayers] = useState<LocalizedPrayer[]>([]);
  const [isLoading, setIsLoading] = useState(true);
  const [error, setError] = useState<string | null>(null);

  useEffect(() => {
    setIsLoading(true);
    setError(null);
    getPrayers()
      .then((data) => setPrayers(data as LocalizedPrayer[]))
      .catch((err: Error) => setError(err.message))
      .finally(() => setIsLoading(false));
  }, [lang]);

  return { prayers, isLoading, error };
}

שלב 2 — Wire ל-index.tsx

// app/(tabs)/index.tsx
export default function HomeScreen() {
  const { t } = useTranslation();
  const { prayers, isLoading, error } = usePrayers();

  if (isLoading) return <LoadingSpinner />;
  if (error)     return <Text>{t('error.loading')}</Text>;

  return (
    <View style={styles.screen}>
      <AppDownloadBanner />     {/* stub — Sprint 5 */}
      <QuickButtons />          {/* stub — Sprint 3 */}
      <FlatList
        data={prayers}
        keyExtractor={(p) => p.slug}
        renderItem={({ item }) => <PrayerCard prayer={item} />}
      />
    </View>
  );
}

שלב 3 — מפתח i18n חדש

// i18n/he.json — הוסיפי אם לא קיים:
"error": {
  "loading": "שגיאה בטעינה, נסה שוב"
}

✅ קריטריוני קבלה

• מסך הבית מציג 5 PrayerCards עם כותרות בעברית
• LoadingSpinner גלוי בזמן loading
• Error state בעברית כשה-API לא רץ (לא מסך ריק)
• Tap על card → ניווט ל-/prayer/[slug]
• אין hardcoded עברית ב-JSX — הכל דרך t('key')
• npm run lint + npm run type-check עוברים
• PR עבר review + אישור שרה

שלב 1 — מלאי את usePrayer(slug)

// hooks/usePrayer.ts — ממלאות את הגוף של usePrayer(slug):
export function usePrayer(slug: string) {
  const { lang } = useLanguageStore();
  const [prayer, setPrayer] = useState<LocalizedPrayer | null>(null);
  const [isLoading, setIsLoading] = useState(true);
  const [error, setError] = useState<string | null>(null);

  useEffect(() => {
    if (!slug) return;
    setIsLoading(true);
    getPrayer(slug)
      .then((data) => setPrayer(data as LocalizedPrayer))
      .catch((err: Error) => setError(err.message))
      .finally(() => setIsLoading(false));
  }, [slug, lang]);

  return { prayer, isLoading, error };
}

שלב 2 — עמוד תפילה (app/prayer/[slug].tsx)

export default function PrayerScreen() {
  const { slug } = useLocalSearchParams<{ slug: string }>();
  const { prayer, isLoading, error } = usePrayer(slug);
  const { t } = useTranslation();

  if (isLoading) return <LoadingSpinner />;

  if (!prayer || error) return (
    <View style={styles.center}>
      <Text>{t('prayer.not_found')}</Text>
      <Button label={t('common.back')} onPress={() => router.back()} />
    </View>
  );

  return (
    <View style={styles.screen}>
      <ScrollView>
        <Text style={styles.title}>{prayer.title}</Text>
        <Text style={styles.body}>{prayer.body}</Text>
      </ScrollView>
      <View style={styles.bottomBar}>
        <DonationWidget prayerId={prayer.id} />
      </View>
    </View>
  );
}

שלב 3 — DonationWidget.tsx

export function DonationWidget({ prayerId }: { prayerId: string }) {
  const { t } = useTranslation();
  const { currency } = useLanguageStore();
  const { selectedTier, selectTier } = useDonationStore();

  const tiers = DONATION_TIERS[currency] ?? DONATION_TIERS.ILS;

  return (
    <View style={styles.container}>
      <View style={styles.tiersRow}>
        {tiers.map((tier) => {
          const isSelected = selectedTier?.amount === tier.amount;
          return (
            <TouchableOpacity
              key={tier.amount}
              style={[styles.tierBtn, isSelected && styles.selected]}
              onPress={() => selectTier(tier)}
            >
              <Text style={[styles.tierLabel, isSelected && styles.selectedLabel]}>
                {tier.display}
              </Text>
            </TouchableOpacity>
          );
        })}
      </View>

      <Button
        label={t('donation.donate')}
        onPress={() => {
          // TODO Sprint 2: setSheetOpen(true)
        }}
      />
    </View>
  );
}

✅ קריטריוני קבלה

• ניווט: בית → tap card → עמוד תפילה עם כותרת + גוף בעברית
• LoadingSpinner מוצג בזמן loading
• Slug לא תקין → "תפילה לא נמצאה" + כפתור חזרה
• 5 כפתורי tier גלויים (₪18/₪36/₪72/₪180/₪360)
• Tap על tier → כפתור מוהדר (highlighted), הקודם מבוטל
• כפתור "תרום" גלוי אך ה-onPress ריק (comment: TODO Sprint 2)
• אין hardcoded עברית — הכל דרך t('key')
• npm run lint + npm run type-check עוברים
• PR עבר review + אישור שרה