AutoRepo

A Git-style vehicle maintenance tracking system for car enthusiasts.

简体中文 • Features • Quick Start • Architecture • Deployment

---

What is AutoRepo?

AutoRepo transforms vehicle maintenance tracking into an intuitive, developer-friendly experience by borrowing concepts from Git version control:

Git Concept	AutoRepo Equivalent
Repository	Your Vehicle
Commit	Maintenance/Repair Record
Issue	Scheduled Maintenance Task
HEAD	Current Status (Mileage/Condition)

Perfect for car enthusiasts who want to:

• Track every modification, repair, and maintenance
• Monitor total investment and cost breakdown
• Document with photos (up to 9 per record)
• Export professional PDF reports
• Never lose your vehicle's history

---

Features

Core Functionality

• Git-Style Timeline — Visual commit history of all vehicle changes
• Multi-Vehicle Support — Manage multiple cars in one app
• Cost Tracking — Labor costs, parts fees, automatic totals
• Image Upload — Up to 9 photos per maintenance record
• PDF Export — Professional reports for insurance or resale
• Search & Filter — By type, date range, mileage, or keywords
• Issue Tracking — Plan maintenance tasks with priorities

User Experience

• Dark Mode — Auto-detects system preference
• Real-time Sync — WeChat Cloud Run powered
• Secure — JWT authentication, data isolation per user
• Native Feel — Custom navigation, smooth animations
• Swipe Actions — Swipe to delete vehicles and tasks

---

Screenshots

Home	Home (Dark)	Add Vehicle
Vehicle Detail	Timeline	Add Record
Stats - Cost	Stats - Issues	Add Reminder
Settings	Help	PDF Export

---

Architecture

┌─────────────────────────────────────────────────────────────────┐
│                     WeChat Mini Program                         │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐              │
│  │  Timeline   │  │  Dashboard  │  │  Settings   │              │
│  │   (Repo)    │  │   (Stats)   │  │   (Theme)   │              │
│  └──────┬──────┘  └──────┬──────┘  └─────────────┘              │
│         │                │                                       │
│  ┌──────┴────────────────┴──────┐                               │
│  │       api.ts (HTTP Client)    │                               │
│  │   • JWT Auth • Retry Logic    │                               │
│  └──────────────┬───────────────┘                               │
└─────────────────┼───────────────────────────────────────────────┘
                  │ wx.cloud.callContainer
                  ▼
┌─────────────────────────────────────────────────────────────────┐
│                   WeChat Cloud Run (Docker)                     │
│  ┌──────────────────────────────────────────────────────────┐   │
│  │                    FastAPI Backend                        │   │
│  │  ┌────────┐  ┌────────┐  ┌────────┐  ┌────────┐          │   │
│  │  │ /repos │  │/commits│  │/issues │  │ /auth  │          │   │
│  │  └────┬───┘  └────┬───┘  └────┬───┘  └────┬───┘          │   │
│  │       └───────────┴───────────┴───────────┘               │   │
│  │                       │                                    │   │
│  │              ┌────────┴────────┐                          │   │
│  │              │   MongoDB/Mock  │                          │   │
│  │              └─────────────────┘                          │   │
│  └──────────────────────────────────────────────────────────┘   │
└─────────────────────────────────────────────────────────────────┘

Tech Stack

Layer	Technology
Frontend	TypeScript, SCSS, WeChat Mini Program
Backend	Python 3.9+, FastAPI, Pydantic
Database	MongoDB (Motor async driver)
Auth	JWT + WeChat Login
PDF	ReportLab (Chinese font support)
Deployment	Docker, WeChat Cloud Run

---

Quick Start

Prerequisites

• Python 3.9+
• WeChat Developer Tools
• (Optional) Docker, MongoDB

1. Backend Setup

# Clone the repository
git clone https://github.com/lecrix/auto-repo.git
cd auto-repo/backend

# Install dependencies
pip install -r requirements.txt

# Create .env file
cp .env.example .env
# Edit .env with your credentials

# Run development server
uvicorn main:app --reload --host 0.0.0.0 --port 8000

Environment Variables (.env):

WECHAT_APPID=your_wechat_appid
WECHAT_SECRET=your_wechat_secret
JWT_SECRET=your-random-secret-key-at-least-32-characters
MONGO_URL=mongodb://localhost:27017  # Optional, defaults to MockDB

Without MongoDB, the system automatically uses MockDB (file-based) for local development.

2. Frontend Setup

1. Open WeChat Developer Tools
2. Import miniprogram/ directory
3. Set AppID (or use test mode)
4. Update config in miniprogram/config.ts:

   const CURRENT_MODE: 'dev' | 'device' | 'prod' = 'dev'

5. Compile and preview

---

Deployment

WeChat Cloud Run (Recommended)

See docs/DEPLOY.md for detailed instructions.

Key Benefits:

• No domain registration/ICP required
• Auto-scaling (scale to zero when idle)
• Built-in HTTPS
• Direct internal network access

---

Project Structure

auto-repo/
├── backend/                 # FastAPI Backend
│   ├── main.py              # App entrypoint
│   ├── auth.py              # JWT + WeChat login
│   ├── routes.py            # API endpoints
│   ├── models.py            # Pydantic schemas
│   ├── database.py          # MongoDB connection
│   └── mock_db.py           # Development fallback DB
│
├── miniprogram/             # WeChat Mini Program
│   ├── pages/               # UI pages
│   ├── components/          # Reusable components
│   └── services/            # API client, auth
│
├── docs/                    # Documentation
│   ├── DEPLOY.md            # Deployment guide
│   ├── FEATURE_SUMMARY.md   # Feature summary
│   ├── TESTING_GUIDE.md     # Testing guide
│   └── WORK_SUMMARY.md      # Development history
│
├── AGENTS.md                # AI assistant guide
└── CONTRIBUTING.md          # Contribution guide

---

API Overview

Endpoint	Method	Description
/auth/login	POST	WeChat code → JWT token
/repos	GET/POST	List/Create vehicles
/repos/{id}	GET/PUT/DELETE	Vehicle CRUD
/commits	GET/POST	List/Create records
/commits/{id}	GET/PUT/DELETE	Record CRUD
/repos/{id}/issues	GET/POST	Maintenance tasks
/issues/{id}	GET/PATCH/DELETE	Task CRUD
/repos/{id}/stats	GET	Cost statistics
/repos/{id}/export/pdf-base64	GET	PDF export

Full API docs available at http://localhost:8000/docs when running locally.

---

Roadmap

• Core UI/UX & Backend Integration
• Multi-user Authentication
• Image Upload & PDF Export
• Data Visualization & Statistics
• WeChat Cloud Run Deployment
• Issue Detail Page & Swipe Actions
• OCR for Receipt Scanning
• Maintenance Reminders (Push Notifications)
• Social Sharing & Community Features

---

Contributing

Contributions are welcome! Please read CONTRIBUTING.md first.

git checkout -b feature/amazing-feature
git commit -m 'Add amazing feature'
git push origin feature/amazing-feature
# Open a Pull Request

---

License

This project is licensed under the MIT License - see the LICENSE file for details.

---

Made with love for car enthusiasts
Report Bug • Request Feature