magentaaps/kas-self

KapitalAfkastSkat 自助服务门户镜像文档

1. 镜像概述

KapitalAfkastSkat自助服务门户Docker镜像，专为资本收益税（KapitalAfkastSkat）相关业务设计，提供用户友好的自助服务平台。该镜像封装了完整的门户应用，旨在简化用户办理资本收益税业务的流程，支持在线操作，提升服务效率。

2. 核心功能与特性

• 用户认证与授权：支持安全登录机制，基于角色的权限管理，确保用户仅能访问授权范围内的功能。
• 税务信息查询：提供个人或企业资本收益税相关信息的实时查询功能，包括历史申报记录、税费计算结果等。
• 申报表单提交：支持在线填写并提交资本收益税申报表单，自动校验数据格式，减少人工错误。
• 数据安全保障：采用加密技术保护用户敏感信息及交易数据，符合数据安全合规要求。
• 响应式界面：适配桌面端、移动端等多种设备，提供一致的用户体验。
• 日志与审计：记录用户操作日志，支持业务审计与问题排查。

3. 使用场景与适用范围

3.1 适用场景

• 税务管理部门向纳税人提供资本收益税自助服务
• ***机构为客户提供资本收益相关税务辅助服务
• 企业内部财务系统集成，支持员工自助办理资本收益税相关业务

3.2 适用范围

• 个人纳税人：查询及申报个人资本收益税
• 企业用户：办理企业资本收益税申报、数据导出等业务
• 服务提供方：快速部署资本收益税自助服务平台，降低基础设施成本

4. 使用方法与配置说明

4.1 基本部署（Docker Run）

通过以下命令快速启动容器：

bash
docker run -d \
  --name kapitalafkastskat-portal \
  -p 8080:8080 \
  -e DB_HOST=your-db-host \
  -e DB_PORT=5432 \
  -e DB_USER=portal-user \
  -e DB_PASSWORD=your-secure-password \
  -e APP_SECRET=your-app-secret-key \
  kapitalafkastskat/portal:latest

4.2 Docker Compose 配置示例

创建docker-compose.yml文件：

yaml
version: '3.8'
services:
  portal:
    image: kapitalafkastskat/portal:latest
    container_name: kapitalafkastskat-portal
    ports:
      - "8080:8080"
    environment:
      - DB_HOST=db
      - DB_PORT=5432
      - DB_USER=portal_user
      - DB_PASSWORD=secure_password
      - APP_SECRET=your_app_secret
      - LOG_LEVEL=INFO
    depends_on:
      - db
    restart: unless-stopped

  db:
    image: postgres:14
    container_name: kapitalafkastskat-db
    environment:
      - POSTGRES_DB=kapitalafkastskat
      - POSTGRES_USER=portal_user
      - POSTGRES_PASSWORD=secure_password
    volumes:
      - db-data:/var/lib/postgresql/data
    restart: unless-stopped

volumes:
  db-data:

启动服务：

bash
docker-compose up -d

4.3 环境变量配置

5. 注意事项

• 首次部署前需确保数据库已完成初始化（可通过执行镜像内置初始化脚本实现）。
• 生产环境建议配置HTTPS（可通过反向代理如Nginx实现），避免明文传输。
• 定期备份数据库数据，建议通过容器卷挂载持久化存储。
• 根据实际业务需求调整资源限制（如内存、CPU），避免性能瓶颈。