# 1. 鍏嬮殕浠撳簱
git clone https://github.com/your-org/xiaoxia-saas.git
cd xiaoxia-saas

# 2. 鍚姩鎵€鏈夋湇鍔?docker-compose up -d

# 3. 璁块棶 API 鏂囨。
open http://localhost:8000/docs

灏辫繖涔堢畝鍗曪紒馃帀

鏂瑰紡 2: 鏈湴寮€鍙?

# 1. 鍏嬮殕浠撳簱
git clone https://github.com/your-org/xiaoxia-saas.git
cd xiaoxia-saas

# 2. 鍒涘缓铏氭嫙鐜
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

# 3. 瀹夎渚濊禆
pip install -r requirements.txt

# 4. 浣跨敤鍐呭瓨鏁版嵁搴擄紙鏃犻渶 PostgreSQL锛?echo "USE_IN_MEMORY_DB=true" > .env

# 5. 鍚姩寮€鍙戞湇鍔″櫒
uvicorn apps.api.main:app --reload

# 6. 璁块棶 API 鏂囨。
open http://localhost:8000/docs

馃摉 API 绀轰緥

娉ㄥ唽鐢ㄦ埛

curl -X POST http://localhost:8000/api/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{
    "email": "user@example.com",
    "password": "SecurePass123",
    "username": "myuser",
    "display_name": "My Name"
  }'

鐧诲綍

curl -X POST http://localhost:8000/api/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{
    "email": "user@example.com",
    "password": "SecurePass123"
  }'

鍒涘缓宸ヤ綔绌洪棿

curl -X POST http://localhost:8000/api/v1/workspaces \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "鎴戠殑鍥㈤槦",
    "subscription_plan": "free"
  }'

馃彈锔?鏋舵瀯

灏忚櫨 SaaS
鈹溾攢鈹€ packages/              # 鏍稿績涓氬姟閫昏緫
鈹?  鈹溾攢鈹€ domain/           # 棰嗗煙妯″瀷
鈹?  鈹溾攢鈹€ application/      # 鐢ㄤ緥
鈹?  鈹溾攢鈹€ ports/            # 鎺ュ彛瀹氫箟
鈹?  鈹斺攢鈹€ adapters/         # 閫傞厤鍣ㄥ疄鐜?鈹溾攢鈹€ apps/                 # 搴旂敤灞?鈹?  鈹斺攢鈹€ api/             # FastAPI 搴旂敤
鈹溾攢鈹€ migrations/           # 鏁版嵁搴撹縼绉?鈹溾攢鈹€ tests/               # 娴嬭瘯
鈹?  鈹溾攢鈹€ unit/           # 鍗曞厓娴嬭瘯锛?70 涓級
鈹?  鈹斺攢鈹€ integration/    # 闆嗘垚娴嬭瘯锛?2 涓級
鈹斺攢鈹€ docs/                # 鏂囨。

璁捐妯″紡:

Clean Architecture
渚濊禆娉ㄥ叆
Repository 妯″紡
Domain-Driven Design

馃敡閰嶇疆

鐜鍙橀噺

# 鏁版嵁搴撳垏鎹?USE_IN_MEMORY_DB=true          # 寮€鍙戠幆澧冿紙鏃犻渶 PostgreSQL锛?USE_IN_MEMORY_DB=false         # 鐢熶骇鐜锛堜娇鐢?PostgreSQL锛?
# 鏁版嵁搴撹繛鎺?DATABASE_URL=postgresql://user:pass@localhost:5432/xiaoxia_saas

# JWT 閰嶇疆
JWT_SECRET_KEY=your-secret-key-at-least-32-chars

# 閭欢閰嶇疆
SMTP_HOST=smtp.gmail.com
SMTP_USER=your-email@gmail.com
SMTP_PASSWORD=your-app-password

瀹屾暣閰嶇疆鍙傝€?.env.example

馃И 娴嬭瘯

# 杩愯鎵€鏈夋祴璇?pytest tests/ -v

# 杩愯鍗曞厓娴嬭瘯
pytest tests/unit -v

# 鐢熸垚瑕嗙洊鐜囨姤鍛?pytest --cov=packages --cov-report=html

# 鏌ョ湅瑕嗙洊鐜?open htmlcov/index.html

娴嬭瘯缁熻:

鍗曞厓娴嬭瘯: 170 涓?鉁?- 娴嬭瘯瑕嗙洊鐜? 85%+
闆嗘垚娴嬭瘯: 12 涓?

馃摎鏂囨。

API 浣跨敤鎸囧崡
Docker 閮ㄧ讲鎸囧崡
[鏁版嵁搴撳垏鎹㈡寚鍗梋(docs/DATABASE-SWITCH.md)
鎬ц兘鐩戞帶鎸囧崡
鐜閰嶇疆鎸囧崡
[鍋ュ悍妫€鏌ユ寚鍗梋(docs/HEALTH-CHECKS.md)
鍒嗛〉浣跨敤鎸囧崡
[鐢熶骇閮ㄧ讲妫€鏌ユ竻鍗昡(docs/PRODUCTION-CHECKLIST.md)
璐＄尞鎸囧崡

馃殺閮ㄧ讲

Kubernetes

apiVersion: apps/v1
kind: Deployment
metadata:
  name: xiaoxia-api
spec:
  replicas: 3
  template:
    spec:
      containers:
      - name: api
        image: xiaoxia-saas:latest
        ports:
        - containerPort: 8000
        livenessProbe:
          httpGet:
            path: /health
            port: 8000
        readinessProbe:
          httpGet:
            path: /ready
            port: 8000

Docker Compose

version: '3.8'
services:
  api:
    build: .
    ports:
      - "8000:8000"
    environment:
      - DATABASE_URL=postgresql://...
      - REDIS_URL=redis://...

鏌ョ湅瀹屾暣閮ㄧ讲鎸囧崡

馃幆鎶€鏈爤

鍚庣:

Python 3.12
FastAPI 0.115.0
Pydantic 2.9
PostgreSQL 16
Redis 7

娴嬭瘯:

pytest
pytest-asyncio
pytest-cov

閮ㄧ讲:

Docker
Docker Compose
Kubernetes锛堝彲閫夛級

馃搳鎬ц兘

鎸囨爣	鏁板€?
API 骞冲潎鍝嶅簲鏃堕棿	< 50ms
鏁版嵁搴撴煡璇㈡椂闂?	< 10ms
骞跺彂鏀寔	1000+ RPS
杩炴帴姹犳€ц兘鎻愬崌	5-6x
娴嬭瘯瑕嗙洊鐜?	85%+

馃 璐＄尞

娆㈣繋璐＄尞锛佽鏌ョ湅璐＄尞鎸囧崡

Fork 椤圭洰
鍒涘缓鍒嗘敮 (git checkout -b feature/AmazingFeature)
鎻愪氦鏇存敼 (git commit -m 'feat: Add some AmazingFeature')
鎺ㄩ€佸埌鍒嗘敮 (git push origin feature/AmazingFeature)
鍒涘缓 Pull Request

馃搫璁稿彲璇?

鏈」鐩噰鐢?MIT 璁稿彲璇?- 鏌ョ湅 LICENSE 鏂囦欢浜嗚В璇︽儏

馃摓鑱旂郴鏂瑰紡

鏂囨。: https://docs.xiaoxia-saas.com
闂鍙嶉: GitHub Issues
閭: support@xiaoxia-saas.com

馃帀鑷磋阿

鎰熻阿鎵€鏈夎础鐚€呭拰浣跨敤鑰咃紒

寮€鍙戝洟闃? 灏忚櫨馃

*猸?濡傛灉杩欎釜椤圭洰瀵逛綘鏈夊府鍔╋紝璇风粰涓€涓?Star锛?

Releases 7

v2.1.0-test.9 Latest

2026-07-09 08:32:46 +08:00

Languages

Python 75.2%

TypeScript 17.6%

CSS 4.1%

Shell 2.9%

Dockerfile 0.1%

Other 0.1%

README.md

灏忚櫨 SaaS - 鑷姩鍖栧壀杈?SaaS 骞冲彴

涓€涓姛鑳藉畬鏁淬€佺敓浜у氨缁殑澶氱鎴?SaaS 骞冲彴锛屼笓涓鸿嚜鍔ㄥ寲瑙嗛鍓緫鏈嶅姟璁捐銆?

鉁?鐗规€?

馃攼 瀹屾暣鐨勮璇佺郴缁?- JWT 璁よ瘉锛坅ccess + refresh token锛?- 閭楠岃瘉鍜屽瘑鐮侀噸缃?- Session 绠＄悊

馃彚 澶氱鎴锋灦鏋?- 宸ヤ綔绌洪棿闅旂

馃挸 璁㈤槄绠＄悊

鈿?楂樻€ц兘

馃摎 瀹屾暣鏂囨。

馃殌 蹇€熷紑濮?

鏂瑰紡 1: Docker锛堟帹鑽愶級

鏂瑰紡 2: 鏈湴寮€鍙?

馃摉 API 绀轰緥

娉ㄥ唽鐢ㄦ埛

鐧诲綍

鍒涘缓宸ヤ綔绌洪棿

馃彈锔?鏋舵瀯

馃敡 閰嶇疆

鐜鍙橀噺

馃И 娴嬭瘯

馃摎 鏂囨。

馃殺 閮ㄧ讲

Kubernetes

Docker Compose

馃幆 鎶€鏈爤

馃搳 鎬ц兘

馃 璐＄尞

馃搫 璁稿彲璇?

馃摓 鑱旂郴鏂瑰紡

馃帀 鑷磋阿

馃攼瀹屾暣鐨勮璇佺郴缁?- JWT 璁よ瘉锛坅ccess + refresh token锛?- 閭楠岃瘉鍜屽瘑鐮侀噸缃?- Session 绠＄悊

馃彚澶氱鎴锋灦鏋?- 宸ヤ綔绌洪棿闅旂

馃挸璁㈤槄绠＄悊

馃摎瀹屾暣鏂囨。

馃殌蹇€熷紑濮?