Fixes to the map display and several other bugs

This commit is contained in:
2025-07-11 08:50:04 -06:00
parent cee9af7e49
commit 26a94fb3c0
38 changed files with 1336 additions and 411 deletions

View File

@@ -1,5 +1,4 @@
# Services
Changemaker Lite includes several powerful services that work together to provide a complete documentation and development platform. Each service is containerized and can be accessed through its dedicated port.
## Available Services
@@ -84,6 +83,15 @@ Changemaker Lite includes several powerful services that work together to provid
- Simple and fast interface
- No user registration required
### [Map](map.md)
**Port: 3000** | Canvassing and community organizing application
<div class="gitea-widget" data-repo="admin/changemaker.lite"></div>
- Interactive map for door-to-door canvassing
- Location and contact management
- Admin panel and QR code walk sheets
- NocoDB integration for data storage
- User authentication and access control
## Service Architecture
```
@@ -101,92 +109,10 @@ Changemaker Lite includes several powerful services that work together to provid
│ NocoDB │ │ PostgreSQL │ │ PostgreSQL │
│ :8090 │ │ (listmonk-db) │ │ (root_db) │
└─────────────────┘ │ :5432 │ │ :5432 │
└─────────────────┘ └─────────────────┘
└──────────────────────────────────────────────────────┘
```
└─────────────────┘ └─────────────────┘
## Getting Started
1. **Start all services**: `docker compose up -d`
2. **Check service status**: `docker compose ps`
3. **View logs**: `docker compose logs [service-name]`
4. **Stop services**: `docker compose down`
## Service Dependencies
- **Listmonk** depends on **PostgreSQL** (listmonk-db)
- **NocoDB** depends on **PostgreSQL** (root_db)
- **Static Server** serves content built by **MkDocs**
- **n8n** can integrate with all other services
- All services share the `changemaker` network
## Environment Configuration
Services are configured through environment variables in your `.env` file:
```env
# Port configurations
CODE_SERVER_PORT=8888
LISTMONK_PORT=9000
LISTMONK_DB_PORT=5432
MKDOCS_PORT=4000
MKDOCS_SITE_SERVER_PORT=4001
N8N_PORT=5678
# User and group IDs
USER_ID=1000
GROUP_ID=1000
# Database configuration
POSTGRES_USER=listmonk
POSTGRES_PASSWORD=your_password
POSTGRES_DB=listmonk
# n8n configuration
N8N_ENCRYPTION_KEY=your_encryption_key
N8N_USER_EMAIL=admin@example.com
N8N_USER_PASSWORD=your_password
```
## Monitoring and Maintenance
### Health Checks
```bash
# Check all services
docker compose ps
# Check specific service logs
docker compose logs listmonk-app
docker compose logs code-server
```
### Updates
```bash
# Pull latest images
docker compose pull
# Restart with new images
docker compose down && docker compose up -d
```
### Backups
- **PostgreSQL**: Regular database backups
- **n8n**: Export workflows and credentials
- **Code Server**: Backup configuration and workspace
- **MkDocs**: Version control your documentation
## Troubleshooting
### Common Issues
1. **Port Conflicts**: Ensure ports are not used by other applications
2. **Permission Issues**: Check `USER_ID` and `GROUP_ID` settings
3. **Network Issues**: Verify services can communicate through the `changemaker` network
4. **Data Persistence**: Ensure volumes are properly mounted
### Getting Help
- Check individual service documentation
- Review container logs for error messages
- Verify environment variable configuration
- Test network connectivity between services
┌─────────────────┐
│ Map │
│ :3000 │
└─────────────────┘
```