Saltar a contenido

❓ FAQ

Frequently asked questions about Aeternus.

Setup & Installation

Q: My Node version is wrong. How do I fix it?
A: Use nvm (macOS/Linux):

nvm install 20 && nvm use 20

Q: Port 3000 already in use.
A:

npm run dev:clean

Q: Can I skip PostgreSQL?
A: Not for production. For development, use Docker:

docker run -p 5432:5432 -e POSTGRES_PASSWORD=postgres postgres:15

Development

Q: How do I debug the frontend?
A: Press F12 in browser → Console/Network tabs.

Q: How do I debug the backend?
A: Check the terminal where make run is running. Add print() statements.

Q: My changes aren't showing up.
A:

  • Frontend: Refresh browser
  • Backend: Wait for auto-reload
  • Or restart both

APIs & Integration

Q: Do I need OpenAI API key?
A: No. Set CORE_MOCK_MODE=true for fake responses.

Q: Do I need Auth0?
A: No for local development.

Q: Do I need Neo4j?
A: No. Set NEO4J_OFFLINE=true.

Contributing

Q: Can I commit directly to master?
A: No. Always create a feature branch.

Q: How do I write good commit messages?
A: Use imperative mood: "Add feature", "Fix bug", "Update docs".

Q: Can I use git push --force?
A: Only with --force-with-lease and if you know what you're doing.

Deployment

Q: When are deployments?
A: Every push to master triggers automatic deployment.

Q: How do I rollback?
A: See Deployment Guide.

Troubleshooting

Q: Everything is broken!
A: Try:

  1. npm run dev:clean
  2. npm install && cd core && make setup
  3. Check .env.local and core/.env
  4. Restart both frontend and backend
  5. Ask for help!

Q: "Cannot GET /api/..."
A: Backend isn't running or URL is wrong.

Q: Database errors
A: Make sure PostgreSQL is running and database is created.

Still have questions? Ask the team!