【More Than Coding】用 SOLO 30 分钟搭建基层管理系统：从需求到可运行的完整系统

SOLO挑战赛专区
,
1

1. 摘要

使用 TRAE SOLO，30 分钟内从零搭建了一套基层街道管理系统(经济)，涵盖企业税收管理、新注册企业走访管理、重点企业管理、社区自动匹配、Excel 批量导入导出、AI 走访总结生成等核心功能。系统采用前后端分离架构，支持多角色权限管理，可直接用于街道日常工作。

2. 背景

我是一名基层街道工作人员，负责经济相关的日常工作，虽然曾是计算机科班人员，但是好久没有接触开发，但是还想通过技术优化现有的工作流程。面临的挑战：

  • 大量 Excel 表格管理：每月税收数据、新注册企业信息、重点企业信息等分散在多个 Excel 文件中，查询和统计效率低下

  • 社区划分工作繁琐：需要根据企业地址手动匹配所属社区，容易出错

  • 走访记录整理耗时：每次企业走访后需要手写记录，再整理成电子文档，最后生成走访报告

  • 数据权限混乱：多人使用同一份 Excel，容易造成数据覆盖或误删

原本需要一个完整的 IT 开发团队和数月的开发周期，现在希望用 SOLO 快速实现一套可用的管理系统。

3. 实践过程

3.1 任务拆解

我把整个项目拆成以下几个核心模块：

1. 技术架构设计：确定前后端技术栈、数据库设计

2. 用户认证系统：登录注册、角色权限（管理员/编辑/查看）

3. 企业税收管理：Excel 上传解析、数据预览、筛选、导出

4. 新注册企业走访：企业录入、走访记录、AI 总结生成

5. 社区自动匹配：根据地址关键词自动分配社区

6. 重点企业管理：重点企业信息维护、Excel 批量导入

3.2 使用的 SOLO 能力

  • 自然语言理解：直接用中文描述需求，SOLO 理解并生成代码

  • 代码生成：根据描述自动生成前后端完整代码

  • 文件操作：自动创建项目结构、配置文件、依赖文件

  • 错误修复：遇到编译错误时，直接把错误日志贴给 SOLO，自动修复

  • 上下文理解：在多次对话中保持对项目整体架构的理解

3.3 关键 Prompt / 操作过程

第一步：需求描述与技术架构确认

这部分我的思路就是先看trae官方的文档里面的示例，看官方的精品项目是如何从0开始搭建的，然后根据自己具体的项目调整对应的提示词。

/plan 我们为一个基层经济办公室建立一个基层管理系统，用于实现一些基层事务功能（自动拆分走访企业名单等）、经济相关数据的更新（原来都是更新一些表格），以及常用的功能和工具。整个系统目前的模块包括： 
  - 经济数据（指标）管理 
  - 企业税收管理（查询，计算等） 
  - 新注册企业走访功能（根据地址划分企业到社区，然后根据模板，生成每个社区的走访表） 
 
 后续还可能会增加一些模块。 
  
  请协助给出产品文档。

等生成之后再开始反复打磨，因为官方文档提到了，这部分多和AI沟通比后面修改代码更有效。

根据.trae/documents/基层管理系统产品文档.md 的文档，我补充一些细节： 
 1.经济数据指标管理，表现为街道有规模以上企业表格（xlsx格式）定期需要更新其中的表项，看看是直接修改xlsx文件还是数据库管理的话，需要能导出xlsx。还需要能有统计功能，规上企业总营收，总税收等。 
 2.企业税收管理，也是有一个xlsx的大表格，里面包含几千个企业对应的税收情况，需要能导入每个月的xlsx表格，然后导出税收25万元以上的企业名单，并且导出的时候需要增加备注列，同比增减幅绝对值超过20%，就得备注涨幅/跌幅较大。还需要能随时查询企业的税收（不同xlsx表的），以及相应的统计功能 
 3.新注册企业走访功能，就按照之前看到md文件分步骤能可视化执行就行，都是上级单位下发表格。 
 
 完善产品文档，不着急开发。

最后Solo生成了完整的产品文档，包括产品的各个周期和细节，很棒！！！

第二步：技术架构文档生成

参考官方教程的步骤开始生成技术架构文档。然后Trae推荐了前后端分离的架构。

需要注意的是，机关单位的电脑配置和系统就不是最新的，所以开发的时候要考虑现有的主机环境方便部署，避免后续各种环境报错和安装大量的软件。

很好，结合'/data/usershare/上杭路街道/.trae/documents/基层管理系统产品文档.md'文档和**现有主机环境**，生成一份技术架构文档。

最后，SOLO 生成了完整的技术架构文档，包括：

  • 项目目录结构设计

  • 数据库表设计（社区表、企业表、税收记录表、走访记录表等）

  • 前后端 API 接口设计

第三步：代码生成

好的，按照 `/data/usershare/上杭路街道/.trae/documents/技术架构文档.md` 文档开始编程吧，路径放在'/data/usershare/'下，新建一个文件夹。

SOLO 自动生成了完整的前后端代码：

后端部分（Flask + SQLAlchemy）：

  • 数据模型定义（User, Community, Enterprise, TaxRecord 等）

  • API 路由（CRUD 操作、文件上传、Excel 解析）

  • 业务服务层（社区匹配、税收统计、AI 服务）

  • 工具函数（JWT 认证、Excel 处理）

前端部分（Vue 3 + Element Plus）：

  • 页面组件（登录页、仪表盘、各模块管理页）

  • API 请求封装（Axios + 拦截器）

  • 状态管理（Pinia）

  • 路由配置（权限守卫）

第四步：项目优化

第一版本的程序基础功能都已经实现了，真的震撼，极大的提升了效率！而且全程没有报错，后续就是根据自己的实际项目需求进行了相应的更改，我这里做了一些更加细致的要求，描述尽可能详细并且直接给SOLO对应的文件，方便读取到直接的数据格式。避免后续兼容问题。

很好，现在我启动前后端已经可以进入系统了，需要进一步优化: 
 1.实现注册登录功能，需要管理员权限，管理员用户都是最高权限，可以增删改查。普通用户只能查看。 
 2.企业税收管理模块，现在只能添加记录是很麻烦的，之前对话中给了excel表格的路径'/data/usershare/企业纳税统计表.xlsx'，根据路径中的excel文件格式、标题行和sheet等实现可以选择excel文件上传解析，上传解析的时候提高容错率，可以选择sheet命，标题行等解析。然后上传的一个文件(某个月税收)就是一个库。这样企业税收管理页面下上传的就是不同月的税收数据。每个上传的表，解析后再弄一个统计功能、筛选、导出啥的常见操作。 
 3.新注册企业走访也是，根据文件'/data/usershare/企业划分社区到AI筛选已走访企业.md'的提示代码，进一步完善。 
 具体来说就是将根据md中每个模块/步骤，可视化设计成一个子页面，比如划分社区模块，页面中显示每个社区对应的关键字，然后可以增删改，然后生成划分社区后结果和文件；生成线索表模块，可以可视化选择/输入路径指定源文件、模板和输出文件夹……其他步骤/模块都类似设计成可视化、可输入/选择的。 
 4.经济数据管理就直接改成“规上企业管理”，也是和前面的一样，可以直接上传和解析excel表格（/data/usershare/一季度/规上企业情况_一季度全.xlsx），解析的时候可以选择标题行和sheet等必要参数，方便解析。也可以导出、筛选等常规操作。

SOLO 实现了：

  • 完整的多角色权限系统

  • Excel 批量导入导出（支持选择 sheet、标题行、列映射）

  • 社区自动匹配算法（地址关键词匹配）

  • AI 服务集成（OpenAI API 生成走访总结）

3.4 踩过的坑

  1. 命名冲突问题：Vue 组件中 previewData 同时作为响应式变量和异步函数名，导致编译失败。直接把错误日志贴给 SOLO，自动将函数改名为 loadPreviewData。

  2. 导入错误：Login.vue 错误导入了 doLogin 函数。SOLO 分析后删除了多余导入，因为该函数实际在 Pinia Store 中。

  3. 数据库未初始化：首次启动后端时，数据库中没有默认用户，导致登录返回 401。运行 python init_data.py 初始化数据后解决。

  4. 依赖安装路径：uv 包管理器需要正确配置虚拟环境和依赖文件，SOLO 自动生成了 requirements.txt 和 pyproject.toml 两种格式的配置文件。

4. 成果展示

技术栈

后端：Python 3.12 + Flask 3.0 + SQLAlchemy 2.0 + SQLite + pandas + openpyxl + PyJWT

前端：Vue 3 + Vite + Element Plus + Pinia + Axios + ECharts

部署：前后端分离，后端提供 RESTful API，前端通过 Vite 开发服务器运行

项目结构


shanghanglu-office/

├── backend/                 # 后端项目

│   ├── app/

│   │   ├── models/          # 数据模型（用户、社区、企业、税收、走访）

│   │   ├── routes/          # API 路由（认证、社区、企业、税收、走访）

│   │   ├── services/        # 业务服务（社区匹配、税收统计、AI、Excel）

│   │   ├── utils/           # 工具函数（JWT 认证、Excel 处理）

│   │   └── config.py        # 配置管理

│   ├── uploads/             # 上传文件存储

│   ├── instance/            # SQLite 数据库

│   ├── .env                 # 环境变量

│   ├── requirements.txt     # Python 依赖

│   ├── pyproject.toml       # 项目配置（uv）

│   └── run.py               # 启动文件

├── frontend/                # 前端项目

│   ├── src/

│   │   ├── views/           # 页面组件（登录、仪表盘、税收、企业等）

│   │   ├── components/      # 通用组件（布局、导航）

│   │   ├── api/             # API 接口封装

│   │   ├── stores/          # 状态管理（Pinia）

│   │   └── router/          # 路由配置

│   ├── package.json

│   └── vite.config.js

└── README.md

核心功能清单

功能模块 功能说明
用户认证 登录、JWT 验证、角色权限（管理员 / 编辑 / 查看）
税收管理 Excel 上传、解析、预览、筛选、统计、导出
企业走访 走访记录、AI 总结生成、地址自动匹配社区
重点企业 企业信息维护、Excel 批量导入、重点关注标记
社区管理 社区信息维护、地址关键词配置
数据看板 仪表盘、统计图表、数据可视化

5. 效果与总结

提效数据

环节 传统方式 使用 SOLO 节省时间
需求分析到技术设计 2-3 天 10 分钟 99%
前后端代码开发 2-4 周 30 分钟 95%+
Bug 修复 数小时 即时 90%+
总计 约 1-2 个月 30-60 分钟 约 98%

SOLO 在流程中的角色

1. 架构设计师：根据需求自动生成完整的技术架构和数据库设计

2. 全栈开发工程师：编写前后端代码，包括业务逻辑、API、UI 组件

3. 调试专家：快速定位并修复编译错误、运行时错误

4. 文档助手：自动生成 README 和部署说明

可复用的方法

1. 先设计，后编码：先让 SOLO 生成技术架构文档，确认无误后再开始写代码

2. 模块化拆解：把大功能拆成小模块，逐一描述和实现

3. 日志驱动修复：遇到问题直接把错误日志贴给 SOLO，不要自己猜测原因

4. 持续迭代优化：先实现核心功能，再逐步添加权限管理、Excel 处理等高级功能

对 AI 编程的思考

  • AI 不是替代，而是赋能：SOLO 让我这样一个非专业开发人员，也能在短时间内搭建出一个完整可用的管理系统

  • 质量可控：生成的代码结构清晰、注释完整、遵循最佳实践，可以直接用于生产环境

  • 快速迭代：需求变更时，只需描述新需求，SOLO 就能快速调整代码

  • 学习曲线低：用自然语言描述需求即可，不需要精通编程语言和框架

项目完整代码：/data/usershare/shanghanglu-office/

技术架构文档：/data/usershare/.trae/documents/技术架构文档.md

产品文档：/data/usershare/.trae/documents/基层管理系统产品文档.md

后续补充链接