1.5 KiB
CLAUDE.md
Mandatory Instructions
Before making any code changes, you MUST read and understand the following documents:
- docs/01-project-overview.md
- docs/02-architecture.md
- docs/03-database-design.md
- docs/04-routing.md
- docs/05-ui-pages.md
- docs/06-admin-panel.md
- docs/07-deployment.md
- docs/08-roadmap.md
- docs/09-coding-standards.md
- docs/10-project-structure.md
These documents are the source of truth.
Do not make assumptions that contradict these documents.
Architecture Rules
Follow:
Handler Service Repository
Pattern.
Do not place business logic inside handlers.
Do not execute SQL inside handlers.
Use dependency injection.
Technology Stack
Backend:
- Go
- Fiber
- GORM
- MariaDB
- Redis
Frontend:
- Go Templates
- HTMX
- TinyMCE
No SPA.
No Vue.
No React.
No Next.js.
Authentication
Session Based Authentication.
Redis Session Storage.
No JWT.
Rendering
Server Side Rendering.
Use HTMX only where partial updates are required.
Uploads
Never store uploads inside repository.
Production upload path:
/opt/data/uploads
Database
Use GORM.
Use migrations.
Use soft delete.
Coding Style
Prefer simple solutions.
Avoid over-engineering.
Avoid premature abstractions.
Keep code readable.
Maintain clear separation of responsibilities.
Session Recovery
If context is lost, re-read all documentation files before continuing implementation.
Treat documentation as the authoritative project specification.