skill-service 0.2.0__tar.gz

skill_service-0.2.0/.env.example

@@ -0,0 +1,57 @@
+# Skill Service — environment template
+# Copy to .env and fill in values. Do not commit .env.
+
+# --- docker-compose.dev.yml (host-side scripts) ---
+# SKILL_DATABASE_URL=postgresql://skill_app:skill_dev_pass@127.0.0.1:5433/skills
+# SKILL_REDIS_URL=redis://127.0.0.1:6380/0
+
+APP_NAME=Creator SKILL
+APP_VERSION=0.2.0
+SKILL_HTTP_PORT=8080
+
+SKILL_DATABASE_URL=postgresql://skill_app:CHANGE_ME@127.0.0.1:5432/skills
+SKILL_DATABASE_NAME=skills
+SKILL_REDIS_URL=redis://:CHANGE_ME@127.0.0.1:6379/0
+
+MODASH_API_KEY=
+MODASH_BASE_URL=https://api.modash.io/v1
+MODASH_TIMEOUT=30
+MODASH_MAX_RETRIES=3
+
+SKILL_TOKEN_PREFIX=sk_live_
+SESSION_TOKEN_PREFIX=sk_sess_
+SESSION_TTL_HOURS=24
+
+PAYMENT_MODE=mock
+# live 时建议 false，避免凭证缺失却走 mock
+PAYMENT_ALLOW_MOCK_FALLBACK=false
+
+SKILL_PUBLIC_BASE_URL=http://127.0.0.1:8080
+
+# --- WeChat Pay API v3 ---
+WECHAT_APP_ID=
+WECHAT_MCH_ID=
+WECHAT_MCH_SERIAL_NO=
+WECHAT_MCH_PRIVATE_KEY=
+WECHAT_MCH_PRIVATE_KEY_PATH=
+WECHAT_API_V3_KEY=
+WECHAT_PLATFORM_PUBLIC_KEY=
+
+# --- Alipay ---
+ALIPAY_APP_ID=
+ALIPAY_PRIVATE_KEY=
+ALIPAY_PRIVATE_KEY_PATH=
+ALIPAY_PUBLIC_KEY=
+ALIPAY_GATEWAY_URL=https://openapi.alipay.com/gateway.do
+
+STRIPE_SECRET_KEY=
+STRIPE_WEBHOOK_SECRET=
+STRIPE_PUBLISHABLE_KEY=
+STRIPE_CURRENCY=cny
+
+# OpenClaw test-only: enables POST /api/v1/subscriptions/automation/complete-checkout
+# SKILL_OPENCLAW_AUTOMATION_KEY=
+
+# mock / dev HMAC callbacks (optional)
+WECHAT_NOTIFY_SECRET=
+ALIPAY_NOTIFY_SECRET=

skill_service-0.2.0/.gitignore

@@ -0,0 +1,65 @@
+# --- Secrets & local config (never commit) ---
+.env
+.env_prod
+prod.yaml
+deploy/.env.test-server
+secrets/
+
+# --- Python ---
+.venv/
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+.eggs/
+dist/
+build/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+
+# --- Build / deploy artifacts ---
+*.tgz
+deploy.tgz
+deploy-sync.tgz
+skill-service-deploy.tgz
+
+# --- scripts/: only init_db + seed_dev_account go to remote ---
+scripts/*
+!scripts/init_db.py
+!scripts/seed_dev_account.py
+!scripts/deploy_prod_server.py
+!scripts/sync_prod_stripe_plans.py
+!scripts/prod_test_account_flow.py
+
+# --- Tests (local only) ---
+tests/
+
+# --- Dev / E2E docs (see docs/SCRIPTS.md for script index) ---
+docs/CI_SMOKE.md
+docs/CURSOR_DEBUG.md
+docs/PAYMENT_E2E_TEST.md
+docs/SUBSCRIPTION_E2E_TEST.md
+docs/STRIPE_TEST_ENV_SETUP.md
+docs/PLAN.md
+
+# --- CI workflow (needs remote smoke secrets) ---
+.github/
+
+# --- Dev-only compose ---
+docker-compose.test-deploy.yml
+
+# --- Registry local publish helpers ---
+output/registry/publish-registry.cmd
+output/registry/publish-registry.ps1
+
+# --- Logs ---
+*.log
+
+# --- IDE / OS ---
+.idea/
+.vscode/
+*.swp
+*~
+.DS_Store
+Thumbs.db

skill_service-0.2.0/Dockerfile

@@ -0,0 +1,11 @@
+FROM python:3.11-slim
+
+WORKDIR /app
+COPY . /app
+
+RUN pip install --no-cache-dir --upgrade pip && \
+    pip install --no-cache-dir .
+
+EXPOSE 8080
+
+CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8080"]

skill_service-0.2.0/PKG-INFO

@@ -0,0 +1,73 @@
+Metadata-Version: 2.4
+Name: skill-service
+Version: 0.2.0
+Summary: Standalone Creator SKILL MCP service
+Requires-Python: >=3.11
+Requires-Dist: asyncpg>=0.29.0
+Requires-Dist: cryptography>=42.0.0
+Requires-Dist: email-validator>=2.2.0
+Requires-Dist: fastapi>=0.115.0
+Requires-Dist: fastmcp<4,>=3.3.1
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: loguru>=0.7.2
+Requires-Dist: pydantic-settings>=2.3.0
+Requires-Dist: pydantic>=2.8.0
+Requires-Dist: stripe>=10.0.0
+Requires-Dist: uvicorn>=0.30.0
+Description-Content-Type: text/markdown
+
+# skill-service
+
+Standalone Creator SKILL service — MCP + REST API + independent billing.
+
+<!-- mcp-name: ai.deinai/creator-skill-v2 -->
+
+## Quick start
+
+```bash
+cd apps/skill-service
+python -m venv .venv
+.venv/Scripts/python -m pip install -U pip
+.venv/Scripts/pip install -e .
+cp .env.example .env   # edit database / modash keys
+.venv/Scripts/python scripts/init_db.py
+.venv/Scripts/python scripts/seed_dev_account.py --email dev@demo.com --password "12345678" --credits 5000
+.venv/Scripts/python main.py
+```
+
+Health: `GET http://127.0.0.1:8080/health`  
+MCP: `http://127.0.0.1:8080/mcp` (Bearer `sk_live_...`)
+
+## Production
+
+- **Release (Stripe only)**: [docs/PRODUCTION_RELEASE.md](docs/PRODUCTION_RELEASE.md)
+- **Prod deploy script**: `python scripts/deploy_prod_server.py` (uses `prod.yaml` + `.env_prod`)
+- Deploy: [docs/DEPLOY_CHECKLIST.md](docs/DEPLOY_CHECKLIST.md)
+- Local dev: `docker compose -f docker-compose.dev.yml up -d --build` or `scripts/dev_up.ps1 -Build`
+- Payments: [docs/PAYMENT_CALLBACKS.md](docs/PAYMENT_CALLBACKS.md)
+- Payment E2E (Plan A/C): [docs/PAYMENT_E2E_TEST.md](docs/PAYMENT_E2E_TEST.md)
+- Subscription E2E: [docs/SUBSCRIPTION_E2E_TEST.md](docs/SUBSCRIPTION_E2E_TEST.md)
+- **OpenClaw + ClawHub E2E**: [docs/OPENCLAW_E2E_TEST.md](docs/OPENCLAW_E2E_TEST.md)
+- **Stripe 测试环境配置**: [docs/STRIPE_TEST_ENV_SETUP.md](docs/STRIPE_TEST_ENV_SETUP.md)
+- MCP Registry: [output/registry/](output/registry/)
+- Coze HTTP SOP: `deinai_backend/output/coze/PATH-A-SOP.md`
+
+## Stdio bridge (Cursor / Claude Desktop)
+
+```bash
+export SKILL_TOKEN="sk_live_..."
+skill-service-match
+# or: uvx --from skill-service skill-service-match
+```
+
+Optional: `SKILL_MCP_URL` (default `https://skill.deinai.ai/mcp`).
+
+## Status
+
+- Independent account / session (`sk_sess_`) / API token (`sk_live_`)
+- Wallet, recharge, consumption ledger
+- **Portal** (`/portal/`): login, recharge, mock checkout, token management
+- **Payment checkout**: `POST /recharge/orders` returns `payParams` (mock / wechat / alipay)
+- MCP tools: `ping`, `get_location_ids`, `searchInfluencers`
+- REST: `GET /api/v1/account/status`, `POST /api/v1/search/influencers`
+- Admin: credit packages, consume rules, audit logs

skill_service-0.2.0/README.md

@@ -0,0 +1,55 @@
+# skill-service
+
+Standalone Creator SKILL service — MCP + REST API + independent billing.
+
+<!-- mcp-name: ai.deinai/creator-skill-v2 -->
+
+## Quick start
+
+```bash
+cd apps/skill-service
+python -m venv .venv
+.venv/Scripts/python -m pip install -U pip
+.venv/Scripts/pip install -e .
+cp .env.example .env   # edit database / modash keys
+.venv/Scripts/python scripts/init_db.py
+.venv/Scripts/python scripts/seed_dev_account.py --email dev@demo.com --password "12345678" --credits 5000
+.venv/Scripts/python main.py
+```
+
+Health: `GET http://127.0.0.1:8080/health`  
+MCP: `http://127.0.0.1:8080/mcp` (Bearer `sk_live_...`)
+
+## Production
+
+- **Release (Stripe only)**: [docs/PRODUCTION_RELEASE.md](docs/PRODUCTION_RELEASE.md)
+- **Prod deploy script**: `python scripts/deploy_prod_server.py` (uses `prod.yaml` + `.env_prod`)
+- Deploy: [docs/DEPLOY_CHECKLIST.md](docs/DEPLOY_CHECKLIST.md)
+- Local dev: `docker compose -f docker-compose.dev.yml up -d --build` or `scripts/dev_up.ps1 -Build`
+- Payments: [docs/PAYMENT_CALLBACKS.md](docs/PAYMENT_CALLBACKS.md)
+- Payment E2E (Plan A/C): [docs/PAYMENT_E2E_TEST.md](docs/PAYMENT_E2E_TEST.md)
+- Subscription E2E: [docs/SUBSCRIPTION_E2E_TEST.md](docs/SUBSCRIPTION_E2E_TEST.md)
+- **OpenClaw + ClawHub E2E**: [docs/OPENCLAW_E2E_TEST.md](docs/OPENCLAW_E2E_TEST.md)
+- **Stripe 测试环境配置**: [docs/STRIPE_TEST_ENV_SETUP.md](docs/STRIPE_TEST_ENV_SETUP.md)
+- MCP Registry: [output/registry/](output/registry/)
+- Coze HTTP SOP: `deinai_backend/output/coze/PATH-A-SOP.md`
+
+## Stdio bridge (Cursor / Claude Desktop)
+
+```bash
+export SKILL_TOKEN="sk_live_..."
+skill-service-match
+# or: uvx --from skill-service skill-service-match
+```
+
+Optional: `SKILL_MCP_URL` (default `https://skill.deinai.ai/mcp`).
+
+## Status
+
+- Independent account / session (`sk_sess_`) / API token (`sk_live_`)
+- Wallet, recharge, consumption ledger
+- **Portal** (`/portal/`): login, recharge, mock checkout, token management
+- **Payment checkout**: `POST /recharge/orders` returns `payParams` (mock / wechat / alipay)
+- MCP tools: `ping`, `get_location_ids`, `searchInfluencers`
+- REST: `GET /api/v1/account/status`, `POST /api/v1/search/influencers`
+- Admin: credit packages, consume rules, audit logs

skill_service-0.2.0/alembic/versions/0001_init_skills.sql

@@ -0,0 +1,40 @@
+-- 0001_init_skills.sql
+-- Minimal Phase-3 schema for DB-backed token auth.
+
+CREATE EXTENSION IF NOT EXISTS "pgcrypto";
+
+CREATE TABLE IF NOT EXISTS skill_accounts (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  email VARCHAR UNIQUE,
+  password_hash VARCHAR,
+  display_name VARCHAR,
+  status VARCHAR NOT NULL DEFAULT 'active',
+  created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+  updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+
+CREATE TABLE IF NOT EXISTS skill_tokens (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  account_id UUID NOT NULL REFERENCES skill_accounts(id),
+  token_hash VARCHAR NOT NULL UNIQUE,
+  token_prefix VARCHAR(16) NOT NULL,
+  name VARCHAR,
+  scopes TEXT[] NOT NULL DEFAULT ARRAY[]::TEXT[],
+  expires_at TIMESTAMPTZ,
+  revoked_at TIMESTAMPTZ,
+  last_used_at TIMESTAMPTZ,
+  created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+
+CREATE TABLE IF NOT EXISTS skill_account_roles (
+  account_id UUID NOT NULL REFERENCES skill_accounts(id),
+  role VARCHAR NOT NULL,
+  granted_by UUID,
+  granted_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+  PRIMARY KEY (account_id, role)
+);
+
+CREATE INDEX IF NOT EXISTS idx_skill_tokens_account_id ON skill_tokens(account_id);
+CREATE INDEX IF NOT EXISTS idx_skill_tokens_revoked_at ON skill_tokens(revoked_at);
+CREATE INDEX IF NOT EXISTS idx_skill_accounts_status ON skill_accounts(status);
+

skill_service-0.2.0/alembic/versions/0002_wallet_and_billing.sql

@@ -0,0 +1,74 @@
+-- 0002_wallet_and_billing.sql
+-- Wallet, billing rules, and consumption records.
+
+CREATE TABLE IF NOT EXISTS skill_wallets (
+  account_id UUID PRIMARY KEY REFERENCES skill_accounts(id),
+  balance BIGINT NOT NULL DEFAULT 0,
+  frozen_balance BIGINT NOT NULL DEFAULT 0,
+  version INT NOT NULL DEFAULT 0,
+  updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+
+CREATE TABLE IF NOT EXISTS skill_pricing_rules (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  feature VARCHAR NOT NULL,
+  unit_price INT NOT NULL,
+  effective_from TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+  effective_to TIMESTAMPTZ
+);
+
+CREATE TABLE IF NOT EXISTS skill_feature_consume_rules (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  feature VARCHAR UNIQUE NOT NULL,
+  unit_type VARCHAR NOT NULL DEFAULT 'per_result',
+  unit_price INT NOT NULL DEFAULT 1,
+  min_charge INT NOT NULL DEFAULT 0,
+  max_charge INT NOT NULL DEFAULT 0,
+  is_active BOOLEAN NOT NULL DEFAULT true,
+  effective_from TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+  effective_to TIMESTAMPTZ,
+  updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+
+CREATE TABLE IF NOT EXISTS skill_ledger_entries (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  account_id UUID NOT NULL REFERENCES skill_accounts(id),
+  entry_type VARCHAR NOT NULL,
+  amount BIGINT NOT NULL,
+  balance_after BIGINT NOT NULL,
+  ref_type VARCHAR,
+  ref_id UUID,
+  idempotency_key VARCHAR UNIQUE,
+  metadata JSONB NOT NULL DEFAULT '{}'::JSONB,
+  created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+
+CREATE TABLE IF NOT EXISTS skill_consumption_records (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  account_id UUID NOT NULL REFERENCES skill_accounts(id),
+  token_id UUID REFERENCES skill_tokens(id),
+  tool_name VARCHAR NOT NULL,
+  request_id VARCHAR,
+  units INT NOT NULL,
+  unit_price INT NOT NULL,
+  total_cost INT NOT NULL,
+  ledger_entry_id UUID REFERENCES skill_ledger_entries(id),
+  metadata JSONB NOT NULL DEFAULT '{}'::JSONB,
+  created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+
+CREATE INDEX IF NOT EXISTS idx_skill_ledger_account_id ON skill_ledger_entries(account_id);
+CREATE INDEX IF NOT EXISTS idx_skill_consumption_account_id ON skill_consumption_records(account_id);
+
+INSERT INTO skill_feature_consume_rules (feature, unit_type, unit_price, min_charge, max_charge, is_active)
+VALUES ('search', 'per_result', 1, 0, 0, true)
+ON CONFLICT (feature) DO NOTHING;
+
+INSERT INTO skill_feature_consume_rules (feature, unit_type, unit_price, min_charge, max_charge, is_active)
+VALUES ('get_location_ids', 'per_call', 0, 0, 0, true)
+ON CONFLICT (feature) DO NOTHING;
+
+INSERT INTO skill_feature_consume_rules (feature, unit_type, unit_price, min_charge, max_charge, is_active)
+VALUES ('ping', 'per_call', 0, 0, 0, true)
+ON CONFLICT (feature) DO NOTHING;
+

skill_service-0.2.0/alembic/versions/0003_recharge_and_payments.sql

@@ -0,0 +1,53 @@
+-- 0003_recharge_and_payments.sql
+-- Recharge packages, orders, and payment transaction tables.
+
+CREATE TABLE IF NOT EXISTS skill_credit_packages (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  code VARCHAR UNIQUE NOT NULL,
+  credits INT NOT NULL,
+  price_cents INT NOT NULL,
+  list_price_cents INT,
+  title VARCHAR,
+  description VARCHAR,
+  is_active BOOLEAN NOT NULL DEFAULT true,
+  effective_from TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+  effective_to TIMESTAMPTZ,
+  created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+  updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+
+CREATE TABLE IF NOT EXISTS skill_recharge_orders (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  account_id UUID NOT NULL REFERENCES skill_accounts(id),
+  order_no VARCHAR UNIQUE NOT NULL,
+  package_id UUID REFERENCES skill_credit_packages(id),
+  amount_cents INT NOT NULL,
+  credits_granted INT NOT NULL,
+  channel VARCHAR NOT NULL, -- wechat | alipay
+  status VARCHAR NOT NULL DEFAULT 'pending', -- pending | paid | closed | refunded
+  idempotency_key VARCHAR UNIQUE,
+  paid_at TIMESTAMPTZ,
+  created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+
+CREATE TABLE IF NOT EXISTS skill_payment_transactions (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  order_id UUID NOT NULL REFERENCES skill_recharge_orders(id),
+  channel VARCHAR NOT NULL,
+  provider_txn_id VARCHAR UNIQUE,
+  raw_notify JSONB NOT NULL DEFAULT '{}'::JSONB,
+  status VARCHAR NOT NULL,
+  created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+
+CREATE INDEX IF NOT EXISTS idx_skill_recharge_orders_account_id ON skill_recharge_orders(account_id);
+CREATE INDEX IF NOT EXISTS idx_skill_recharge_orders_status ON skill_recharge_orders(status);
+
+INSERT INTO skill_credit_packages (code, credits, price_cents, title, description, is_active)
+VALUES
+  ('D', 100, 2600, 'D 档', '入门体验，1.2 倍单价', true),
+  ('C', 400, 9400, 'C 档', '轻度使用，1.1 倍单价', true),
+  ('B', 1600, 34300, 'B 档', '标准包，基准定价', true),
+  ('A', 5000, 85800, 'A 档', '高频大户，8 折优惠', true)
+ON CONFLICT (code) DO NOTHING;
+

skill_service-0.2.0/alembic/versions/0004_subscriptions.sql

@@ -0,0 +1,26 @@
+-- 0004_subscriptions.sql
+-- Minimal subscription schema for renewal gate.
+
+CREATE TABLE IF NOT EXISTS skill_subscription_plans (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  name VARCHAR NOT NULL,
+  price_cents INT NOT NULL,
+  credits_per_period INT NOT NULL,
+  period_days INT NOT NULL,
+  auto_renew BOOLEAN NOT NULL DEFAULT false
+);
+
+CREATE TABLE IF NOT EXISTS skill_subscriptions (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  account_id UUID NOT NULL REFERENCES skill_accounts(id),
+  plan_id UUID NOT NULL REFERENCES skill_subscription_plans(id),
+  status VARCHAR NOT NULL DEFAULT 'active', -- active | past_due | grace | canceled | expired
+  current_period_start TIMESTAMPTZ NOT NULL,
+  current_period_end TIMESTAMPTZ NOT NULL,
+  auto_renew BOOLEAN NOT NULL DEFAULT false,
+  created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+
+CREATE INDEX IF NOT EXISTS idx_skill_subscriptions_account_id ON skill_subscriptions(account_id);
+CREATE INDEX IF NOT EXISTS idx_skill_subscriptions_status ON skill_subscriptions(status);
+

skill_service-0.2.0/alembic/versions/0005_admin_config_logs.sql

@@ -0,0 +1,19 @@
+-- 0005_admin_config_logs.sql
+-- Config change audit log for admin/ops operations.
+
+CREATE TABLE IF NOT EXISTS skill_config_change_logs (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  config_type VARCHAR NOT NULL, -- credit_package | consume_rule
+  config_key VARCHAR NOT NULL,  -- package code or feature
+  action VARCHAR NOT NULL,      -- create | update | enable | disable
+  before_value JSONB NOT NULL DEFAULT '{}'::JSONB,
+  after_value JSONB NOT NULL DEFAULT '{}'::JSONB,
+  operator_id UUID,
+  operator_email VARCHAR,
+  reason VARCHAR,
+  created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+
+CREATE INDEX IF NOT EXISTS idx_skill_cfg_logs_type_key ON skill_config_change_logs(config_type, config_key);
+CREATE INDEX IF NOT EXISTS idx_skill_cfg_logs_created_at ON skill_config_change_logs(created_at);
+

skill_service-0.2.0/alembic/versions/0006_sessions.sql

@@ -0,0 +1,15 @@
+-- 0006_sessions.sql
+-- Portal session tokens for account management without password on each request.
+
+CREATE TABLE IF NOT EXISTS skill_sessions (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  account_id UUID NOT NULL REFERENCES skill_accounts(id),
+  session_hash VARCHAR NOT NULL UNIQUE,
+  expires_at TIMESTAMPTZ NOT NULL,
+  revoked_at TIMESTAMPTZ,
+  last_used_at TIMESTAMPTZ,
+  created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+
+CREATE INDEX IF NOT EXISTS idx_skill_sessions_account_id ON skill_sessions(account_id);
+CREATE INDEX IF NOT EXISTS idx_skill_sessions_expires_at ON skill_sessions(expires_at);

skill_service-0.2.0/alembic/versions/0007_order_pay_params.sql

@@ -0,0 +1,9 @@
+-- 0007_order_pay_params.sql
+-- Store gateway prepay payload on recharge orders.
+
+ALTER TABLE skill_recharge_orders
+  ADD COLUMN IF NOT EXISTS pay_params JSONB NOT NULL DEFAULT '{}'::JSONB,
+  ADD COLUMN IF NOT EXISTS provider_prepay_id VARCHAR,
+  ADD COLUMN IF NOT EXISTS expires_at TIMESTAMPTZ;
+
+CREATE INDEX IF NOT EXISTS idx_skill_recharge_orders_order_no ON skill_recharge_orders(order_no);

skill_service-0.2.0/alembic/versions/0008_subscription_stripe.sql

@@ -0,0 +1,48 @@
+-- 0008_subscription_stripe.sql
+-- Stripe auto-subscription plans + account linkage.
+
+ALTER TABLE skill_subscription_plans
+  ADD COLUMN IF NOT EXISTS code VARCHAR,
+  ADD COLUMN IF NOT EXISTS stripe_product_id VARCHAR,
+  ADD COLUMN IF NOT EXISTS stripe_price_id_monthly VARCHAR,
+  ADD COLUMN IF NOT EXISTS stripe_price_id_yearly VARCHAR,
+  ADD COLUMN IF NOT EXISTS seats INT NOT NULL DEFAULT 1;
+
+DO $$
+BEGIN
+  IF NOT EXISTS (
+    SELECT 1 FROM pg_constraint WHERE conname = 'skill_subscription_plans_code_key'
+  ) THEN
+    ALTER TABLE skill_subscription_plans ADD CONSTRAINT skill_subscription_plans_code_key UNIQUE (code);
+  END IF;
+END $$;
+
+ALTER TABLE skill_subscriptions
+  ADD COLUMN IF NOT EXISTS stripe_subscription_id VARCHAR,
+  ADD COLUMN IF NOT EXISTS stripe_customer_id VARCHAR,
+  ADD COLUMN IF NOT EXISTS credits_period_month VARCHAR;
+
+CREATE UNIQUE INDEX IF NOT EXISTS idx_skill_subscriptions_stripe_sub_id
+  ON skill_subscriptions(stripe_subscription_id) WHERE stripe_subscription_id IS NOT NULL;
+
+ALTER TABLE skill_recharge_orders
+  ADD COLUMN IF NOT EXISTS order_kind VARCHAR NOT NULL DEFAULT 'one_time',
+  ADD COLUMN IF NOT EXISTS plan_code VARCHAR,
+  ADD COLUMN IF NOT EXISTS billing_interval VARCHAR;
+
+INSERT INTO skill_subscription_plans (
+  code, name, price_cents, credits_per_period, period_days, auto_renew,
+  stripe_product_id, stripe_price_id_monthly, seats
+) VALUES
+  ('starter', '基础版 Starter', 4900, 1200, 30, true, 'prod_UkTCwwK294NReq', 'price_1TkyFp1IU0S8vi06Qlg2uLdD', 3),
+  ('pro', '专业版 Pro', 19900, 6000, 30, true, 'prod_UkTCmMULdliGZ2', 'price_1TkyGO1IU0S8vi060XbAmbAr', 5),
+  ('growth', '增长版 Growth', 49900, 20000, 30, true, 'prod_UkTD5o9CVt48dU', 'price_1TkyHI1IU0S8vi06h2pdiAQd', 10)
+ON CONFLICT (code) DO UPDATE SET
+  name = EXCLUDED.name,
+  price_cents = EXCLUDED.price_cents,
+  credits_per_period = EXCLUDED.credits_per_period,
+  period_days = EXCLUDED.period_days,
+  auto_renew = EXCLUDED.auto_renew,
+  stripe_product_id = EXCLUDED.stripe_product_id,
+  stripe_price_id_monthly = EXCLUDED.stripe_price_id_monthly,
+  seats = EXCLUDED.seats;

skill_service-0.2.0/alembic/versions/0009_subscription_billing_period.sql

@@ -0,0 +1,5 @@
+-- 0009_subscription_billing_period.sql
+-- Credits follow Stripe billing period; drop calendar-month tracking.
+
+ALTER TABLE skill_subscriptions
+  ADD COLUMN IF NOT EXISTS last_credit_invoice_id VARCHAR;

skill_service-0.2.0/alembic/versions/0010_subscription_stripe_unique.sql

@@ -0,0 +1,5 @@
+-- 0010_subscription_stripe_unique.sql
+-- Required for idempotent subscription upserts.
+
+CREATE UNIQUE INDEX IF NOT EXISTS idx_skill_subscriptions_stripe_sub_id_unique
+  ON skill_subscriptions(stripe_subscription_id);

skill_service-0.2.0/alembic/versions/0011_subscription_constraints.sql

@@ -0,0 +1,25 @@
+-- 0011_subscription_constraints.sql
+-- One active subscription per account; faster pending-order lookup.
+
+-- Keep newest billing period per account when cleaning legacy duplicates.
+WITH ranked AS (
+  SELECT id,
+         ROW_NUMBER() OVER (
+           PARTITION BY account_id
+           ORDER BY current_period_end DESC NULLS LAST, created_at DESC
+         ) AS rn
+  FROM skill_subscriptions
+  WHERE status = 'active'
+)
+UPDATE skill_subscriptions s
+SET status = 'canceled', auto_renew = false
+FROM ranked r
+WHERE s.id = r.id AND r.rn > 1;
+
+CREATE UNIQUE INDEX IF NOT EXISTS idx_skill_subscriptions_one_active_per_account
+  ON skill_subscriptions(account_id)
+  WHERE status = 'active';
+
+CREATE INDEX IF NOT EXISTS idx_skill_recharge_orders_sub_pending
+  ON skill_recharge_orders(account_id, plan_code, status)
+  WHERE order_kind = 'subscription' AND status = 'pending';

skill_service-0.2.0/deploy/.env.live.example

@@ -0,0 +1,35 @@
+# Live payment — copy to server /root/apps/skill-service/.env (merge with existing)
+# See docs/PAYMENT_LIVE_SETUP.md and docs/PAYMENT_STRIPE.md
+
+PAYMENT_MODE=live
+# Do NOT set true in production unless debugging
+PAYMENT_ALLOW_MOCK_FALLBACK=false
+
+SKILL_PUBLIC_BASE_URL=http://15.135.232.100:18080
+
+# --- WeChat Pay API v3 (Native QR) ---
+WECHAT_APP_ID=
+WECHAT_MCH_ID=
+WECHAT_MCH_SERIAL_NO=
+# Option A: PEM inline with \n
+WECHAT_MCH_PRIVATE_KEY=
+# Option B: mount file in container e.g. /secrets/wechat_apiclient_key.pem
+WECHAT_MCH_PRIVATE_KEY_PATH=
+WECHAT_API_V3_KEY=
+WECHAT_PLATFORM_PUBLIC_KEY=
+
+# --- Alipay ---
+ALIPAY_APP_ID=
+ALIPAY_PRIVATE_KEY=
+ALIPAY_PRIVATE_KEY_PATH=
+ALIPAY_PUBLIC_KEY=
+# Production:
+ALIPAY_GATEWAY_URL=https://openapi.alipay.com/gateway.do
+# Sandbox:
+# ALIPAY_GATEWAY_URL=https://openapi-sandbox.dl.alipaydev.com/gateway.do
+
+# --- Stripe (Checkout + Webhook) ---
+STRIPE_SECRET_KEY=sk_test_...
+STRIPE_WEBHOOK_SECRET=whsec_...
+STRIPE_PUBLISHABLE_KEY=pk_test_...
+STRIPE_CURRENCY=cny