Expense Tracker
Веб-приложение для учёта личных расходов: диаграмма расходов по категориям,
таблица операций, добавление расходов и экспорт в CSV/Excel.
Полное техническое задание — см. TZ.md.
Схема модели данных — см. data-model.mermaid.
Стек технологий
- Frontend: Angular + TypeScript, Chart.js (ng2-charts)
- Backend: Python + FastAPI, SQLAlchemy + Alembic
- База данных: SQLite
- Авторизация: JWT (регистрация/логин, passlib/bcrypt для хэша паролей)
- Экспорт: CSV и Excel (openpyxl) — генерируются на backend
Функциональность
- Круговая диаграмма — расходы за период по категориям, с выбором периода
- Таблица расходов — список операций (название, категория, сумма, дата),
с сортировкой и своим фильтром периода
- Добавление расхода — форма с выбором существующей категории или
созданием новой
- Экспорт — выгрузка отфильтрованных данных в CSV или Excel
Структура проекта
expense-tracker/
├── backend/ # FastAPI приложение
│ ├── app/
│ │ ├── models/ # SQLAlchemy модели (User, Category, Expense)
│ │ ├── routers/ # API-роуты (auth, categories, expenses, export)
│ │ ├── schemas/ # Pydantic-схемы
│ │ └── main.py
│ ├── alembic/ # миграции БД
│ └── requirements.txt
├── frontend/ # Angular приложение
│ └── src/app/
│ ├── auth/ # логин/регистрация
│ ├── expenses/ # таблица + форма добавления
│ ├── charts/ # круговая диаграмма
│ └── shared/
├── TZ.md
├── data-model.mermaid
└── README.md
Запуск проекта (backend)
cd backend
python -m venv venv
source venv/bin/activate # Windows: venv\Scripts\activate
pip install -r requirements.txt
alembic upgrade head
uvicorn app.main:app --reload
Backend будет доступен на http://localhost:8000.
Запуск проекта (frontend)
cd frontend
npm install
ng serve
Frontend будет доступен на http://localhost:4200.
Статус разработки
Проект в разработке пошагово, см. этапы в TZ.md.
