recuperando informacion y tratandola

README.md

@@ -34,3 +34,33 @@ You can check out [the Next.js GitHub repository](https://github.com/vercel/next
 The easiest way to deploy your Next.js app is to use the [Vercel Platform](https://vercel.com/new?utm_medium=default-template&filter=next.js&utm_source=create-next-app&utm_campaign=create-next-app-readme) from the creators of Next.js.
 
 Check out our [Next.js deployment documentation](https://nextjs.org/docs/app/building-your-application/deploying) for more details.
+
+## Development with Docker (recommended for full features)
+
+The project uses Postgres for caching generated movie insight cards. For the best experience (including persistent cache and automatic migrations):
+
+```bash
+# Start everything (app + database)
+docker compose -f docker-compose.dev.yml up --build
+```
+
+- Open http://localhost:3000
+- The first time it will run DB migrations automatically.
+- Source code is mounted for live reload (`npm run dev` inside the container).
+- Stop with `docker compose -f docker-compose.dev.yml down`
+
+Environment variables (TMDB_API_KEY, LLM_API_KEY, etc.) are read from your `.env` file.
+
+If you prefer running without Docker:
+
+```bash
+npm run dev
+```
+
+> Note: Without the database the insight cards will still generate (they just won't be cached), thanks to graceful cache handling.
+
+## Production
+
+```bash
+docker compose -f docker-compose.yml up --build
+```