Business-Management/changelog/2026-04-12_initial-scaffold.md

2026-04-12 — Initial project scaffold

Timestamp: 2026-04-12T14:22:00

Summary

Created the initial fullstack SaaS project structure from scratch.

Files Added

Backend

• backend/pyproject.toml — project dependencies (FastAPI, SQLAlchemy, Alembic, pydantic-settings, python-jose, passlib)
• backend/alembic.ini — Alembic configuration
• backend/alembic/env.py — async Alembic migration environment
• backend/alembic/script.py.mako — migration file template
• backend/app/__init__.py
• backend/app/main.py — FastAPI app, CORS middleware, router mounts
• backend/app/database.py — async SQLAlchemy engine, session factory, Base
• backend/app/deps.py — get_current_user FastAPI dependency (JWT validation)
• backend/app/core/__init__.py
• backend/app/core/config.py — Settings via pydantic-settings, reads .env
• backend/app/core/security.py — bcrypt password hashing, JWT encode/decode
• backend/app/models/__init__.py
• backend/app/models/user.py — User ORM model (id, email, hashed_password, full_name, is_active, is_superuser)
• backend/app/schemas/__init__.py
• backend/app/schemas/user.py — UserCreate, UserOut, Token Pydantic schemas
• backend/app/routers/__init__.py
• backend/app/routers/auth.py — POST /api/auth/register, POST /api/auth/login
• backend/app/routers/users.py — GET /api/users/me

Frontend

• frontend/package.json — dependencies (React 18, TypeScript, Vite, React Router v6, TanStack Query, Axios)
• frontend/vite.config.ts — Vite config, /api proxy to :8000
• frontend/tsconfig.json — strict TypeScript config
• frontend/index.html
• frontend/src/main.tsx — React root, QueryClientProvider, BrowserRouter
• frontend/src/App.tsx — route tree, PrivateRoute guard
• frontend/src/api/client.ts — Axios instance, auth interceptor, login, register, getMe
• frontend/src/hooks/useAuth.ts — JWT token state, login, logout
• frontend/src/pages/LoginPage.tsx
• frontend/src/pages/RegisterPage.tsx
• frontend/src/pages/DashboardPage.tsx

Root

• docker-compose.yml — postgres, backend, frontend services
• .env.example
• .gitignore
• CLAUDE.md

---

2026-04-12 — Added README and changelog

Timestamp: 2026-04-12T14:45:00

Summary

Added project README with overview and installation guide. Created changelog/ directory and this initial entry.

Files Added

• README.md — project overview, stack table, current state, Option A (Docker) and Option B (local) install guides, env variable reference, dev commands
• changelog/2026-04-12_initial-scaffold.md — this file