How gokruzk/photo_manager works
Project type and purpose
• This is a full-stack web application (“Photo Album Manager”) composed of:
• Frontend: Next.js (React + TypeScript + Tailwind)
• Backend: FastAPI (Python) with a modular routes/controllers structure
• Persistence: PostgreSQL via Prisma ORM
File structure
• Top-level directories:
• Backend/ – Python service, organized into config, controller, routes, model, utils, prisma schema, database artifacts
• Frontend/ – Next.js 13+ “app” directory, API‐caller modules, shared components, styles, middleware
• Patterns:
• Backend follows a layered (routes → controllers → models) / MVC‐style pattern
• Frontend uses React server + client components under “app/” and a thin API layer in api/*.tsx
• Config & deployment artifacts:
• Backend/config/db.py, .env for DB_URL & JWT SECRET_KEY
• Frontend/next.config.mjs, tsconfig.json, tailwind.config.ts
Key README insights
• Backend stack: FastAPI + PrismaORM + PostgreSQL, JWT‐based auth, email service variable (API_EMAIL)
• Frontend: create-next-app bootstrapped, uses next/font, Tailwind for styling
a. Main components
1) Client/browser (Web UI)
2) Next.js Server / App Layer
3) FastAPI Backend
– Route handlers (routes/*.py)
– Business logic (controller/*.py)
– Models & ORM (prisma/schema.prisma + model/models.py)
– Utilities (auth, hashing, session)
4) PostgreSQL Database
5) External services
– Email provider (for notifications)
– (Optional) Object store or CDN for images, if applicable
b. Relationships & interactions
• User interacts with Next.js UI → issues HTTP(S) calls to FastAPI endpoints (e.g. /users, /images, /countries)
• FastAPI routes forward to controller logic → use Prisma client to query/update PostgreSQL
• Auth utility issues/verifies JWTs; controllers validate tokens on protected routes
• On successful upload, images are persisted (either in DB or file store) and metadata recorded
• If configured, backend invokes external email API (API_EMAIL) for password resets or notifications
c. Architectural patterns & design principles
• Layered architecture (Presentation → Application/API → Domain logic → Data access)
• RESTful API design in FastAPI
• Modularization by domain (auth, user, image, country)
• Type safety and code sharing in Frontend (TypeScript types)
d. Key technologies/frameworks
• Frontend: Next.js 13 app router, React, Tailwind CSS, TypeScript
• Backend: FastAPI, Python 3.x, Prisma ORM, PostgreSQL, JWT for authentication
• DevOps/tools: prisma CLI, pydantic models, node/npm or pnpm for FE
Detail without over-complication
• Prisma schema and database scripts as part of the Data Access layer
• Notes on environment configuration (.env variables for DB_URL, SECRET_KEY, API_EMAIL)