Complete rebrand from Apoklisis to Patherly

- Update all frontend branding (title, headers, login/register pages)
- Update documentation (CLAUDE-SETUP, CURRENT-STATE, PROGRESS, LESSONS-LEARNED)
- Update backend scripts and test configuration
- Fix emoji encoding in seed scripts for Windows compatibility
- Sync seed user credentials between seed_data.py and seed_trees.py
- Update database references to patherly/patherly_test

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Michael Chihlas
2026-01-31 21:55:55 -05:00
parent 06cc83e3fe
commit 2421f10dbd
16 changed files with 60 additions and 60 deletions

View File

@@ -11,12 +11,12 @@
### Database Name Mismatch After Fresh Clone
**Problem:** After cloning the repo and running `docker-compose up -d`, Alembic migrations fail with `database "decision_tree" does not exist`.
**Cause:** The `.env` file contains the old database name (`decision_tree`) but `docker-compose.yml` creates a database called `apoklisis`.
**Cause:** The `.env` file contains the old database name (`decision_tree`) but `docker-compose.yml` creates a database called `patherly`.
**Solution:** Update `.env` to use the correct database name:
```
DATABASE_URL=postgresql+asyncpg://postgres:postgres@localhost:5432/apoklisis
DATABASE_URL_SYNC=postgresql://postgres:postgres@localhost:5432/apoklisis
DATABASE_URL=postgresql+asyncpg://postgres:postgres@localhost:5432/patherly
DATABASE_URL_SYNC=postgresql://postgres:postgres@localhost:5432/patherly
```
**Files affected:** `backend/.env`
@@ -57,7 +57,7 @@ When setting up development on a new machine:
1. **Clone repo:** `git clone <repo-url>`
2. **Start Docker Desktop**
3. **Start database:** `cd backend && docker-compose up -d`
4. **Fix .env database name** if it says `decision_tree` → change to `apoklisis`
4. **Fix .env database name** if it says `decision_tree` → change to `patherly`
5. **Create venv:** `python -m venv venv`
6. **Activate venv:** `.\venv\Scripts\Activate`
7. **Install backend deps:** `pip install -r requirements.txt`
@@ -422,13 +422,13 @@ module.exports = {
**Solution:** Use Docker exec to run psql inside the container:
```powershell
# Single command
docker exec -it apoklisis_postgres psql -U postgres -c "SELECT * FROM users;"
docker exec -it patherly_postgres psql -U postgres -c "SELECT * FROM users;"
# Interactive session
docker exec -it apoklisis_postgres psql -U postgres
docker exec -it patherly_postgres psql -U postgres
# Create database
docker exec -it apoklisis_postgres psql -U postgres -c "CREATE DATABASE apoklisis_test;"
docker exec -it patherly_postgres psql -U postgres -c "CREATE DATABASE patherly_test;"
```
---
@@ -439,7 +439,7 @@ docker exec -it apoklisis_postgres psql -U postgres -c "CREATE DATABASE apoklisi
**Solution:** Check and start the container:
```powershell
docker ps # See running containers
docker start apoklisis_postgres # Start if stopped
docker start patherly_postgres # Start if stopped
```
---
@@ -451,7 +451,7 @@ docker start apoklisis_postgres # Start if stopped
**Solution:** Always run git commands from project root:
```powershell
cd C:\Dev\Projects\Apoklisis
cd C:\Dev\Projects\patherly
git add .
git commit -m "Your message"
git push origin main
@@ -512,7 +512,7 @@ decision = {
**One-time setup:**
```powershell
docker exec -it apoklisis_postgres psql -U postgres -c "CREATE DATABASE apoklisis_test;"
docker exec -it patherly_postgres psql -U postgres -c "CREATE DATABASE patherly_test;"
```
**Run tests:**
@@ -560,7 +560,7 @@ pip install httpx
**Solution:** Use a standard domain like `example.com` for seed/test users:
```python
# BAD
"email": "seed.admin@apoklisis.local"
"email": "seed.admin@patherly.local"
# GOOD
"email": "seed.admin@example.com"