egullickson/motovaultpro
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Updated frameworks.

Browse Source
This commit is contained in:
Eric Gullickson
2025-08-25 12:40:27 -05:00
parent e22d643ae3
commit 0cdb9803de
25 changed files with 5366 additions and 41 deletions
Download Patch File Download Diff File Expand all files Collapse all files

17
README.md
View File

@@ -32,7 +32,7 @@ Load `docs/database-schema.md` for complete schema overview
Load `docs/testing.md` for Docker-based testing workflow
Only use docker containers for testing. Never install local tools if they do not exist already.
### 4. Development Environment (Docker-first)
### 4. Development Environment (Production-Only)
```bash
# One-time setup (copies .env and builds containers)
make setup
@@ -41,9 +41,10 @@ make setup
make dev
```
Note: The frontend runs behind nginx with HTTPS in dev. You must provide local certificates in `./certs` (see SSL section below) or the frontend container will fail to start.
**Production-Only Development**: This application runs in production mode only. All development happens with production builds and configurations.
### 5. Key Principles
- **Production-Only**: All development uses production builds and configuration
- **Docker-First**: All development in containers, no local installs
- **Feature Independence**: Each feature is completely isolated
- **Single Directory Context**: Load one directory for complete understanding
@@ -74,19 +75,21 @@ make shell-backend
- **maintenance**: Scaffolded (depends on vehicles)
- **stations**: Partial (Google Maps integration)
## SSL for Frontend (Local Dev)
## SSL for Frontend (Production Development)
- Place `motovaultpro.com.crt` and `motovaultpro.com.key` in `./certs`.
- To generate self-signed dev certs:
- To generate self-signed certs for production development:
```bash
openssl req -x509 -nodes -days 365 -newkey rsa:2048 \
-keyout certs/motovaultpro.com.key \
-out certs/motovaultpro.com.crt \
-subj "/CN=localhost"
-subj "/CN=motovaultpro.com"
```
- Access frontend at `https://localhost:3443` (HTTP on `:3000` redirects to HTTPS).
- **Access frontend at**: `https://motovaultpro.com` (requires DNS or hosts file entry)
- **Hosts file setup**: Add `127.0.0.1 motovaultpro.com` to `/etc/hosts`
- HTTP requests redirect to HTTPS automatically.
## Architecture Summary
Vehicle management platform using Modified Feature Capsule design where each feature is self-contained with API, domain logic, database layer, migrations, external integrations, tests, and documentation in a single directory. Built for AI maintainability with Docker-first development.
Vehicle management platform using Modified Feature Capsule design where each feature is self-contained with API, domain logic, database layer, migrations, external integrations, tests, and documentation in a single directory. Built for AI maintainability with production-only Docker development.
## Quick Navigation
- **Setup**: AI_PROJECT_GUIDE.md