# eyqc

**Repository Path**: mazingan/eyqc

## Basic Information

- **Project Name**: eyqc
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-22
- **Last Updated**: 2026-01-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 过年恩怨情仇记账本

A cyberpunk + 8Bit styled ledger for tracking Chinese New Year grudges, debts, and financial transactions. Built for the 90s/00s generation who need to keep track of social obligations during the holiday season.

## Features

### 1. Financial Records (财务来往) - Neon Green
- Track lending and borrowing
- Amount, date, notes
- Status: unpaid/partial/paid

### 2. Festival Exchanges (节日来往) - Cyber Red
- Red packet records
- Gift exchange tracking
- Return gift reminders

### 3. Grudge Ledger (记仇本) - Abyss Purple
- Record grudges and conflicts
- Severity levels (1-5)
- Reconciliation progress tracking

### 4. Social Debts (人情欠账) - Warning Yellow
- Gift/favor debts
- Priority sorting
- Overdue reminders

## Tech Stack

- **Frontend**: React + Vite + TailwindCSS
- **Backend**: FastAPI + SQLAlchemy
- **Database**: SQLite
- **Auth**: JWT Token (default password: `123456`)

## Project Structure

```
eyqc/
├── backend/
│   ├── main.py              # FastAPI entry point
│   ├── database.py          # Database configuration
│   ├── auth.py              # Authentication logic
│   ├── models/              # SQLAlchemy models
│   ├── schemas/             # Pydantic schemas
│   └── api/                 # API routes
├── frontend/
│   ├── src/
│   │   ├── pages/           # Page components
│   │   ├── components/8bit/ # 8Bit UI components
│   │   ├── styles/          # Cyberpunk styles
│   │   └── utils/api.js     # API client
│   └── package.json
└── README.md
```

## Setup

### Backend Setup

```bash
cd backend

# Create virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

# Run the server
uvicorn main:app --reload
```

Backend will run on `http://localhost:8000`

API Documentation: `http://localhost:8000/docs`

### Frontend Setup

```bash
cd frontend

# Install dependencies
npm install

# Run development server
npm run dev
```

Frontend will run on `http://localhost:3000`

### Build for Production

```bash
cd frontend
npm run build
```

The built files will be in `frontend/dist/` and served by the FastAPI backend.

## Default Login

- **Password**: `123456`

## UI Design

- **8Bit Pixel Style**: Press Start 2P font, square buttons, thick borders
- **Cyberpunk Colors**: Deep black background, neon accents
- **Mobile First**: Bottom navigation, touch-friendly buttons
- **Effects**: Scanlines, CRT flicker, neon glow

## API Endpoints

### Authentication
- `POST /api/auth/login` - Login and get token
- `POST /api/auth/verify` - Verify token

### Financial Records
- `GET /api/financial` - List all records
- `POST /api/financial` - Create record
- `PUT /api/financial/{id}` - Update record
- `DELETE /api/financial/{id}` - Delete record

### Festival Records
- `GET /api/festival` - List all records
- `POST /api/festival` - Create record
- `PUT /api/festival/{id}` - Update record
- `DELETE /api/festival/{id}` - Delete record

### Grudge Records
- `GET /api/grudge` - List all records
- `POST /api/grudge` - Create record
- `PUT /api/grudge/{id}` - Update record
- `DELETE /api/grudge/{id}` - Delete record

### Debt Records
- `GET /api/debt` - List all records
- `POST /api/debt` - Create record
- `PUT /api/debt/{id}` - Update record
- `DELETE /api/debt/{id}` - Delete record

## License

MIT