Files
inquiry_robot/inquiry-api/YTD-README.md
T

84 lines
3.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 友通达 · 空白 JeecgBoot 主账(低代码)
产品决策:主账用 Jeecg + Online/cgform。本目录为官方 **v3.5.3** 空白工程(Gitee 拉取后去掉嵌套 `.git`),再叠加 `application-inquiry.yml`。
对照:`docs/2026-09-12-jeecg-lowcode-ledger-decision.md`、`prompt/07`。
## 工程裁剪(已做)
保留单体:**`jeecg-boot-base-core` + `jeecg-module-system`(含 start)+ `jeecg-module-inquiry`(询价手写主账)**。
已删除、勿再依赖:
- `jeecg-module-demo`(演示)
- `jeecg-server-cloud`(微服务整树)
- `jeecg-system-cloud-api`(仅微服务用)
启动模块:`jeecg-module-system/jeecg-system-start`(已依赖 inquiry 模块)。
## 询价业务表与菜单
从零实现。导入库 `inquiry_robot` 后执行:
1. [`deploy/sql/inquiry_admin_v1.sql`](../deploy/sql/inquiry_admin_v1.sql) — 业务表 `inq_*`
2. [`deploy/sql/inquiry_quote_template_v1.sql`](../deploy/sql/inquiry_quote_template_v1.sql) — 报价模板逻辑头 + 版本/映射
3. [`deploy/sql/inquiry_admin_menu_seed_v1.sql`](../deploy/sql/inquiry_admin_menu_seed_v1.sql) — 菜单/权限/演示数据
前端页面在 `inquiry-backend/src/views/inquiry/`:分析看板、询价工单、员工管理、报价模板(对接 `/inquiry/quoteTemplate`)、机器人回复语、账号/角色。
首批模板 seed:`python tools/seed_quote_templates.py --dry-run`(清单 `deploy/seed/`)。
## 与现网隔离
| 项 | 现网(勿动) | 新系统 |
|---|---|---|
| 端口 | 8080 | **8180** |
| context-path | 现网自定 | **`/jeecgboot`** |
| MySQL | `jeecg-boot` | **`inquiry_robot`** |
| Redis | db0 / `ytd:prod:` | **db1**(口令走环境变量) |
## 库表原则(重要)
- 当前阶段只要 **账号 / 角色 / 权限 / 菜单** 五张表:
- `sys_user`、`sys_role`、`sys_user_role`、`sys_permission`、`sys_role_permission`
- 其余 `sys_*`、Online、Quartz、积木、演示表一律不要。
- 询价业务表按需另加。清理脚本:`deploy/_remote_keep_rbac_only.ps1`。
## 启动后端(JDK 8)
Jeecg 3.5.3 需要 **JDK 8**(服务器可用 `C:\yutongda\tools\jdk8`;勿用 JDK 17 跑本工程)。
```powershell
$env:JAVA_HOME = "C:\yutongda\tools\jdk8" # 按实际路径
$env:LEDGER_PORT = "8180"
$env:MYSQL_USER = "inquiry_robot"
$env:MYSQL_PASSWORD = "<来自 E:\wwwroot\.env>"
$env:YTD_MYSQL_URL = "jdbc:mysql://10.206.0.15:3306/inquiry_robot?characterEncoding=UTF-8&useUnicode=true&useSSL=false&allowPublicKeyRetrieval=true&tinyInt1isBit=false&serverTimezone=Asia/Shanghai"
# Redis / MinIO 同样从 .env 注入
cd jeecg-module-system\jeecg-system-start
mvn -DskipTests spring-boot:run "-Dspring-boot.run.profiles=inquiry"
```
健康检查(导入库并启动成功后):
```text
http://127.0.0.1:8180/jeecgboot/
```
## 前端(Jeecg Vue3)
空白 Online 需要官方 Vue3 工程(另目录 `jeecg-vue/`,见仓库说明)。`VITE_APP_API_BASE_URL` 指向 `/jeecgboot`,开发代理到 `8180`。
## Online 低代码怎么用
1. 用默认账号登录(导入官方 SQL 后的初始 admin,**首次登录后立刻改密**)。
2. 菜单:在线开发 → Online 表单 / 报表 / 图表。
3. 先建询价业务表(或导入表结构),再「从数据库导入」生成 Online 配置。
4. 六态流转、TMS、报价版本等复杂规则:后续再加手写 `jeecg-module-inquiry`(与现网混合模式一致);空白阶段先把登录、菜单、Online CRUD 跑通。
## 不要
- 不要连现网 8080 / 库 `jeecg-boot`
- 不要把 `.env`、数据库口令提交进 Git
- 不要在未改 profile 时用默认 `application-dev.yml`(仍指向 `jeecg-boot`@8080)