Docs: quick-start guide, progress archive, and codebuddy gitignore

开发进度存档.md

@@ -0,0 +1,46 @@
+# 农易富 · 开发进度存档
+
+> 供重装环境 / 换目录后快速恢复上下文。最近更新：2026-08-23。
+
+## 一、版本里程碑
+
+| 时间 | 提交 | 内容 |
+| --- | --- | --- |
+| 2026-08-13 | `8099eba`（首次推送） | 平台全量代码上线：登录修复（JWT `uid` claim + 控制器统一 `ClaimTypes.NameIdentifier`）、收购菜单层级修正（过磅/触摸屏过磅归入收购业务）、版权信息移至框架底部、顶栏动态日历图标、天气数据源统一（`useWeather.ts`）、农易富® 商标、`system_logo` 数据字典（Logo 图标可配）、大屏日期选择器深色化、OCR/OSS 上传接入 |
+| 2026-08-20 | `c7a9028` | 端口统一：后端 **9002**、前端 **9000**（此前 5246/5173）；报表按月/日分组排序修复（内存拼 Key 避免字典序错位）；过磅金额超 100 万自动转万元显示 |
+
+## 二、当前运行状态
+
+- 后端：`backend/AgriculturalPlatform.Api`，端口 **9002**，`scripts/start-backend.ps1` 启动（`dotnet run --no-build`）
+- 前端：Vite dev server 端口 **9000**（`frontend/vite.config.ts` 代理 `/api`、`/uploads` → 9002）
+- 数据库：在线 MySQL（`server=116.198.221.105;port=3306;database=F8Web`），启动自动建表+种子
+- 管理员：`admin / 123456`
+- Git 远程：`https://github.bbitcn.net/fanhongcai/F8WebAI.git`（origin，已推送 `8099eba`、`c7a9028`）
+
+## 三、已完成功能
+
+- 登录认证（JWT + BCrypt）、四级组织角色与数据权限隔离
+- 农户档案管理（含身份证 OCR 识别、手机传图、信用分、冻结）
+- 过磅称重（一次/二次过磅、净重金额计算、触摸屏大字键盘 `/weighing/touch`、实时进行中单据）
+- 电子支付（微信/支付宝/银行/现金、退款、应收汇总）
+- 反向开票（自产免税 0%、一键开票、作废红冲）
+- 统计报表（收购/付款/开票，按日/月/品种/农户/收购方，图表 + CSV 导出）
+- 可视化大屏 `/dashboard`（KPI、趋势、占比、排行、实时过磅、30s 刷新、深色日期选择器）
+- 系统管理（角色/菜单/数据字典，Logo 图标字典 `system_logo`）
+- 通知公告、关于系统、个人中心
+- 顶栏：动态日历（农历）、天气（IP 定位 + Open-Meteo）、商标®
+
+## 四、已知问题 / 注意事项
+
+1. **旧 DLL 陷阱（最重要）**：改后端代码后必须先 `dotnet build` 再启动，否则 `--no-build` 加载旧产物 → 表现为接口行为异常（曾致 `/menus/my` 401 登录失败）。详见《项目说明》§6。
+2. **PowerShell 中文乱码**：命令用相对路径，git commit 用英文信息。
+3. **git 自动化终端认证**：无法弹登录窗，推送需内嵌凭据 URL（见《项目说明》§7）；本机 GCM 配置名有告警（`credential-manager-core`），暂不影响已缓存凭据推送。
+4. **冗余远程已清理**：`F8Web`（地址无效）、`F8WebAI`（与 origin 重复）已删除，仅留 `origin`。
+5. 数据库连接串、OSS、OCR 密钥均在 `appsettings.json`（已提交远程，属私有仓库，注意勿外泄）。
+
+## 五、待办 / 建议
+
+- [ ] `start-backend.ps1` 建议改为"先 build 再 run"，从根上消除旧 DLL 陷阱
+- [ ] 修复本机 GCM 凭据助手配置告警（`git config --global credential.helper manager`）
+- [ ] 生产环境建议引入 EF Core Migration 管理表结构（当前为 EnsureCreated + SchemaMigrator 补丁）
+- [ ] 大屏 / 报表如需多数据源可接入更多统计维度