F8WebAI/开发进度存档.md

农易富 · 开发进度存档

供重装环境 / 换目录后快速恢复上下文。最近更新：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 补丁）
• 大屏 / 报表如需多数据源可接入更多统计维度