galaxis-po/README.md

# Galaxy-PO

Integrated Quant Portfolio Management Application

## Tech Stack

- **Backend:** FastAPI, Python 3.12, SQLAlchemy, PostgreSQL
- **Frontend:** Next.js 15, React 19, TypeScript, Tailwind CSS
- **Infrastructure:** Docker, Docker Compose, uv

## Development

### Prerequisites

- Docker & Docker Compose
- Python 3.12
- Node.js 24
- [uv](https://docs.astral.sh/uv/) (Python package manager)

### Quick Start

```bash
# Start all services
docker-compose up -d

# Backend only (development)
cd backend
uv sync
uv run uvicorn app.main:app --reload

# Frontend only (development)
cd frontend
npm install
npm run dev
```

## Project Structure

```
galaxy-po/
├── backend/           # FastAPI backend
├── frontend/          # Next.js frontend
├── docker-compose.yml
└── docs/plans/        # Implementation plans
```