a69eb7e587
Implements all 5 phases of Foundary Studio backend:
Phase 1: Chat Persistence (8 API endpoints)
- Conversations and messages with proper cascading deletes
- PostgreSQL schema with auto-update triggers
- Full CRUD operations with structured logging
Phase 2: Blueprint Entity (5 API endpoints)
- JSONB spec storage with GIN indexes
- Flexible structured data for project specifications
- Version-controlled blueprint management
Phase 3: Architect Service (3 API endpoints)
- Conversational AI orchestration with Claude
- Multi-turn dialogue with context building
- Blueprint spec extraction from conversations
Phase 4: Work Queue Integration
- Verified existing endpoint compatibility
Phase 5: Structured Questions (6 API endpoints)
- Four question types: text, choice, multichoice, yesno
- Answer validation with proper constraints
- Conversation-linked Q&A flow
Architecture:
- Textbook hexagonal architecture (domain → port → adapter → service → handler)
- Zero external dependencies in domain layer
- Consistent error handling with proper wrapping
- Auth scopes on all routes (projects:read, projects:execute)
- Structured logging with operation context and duration tracking
- NULL-safe DTO converters throughout
Database:
- 3 new migrations (019, 020, 021)
- UUIDs for all primary keys
- Proper foreign key constraints with ON DELETE CASCADE
- Optimized indexes including partial index for unanswered questions
- Auto-update triggers for timestamps
OpenAPI Documentation:
- Complete API documentation under 'Foundary' tag
- 22 new endpoints documented with examples
- Request/response schemas for all operations
Logging Improvements:
- Added operation field to all service logs
- Added duration_ms tracking for performance monitoring
- Log response_length instead of full response content
- Consistent use of logging field constants
- Execute-then-log pattern for delete operations
Files: 32 changed, 2800+ lines added
- 7 domain models
- 3 database migrations
- 3 port interfaces
- 3 postgres adapters
- 4 services (conversation, blueprint, question, architect)
- 4 handlers with DTOs
- OpenAPI documentation
- Integration in main.go
🤖 Generated with Claude Code
Co-Authored-By: Claude <noreply@anthropic.com>
|
||
|---|---|---|
| .. | ||
| api | ||
| architecture | ||
| features | ||
| guides/sdlc | ||
| legal | ||
| operations | ||
| plans | ||
| specs | ||
| ui/ideation | ||
| claude-config-api.md | ||
| media-handling-spec.md | ||
| README.md | ||
| reference.md | ||
| RELEASE_CHECKLIST.md | ||
rdev Documentation
Documentation for the rdev remote development API.
Quick Start
- Quick Reference - Essential commands for daily operations
- API Documentation - REST API reference
Documentation Structure
docs/
├── reference.md # Quick reference for operations
├── api/ # API documentation
│ ├── README.md # API overview
│ ├── authentication.md # API key auth
│ ├── sse-examples.md # SSE streaming
│ └── errors.md # Error codes
├── architecture/ # System design
│ ├── README.md # Architecture overview
│ ├── hexagonal.md # Ports & adapters
│ ├── security.md # Auth, sanitization
│ └── streaming.md # SSE protocol
├── operations/ # Operational guides
│ ├── deployment.md # K8s deployment
│ ├── monitoring.md # Prometheus/Grafana
│ ├── troubleshooting.md # Common issues
│ ├── database-connections.md # CRDB/Redis/Postgres
│ └── runbooks/ # Incident runbooks
├── features/ # Feature documentation
│ └── multi-provider.md # Code agent providers
└── plans/ # Planning documents
Developer Guides
For day-to-day development, see .claude/guides/:
| Guide | Description |
|---|---|
| local/setup.md | Local development setup |
| local/testing.md | Running tests |
| backend/go-guidelines.md | Go coding standards |
| backend/hexagonal.md | Hexagonal architecture |
| ops/credentials.md | Credentials management |
| ops/deploying.md | Deployment process |
Key Resources
Database Connections
See operations/database-connections.md for:
- CockroachDB SQL shell access
- Redis CLI access
- PostgreSQL access for rdev metadata
Credentials
Infrastructure credentials (Cloudflare, Gitea, Woodpecker) are stored in:
- Source:
.secretsfile at repo root (gitignored) - Storage: PostgreSQL with encryption
- Guide: .claude/guides/ops/credentials.md
Service URLs
| Service | External URL |
|---|---|
| rdev API | https://rdev.masq-ops.orchard9.ai |
| CockroachDB Console | https://cockroachdb.threesix.ai |
| Gitea | https://git.threesix.ai |
| Woodpecker CI | https://ci.threesix.ai |
Related
- CLAUDE.md - Project root documentation (always in context)
- ai-lookup/ - Quick fact lookups for Claude