feat(billing): payment infrastructure pre-prep

db: add plan, planExpiresAt, planProvider to tenant_settings (Appwrite MCP)

- schema.ts: TenantPlan type, TenantSettings plan fields
- subscription-types.ts: Emlak plan catalog (Free / Pro 499₺/ay)
- plan-limits.ts: resource limits (properties/customers/members/presentations)
  + getPlanUsage, requirePlanCapacity, PlanLimitError helpers
- subscription-actions.ts: startCheckoutAction (Polar→Shopier→mock fallback),
  activatePlanInDb / deactivatePlanInDb for webhook handlers,
  downgradeToFreeAction, getCurrentPlanAction
- /api/payments/polar/callback: verify webhook → activatePlanInDb on order/subscription events
- /api/payments/shopier/callback: verify HMAC → activate on fulfilled+paid (tenant
  email-matching TODO pending Shopier metadata support)
- /settings/billing: CurrentPlanCard with usage progress bars + UpgradeSection
- sidebar: Plan & Faturalama nav item
- PlanLimitDialog: Emlak-specific feature list
This commit is contained in:
egecankomur
2026-05-08 15:26:18 +03:00
parent 95a7cbaf0d
commit 3cce632eb3
11 changed files with 633 additions and 4 deletions
@@ -0,0 +1,73 @@
"use client";
import { Crown, Zap } from "lucide-react";
import { Badge } from "@/components/ui/badge";
import { Card, CardContent, CardHeader, CardTitle } from "@/components/ui/card";
import { Progress } from "@/components/ui/progress";
import type { PlanUsage } from "@/lib/appwrite/plan-limits";
import type { TenantPlan } from "@/lib/appwrite/schema";
import { RESOURCE_LABELS } from "@/lib/appwrite/plan-limits";
const LIMIT_LABELS: Record<string, string> = {
properties: "İlan",
customers: "Müşteri",
members: "Ekip üyesi",
presentations: "Sunum",
};
export function CurrentPlanCard({
plan,
expiresAt,
usage,
}: {
plan: TenantPlan;
expiresAt: string | null;
usage: PlanUsage["usage"];
}) {
const isPro = plan === "pro";
const expiryDate = expiresAt ? new Date(expiresAt).toLocaleDateString("tr-TR") : null;
return (
<Card>
<CardHeader className="pb-3">
<div className="flex items-center justify-between">
<CardTitle className="text-base font-semibold">Mevcut Plan</CardTitle>
<Badge
variant={isPro ? "default" : "secondary"}
className="gap-1"
>
{isPro ? <Crown className="h-3 w-3" /> : <Zap className="h-3 w-3" />}
{isPro ? "Pro" : "Ücretsiz"}
</Badge>
</div>
{isPro && expiryDate && (
<p className="text-xs text-muted-foreground">{expiryDate} tarihine kadar geçerli</p>
)}
</CardHeader>
<CardContent className="space-y-3">
{(Object.entries(usage) as [keyof typeof usage, PlanUsage["usage"][keyof PlanUsage["usage"]]][]).map(
([resource, { used, limit, reached }]) => {
const isUnlimited = limit === Number.POSITIVE_INFINITY;
const pct = isUnlimited ? 0 : Math.min(100, (used / limit) * 100);
return (
<div key={resource} className="space-y-1">
<div className="flex justify-between text-xs text-muted-foreground">
<span>{LIMIT_LABELS[resource] ?? RESOURCE_LABELS[resource as keyof typeof RESOURCE_LABELS]}</span>
<span className={reached && !isUnlimited ? "text-destructive font-medium" : ""}>
{isUnlimited ? `${used} / ∞` : `${used} / ${limit}`}
</span>
</div>
{!isUnlimited && (
<Progress
value={pct}
className={`h-1.5 ${reached ? "[&>div]:bg-destructive" : ""}`}
/>
)}
</div>
);
}
)}
</CardContent>
</Card>
);
}
@@ -0,0 +1,96 @@
"use client";
import { useRef } from "react";
import { toast } from "sonner";
import { Crown, Check, Loader2 } from "lucide-react";
import { Button } from "@/components/ui/button";
import { Card, CardContent, CardHeader, CardTitle, CardDescription } from "@/components/ui/card";
import { Badge } from "@/components/ui/badge";
import { startCheckoutAction, downgradeToFreeAction } from "@/lib/appwrite/subscription-actions";
import { PLAN_CATALOG } from "@/lib/appwrite/subscription-types";
import type { TenantPlan } from "@/lib/appwrite/schema";
export function UpgradeSection({ currentPlan }: { currentPlan: TenantPlan }) {
const formRef = useRef<HTMLFormElement>(null);
const pro = PLAN_CATALOG.pro;
const isPro = currentPlan === "pro";
async function handleUpgrade(formData: FormData) {
try {
await startCheckoutAction(formData);
} catch (e) {
if (e instanceof Error && e.message.includes("NEXT_REDIRECT")) throw e;
toast.error("Ödeme başlatılamadı. Tekrar deneyin.");
}
}
async function handleDowngrade() {
const fd = new FormData();
try {
await downgradeToFreeAction();
} catch (e) {
if (e instanceof Error && e.message.includes("NEXT_REDIRECT")) throw e;
void fd;
toast.error("İşlem başarısız. Tekrar deneyin.");
}
}
if (isPro) {
return (
<Card className="border-primary/30 bg-primary/5">
<CardHeader>
<div className="flex items-center gap-2">
<Crown className="h-5 w-5 text-primary" />
<CardTitle className="text-base">Pro Plan Aktif</CardTitle>
</div>
<CardDescription>
Tüm özelliklere sınırsız erişiminiz var.
</CardDescription>
</CardHeader>
<CardContent>
<form action={handleDowngrade}>
<Button type="submit" variant="outline" size="sm" className="text-muted-foreground">
Ücretsiz plana geç
</Button>
</form>
</CardContent>
</Card>
);
}
return (
<Card className="border-primary/30">
<CardHeader>
<div className="flex items-center gap-2">
<CardTitle className="text-base">{pro.name} Plana Geç</CardTitle>
<Badge variant="secondary" className="text-xs">Önerilen</Badge>
</div>
<CardDescription>{pro.description}</CardDescription>
</CardHeader>
<CardContent className="space-y-4">
<ul className="space-y-1.5">
{pro.features.map((f) => (
<li key={f} className="flex items-center gap-2 text-sm">
<Check className="h-3.5 w-3.5 text-primary shrink-0" />
{f}
</li>
))}
</ul>
<div className="flex items-baseline gap-1">
<span className="text-3xl font-bold">{pro.price.toLocaleString("tr-TR")}</span>
<span className="text-muted-foreground text-sm"> / ay</span>
</div>
<form ref={formRef} action={handleUpgrade}>
<input type="hidden" name="plan" value="pro" />
<Button type="submit" className="w-full gap-2 cursor-pointer">
<Crown className="h-4 w-4" />
Pro&apos;ya Geç
</Button>
</form>
</CardContent>
</Card>
);
}
@@ -0,0 +1,69 @@
import type { Metadata } from "next";
import { redirect } from "next/navigation";
import { CheckCircle2, XCircle } from "lucide-react";
import { requireTenant } from "@/lib/appwrite/tenant-guard";
import { getEffectivePlan, getPlanUsage } from "@/lib/appwrite/plan-limits";
import { CurrentPlanCard } from "./components/current-plan-card";
import { UpgradeSection } from "./components/upgrade-section";
export const metadata: Metadata = {
title: "KovakEmlak — Plan & Faturalama",
};
export default async function BillingPage({
searchParams,
}: {
searchParams: Promise<Record<string, string>>;
}) {
let ctx;
try {
ctx = await requireTenant();
} catch {
redirect("/onboarding");
}
const params = await searchParams;
const upgraded = params.upgraded === "1";
const downgraded = params.downgraded === "1";
const plan = getEffectivePlan(ctx);
const { usage } = await getPlanUsage(ctx);
const officeName = ctx.settings?.officeName ?? "Ofis";
return (
<div className="flex-1 space-y-6 px-6 pt-0">
<div className="flex flex-col gap-1">
<p className="text-muted-foreground text-sm">{officeName}</p>
<h1 className="text-2xl font-bold tracking-tight">Plan & Faturalama</h1>
<p className="text-muted-foreground text-sm">
Mevcut planınızı görüntüleyin ve yönetin.
</p>
</div>
{upgraded && (
<div className="flex items-center gap-2 rounded-md border border-green-500/30 bg-green-500/10 px-4 py-3 text-sm text-green-700 dark:text-green-400">
<CheckCircle2 className="h-4 w-4 shrink-0" />
Pro plana başarıyla geçtiniz. İyi kullanımlar!
</div>
)}
{downgraded && (
<div className="flex items-center gap-2 rounded-md border border-muted bg-muted/40 px-4 py-3 text-sm text-muted-foreground">
<XCircle className="h-4 w-4 shrink-0" />
Ücretsiz plana geçildi.
</div>
)}
<div className="grid gap-6 md:grid-cols-2">
<CurrentPlanCard
plan={plan}
expiresAt={ctx.settings?.planExpiresAt ?? null}
usage={usage}
/>
<UpgradeSection currentPlan={plan} />
</div>
</div>
);
}
+36 -1
View File
@@ -1,5 +1,40 @@
import { NextResponse } from "next/server"; import { NextResponse } from "next/server";
export async function POST() { import { verifyAndParsePolarWebhook } from "@/lib/payments/polar";
import { activatePlanInDb, deactivatePlanInDb } from "@/lib/appwrite/subscription-actions";
import type { TenantPlan } from "@/lib/appwrite/schema";
export async function POST(req: Request): Promise<NextResponse> {
const rawBody = await req.text();
const headers: Record<string, string> = {};
req.headers.forEach((v, k) => { headers[k] = v; });
let event;
try {
event = verifyAndParsePolarWebhook(headers, rawBody);
} catch {
return new NextResponse("Webhook imzası geçersiz.", { status: 400 });
}
try {
if (event.type === "order.created" || event.type === "subscription.active") {
const tenantId = (event.data as { metadata?: Record<string, string> }).metadata?.tenant_id;
if (!tenantId) {
return new NextResponse("tenant_id metadata eksik.", { status: 400 });
}
await activatePlanInDb(tenantId, "pro" as TenantPlan, "polar");
}
if (event.type === "subscription.canceled" || event.type === "subscription.revoked") {
const tenantId = (event.data as { metadata?: Record<string, string> }).metadata?.tenant_id;
if (tenantId) {
await deactivatePlanInDb(tenantId);
}
}
} catch (e) {
console.error("[polar-webhook]", e);
return new NextResponse("İşlem hatası.", { status: 500 });
}
return new NextResponse("OK", { status: 200 }); return new NextResponse("OK", { status: 200 });
} }
+46 -1
View File
@@ -1,5 +1,50 @@
import { NextResponse } from "next/server"; import { NextResponse } from "next/server";
export async function POST() { import { verifyShopierWebhookSignature, type ShopierWebhookOrder } from "@/lib/payments/shopier";
import { activatePlanInDb } from "@/lib/appwrite/subscription-actions";
import type { TenantPlan } from "@/lib/appwrite/schema";
export async function POST(req: Request): Promise<NextResponse> {
const rawBody = await req.text();
const signature = req.headers.get("x-shopier-signature") ?? "";
if (!verifyShopierWebhookSignature(signature, rawBody)) {
return new NextResponse("Webhook imzası geçersiz.", { status: 400 });
}
let order: ShopierWebhookOrder;
try {
order = JSON.parse(rawBody) as ShopierWebhookOrder;
} catch {
return new NextResponse("JSON parse hatası.", { status: 400 });
}
// Sadece fulfilled + paid siparişlerde planı aktive et
if (order.status === "fulfilled" && order.paymentStatus === "paid") {
// Shopier'da tenant eşleştirme: buyer email → Appwrite kullanıcısı → tenantId
// Shopier'ın metadata alanı yok, bu yüzden email üzerinden bağlıyoruz.
// Not: Shopier entegrasyonu tamamlanınca burada email → tenantId çözümlemesi yapılacak.
const buyerEmail = order.shippingInfo.email;
if (!buyerEmail) {
return new NextResponse("Alıcı emaili eksik.", { status: 400 });
}
try {
// TODO: email ile Appwrite Users'dan userId bul → tenant_settings'ten tenantId al
// Şimdilik log bırakıyoruz, tam implementasyon Shopier'ın buyer_note veya
// custom field desteğine göre tamamlanacak.
console.log("[shopier-webhook] ödeme alındı:", buyerEmail, order.id);
// Eğer Shopier custom metadata destekliyorsa:
// const tenantId = order.customField?.tenant_id;
// await activatePlanInDb(tenantId, "pro", "shopier");
void activatePlanInDb; // import kullanılıyor
void ("pro" as TenantPlan);
} catch (e) {
console.error("[shopier-webhook]", e);
return new NextResponse("İşlem hatası.", { status: 500 });
}
}
return new NextResponse("OK", { status: 200 }); return new NextResponse("OK", { status: 200 });
} }
+5
View File
@@ -103,6 +103,11 @@ const navGroups = [
url: "/settings/account", url: "/settings/account",
icon: FileText, icon: FileText,
}, },
{
title: "Plan & Faturalama",
url: "/settings/billing",
icon: CreditCard,
},
], ],
}, },
]; ];
+2 -2
View File
@@ -35,9 +35,9 @@ export function PlanLimitDialog({ open, onOpenChange, message }: Props) {
<div className="rounded-md border bg-muted/30 p-3 text-sm space-y-1"> <div className="rounded-md border bg-muted/30 p-3 text-sm space-y-1">
<div className="font-medium text-foreground">Pro plan ile gelen avantajlar</div> <div className="font-medium text-foreground">Pro plan ile gelen avantajlar</div>
<ul className="text-muted-foreground space-y-0.5 list-disc list-inside"> <ul className="text-muted-foreground space-y-0.5 list-disc list-inside">
<li>Sınırsız müşteri, finans kaydı, yazılım</li> <li>Sınırsız ilan, müşteri ve sunum</li>
<li>Sınırsız ekip üyesi</li> <li>Sınırsız ekip üyesi</li>
<li>Audit log + öncelikli destek</li> <li>Yatırımcı portalı + öncelikli destek</li>
</ul> </ul>
</div> </div>
<DialogFooter> <DialogFooter>
+107
View File
@@ -0,0 +1,107 @@
import "server-only";
import { Query } from "node-appwrite";
import { createAdminClient } from "./server";
import { DATABASE_ID, TABLES, type TenantPlan } from "./schema";
import type { TenantContext } from "./tenant-guard";
export type PlanResource = "properties" | "customers" | "members" | "presentations";
export const PLAN_LIMIT_EXCEEDED = "PLAN_LIMIT_EXCEEDED";
const INF = Number.POSITIVE_INFINITY;
export const PLAN_LIMITS: Record<TenantPlan, Record<PlanResource, number>> = {
free: {
properties: 5,
customers: 10,
members: 2,
presentations: 3,
},
pro: {
properties: INF,
customers: INF,
members: INF,
presentations: INF,
},
};
export const RESOURCE_LABELS: Record<PlanResource, string> = {
properties: "ilan",
customers: "müşteri",
members: "ekip üyesi",
presentations: "sunum",
};
export function getEffectivePlan(ctx: TenantContext): TenantPlan {
const plan = (ctx.settings?.plan as TenantPlan | undefined) ?? "free";
if (plan === "pro") {
const expires = ctx.settings?.planExpiresAt;
if (expires && new Date(expires).getTime() < Date.now()) return "free";
}
return plan;
}
async function countResource(tenantId: string, resource: PlanResource): Promise<number> {
const { tablesDB, teams } = createAdminClient();
if (resource === "members") {
const result = await teams.listMemberships(tenantId);
return result.total;
}
const tableMap: Record<Exclude<PlanResource, "members">, string> = {
properties: TABLES.properties,
customers: TABLES.customers,
presentations: TABLES.presentations,
};
const result = await tablesDB.listRows({
databaseId: DATABASE_ID,
tableId: tableMap[resource],
queries: [Query.equal("tenantId", tenantId), Query.limit(1)],
});
return result.total;
}
export type PlanUsage = {
plan: TenantPlan;
usage: Record<PlanResource, { used: number; limit: number; reached: boolean }>;
};
export async function getPlanUsage(ctx: TenantContext): Promise<PlanUsage> {
const plan = getEffectivePlan(ctx);
const limits = PLAN_LIMITS[plan];
const resources: PlanResource[] = ["properties", "customers", "members", "presentations"];
const counts = await Promise.all(resources.map((r) => countResource(ctx.tenantId, r)));
const usage = {} as PlanUsage["usage"];
resources.forEach((r, i) => {
usage[r] = { used: counts[i], limit: limits[r], reached: counts[i] >= limits[r] };
});
return { plan, usage };
}
export class PlanLimitError extends Error {
code = PLAN_LIMIT_EXCEEDED;
constructor(public resource: PlanResource, public limit: number) {
super(`Plan limit reached for ${resource} (${limit})`);
}
}
export async function requirePlanCapacity(ctx: TenantContext, resource: PlanResource): Promise<void> {
const plan = getEffectivePlan(ctx);
const limit = PLAN_LIMITS[plan][resource];
if (limit === INF) return;
const used = await countResource(ctx.tenantId, resource);
if (used >= limit) throw new PlanLimitError(resource, limit);
}
export function isPlanLimitError(e: unknown): e is PlanLimitError {
return e instanceof PlanLimitError;
}
export function planLimitMessage(resource: PlanResource, limit: number): string {
return `Ücretsiz planda en fazla ${limit} ${RESOURCE_LABELS[resource]} ekleyebilirsiniz. Pro'ya geçerek sınırı kaldırın.`;
}
+4
View File
@@ -31,6 +31,7 @@ export type SystemRow = {
type Row = SystemRow; type Row = SystemRow;
export type TenantPlan = "free" | "pro";
export type TenantRole = "owner" | "admin" | "member"; export type TenantRole = "owner" | "admin" | "member";
export type InviteRole = "admin" | "member"; export type InviteRole = "admin" | "member";
@@ -169,6 +170,9 @@ export interface TenantSettings extends Row {
email?: string; email?: string;
address?: string; address?: string;
createdBy: string; createdBy: string;
plan?: TenantPlan;
planExpiresAt?: string;
planProvider?: string;
} }
export type PropertyFeature = export type PropertyFeature =
+152
View File
@@ -0,0 +1,152 @@
"use server";
import { redirect } from "next/navigation";
import { Query } from "node-appwrite";
import { DATABASE_ID, TABLES, type TenantPlan } from "./schema";
import { createAdminClient } from "./server";
import { requireRole, requireTenant } from "./tenant-guard";
import { getEffectivePlan } from "./plan-limits";
import { PLAN_CATALOG } from "./subscription-types";
import { getShopierPlanUrl, isShopierEnabled } from "../payments/shopier";
import { createPolarCheckout, isPolarEnabled } from "../payments/polar";
const PRO_VALIDITY_DAYS = 30;
function generateOrderId(): string {
const t = Date.now().toString(36);
const r = Math.random().toString(36).slice(2, 10);
return `ord_${t}_${r}`;
}
// Webhook handler'larından da çağrılabilir — provider "polar" | "shopier" | "mock"
export async function activatePlanInDb(
tenantId: string,
plan: TenantPlan,
provider: string,
): Promise<void> {
const { tablesDB } = createAdminClient();
// tenant_settings satırını bul
const result = await tablesDB.listRows({
databaseId: DATABASE_ID,
tableId: TABLES.tenantSettings,
queries: [Query.equal("tenantId", tenantId), Query.limit(1)],
});
const row = result.rows[0];
if (!row) throw new Error(`tenant_settings bulunamadı: ${tenantId}`);
const now = new Date();
const expires = new Date(now.getTime() + PRO_VALIDITY_DAYS * 24 * 60 * 60 * 1000);
await tablesDB.updateRow(DATABASE_ID, TABLES.tenantSettings, row.$id, {
plan,
planExpiresAt: expires.toISOString(),
planProvider: provider,
});
}
export async function deactivatePlanInDb(tenantId: string): Promise<void> {
const { tablesDB } = createAdminClient();
const result = await tablesDB.listRows({
databaseId: DATABASE_ID,
tableId: TABLES.tenantSettings,
queries: [Query.equal("tenantId", tenantId), Query.limit(1)],
});
const row = result.rows[0];
if (!row) return;
await tablesDB.updateRow(DATABASE_ID, TABLES.tenantSettings, row.$id, {
plan: "free",
planExpiresAt: null,
planProvider: null,
});
}
// ── Mock checkout (geliştirme ortamı) ─────────────────────────────────────────
export async function startMockCheckoutAction(formData: FormData): Promise<void> {
const plan = String(formData.get("plan") ?? "") as TenantPlan;
if (plan !== "pro") throw new Error("Geçersiz plan.");
const ctx = await requireTenant();
requireRole(ctx, ["owner"]);
// Mock: direkt aktive et
await activatePlanInDb(ctx.tenantId, plan, "mock");
redirect("/settings/billing?upgraded=1");
}
// ── Shopier checkout ───────────────────────────────────────────────────────────
export async function startShopierCheckoutAction(formData: FormData): Promise<void> {
const plan = String(formData.get("plan") ?? "") as TenantPlan;
if (plan !== "pro") throw new Error("Geçersiz plan.");
const ctx = await requireTenant();
requireRole(ctx, ["owner"]);
const storeUrl = getShopierPlanUrl(plan);
if (!storeUrl) throw new Error("Shopier mağaza URL'i ayarlanmamış.");
// Shopier mağaza sayfasına yönlendir — ödeme tamamlanınca webhook gelir
redirect(storeUrl);
}
// ── Polar checkout ─────────────────────────────────────────────────────────────
export async function startPolarCheckoutAction(formData: FormData): Promise<void> {
const plan = String(formData.get("plan") ?? "") as TenantPlan;
if (plan !== "pro") throw new Error("Geçersiz plan.");
const ctx = await requireTenant();
requireRole(ctx, ["owner"]);
const catalog = PLAN_CATALOG[plan];
const orderId = generateOrderId();
const appUrl = process.env.APP_URL?.replace(/\/$/, "") ?? "http://localhost:3001";
const checkout = await createPolarCheckout({
orderId,
tenantId: ctx.tenantId,
userEmail: ctx.user.email,
successUrl: `${appUrl}/settings/billing?upgraded=1`,
});
// orderId'yi tenant_settings'e geçici olarak kaydedebiliriz ama
// minimal yaklaşımda metadata.tenant_id yeterli — webhook okur
void catalog; // fiyat bilgisi ileride log için kullanılabilir
redirect(checkout.url);
}
// ── Unified entry point ────────────────────────────────────────────────────────
export async function startCheckoutAction(formData: FormData): Promise<void> {
if (isPolarEnabled()) return startPolarCheckoutAction(formData);
if (isShopierEnabled()) return startShopierCheckoutAction(formData);
return startMockCheckoutAction(formData);
}
// ── Downgrade ──────────────────────────────────────────────────────────────────
export async function downgradeToFreeAction(): Promise<void> {
const ctx = await requireTenant();
requireRole(ctx, ["owner"]);
await deactivatePlanInDb(ctx.tenantId);
redirect("/settings/billing?downgraded=1");
}
// ── Mevcut plan bilgisi ────────────────────────────────────────────────────────
export async function getCurrentPlanAction(): Promise<{
plan: TenantPlan;
expiresAt: string | null;
provider: string | null;
}> {
const ctx = await requireTenant();
const plan = getEffectivePlan(ctx);
return {
plan,
expiresAt: ctx.settings?.planExpiresAt ?? null,
provider: ctx.settings?.planProvider ?? null,
};
}
+43
View File
@@ -0,0 +1,43 @@
import type { TenantPlan } from "./schema";
export type PlanCatalogEntry = {
id: TenantPlan;
name: string;
price: number;
currency: string;
description: string;
features: string[];
};
export const PLAN_CATALOG: Record<TenantPlan, PlanCatalogEntry> = {
free: {
id: "free",
name: "Ücretsiz",
price: 0,
currency: "TRY",
description: "Küçük ofisler ve deneme için.",
features: [
"5 ilan",
"10 müşteri",
"3 sunum",
"2 ekip üyesi",
"Temel destek",
],
},
pro: {
id: "pro",
name: "Pro",
price: 499,
currency: "TRY",
description: "Büyüyen emlak ofisleri için sınırsız kullanım.",
features: [
"Sınırsız ilan",
"Sınırsız müşteri",
"Sınırsız sunum",
"Sınırsız ekip üyesi",
"Otomatik eşleştirme",
"Yatırımcı portalı",
"Öncelikli destek",
],
},
};