# VAMS

**Repository Path**: J_code_rpe/vams

## Basic Information

- **Project Name**: VAMS
- **Description**: 村务管理系统
- **Primary Language**: Python
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 6
- **Forks**: 2
- **Created**: 2026-07-21
- **Last Updated**: 2026-11-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# VAMS-村务管理系统
![输入图片说明](image.png)

#### 介绍
本系统面向村级基层政务日常管理场景，即开即用的内网版本。
系统重点解决村民基础信息集中管理、组织机构维护、待办提醒、会议通知、证明开具、用户权限和操作留痕等问题。

#### 软件架构
技术栈统一为 FastAPI + Vue 3 + Element Plus + SQLite | MySQL


#### 使用发行版软件教程

1.  下载发行版本，解压压缩包。
2.  双击start.bat。
3.  打开浏览器，地址栏输入：localhost:8000 或者 127.0.0.1:8000，
    如果你需要同一个网络下的其他同事访问此系统，请查看当前启动电脑的内网ip地址，使用 ip地址:8000 即可在局域网内任意电脑访问。

#### 默认账户

```
用户名：root
密码：root123
```

#### 后端开发环境启动

```
cd D:\VAMSN\backend
python -m pip install -r requirements.txt
（1）python -m uvicorn app.main:app --host 127.0.0.1 --port 8000
（2）或者直接运行run_server.py
```

默认数据库配置：

```env
DATABASE_URL=sqlite+aiosqlite:///./data/vamsn.db
AUTO_INIT_DB=true
```

首次启动时，系统会自动创建 SQLite 数据库文件、数据表和基础菜单权限数据。

#### 前端开发环境启动

```
cd D:\VAMSN\frontend
npm install
npm run dev
```

访问：

```text
http://localhost:5173/
```

前端开发服务已配置 `/api` 代理到 `http://127.0.0.1:8000`。

#### 构建检查

```
cd D:\VAMSN\backend
python -m compileall app

cd D:\VAMSN\frontend
npm run build
```

#### Nuitka打包（exe）

```
powershell -ExecutionPolicy Bypass -File .\scripts\package_windows.ps1

powershell -ExecutionPolicy Bypass -File .\scripts\package_windows.ps1 -SkipInstall
```




#### 更新记录

1. v1.0.0：初版已定，系统雏形、基本功能已经完善，当前为发行版
2. v1.0.1：修复了一些小问题，美化了部分界面
3. v1.0.2：修复居民信息导入模板规范、导入信息数据异常处理
4. v1.0.3：居民信息excel快捷导入、增加户籍删除功能
5. v1.0.4：修复新增居民时非户主选择户籍时无法正常搜索到户籍的问题
6. v1.0.5：支持证明开具自定义类型，系统预设3种证明类型模板
7. v1.0.6：优化首页数据看板图、优化证明类型模板数据结构


#### 结尾

1.  如果你在使用中遇到任何问题，请提issues。