Veyra/AGENTS.md

Veyra 工程约定

项目背景、已完成功能和验证状态见 docs/development-state.md。继续开发前阅读该文件，完成工作后更新事实与待办，不记录密码。

• 后端使用 Go，遵循 gofmt、go vet、惯用错误处理、context 传递、明确依赖注入及 cmd/internal 分层。
• 后端采用仓库根目录的单 Go module：cmd 放入口，internal 按 model、service、repository、handler、config、database 等职责组织；管理端位于 web/admin。避免为单体项目重复嵌套 services/api、业务域目录和 platform 层，不引入单模块 go.work。
• HTTP handler 只做协议适配，业务规则归 service/domain，SQL 归 repository。不得将 Gin Context 传入业务层。
• PostgreSQL 所有表（包括迁移、任务和关联表）必须以 veyra_ 开头，表与字段使用 snake_case。
• 主键 id 使用字符串 UUID：Go 类型 string，数据库 varchar(36) 并校验 UUID 格式。外键保持相同类型。
• 映射去掉表名前缀并转 PascalCase：veyra_user → User，veyra_trade_plan → TradePlan。使用显式 SQL 与 db tag，不依赖 ORM 隐式命名。
• 金额、价格、数量规则不得使用 float64；采用明确精度的整数或 Decimal。
• 已入账成交不可覆盖，采用冲正；触发提醒不可产生持仓或扣款。
• 管理端必须采用 Vite + React + TypeScript + Tailwind CSS + shadcn/ui，保留暖白、炭黑、焦糖橙视觉。
• 管理端生产构建必须通过 Go embed 嵌入后端，页面和 API 同源服务，Vite 仅用于本地开发。
• App 采用 React Native + Expo，白底、石墨黑与柔紫。
• 凭据通过环境配置，禁止提交 .env、打印连接串或口令。所有数据库变更使用版本化迁移。
• 功能与真实数据能力必须如实呈现；不得用演示结果冒充在线统计。
• 更改后完成对应测试、go vet、类型检查与构建。原始两个设计文件保留。
• PostgreSQL 开发地址为 192.168.100.127:5432，数据库名 veyra；Redis 为 192.168.100.127:6379，无用户名、有密码。实际凭据只从本地 .env 读取。
• 本机与数据库处于同一内网。若工具返回 Operation not permitted，应区分执行沙箱权限限制与主机网络故障，不因此修改服务地址。