Files
NianAIGC/.project-docs/00-brief/project-positioning.md
T

49 lines
2.6 KiB
Markdown

# Project Positioning
## One-line Positioning
智念AIGC平台 (Zhinian AIGC Platform) is a production-deployable Web workbench for AI image and video creation with organization accounts, usage tracking, and billing.
## Primary Goal
The project exists to give organizations an Alibaba Cloud ACK-deployable AI creation platform: prompt authoring, material upload, image generation (即梦/Jimeng 4.6 and EvoLink GPT Image 2), video generation (Seedance 2.0), task management, result download, account and role management, usage reporting, and organization billing backed by direct RDS PostgreSQL persistence.
## Target Users / Consumers
- Ordinary organization members: create images and videos, manage their own account and password.
- Organization administrators: manage members, organizations, and engine settings.
- Super administrators: own pricing rules, wallets, ledger adjustments, and platform logs.
- External partner systems: consume the API-key authenticated public `/api/v1` surface.
## Non-goals
- This project does not aim to be a model-training, dataset, or labeling platform.
- It is not a public social sharing site; assets stay account and organization scoped.
- In the current version it is not a horizontally auto-scaled multi-region
SaaS: the static Web is stateless, but Go remains one replica until generated
and uploaded assets move to shared OSS.
## Core Constraints
- Same-origin browser authentication through signed, chunked `zhinian_session` cookies with per-request account/organization/sessionVersion revalidation.
- Production persistence fails closed: explicit RDS PostgreSQL through the Go
PostgreSQL Adapter; local JSON is development/test only.
- PostgreSQL clients enforce plaintext (`sslmode=disable`) for the selected RDS
endpoint. Production database traffic must stay on the internal network and
be restricted by VPC, security-group, and RDS allowlist controls.
- Production Web is a static export on Nginx. Browser runtime requests stay
same-origin and all API/file/auth behavior belongs to Go.
- Cross-instance concurrency stays in PostgreSQL: `claim_generation_jobs` for job claims and `billing_post_wallet_entry` for wallet idempotency; no process-local lock replacements.
- Chinese-first product surfaces; production deployment targets Alibaba Cloud ACK.
## Quality Bar
A good solution should preserve current HTTP/Cookie/authorization behavior,
keep provider, billing, and storage semantics idempotent and tenant-scoped,
pass the executable contracts under `contracts/`, and keep the static Web/Go
runtime boundary mechanically testable.
## Last Reviewed
2026-08-16