# Aurask API

`api/` 包含 Aurask 后端服务与外部组件桥接配置。

## 当前实现范围

- HTTP 网关：`api/aurask/api.py`
- 应用装配：`api/aurask/app.py`
- 租户、用户、API Key、Session：`api/aurask/auth.py`
- 套餐、订单、支付、TBU：`api/aurask/plans.py`、`api/aurask/billing.py`、`api/aurask/quota.py`
- 工作流编排：`api/aurask/orchestrator.py`
- AnythingLLM workspace / 文档接入门面：`api/aurask/knowledge_base.py`
- PostgreSQL / PGVector / Redis / AnythingLLM / Langflow 桥接：`api/aurask/bridges/`
- 门户站点配置：`api/aurask/site_config.py`

## 认证模式

Aurask 现在支持两类 Bearer Token：

1. API Key
   - 适用于接口集成、自动化脚本
   - 由创建租户/用户或 demo bootstrap 返回
2. Session Token
   - 适用于 `protal/` 登录态
   - 由 Google 登录接口签发

## 公开接口

```text
GET  /health
GET  /plans
GET  /auth/config
POST /auth/google/login
POST /demo/bootstrap
POST /tenants
```

## 鉴权接口

```text
GET  /auth/session
POST /auth/logout
GET  /me
GET  /quota
GET  /workflow-templates
GET  /workspaces
POST /workspaces
POST /documents
POST /orders
POST /payments/match
POST /workflow-runs
GET  /workflow-runs/{run_id}
GET  /admin/bridge-status
```

## 门户与嵌入配置

`GET /auth/config` 会向前端返回：

- 公网站点地址
- API 地址
- Google 开关
- Langflow / AnythingLLM iframe 地址
- DevCloud 对齐后的镜像与 NodePort 默认值

## 环境变量

### 门户 / 登录

```text
AURASK_PUBLIC_BASE_URL=https://aurask.xyz
AURASK_PUBLIC_API_BASE_URL=https://aurask.xyz/api
AURASK_PUBLIC_LANGFLOW_URL=https://aurask.xyz/runtime/langflow/
AURASK_PUBLIC_ANYTHINGLLM_URL=https://aurask.xyz/runtime/anythingllm/
AURASK_GOOGLE_ENABLED=true
AURASK_GOOGLE_CLIENT_ID=<google-client-id>
AURASK_GOOGLE_TOKENINFO_URL=https://oauth2.googleapis.com/tokeninfo
AURASK_GOOGLE_ALLOW_UNVERIFIED_ID_TOKEN=false
AURASK_SESSION_TTL_DAYS=7
AURASK_CORS_ALLOW_ORIGIN=https://aurask.xyz
```

### 运行时桥接

```text
AURASK_USE_EXTERNAL_BRIDGES=true
AURASK_DATABASE_URL=postgresql://aurask:<password>@postgres.aurask-data.svc.cluster.local:5432/aurask
AURASK_POSTGRES_MIN_CONNECTIONS=1
AURASK_POSTGRES_MAX_CONNECTIONS=10
AURASK_PGVECTOR_TABLE=aurask_vectors
AURASK_PGVECTOR_DIMENSION=1536
AURASK_REDIS_URL=redis://redis.aurask-data.svc.cluster.local:6379/0
AURASK_REDIS_WORKFLOW_QUEUE=aurask:workflow-runs
AURASK_ANYTHINGLLM_BASE_URL=http://anythingllm.aurask-runtime.svc.cluster.local:3001
AURASK_ANYTHINGLLM_API_KEY=<anythingllm-api-key>
AURASK_LANGFLOW_BASE_URL=http://langflow-runtime.aurask-runtime.svc.cluster.local:7860
AURASK_LANGFLOW_API_KEY=<langflow-api-key>
```

## DevCloud 默认值

已内置以下默认值以对齐 `devcloud` 当前部署：

```text
AURASK_DEVCLOUD_API_IMAGE=registry.mydevcloud.love/devcloud/aurask-api:latest
AURASK_DEVCLOUD_WEB_IMAGE=registry.mydevcloud.love/devcloud/aurask-web:latest
AURASK_DEVCLOUD_API_NODE_URL=http://45.113.2.55:30091
AURASK_DEVCLOUD_WEB_NODE_URL=http://45.113.2.55:30090
```

## 示例请求

接口示例文件：

- `api/requests/aurask-api.http`

## 本地验证

```powershell
$env:PYTHONPATH='api'
py -3 -m aurask serve --reset --host 127.0.0.1 --port 8080
cmd /c "py -3 -m unittest discover -s tests -v"
```