🌍 Beyond Scripts: A Platform / 超越脚本：打造平台

While my previous tool (Czech-Visa-Application-Status-Check) is excellent for server-side automation, sometimes you need a User Interface. You need multi-user support, a dashboard to view history, and an extendable architecture for different countries.
虽然我之前的工具 (Czech-Visa-Application-Status-Check) 在服务器端自动化方面表现出色，但有时你需要一个用户界面。你需要多用户支持、查看历史记录的仪表盘，以及支持不同国家的可扩展架构。

Enter VisaStatusMonitor.
于是，VisaStatusMonitor 应运而生。

It is a modern, full-stack web application designed for families, agencies, or communities to track visa statuses together.
这是一个现代化的全栈 Web 应用程序，专为家庭、中介机构或社区设计，用于共同追踪签证状态。

🏗️ Modern Tech Stack / 现代技术栈

I built this using the latest industry standards to ensure performance and maintainability.
我使用了最新的行业标准构建此项目，以确保性能和可维护性。

Backend (Python Powerhouse)

  • FastAPI: For high-performance async APIs.
  • SQLAlchemy: Robust ORM for SQLite/MySQL.
  • APScheduler: Intelligent task scheduling to prevent IP bans.
  • Plugin Architecture: Easily add support for new countries (e.g., Poland, Germany) by adding a single Python file.

Frontend (Sleek & Reactive)

  • Vue 3 + Vite: Lightning-fast loading speeds.
  • Element Plus: Professional, responsive UI components.
  • Pinia: State management made simple.
  • TypeScript: Type safety across the board.

✨ Features / 功能亮点

1. Multi-User & Multi-Role / 多用户与多角色

You can host a single instance for your entire friend group.

  • Users can register and add their own application numbers.
  • Admins can manage the system and view global stats.

2. Multi-Country Plugin System / 多国家插件系统

The core logic is decoupled from specific website parsing.
Need to support a new country? Just write a plugin inheriting from BasePlugin.
核心逻辑与具体的网站解析解耦。
想要支持新国家？只需编写一个继承自 BasePlugin 的插件即可。

3. Smart Notifications / 智能通知

Integrates deeply with:

  • 📧 Email (SMTP)
  • 📱 Telegram Bot
  • 🔔 Web Source (Real-time dashboard updates)

🚀 Deployment / 部署指南

Everything is containerized for ease of use. I recommend using Docker Compose.
一切皆已容器化。推荐使用 Docker Compose 进行一键部署。

1. Structure Preparation / 目录准备

git clone https://github.com/yuanweize/VisaStatusMonitor.git
cd VisaStatusMonitor
cp .env.example .env

2. Configuration (.env) / 配置详解

Key parameters to customize:

# Security
SECRET_KEY=change_this_to_random_string

# Database
# Use sqlite for small deployments, or mysql/postgresql for larger ones
DATABASE_URL=sqlite:///./data/visa.db

# Notifications
SMTP_SERVER=smtp.gmail.com
SMTP_USERNAME=your_email@gmail.com
SMTP_PASSWORD=your_app_password

3. Launch / 启动

docker-compose up -d

Visit http://localhost (or your domain) to see the dashboard. Default admin credentials are printed in the container logs on first run.
Visit http://localhost and start tracking.

🔗 Contribute / 参与贡献

This is an ambitious project aiming to cover visa systems worldwide. I need your help!
这是一个雄心勃勃的项目，旨在覆盖全球的签证系统。我需要你的帮助！

👉 GitHub: VisaStatusMonitor


GitHub Stars