feat: 基础框架搭建完毕

docs/development-state.md

@@ -33,6 +33,19 @@
 - OpenAPI、依赖锁文件、Makefile 和带 PostgreSQL 集成测试服务的 CI。
 - `make build` 生成内嵌管理端的 veyra-api，以及 veyra-db 和 veyra-user。
 
+## 当前工程目录
+
+- 用户指出旧后端目录过深，当前已改为仓库根目录的单 Go module。
+- module 为 git.sundynix.cn/Blizzard/Veyra，与仓库地址一致；删除单模块 go.work。
+- cmd/api、cmd/db、cmd/user 放入口与装配。
+- internal/model 放模型，internal/service 放业务，internal/repository 放 SQL 与事务，internal/handler 放 HTTP 路由和协议适配。
+- internal/config、database、adminui、apperror、ratelimit 放当前实际需要的设施；避免多余嵌套和空目录。
+- 管理端由 apps/admin 迁至 web/admin；embed 构建产物由 internal/adminui/dist 提供。
+- Makefile、CI、npm workspace/锁文件、Go 导入路径与 README 一并更新，原有命令和接口保持一致。
+- 原始设计报告中的 monorepo 目录仅为旧规划，当前实现以本文件、AGENTS.md 和 README 的结构为准。
+- 迁移文件仅移动路径，已逐字节核对两版 SQL 与原提交一致，不影响已执行迁移的 checksum。
+- 新结构已通过前端构建与 embed、Go 编译、race 检查和 go vet；真实数据库集成测试仍因连接限制跳过，不将目录迁移视作数据库验证。
+
 ## 验证与环境事实
 
 - 已通过前端 TypeScript 检查与生产构建、Go 编译、go vet、单元与无监听 HTTP 测试（含 race 检查）。
@@ -58,3 +71,9 @@
 用户本轮明确要求保存记忆、git add、commit 和 push。目标为当前 master 分支的 origin；操作结果以实际 Git 输出为准，禁止将失败的提交或推送记作已完成。
 
 本轮操作结果：项目记忆与忽略规则已保存，候选文件检查未发现本地配置的长密码。仓库当前没有提交；git add 因无法创建 .git/index.lock（Operation not permitted）失败，尚未 commit/push。远程分支读取失败，原因是执行环境无法解析远程域名。后续需在有 Git 写权限和网络访问能力的终端完成提交与推送，先确认远程状态；不强制推送、不覆盖远程历史。
+
+后续检查发现本地已有 ba6dfff（init: initial commit）等提交，说明前述无提交状态已变化；远程推送状态未经核验。此次目录调整尚未提交，Git 输出中的旧路径删除与新路径新增是迁移表现，提交时应一并暂存。
+
+## 本轮开发状态
+
+原计划推进模拟候选修订、审核与发布；用户中途指出目录不合理，本轮优先完成工程结构纠正与回归。候选功能尚未接入仓库交付代码，不新增第三版迁移；相关草稿保留在本地 .cache/candidate-draft（不提交），后续必须按新结构重新审查、实现和测试。下一步仍为候选审核闭环，不能将其描述为已完成。