ai-workspace-services/portal
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: clarify web console billing boundaries

Browse Source
This commit is contained in:
Haitao Pan 2026-04-11 13:47:59 +08:00
parent 651101c253
commit e774ef0794
2 changed files with 9 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

9
docs/architecture/web-console/overview.md
View File

@ -2,7 +2,7 @@
## Scope ## Scope
`console.svc.plus` is the browser-facing control plane. It is a Next.js App Router application that combines public pages, docs browsing, account/admin panels, and a BFF layer that forwards requests to downstream services. `console.svc.plus` is the browser-facing control plane. It is a Next.js App Router application that combines public pages, docs browsing, account/admin panels, and a BFF layer that forwards requests to downstream services. It never reads PostgreSQL or Prometheus directly for billing or usage.
## Architecture ## Architecture
@ -30,7 +30,9 @@ flowchart TB
Accounts["accounts.svc.plus"] Accounts["accounts.svc.plus"]
Rag["rag-server.svc.plus"] Rag["rag-server.svc.plus"]
DocsSvc["docs.svc.plus"] DocsSvc["docs.svc.plus"]
Grafana["observability.svc.plus / Grafana"]
External["Other upstream services"] External["Other upstream services"]
Subscription["/panel/subscription\nUsage / billing panel"]
AuthAPI --> Accounts AuthAPI --> Accounts
AdminAPI --> Accounts AdminAPI --> Accounts
@ -39,6 +41,8 @@ flowchart TB
UtilAPI --> DocsSvc UtilAPI --> DocsSvc
UtilAPI --> External UtilAPI --> External
SandboxAPI --> Accounts SandboxAPI --> Accounts
Subscription --> Accounts
Subscription -.-> Grafana
``` ```
## Frontend Routes ## Frontend Routes
@ -79,11 +83,14 @@ flowchart TB
## Dependencies ## Dependencies
- `accounts.svc.plus` for identity, profile, sandbox, billing, and admin actions. - `accounts.svc.plus` for identity, profile, sandbox, billing, and admin actions.
- `accounts.svc.plus` for authoritative usage and billing summaries sourced from PostgreSQL.
- `rag-server.svc.plus` for RAG query and AskAI. - `rag-server.svc.plus` for RAG query and AskAI.
- `docs.svc.plus` for docs content and navigation data. - `docs.svc.plus` for docs content and navigation data.
- `observability.svc.plus` for Grafana dashboards and operational views only.
- CDN / external providers for content, analytics, and integration checks. - CDN / external providers for content, analytics, and integration checks.
## Notes ## Notes
- Route groups in parentheses, such as `(auth)`, are Next.js organizational folders and do not appear in the public URL. - Route groups in parentheses, such as `(auth)`, are Next.js organizational folders and do not appear in the public URL.
- The BFF layer is the main place where console-specific auth shaping, cookie management, and upstream proxying happen. - The BFF layer is the main place where console-specific auth shaping, cookie management, and upstream proxying happen.
- The subscription panel displays usage and billing data from accounts only and treats Grafana as an embedded observability surface, not a billing source.

2
next-env.d.ts vendored
View File

@ -1,6 +1,6 @@
/// <reference types="next" /> /// <reference types="next" />
/// <reference types="next/image-types/global" /> /// <reference types="next/image-types/global" />
import "./.next/dev/types/routes.d.ts"; import "./.next/types/routes.d.ts";
// NOTE: This file should not be edited // NOTE: This file should not be edited
// see https://nextjs.org/docs/app/api-reference/config/typescript for more information. // see https://nextjs.org/docs/app/api-reference/config/typescript for more information.