feat: add purchase reflections

README.md

@@ -1 +1,64 @@
-# purchases-personas
+# Purchases Personas Generator
+
+A TypeScript application that leverages the Anthropic Claude API to generate realistic fictional personas and their weekly purchase behaviors. For creating synthetic datasets for retail/e-commerce applications with believable user behaviors and spending patterns.
+
+## 🌟 Features
+
+- Generate detailed fictional personas including:
+  - Personal demographics and household details
+  - Daily routines and activities
+  - Shopping preferences and brand loyalties
+  - Financial patterns and spending habits
+  - Contextual behaviors and upcoming events
+- Create realistic weekly purchase histories that match persona profiles
+- Store generated data in:
+  - PostgreSQL database for structured querying
+  - JSON files for easy data portability
+
+## 🚀 Getting Started
+
+1. Install dependencies:
+
+```bash
+yarn install
+```
+
+2. Set up your environment variables:
+
+```bash
+cp .env.example .env
+```
+
+3. Initialize the database:
+
+```bash
+yarn migrate
+```
+
+4. Build and start the application:
+
+```bash
+yarn build
+yarn start
+```
+
+For development:
+
+```bash
+yarn dev
+```
+
+## 🛠️ Available Scripts
+
+- `yarn start` - Start the production server
+- `yarn dev` - Start development server with hot reload
+- `yarn build` - Build the TypeScript project
+- `yarn lint` - Run ESLint with automatic fixes
+- `yarn format` - Format code using Prettier
+- `yarn typecheck` - Check TypeScript types
+- `yarn generate` - Generate Prisma client
+- `yarn migrate` - Run database migrations
+
+## ⚠️ Disclaimer
+
+The personas and purchase histories generated by this tool are fictional and should not be used as real user data. They are intended for testing and development purposes only.