fastapi-fullstack 0.2.7__py3-none-any.whl → 0.2.9__py3-none-any.whl

{fastapi_fullstack-0.2.7.dist-info → fastapi_fullstack-0.2.9.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fastapi-fullstack
-Version: 0.2.7
+Version: 0.2.9
 Summary: Full-stack FastAPI + Next.js template generator with PydanticAI/LangChain agents, WebSocket streaming, 20+ enterprise integrations, and Logfire/LangSmith observability. Ship AI apps fast. CLI tool to generate production-ready FastAPI + Next.js projects with AI agents, auth, and observability.
 Project-URL: Homepage, https://github.com/vstorm-co/full-stack-ai-agent-template
 Project-URL: Documentation, https://github.com/vstorm-co/full-stack-ai-agent-template#readme
@@ -19,13 +19,20 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Topic :: Software Development :: Code Generators
 Requires-Python: >=3.11
+Requires-Dist: arq>=0.28.0
+Requires-Dist: celery>=5.6.3
 Requires-Dist: click>=8.3.0
 Requires-Dist: cookiecutter>=2.7.0
 Requires-Dist: email-validator>=2.3.0
+Requires-Dist: httpx>=0.28.1
 Requires-Dist: pydantic-settings>=2.13.0
 Requires-Dist: pydantic>=2.13.0
+Requires-Dist: pytest-asyncio>=1.3.0
+Requires-Dist: pytest>=9.0.3
 Requires-Dist: questionary>=2.1.0
 Requires-Dist: rich>=15.0.0
+Requires-Dist: stripe>=15.1.0
+Requires-Dist: taskiq>=0.12.4
 Provides-Extra: dev
 Requires-Dist: pre-commit>=4.0.0; extra == 'dev'
 Requires-Dist: pytest-cov>=7.0.0; extra == 'dev'
@@ -162,89 +169,106 @@ fastapi-fullstack create my_ai_app --preset ai-agent     # AI agent with streami
 fastapi-fullstack create my_ai_app --minimal
 ```
 
-### Start Development (Docker — recommended)
+### Start Development
 
-The fastest way to get running — 2 commands:
+#### First time on a fresh clone
 
 ```bash
 cd my_ai_app
-make docker-up       # Start backend + database + migrations + admin user
-make docker-frontend # Start frontend
+make bootstrap       # = make dev + make seed
 ```
 
-**Access:**
+That's it — backend, database, Redis, vector store (if RAG), Celery (if selected) come up, migrations are applied, and a default admin is seeded.
 
-- API: <http://localhost:8000>
-- Docs: <http://localhost:8000/docs>
-- Admin Panel: <http://localhost:8000/admin>
-- Frontend: <http://localhost:3000>
+#### Day-to-day
 
-> [!TIP]
-> That's it. Docker handles database setup, migrations, and admin user creation automatically.
+```bash
+make dev             # idempotent: build + up + migrate. Re-run anytime.
+```
 
-<details>
-<summary><b>Manual setup (without Docker)</b></summary>
+`make dev` skips admin seeding (that's a one-shot in `make seed`) so it stays cheap to run after every code/config change.
 
-#### 1. Install dependencies
+**Behind the scenes (`make dev`):**
 
-```bash
-cd my_ai_app
-make install
-```
+1. Builds the backend Docker image (cached after first run)
+2. Starts services via `docker-compose.dev.yml` (hot-reload bind mounts)
+3. Polls Postgres until ready (`pg_isready` — no fixed sleeps)
+4. Applies pending Alembic migrations (no-op if already at head)
 
-> [!NOTE]
-> **Windows Users:** The `make` command requires GNU Make which is not available by default on Windows.
-> Install via [Chocolatey](https://chocolatey.org/) (`choco install make`), use WSL, or run raw commands manually.
-> Each generated project includes a "Manual Commands Reference" section in its README with all commands.
+**Then access:**
+
+| | URL | |
+|---|---|---|
+| Backend API | <http://localhost:8000> | |
+| Docs | <http://localhost:8000/docs> | OpenAPI / Swagger |
+| Admin | <http://localhost:8000/admin> | `admin@example.com` / `admin123` (after `make seed`) |
+| Frontend | <http://localhost:3000> | `make dev-frontend` (Docker) or `cd frontend && bun install && bun dev` (local) |
 
-#### 2. Start the database
+### Day-to-day commands
 
 ```bash
-# PostgreSQL (with Docker)
-make docker-db
+make dev           # bootstrap or restart (no admin re-seed)
+make seed          # one-shot admin creation (no-op if admin exists)
+make dev-down      # stop everything
+make dev-logs      # tail container logs
+make dev-rebuild   # force-rebuild backend image (after pyproject.toml changes)
+make dev-frontend  # start the Next.js container
 ```
 
-#### 3. Create and apply database migrations
+### Environments
 
-> [!WARNING]
-> Both commands are required! `db-migrate` creates the migration file, `db-upgrade` applies it to the database.
+| `make` target | Compose file | When to use |
+|---|---|---|
+| `make dev` | `docker-compose.dev.yml` | Local development with hot-reload + bind-mounted source. |
+| `make stage` | `docker-compose.yml` | Production-like build (no bind mounts) running on localhost. Sanity-check before deploy. |
+| `make prod` | `docker-compose.prod.yml` | Production. Requires `backend/.env` (copy from `backend/.env.example`, fill real secrets) + external Nginx using `nginx/nginx.conf`. |
 
-```bash
-# Create initial migration (REQUIRED first time)
-make db-migrate
-# Enter message: "Initial migration"
+Each env has matching `-down`, `-logs`, `-rebuild` siblings.
 
-# Apply migrations to create tables
-make db-upgrade
-```
+> [!NOTE]
+> **Windows users:** `make` requires GNU Make. Install via [Chocolatey](https://chocolatey.org/) (`choco install make`) or use **WSL2 / Git Bash**. The Docker workflow is identical across macOS, Linux, and WSL2.
 
-#### 4. Create admin user
+<details>
+<summary><b>Local backend (no Docker, for IDE breakpoints)</b></summary>
+
+If you want to run the backend on the host while the database stays in Docker:
 
 ```bash
-make create-admin
-# Enter email and password when prompted
+cd my_ai_app
+make install                                                # uv sync + pre-commit hooks
+
+# Start only infrastructure containers
+docker compose -f docker-compose.dev.yml up -d db redis    # add 'milvus etcd minio' if RAG
+
+make db-upgrade                                             # apply migrations
+make create-admin                                           # interactive
+make run                                                    # uvicorn --reload
 ```
 
-#### 5. Start the backend
+</details>
+
+<details>
+<summary><b>Production deploy</b></summary>
 
 ```bash
-make run
+# On your server
+git clone <your-repo>
+cd my_ai_app
+
+cp backend/.env.example backend/.env            # fill in real secrets
+# Configure your nginx host using nginx/nginx.conf as reference
+
+make prod                                       # builds + starts + migrates
+make prod-logs                                  # tail logs
 ```
 
-#### 6. Start the frontend (new terminal)
+For frontend deployment to **Vercel**:
 
 ```bash
-cd frontend
-bun install
-bun dev
+cd frontend && npx vercel --prod
 ```
 
-**Access:**
-
-- API: <http://localhost:8000>
-- Docs: <http://localhost:8000/docs>
-- Admin Panel: <http://localhost:8000/admin> (login with admin user)
-- Frontend: <http://localhost:3000>
+In the Vercel dashboard set `BACKEND_URL`, `BACKEND_WS_URL`, `NEXT_PUBLIC_AUTH_ENABLED=true`.
 
 </details>
 
@@ -268,55 +292,167 @@ Use `make help` to see all available Makefile shortcuts.
 
 ## 🎬 Demo
 
+**CLI generator:**
+
 <p align="center">
   <img src="https://raw.githubusercontent.com/vstorm-co/full-stack-ai-agent-template/main/assets/app_start.gif" alt="FastAPI Fullstack Generator Demo">
 </p>
 
+**Live chat — web search:**
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/vstorm-co/full-stack-ai-agent-template/main/assets/chat/websearchdemo.gif" alt="Agent answering with live web search">
+</p>
+
+**Live chat — chart generation:**
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/vstorm-co/full-stack-ai-agent-template/main/assets/chat/chartdemo.gif" alt="Agent generating an interactive chart">
+</p>
+
+**File upload & RAG ingestion:**
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/vstorm-co/full-stack-ai-agent-template/main/assets/new/file_uploud_light.gif" alt="File Upload Demo">
+</p>
+
 ---
 
 ## 📸 Screenshots
 
-### Landing Page & Login
+### Marketing Site
+
+**Landing Page** — Full-page marketing site with hero, features breakdown, testimonials, pricing preview, and FAQ. Generated with the `enable_marketing_site` option.
+
+![Landing Page](https://raw.githubusercontent.com/vstorm-co/full-stack-ai-agent-template/main/assets/new/landing_page.png)
+
+**Pricing** — Three-tier pricing page (Starter / Pro / Business) with monthly/annual toggle. Pulls live plan data from Stripe when connected; shows template plans otherwise.
+
+![Pricing](https://raw.githubusercontent.com/vstorm-co/full-stack-ai-agent-template/main/assets/new/pricing.png)
+
+**Blog** — Engineering blog included out of the box. Posts are MDX files in the repo — no CMS needed. Supports tags, featured posts, and author bylines.
+
+![Blog](https://raw.githubusercontent.com/vstorm-co/full-stack-ai-agent-template/main/assets/new/blog.png)
+
+**Blog Post** — Individual post view with author card, reading time, and tag badges. Content is plain MDX — edit files and redeploy.
+
+![Blog Post](https://raw.githubusercontent.com/vstorm-co/full-stack-ai-agent-template/main/assets/new/blog_post.png)
+
+### Auth
+
+**Login** — Split-screen login with Google OAuth and email/password. Left panel shows a product pitch with a social proof quote. HTTP-only cookie session on submit.
 
-| Landing Page | Login |
-|:---:|:---:|
-| ![Landing Page](https://raw.githubusercontent.com/vstorm-co/full-stack-ai-agent-template/main/assets/landingpage.png) | ![Login](https://raw.githubusercontent.com/vstorm-co/full-stack-ai-agent-template/main/assets/login.png) |
+![Login](https://raw.githubusercontent.com/vstorm-co/full-stack-ai-agent-template/main/assets/new/login.png)
 
-### Dashboard, Chat & RAG
+**Register** — Same split-screen layout as login. Google sign-up and email/password form with confirm-password field and terms acceptance.
 
-| Dashboard | Chat with RAG |
-|:---:|:---:|
-| ![Dashboard](https://raw.githubusercontent.com/vstorm-co/full-stack-ai-agent-template/main/assets/dashboard.png) | ![Chat with RAG](https://raw.githubusercontent.com/vstorm-co/full-stack-ai-agent-template/main/assets/chatwithrag.png) |
-| **Documents** | **Search** |
-| ![RAG Documents](https://raw.githubusercontent.com/vstorm-co/full-stack-ai-agent-template/main/assets/ragdocuments.png) | ![RAG Search](https://raw.githubusercontent.com/vstorm-co/full-stack-ai-agent-template/main/assets/ragsearch.png) |
+![Register](https://raw.githubusercontent.com/vstorm-co/full-stack-ai-agent-template/main/assets/new/register.png)
+
+### Dashboard
+
+**Dashboard (light mode)** — Workspace overview showing conversation count, knowledge base vector count, recent activity feed, agent tool call stats, active sessions, and team info. Onboarding banner guides new users through setup in under 2 minutes.
+
+![Dashboard Light](https://raw.githubusercontent.com/vstorm-co/full-stack-ai-agent-template/main/assets/new/dashboard_light.png)
+
+**Dashboard (dark mode)** — Same dashboard in dark theme. Theme is saved per-device and can be overridden per-workspace in appearance settings.
+
+![Dashboard Dark](https://raw.githubusercontent.com/vstorm-co/full-stack-ai-agent-template/main/assets/new/dashboard_dark.png)
+
+### Teams & Organizations
+
+**Workspaces** — List of all organizations the user belongs to. Shows plan tier and role for each. Users can switch active workspace or create a new organization.
+
+![Organizations](https://raw.githubusercontent.com/vstorm-co/full-stack-ai-agent-template/main/assets/new/organizations.png)
+
+**Team Management** — Organization detail page with workspace profile (name + avatar), member list with roles, and an "Invite teammate" button. Owners and admins can adjust roles inline.
+
+![Organization Details](https://raw.githubusercontent.com/vstorm-co/full-stack-ai-agent-template/main/assets/new/organizations_details.png)
+
+### Knowledge Bases
+
+**Knowledge Bases** — List of RAG knowledge bases scoped to the current workspace. Each base shows its collection slug. Users can create new bases, toggle which ones are active in chat, and upload documents through the UI.
+
+![Knowledge Bases](https://raw.githubusercontent.com/vstorm-co/full-stack-ai-agent-template/main/assets/new/knowledge_bases.png)
+
+### Billing
+
+**Billing** — Workspace billing dashboard showing current plan, storage usage (chat attachments + indexed RAG documents), quick links to usage breakdown, invoices, payment methods, and subscription management. "Manage in Stripe" opens the Stripe customer portal.
+
+![Billing](https://raw.githubusercontent.com/vstorm-co/full-stack-ai-agent-template/main/assets/new/billing.png)
+
+### Profile & Settings
+
+**Profile** — Personal info tab: avatar upload, display name, email, and active session list with per-device revoke buttons. Visibility note explains which fields are shown to teammates.
+
+![Profile](https://raw.githubusercontent.com/vstorm-co/full-stack-ai-agent-template/main/assets/new/profile.png)
+
+**Account & Security** — Change password form with strength guidance, "Sign out everywhere" button, and danger zone for permanent account deletion.
+
+![Account](https://raw.githubusercontent.com/vstorm-co/full-stack-ai-agent-template/main/assets/new/profile_account.png)
+
+**Slash Commands** — Customize the `/command` palette in chat. Toggle built-in commands (`/clear`, `/regen`, `/settings`, `/summarize`, `/explain`) and create custom shortcuts that send a stored prompt with a few keystrokes.
+
+![Slash Commands](https://raw.githubusercontent.com/vstorm-co/full-stack-ai-agent-template/main/assets/new/profile_commands.png)
+
+**Appearance** — Theme switcher (light / dark / system) and brand color picker with four presets: Blue (Stripe/Vercel), Green (healthtech), Red (energetic), Orange (B2C), Violet (Anthropic-style). Brand color updates CSS variables across the entire workspace and is saved per-device.
+
+![Appearance](https://raw.githubusercontent.com/vstorm-co/full-stack-ai-agent-template/main/assets/new/profile_apperance.png)
+
+**Notification Preferences** — Per-category notification controls with separate toggles for email and in-app delivery. Categories: Billing, Team activity, Security alerts, and Product updates. Preferences stored locally and synced to the backend via `/users/me/notifications`.
+
+![Notifications](https://raw.githubusercontent.com/vstorm-co/full-stack-ai-agent-template/main/assets/new/profile_notifications.png)
+
+### Admin Panel
+
+**Admin Overview** — Workspace-wide metrics (total users, active sessions last 24h, conversation count, MRR) plus a recent activity feed showing all conversations across all users. Requires the `admin` role.
+
+![Admin Overview](https://raw.githubusercontent.com/vstorm-co/full-stack-ai-agent-template/main/assets/new/admin.png)
+
+**User Management** — Full user list with search by email or name. Shows role, status, join date, and an "Inspect" action to impersonate or suspend any user. Pagination built in.
+
+![Admin Users](https://raw.githubusercontent.com/vstorm-co/full-stack-ai-agent-template/main/assets/new/admin_users.png)
+
+**Conversation Browser** — Browse all conversations across the workspace. Filter by status and owner, sort by any column, open any conversation in a read-only view. Useful for support and quality review.
+
+![Admin Conversations](https://raw.githubusercontent.com/vstorm-co/full-stack-ai-agent-template/main/assets/new/admin_conversations.png)
+
+**Message Quality & Ratings** — Aggregated like/dislike feedback on AI responses over the last 30 days. Shows approval rate, daily chart, and a filterable table of individual ratings with optional user comments. Export to CSV.
+
+![Admin Ratings](https://raw.githubusercontent.com/vstorm-co/full-stack-ai-agent-template/main/assets/new/admin_ratings.png)
+
+**Stripe Events Log** — Webhook event browser for debugging Stripe billing flows. Lists all received events (type, customer, amount, status, timestamp) and lets admins manually replay any event via the backend `/admin/stripe-events/{id}/replay` endpoint.
+
+![Stripe Events](https://raw.githubusercontent.com/vstorm-co/full-stack-ai-agent-template/main/assets/new/admin_stripe_events.png)
+
+**System Health** — Live readiness dashboard auto-refreshing every 30 seconds. Checks API, Database (PostgreSQL primary), Redis, Vector store, LLM provider, Background worker, and Stripe API. Shows uptime percentage per service.
+
+![System Health](https://raw.githubusercontent.com/vstorm-co/full-stack-ai-agent-template/main/assets/new/admin_system_health.png)
 
 ### Observability
 
-| Logfire (PydanticAI) | LangSmith (LangChain) |
-|:---:|:---:|
-| ![Logfire](https://raw.githubusercontent.com/vstorm-co/full-stack-ai-agent-template/main/assets/logfire.png) | ![LangSmith](https://raw.githubusercontent.com/vstorm-co/full-stack-ai-agent-template/main/assets/langsmith.png) |
+**Logfire (PydanticAI)** — Full distributed tracing for PydanticAI agent runs, FastAPI requests, database queries, Redis, Celery tasks, and HTTPX calls — all in one timeline.
+
+![Logfire](https://raw.githubusercontent.com/vstorm-co/full-stack-ai-agent-template/main/assets/logfire.png)
+
+**LangSmith (LangChain / LangGraph)** — Trace viewer for LangChain agent runs with step-by-step chain inspection, token usage, and feedback collection.
+
+![LangSmith](https://raw.githubusercontent.com/vstorm-co/full-stack-ai-agent-template/main/assets/langsmith.png)
 
 ### Messaging Channels
 
-<p align="center">
-  <img src="https://raw.githubusercontent.com/vstorm-co/full-stack-ai-agent-template/main/assets/telegram_icon.png" width="40" alt="Telegram">
-  &nbsp;&nbsp;&nbsp;
-  <img src="https://raw.githubusercontent.com/vstorm-co/full-stack-ai-agent-template/main/assets/slack_icon.png" width="40" alt="Slack">
-</p>
+**Telegram Bot** — Multi-bot integration with both polling and webhook modes. Each bot gets its own session, supports group concurrency control, and routes messages through the same agent pipeline as the web UI.
+
+![Telegram](https://raw.githubusercontent.com/vstorm-co/full-stack-ai-agent-template/main/assets/telegram.png)
+
+### Monitoring & API
 
-| Telegram Bot |
-|:---:|
-| ![Telegram](https://raw.githubusercontent.com/vstorm-co/full-stack-ai-agent-template/main/assets/telegram.png) |
+**Celery Flower** — Real-time task queue monitor. Track worker status, task throughput, and failure rates for background jobs (document ingestion, email, webhooks).
 
-### Admin, Monitoring & API
+![Flower](https://raw.githubusercontent.com/vstorm-co/full-stack-ai-agent-template/main/assets/flower.png)
 
-| Celery Flower | SQLAdmin Panel |
-|:---:|:---:|
-| ![Flower](https://raw.githubusercontent.com/vstorm-co/full-stack-ai-agent-template/main/assets/flower.png) | ![Admin](https://raw.githubusercontent.com/vstorm-co/full-stack-ai-agent-template/main/assets/admin.png) |
+**API Documentation** — Auto-generated OpenAPI / Swagger UI at `/docs`. All endpoints documented with request/response schemas, auth requirements, and example payloads.
 
-| API Documentation |
-|:---:|
-| ![API Docs](https://raw.githubusercontent.com/vstorm-co/full-stack-ai-agent-template/main/assets/docs_2.png) |
+![API Docs](https://raw.githubusercontent.com/vstorm-co/full-stack-ai-agent-template/main/assets/docs_2.png)
 
 ---
 
@@ -416,8 +552,12 @@ Generated projects include **CLAUDE.md** and **AGENTS.md** files optimized for A
 
 - **React 19** + **TypeScript** + **Tailwind CSS v4**
 - **AI Chat Interface** - WebSocket streaming, tool call visualization
-- **Authentication** - HTTP-only cookies, auto-refresh
-- **Dark Mode** + **i18n**
+- **Authentication** - HTTP-only cookies, auto-refresh, password reset, magic link
+- **Marketing Site** - hero, pricing, FAQ, blog, contact form, legal pages (PL + EN)
+- **User Settings** - profile, API keys CRUD (`sk_*` tokens), onboarding tracking
+- **Admin Panel** - workspace stats, Stripe events browser
+- **SEO** - per-page metadata, OG image, sitemap, robots, manifest, favicons
+- **Dark Mode** + **i18n** (PL/EN via next-intl, locale-prefixed routes)
 
 ### 🔌 20+ Enterprise Integrations