docs: update project structure in README

Expand the project structure section to include all directories and files with detailed descriptions. The updated structure now shows:
- Complete src/ layout with all modules
- Test suite organization (unit, integration, e2e, mcp)
- Migration and script directories
- OpenSpec structure with all spec categories
- Configuration files

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

README.md

@@ -35,12 +35,40 @@ The system consists of two main components:
 
 ```
 clubber/
-├── openspec/           # Specification-driven development
+├── src/                    # Application source code
-│   ├── project.md      # Project conventions and context
+│   ├── models/             # SQLAlchemy database models
-│   ├── specs/          # Current specifications
+│   ├── resolvers/          # GraphQL resolvers (queries and mutations)
-│   └── changes/        # Change proposals
+│   ├── schemas/            # GraphQL schema definitions
-├── CLAUDE.md           # AI assistant instructions
+│   ├── config.py           # Application configuration
-└── README.md           # This file
+│   ├── database.py         # Database setup and session management
+│   ├── main.py             # FastAPI application entry point
+│   ├── mcp_server.py       # MCP server implementation
+│   └── validation.py       # Input validation logic
+├── tests/                  # Test suite
+│   ├── unit/               # Unit tests (validation logic)
+│   ├── integration/        # Integration tests (database, resolvers)
+│   ├── e2e/                # End-to-end tests (API flows)
+│   ├── mcp/                # MCP server tests
+│   └── conftest.py         # Shared test fixtures
+├── migrations/             # Alembic database migrations
+│   └── versions/           # Migration version files
+├── scripts/                # Utility scripts
+│   └── seed.py             # Database seeding script
+├── openspec/               # Specification-driven development
+│   ├── specs/              # Current specifications
+│   │   ├── database-layer/
+│   │   ├── graphql-api/
+│   │   ├── mcp-integration/
+│   │   ├── member-crud/
+│   │   ├── project-documentation/
+│   │   └── project-setup/
+│   └── changes/            # Change proposals
+│       └── archive/        # Archived completed changes
+├── pyproject.toml          # Project dependencies and configuration
+├── alembic.ini             # Alembic migration configuration
+├── uv.lock                 # Locked dependency versions
+├── CLAUDE.md               # AI assistant instructions
+└── README.md               # This file
 ```
 
 ## Getting Started