43 lines
1.1 KiB
Markdown
43 lines
1.1 KiB
Markdown
# 代码规范
|
||
|
||
## 注释语言
|
||
|
||
所有代码注释必须使用**中文**，禁止使用英文注释。
|
||
|
||
适用范围：Go、Java、JavaScript、TypeScript、Vue、CSS、SQL 等所有文件。
|
||
|
||
示例（Go）：
|
||
```go
|
||
// 获取商品列表
|
||
func (s *ProductStore) List() ([]models.Product, error) {
|
||
// 查询所有激活状态的商品
|
||
...
|
||
}
|
||
```
|
||
|
||
示例（JavaScript/Vue）：
|
||
```js
|
||
// 初始化认证状态
|
||
const saved = loadAuth()
|
||
```
|
||
|
||
## 域名与环境配置
|
||
|
||
- 前端生产环境域名：`store.shumengya.top`
|
||
- 后端生产环境域名：`store.api.shumengya.top`
|
||
- 后端 CORS 策略：宽松模式，允许所有来源（`AllowOrigins: ["*"]`）
|
||
|
||
前端 `.env.production` 示例：
|
||
```
|
||
VITE_API_BASE_URL=https://store.api.shumengya.top
|
||
```
|
||
|
||
后端 CORS 配置示例（Go/Gin）：
|
||
```go
|
||
r.Use(cors.New(cors.Config{
|
||
AllowOrigins: []string{"*"},
|
||
AllowMethods: []string{"GET", "POST", "PUT", "PATCH", "DELETE", "OPTIONS"},
|
||
AllowHeaders: []string{"Origin", "Content-Type", "Accept", "Authorization", "X-Admin-Token"},
|
||
}))
|
||
```
|