docs: record local environment baseline (#5)
This commit is contained in:
@@ -2,8 +2,8 @@
|
||||
generated: true (请先修改 Gitea Wiki,禁止直接编辑本文件)
|
||||
wiki_page: Project-Profile
|
||||
wiki_url: https://git.ilapage.cn/OPC/chorus/wiki/Project-Profile.-
|
||||
wiki_revision: 4a1a822e3cce84386e80447f0aa05fad92544ce9
|
||||
synchronized_at: 2026-08-20T07:03:59Z
|
||||
wiki_revision: 3bbe90891a4d2bdf0f6af5160f0b687792e0f19f
|
||||
synchronized_at: 2026-08-20T14:49:59Z
|
||||
<!-- gitea-wiki-mirror:end -->
|
||||
|
||||
# 项目档案
|
||||
@@ -69,7 +69,7 @@ synchronized_at: 2026-08-20T07:03:59Z
|
||||
| Go | 1.26.5 | 以固定 go-admin 的 `go.mod` 为最低统一版本,不再使用原文档的 Go 1.22+ |
|
||||
| HTTP | Gin | portal 与 admin 共用生态,但 core 不依赖 Gin |
|
||||
| ORM 与迁移 | GORM + golang-migrate | GORM 负责运行期持久化;生产禁止 AutoMigrate |
|
||||
| 数据库 | MySQL 8.0 | 单库;队列依赖 `SELECT … FOR UPDATE SKIP LOCKED` |
|
||||
| 数据库 | MySQL 8.0+;当前开发验收为 8.4.8 | 单库;队列依赖 `SELECT … FOR UPDATE SKIP LOCKED` |
|
||||
| 队列 | MySQL 租约 | 不引入 Redis/MQ;租约 token + CAS 防止陈旧 worker 提交 |
|
||||
| 管理端 | 固定 go-admin + go-admin-ui | schema-first 生成 CRUD;生产关闭 dev-tools |
|
||||
| 用户端会话 | alexedwards/scs | Cookie 会话,不复用管理员 JWT |
|
||||
@@ -77,8 +77,15 @@ synchronized_at: 2026-08-20T07:03:59Z
|
||||
| 限流 | ulule/limiter | MVP-2 用户维度令牌桶 |
|
||||
| 上游调用 | `net/http` 适配器 | 支持多图、`extra_body`、URL/Base64 差异,并实施 SSRF 钩子 |
|
||||
| 用户端 UI | html/template + HTMX 2.x + Alpine 3.x + Tailwind 4.x standalone | portal 不需要 Node;admin-ui 构建需要 Node/pnpm |
|
||||
| 开发环境 | Windows + PowerShell + Git;MySQL 8.0 本地或容器 | Harness 使用 Python 3 标准库 |
|
||||
| 开发环境 | Windows + PowerShell + Git;本机隔离 MySQL 8 | Harness 使用 Python 3 标准库;Chorus 专用实例使用回环地址和独立端口/数据目录 |
|
||||
|
||||
### 已验证的 MVP-0 本机基线(2026-08-20)
|
||||
|
||||
- Go 使用官方 Windows amd64 压缩包固定为 1.26.5;SHA-256 为 `97e6b2a833b6d89f9ff17d25419ac0a7e3b482a044e9ab18cdef834bd834fd38`。便携工具目录加入当前开发 Shell 的 `PATH`,不替换机器已有 Go。
|
||||
- `golang-migrate` 固定为 v4.19.1;Windows amd64 发布资产 SHA-256 为 `d2537dfd991787c1e458965c4f49098c5a72f943bfc9d975c573a9c245f7ba2e`。
|
||||
- 开发数据库复用本机 MySQL 8.4.8 二进制,但使用 Chorus 专用数据目录、`127.0.0.1:3308` 和独立账号/库;现有 `3307` 实例和 MySQL 5.7 服务均不修改。
|
||||
- 本机凭据由仓库外、仅当前账号可读的 PowerShell 环境文件注入;Wiki、工单、Git 和日志只记录变量名,不记录密码或完整 DSN。
|
||||
- 已验证实例停止/重启、最小权限连接以及 `SELECT ... FOR UPDATE SKIP LOCKED`。这只证明开发环境可用,不代表生产部署已经验证。
|
||||
### AutoMigrate 与代码生成结论
|
||||
|
||||
- go-admin 固定提交的 `cmd/migrate` 和模板中确有 AutoMigrate;它适合帮助理解脚手架初始化结构,但不是可审查、可回退的生产迁移。
|
||||
|
||||
Reference in New Issue
Block a user